Rules · High-fidelity page maintenance

高保真页面修改规则

这套页面用于指导 App UI 重做,可以领先当前代码,但必须持续和 iOS 页面层、组件层、DesignSystem 层保持可追踪关系。

1. 一页 App 页面对应一个 HTML 链接

新增或重做 App 页面时,在 docs/ui-redesign/pages/ 下新增对应 HTML。不要把多个页面塞进一张长图,也不要只在首页加一块概念 mock。

  • 页面入口必须从 index.html 可达。
  • 页面文件名使用产品页面名,例如 home.htmlpreview.html
  • 覆盖多个状态时,在同一页面内用清晰区块或状态说明呈现。

2. 每个页面必须声明 UIKit 落点

HTML 可以表达目标态,但必须写明未来应落到哪些 Swift 文件、ViewController 和组件。如果找不到落点,说明这个设计还没有进入可实现范围。

  • 页面级:HomeViewControllerProcessingViewControllerPreviewViewController
  • 组件级:HomePhotoToolbarViewTemplateSelectorViewPhotoUsageRowView
  • 系统级:UIColor.AppUIFont.AppAppSpacingAppRadius

3. 颜色、字号、间距只能从共享 token 出发

不要在页面文件里随意发明品牌色。确实需要新增 token 时,先更新 shared/tokens.css,再同步说明 Swift DesignSystem 应如何命名。

--bg / UIColor.App.background
--accent / UIColor.App.accent
--ink / UIColor.App.primaryText
--bg-soft / UIColor.App.backgroundSecondary
--error / UIColor.App.error
--stage / preview dark surface

4. 页面文案必须是用户语言

高保真页面里的标题、按钮和状态文案默认会进入 App。禁止把调试词、模型名、阈值、slotID、score 这类工程词作为普通用户可见内容。

5. 允许领先现状,但不允许脱离产品边界

Proster 的目标是自动生成海报,不是模板商城,也不是图层编辑器。蓝图可以提升视觉、操作层级和信息架构,但不能引入需要用户理解模板槽位的重编辑流程。