SuperAPI AI 工具集

build-ghost-app-ui

前端与建站

查看项目

更新于 10-30 22:11

技能介绍

用途:本技能用于构建 Ghost 应用的界面屏幕。Ghost 应用屏幕采用 Shade(@tryghost/shade),即 Ghost Admin 所使用的设计系统。本技能负责完成 Shade 的设置,并引导到与其并列安装的 Shade 技能;具体规则以 Shade 文档为准。应用的 manifest、connect() 和安装属于 build-ghost-app 技能。

文档来源:文档链接使用 https://shade.ghost.org。如果项目的 AGENTS.md 指定了 Shade 文档的其他地址或源码目录,则以该指定为准。在给定地址下,从 <address>/llms.txt 开始,使用 curl -s <address>/docs/<page>.md 获取网页,以保证文本原样;网页抓取工具会进行摘要且拒绝 localhost。

信息可信顺序:当来源冲突时,依次信任:已安装的 @tryghost/shade 包(其代码与类型定义;该包不附带文档)决定存在哪些组件、属性与导入,其类型与安装匹配;上述地址的文档决定如何使用;磁盘上的 Ghost 源码仅供参考,不要从其中导入,并跳过其仅适用于 Admin 的规则。

设置步骤(对照应用逐项检查并补齐缺失项):从 npm 安装 @tryghost/shade@alpha 及其 peer 依赖(latest 版本较旧);npm create vite 会脚手架生成 React 19,而 npm 在 Shade 旁边会拒绝该版本,因此先按 Install 的说明移动 React 包与类型;设置 Tailwind 与样式表;加载字体;用 ShadeApp 包裹应用;遵循 Admin 的浅色与深色主题;设置页面框架与边距;若应用将状态保存在查询字符串中,遵循 App state in the URL;将指定小节添加到应用的 AGENTS.md(必要时创建该文件),保留其中已有的说明 Shade 文档位置的任何行。

构建屏幕:从 shade-page-templates 的页面模板开始。按屏幕需要,使用 shade-page-header 处理页头、shade-use-primitives 处理布局、shade-tokens-not-hex 处理颜色、shade-no-dark-variants 处理深色模式、shade-imports 处理导入。只阅读适用于应用的文档。

自检:完成前在 Admin 中确认:屏幕在 Admin 浅色与深色主题下显示正常并随之切换;Inter 正常加载(document.fonts 在 Fonts 中列出的各字重均存在);页面自身没有外层内边距;在 Shade 已有组件、原语或令牌之处没有手工样式;每个状态(空、加载、错误)都能通过示例数据触达并使用 Shade 组件;应用的 AGENTS.md 包含 Shade 小节。