page-design
单页设计子流程。用于已有自定义页面的美化或设计：页面美化、视觉升级、官网首页、列表、看板、大屏、详情、工作台和表单入口体验优化。
Step 1：读取应用主题与功能契约
单页设计和页面重构先确认当前应用主题，同时记录现有功能契约。页面美感提升默认属于 UI-only 改造：调整布局、密度、间距、视觉层级、素材和图标表达，业务功能保持原样。
| 证据来源 | 读取内容 | 写入设计补充 |
|---|---|---|
用户给出的应用 URL、appType、页面 URL、resource context |
目标应用、目标页面、页面所处业务上下文 | appType、pageFormUuid、themeEvidence.source |
project/config.json、.cache/<项目名>-schema.json、.openyida-page.json |
已记录的 app/page/form、themeProfile、页面视觉摘要 | themeEvidence.source=workspace |
当前应用配置中的 colour、themeColor、navTheme |
当前应用主色和导航明暗 | currentAppTheme |
已有 Page Spec / 页面源码中的 themeProfile、应用主题消费方式 |
页面正在消费的应用主题 token | currentPageTheme |
| 已有 Page Spec / 页面源码 / 用户描述中的按钮、筛选、数据源、表单入口、跳转、权限、状态 | 当前页面功能契约和业务动作 | functionContract |
主题证据齐全时，页面重构、局部美化、列表/看板/详情优化沿用当前应用 colour / themeColor。主题证据缺失时，记录 themeEvidence.status=missing，根据行业、品牌、业务情绪和视觉目标生成应用主题文件，不固定回到 podBlue / #1677ff，也不套用行业刻板配色。
共享主题消费
先读取当前应用的 design.md，沿用已确认主题和组件规则；不重新选型或为单页另建主题库。尚无主题契约且本次需要确定风格时，按 共享主题选择规则 只读 主题索引 摘要，选中后读取一份完整主题，再补当前页面的项目化设计。局部美化仍保持应用主题、导航和功能契约。
完整步骤
| 步骤 | 复用文件 | 单页执行重点 |
|---|---|---|
| 1 | 本文件：读取应用主题与功能契约 | 获取 currentAppTheme、currentPageTheme、themeEvidence、functionContract |
| 2 | 读取整理后的用户需求 | 聚焦当前页面的用户、任务、业务对象和 UI-only 改造目标；没有完整应用需求文件时使用当前页面上下文 |
| 3 | 选择主题色和 token | 基于 Step 1 的应用主题；需要换色时生成或更新应用主题文件 |
| 5 | 页面结构和交互设计 | 明确布局骨架、主操作、详情抽屉、表单提交入口和 PC/移动端差异 |
| 6 | UI 视觉和状态设计 | 细化当前页视觉、素材、图标、空态、加载态、错误态和业务化自检 |
| 7 | 写入 design.md | 输出当前页面的设计补充，交给 yida-canvas-custom-page 实现；业务或页面契约变化时交给 yida-prd 更新 PRD |
主题决策口径
- 当前应用主题清楚：
themeDecision=follow-app或page-enhance，themeProfile.name使用当前应用主题 key，themeColorSource=application-theme，页面按业务需要调整构图、密度、素材和辅助视觉。 - 当前页面存在页面级主题 token：由
yida-design将主色和语义变量收敛到应用主题文件。 - 页面重构/局部美化：以当前应用主题为基准，使用
design.md确定的品牌色阶和语义变量。 - 页面美感提升/改 UI：
functionContract保持稳定，现有数据源、字段映射、按钮动作、筛选逻辑、提交 URL、权限和业务状态按原有实现交付。 - 用户明确要求换主色时，执行
openyida sample yida-design app-theme --output <app-theme.css> --design-file prd/<项目名>/design.md复制模板并按design.md自动替换 token；严禁重新生成或覆盖整份 CSS。 - 用户明确要全应用换肤：将诉求回到
yida-design的主题色和 token 分支，输出应用主题 CSS、themeColor和navTheme。 - 单页只做局部美化：保持平台导航和应用主题稳定，直接使用当前主题变量。
输出补充字段
在 design.md 输出格式 基础上补充：
- themeEvidence：<source/status/currentAppTheme/currentPageTheme>
- currentAppTheme：<colour/navTheme/config.COLOUR 或 missing>
- currentPageTheme：<当前应用主题变量或 missing>
- themeDecision：<follow-app / page-enhance / app-theme-update>
- functionContract：<保留的数据源/字段映射/按钮动作/筛选逻辑/提交 URL/权限/状态>
- changeScope：<UI-only：颜色/布局/密度/间距/视觉层级/素材/图标>
