openyida 2026.8.13 → 2026.8.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/docs/capabilities.md +21 -5
  2. package/package.json +1 -1
  3. package/yida-skills/SKILL.md +90 -184
  4. package/yida-skills/references/execution-rules.md +8 -0
  5. package/yida-skills/references/resource-context.md +81 -0
  6. package/yida-skills/references/routing-supplement.md +27 -0
  7. package/yida-skills/references/setup-and-env.md +31 -36
  8. package/yida-skills/skills/yida-app/SKILL.md +48 -294
  9. package/yida-skills/skills/yida-app/references/common-issues.md +49 -0
  10. package/yida-skills/skills/yida-app/workflow/step-1-resource-context.md +63 -0
  11. package/yida-skills/skills/yida-app/workflow/step-2-design.md +40 -0
  12. package/yida-skills/skills/yida-app/workflow/step-3-create-or-reuse-app.md +34 -0
  13. package/yida-skills/skills/yida-app/workflow/step-4-forms-processes.md +74 -0
  14. package/yida-skills/skills/yida-app/workflow/step-5-seed-records.md +44 -0
  15. package/yida-skills/skills/yida-app/workflow/step-6-main-page.md +35 -0
  16. package/yida-skills/skills/yida-app/workflow/step-7-page-code.md +50 -0
  17. package/yida-skills/skills/yida-app/workflow/step-8-publish-navigation.md +42 -0
  18. package/yida-skills/skills/yida-app/workflow/step-9-output-finish.md +82 -0
  19. package/yida-skills/skills/yida-create-form-page/SKILL.md +4 -3
  20. package/yida-skills/skills/yida-design/SKILL.md +9 -9
  21. package/yida-skills/skills/yida-design/references/page-quality-gates.md +1 -1
  22. package/yida-skills/skills/yida-design/references/style-design-selection.md +29 -29
  23. package/yida-skills/skills/yida-design/references/style-designs/aqua-service-progress-dashboard.md +3 -3
  24. package/yida-skills/skills/yida-design/references/style-designs/blue-insight-operations-dashboard.md +3 -3
  25. package/yida-skills/skills/yida-design/references/style-designs/blue-productivity-insight-workbench.md +3 -3
  26. package/yida-skills/skills/yida-design/references/style-designs/command-filter-card-console.md +4 -4
  27. package/yida-skills/skills/yida-design/references/style-designs/contrast-command-analytics-workbench.md +4 -4
  28. package/yida-skills/skills/yida-design/references/style-designs/dark-stage-analytic-dashboard.md +8 -8
  29. package/yida-skills/skills/yida-design/references/style-designs/filterable-card-catalog.md +5 -5
  30. package/yida-skills/skills/yida-design/references/style-designs/green-timeline-progress-workbench.md +3 -3
  31. package/yida-skills/skills/yida-design/references/style-designs/registry.md +30 -30
  32. package/yida-skills/skills/yida-design/references/style-designs/soft-analytic-workbench.md +4 -4
  33. package/yida-skills/skills/yida-design/references/style-designs/soft-blue-grid-analytic-dashboard.md +1 -1
  34. package/yida-skills/skills/yida-design/references/style-designs/soft-bordered-analytic-workbench.md +4 -4
  35. package/yida-skills/skills/yida-design/references/style-designs/soft-curated-filter-gallery.md +4 -4
  36. package/yida-skills/skills/yida-design/references/style-designs/soft-modular-analytic-workbench.md +5 -5
  37. package/yida-skills/skills/yida-design/references/style-designs/soft-progress-analytics-workbench.md +4 -4
  38. package/yida-skills/skills/yida-design/references/style-designs/soft-timeline-analytics-workbench.md +8 -8
  39. package/yida-skills/skills/yida-design/references/style-designs/teal-rail-analytics-workbench.md +8 -8
  40. package/yida-skills/skills/yida-design/workflow/output-design.md +25 -19
  41. package/yida-skills/skills/yida-design/workflow/output-prd.md +11 -6
  42. package/yida-skills/skills/yida-design/workflow/step-1-positioning.md +1 -1
  43. package/yida-skills/skills/yida-design/workflow/step-2-theme-system.md +1 -1
  44. package/yida-skills/skills/yida-design/workflow/step-3-information-architecture.md +1 -1
  45. package/yida-skills/skills/yida-design/workflow/step-5-visual-states.md +10 -10
  46. package/yida-skills/skills/yida-design/workflow/step-6-handoff.md +2 -2
  47. package/yida-skills/skills/yida-flash-note-to-prd/SKILL.md +31 -33
  48. package/yida-skills/skills/yida-flash-note-to-prd/references/flash-note-prd-template.md +1 -1
  49. package/yida-skills/skills/yida-form-detail/SKILL.md +7 -7
  50. package/yida-skills/skills/yida-login/SKILL.md +32 -31
  51. package/yida-skills/skills/yida-publish-page/SKILL.md +9 -6
  52. package/yida-skills/references/development-rules.md +0 -85
  53. package/yida-skills/skills/yida-app/references/app-build-contract.md +0 -141
@@ -1,18 +1,18 @@
1
1
  # 生成 design.md 规则
2
2
 
3
- 本文件用于在 Step 5 为完整应用生成一份应用级 `prd/<项目名>/design.md`。生成流程必须先从业务上下文判断内容兼容性,再推演视觉策略,选择唯一一个内置 `style-designs/*.md` 作为基础视觉母体,最后按主题色适配模板并输出自包含的 `design.md`。
3
+ 本文件用于为完整应用提供一份应用级 `prd/<项目名>/design.md` 生成规则。生成 `design.md` 时必须先从业务上下文判断内容兼容性,再推演视觉策略,选择唯一设计风格,最后按主题色适配所选风格并输出自包含的视觉设计契约。
4
4
 
5
- 业务对象、字段、表单、流程、导航、权限和页面结构都从当前 PRD 读取;模板只提供视觉 DNA、布局机制、组件机制、质量锚点和主题换肤规则,不提供业务内容。指标卡、图表、表格、待办、筛选器、右侧栏、状态标签、快捷入口、时间线等常见内容组件只能判断模板是否可承载,不得作为风格模板的强匹配理由。
6
- `style-designs/_design-md-template.md` 是最终结构模板,只约束章节结构、字段完整度和描述粒度;内置 style-design 模板只提供可复用视觉母体。真实项目的配色、业务内容、资源关系、页面结构和实现交接必须从当前 PRD、应用主题和用户要求生成。
5
+ 业务对象、字段、表单、流程、导航、权限和页面结构都从当前 PRD 读取;内置风格只提供视觉 DNA、布局机制、组件机制、质量锚点和主题换肤规则,不提供业务内容。指标卡、图表、表格、待办、筛选器、右侧栏、状态标签、快捷入口、时间线等常见内容组件只能判断风格是否可承载,不得作为设计风格的强匹配理由。
6
+ `style-designs/_design-md-template.md` 是最终结构参考,只约束章节结构、字段完整度和描述粒度;内置 style-design 风格只提供可复用视觉母体。真实项目的配色、业务内容、资源关系、页面结构和实现交接必须从当前 PRD、应用主题和用户要求生成。
7
7
 
8
8
  ## 何时使用
9
9
 
10
10
  | 页面类型 | 动作 |
11
11
  | --- | --- |
12
- | 工作台 / 门户首页 / 首页 | 选择一个工作台类 style-design 模板,生成 workbench 场景配方,把当前业务的视觉 DNA 落到首屏、指标、入口和侧栏 |
13
- | 列表 / 管理页 / 处理台 | 选择能承载筛选、列表、详情抽屉和状态标签的模板,生成 list 场景配方 |
14
- | 看板 / 驾驶舱 / 经营分析 | 选择能承载指标、图表、排行、异常和管理层摘要的模板,生成 dashboard 场景配方 |
15
- | 官网 / 品牌页 / 落地页 | 当前 analytic workbench 模板通常不适合;按当前业务价值路径、素材清单、CTA 和 `assetStrategy` 生成 landing 场景配方 |
12
+ | 工作台 / 门户首页 / 首页 | 选择工作台类设计风格,生成 workbench 场景配方,把当前业务的视觉 DNA 落到首屏、指标、入口和侧栏 |
13
+ | 列表 / 管理页 / 处理台 | 选择能承载筛选、列表、详情抽屉和状态标签的设计风格,生成 list 场景配方 |
14
+ | 看板 / 驾驶舱 / 经营分析 | 选择能承载指标、图表、排行、异常和管理层摘要的设计风格,生成 dashboard 场景配方 |
15
+ | 官网 / 品牌页 / 落地页 | 当前 analytic workbench 风格通常不适合;按当前业务价值路径、素材清单、CTA 和 `assetStrategy` 生成 landing 场景配方 |
16
16
  | 普通表单 / 流程表单 | 沿用应用级 `design.md` 的主题和平台原生表单,不单独选择设计文件 |
17
17
 
18
18
  ## 输入
@@ -35,19 +35,19 @@
35
35
 
36
36
  ## 选择流程
37
37
 
38
- 1. 读取 [style-designs/registry.md](style-designs/registry.md),了解可选模板和选择规则。
38
+ 1. 读取 [style-designs/registry.md](style-designs/registry.md),了解可选设计风格和选择规则。
39
39
  2. 读取 [style-designs/_design-md-template.md](style-designs/_design-md-template.md),用它作为最终 `design.md` 的结构基准。
40
40
  3. 从业务上下文推演 `inferredUserTask`、`contentCompatibility`、`layoutCompatibility`、`visualStyleIntent`、`visualEmphasis` 和 `interactionFocus`。用户通常不会主动描述视觉风格,agent 必须自行推演。
41
- 4. 先用内容组件做兼容性筛选:模板必须能承载当前页面已有内容,但不得因为“有指标卡 / 有图表 / 有表格 / 有右侧栏 / 有时间线”等公共组件直接胜出。
42
- 5. 再用视觉策略选择模板:判断页面需要柔和均衡、重点舞台、趋势洞察、行动指挥、常驻右栏、规整边框、进度叙事、目录浏览还是视觉陈列。
43
- 6. 对 registry 中的模板做硬过滤:纯表单、长文、品牌营销、移动端单任务等页面不选择明显不合适的分析工作台模板。不要因用户未明确说“深色”而过滤 `dark-stage-analytic-dashboard`;它是浅色画布上的局部深色重点舞台,不等于全页面深色沉浸。
44
- 7. 按 `视觉策略 45% + 视觉强调与密度 15% + 布局兼容性 15% + 内容兼容性 15% + 多样性或用户偏好 10%` 选择唯一模板。内容和布局合计不得超过 30%,避免常见工作台内容把结果塌缩到通用模板。
45
- 8. 做内部近邻比较:生成 `design.md` 前必须在工作记忆中比较最相近的 2-4 个模板;选择 `soft-analytic-workbench` 时必须确认其他更强视觉策略证据不足。近邻比较是选择校验,不默认写入最终 `design.md`。
41
+ 4. 先用内容组件做兼容性筛选:设计风格必须能承载当前页面已有内容,但不得因为“有指标卡 / 有图表 / 有表格 / 有右侧栏 / 有时间线”等公共组件直接胜出。
42
+ 5. 再用视觉策略选择风格:判断页面需要柔和均衡、重点舞台、趋势洞察、行动指挥、常驻右栏、规整边框、进度叙事、目录浏览还是视觉陈列。
43
+ 6. 对 registry 中的风格做硬过滤:纯表单、长文、品牌营销、移动端单任务等页面不选择明显不合适的分析工作台风格。不要因用户未明确说“深色”而过滤 `dark-stage-analytic-dashboard`;它是浅色画布上的局部深色重点舞台,不等于全页面深色沉浸。
44
+ 7. 按 `视觉策略 45% + 视觉强调与密度 15% + 布局兼容性 15% + 内容兼容性 15% + 多样性或用户偏好 10%` 选择唯一风格。内容和布局合计不得超过 30%,避免常见工作台内容把结果塌缩到通用风格。
45
+ 8. 做内部近邻比较:生成 `design.md` 前必须在工作记忆中比较最相近的 2-4 个风格;选择 `soft-analytic-workbench` 时必须确认其他更强视觉策略证据不足。近邻比较是选择校验,不默认写入最终 `design.md`。
46
46
  9. 读取被选中的 `style-designs/*.md`,抽取 `visual_dna`、`theme_adaptation`、`layout_stability`、`quality_anchors`、`components` 和 `modules`。
47
- 10. 根据 Step 2 的主题色来源和主题色输入,按模板 `theme_adaptation` 执行换肤:替换 `replace_tokens`,派生 `derive_tokens`,保留 `preserve_tokens` 和 `visual_dna.invariant`。
47
+ 10. 根据 Step 2 的主题色来源和主题色输入,按所选风格的 `theme_adaptation` 执行换肤:替换 `replace_tokens`,派生 `derive_tokens`,保留 `preserve_tokens` 和 `visual_dna.invariant`。
48
48
  11. 读取 [visual-scaffold-recipes.md](visual-scaffold-recipes.md),把当前页面组合映射到统一 `visualScaffold` 规则。
49
49
  12. 读取 [page-quality-gates.md](page-quality-gates.md),把质量门禁补进 `acceptanceChecks`。
50
- 13. 需要判断详略时参考 `_design-md-template.md` 的字段粒度、registry 的输出记录和所选模板的质量锚点;只学习“写到多细”,不复制示例业务、色盘、字段、页面顺序或组件组合。
50
+ 13. 需要判断详略时参考 `_design-md-template.md` 的字段粒度、registry 的输出记录和所选风格的质量锚点;只学习“写到多细”,不复制示例业务、色盘、字段、页面顺序或组件组合。
51
51
  14. 根据行业、品牌、业务情绪、应用主题和用户偏好生成配色。不要固定使用蓝色、绿色、紫色或任何预置色,也不要复用历史样例色盘。
52
52
  15. 写入 `densityRule`、`breathingRule`、`spacing` 和 `rounded` 的具体数值。默认业务工具页使用 high density + 圆润形状 + 有呼吸感的分组节奏:页面边距 20-28px,卡片与卡片 gap 12-18px 且必须小于 20px,卡片 padding 默认 22-28px 且必须大于 20px,卡片圆角范围 0-32px;只有品牌展示、官网或用户明确要求舒展时才降低密度。
53
53
  16. 写入 `surfaceContrast`:页面背景与卡片背景必须形成明显层次对比,不可相近或相同;默认浅色背景保持清爽,但必须按“白色/浅色背景 + 有边框卡片、浅灰背景(如 `#F3F4F6`)+ 白色无边框卡片、浅彩色背景 + 白色无边框卡片、渐变背景 + 玻璃感卡片”四类方案选择。
@@ -56,16 +56,16 @@
56
56
 
57
57
  ## 内容兼容与视觉策略
58
58
 
59
- 公共内容组件只判断模板是否可承载,不决定最终风格。最终模板必须由视觉策略、视觉强调和近邻比较决定。
59
+ 公共内容组件只判断风格是否可承载,不决定最终风格。最终设计风格必须由视觉策略、视觉强调和近邻比较决定。
60
60
 
61
61
  | 常见内容信号 | 只能用于判断 | 不得直接推出 |
62
62
  | --- | --- | --- |
63
63
  | 指标卡 / KPI | 是否需要状态摘要、核心舞台、趋势入口、行动队列入口 | `soft-analytic-workbench` |
64
- | 图表 | 是否需要轻量分布、大趋势图、进度图、纹理化洞察 | dashboard 模板 |
65
- | 表格 / 明细 | 是否需要主工作区、详情沉淀、搜索结果、记录日志 | analytic 模板 |
66
- | 右侧栏 | 是辅助上下文、常驻洞察栏还是行动队列 | rail 模板 |
67
- | 时间线 / 阶段 | 是核心叙事骨架还是普通进度提示 | timeline 模板 |
68
- | 筛选器 / 标签 | 是主导航还是表格辅助条件 | catalog 模板 |
64
+ | 图表 | 是否需要轻量分布、大趋势图、进度图、纹理化洞察 | dashboard 风格 |
65
+ | 表格 / 明细 | 是否需要主工作区、详情沉淀、搜索结果、记录日志 | analytic 风格 |
66
+ | 右侧栏 | 是辅助上下文、常驻洞察栏还是行动队列 | rail 风格 |
67
+ | 时间线 / 阶段 | 是核心叙事骨架还是普通进度提示 | timeline 风格 |
68
+ | 筛选器 / 标签 | 是主导航还是表格辅助条件 | catalog 风格 |
69
69
 
70
70
  | 视觉策略 | 适用判断 |
71
71
  | --- | --- |
@@ -82,7 +82,7 @@
82
82
 
83
83
  ## 主题色应用规则
84
84
 
85
- 主题色是 style-design 模板的换肤输入,不是重新选择视觉风格的理由。生成 `design.md` 时必须先读取所选模板的 `theme_adaptation`,将主题色应用到 `replace_tokens` 和 `derive_tokens`,保持 `preserve_tokens` 与 `visual_dna.invariant` 不变。
85
+ 主题色是所选设计风格的换肤输入,不是重新选择视觉风格的理由。生成 `design.md` 时必须先读取所选风格的 `theme_adaptation`,将主题色应用到 `replace_tokens` 和 `derive_tokens`,保持 `preserve_tokens` 与 `visual_dna.invariant` 不变。
86
86
 
87
87
  硬规则:
88
88
 
@@ -90,25 +90,25 @@
90
90
  2. 换 token,不换结构。
91
91
  3. 换强调色,不改画布、面板、中性色、布局机制。
92
92
  4. 平台导航可见时,页面主按钮、链接、选中态、重点标签和图表主序列默认跟随应用主题 `--color-brand1-*`。
93
- 5. 模板默认色只在没有任何主题证据时作为 `template-default` 兜底,并必须写入 `themeProfile.themeColorSource`。
93
+ 5. 风格默认色只在没有任何主题证据时作为 `template-default` 兜底,并必须写入 `themeProfile.themeColorSource`。
94
94
 
95
95
  ## 主题关系判定
96
96
 
97
97
  | 场景 | 主题关系写法 | 落地规则 |
98
98
  | --- | --- | --- |
99
- | 平台导航 / 应用菜单可见 | `跟随应用主题` | 主按钮、链接、选中态、重点标签、图表主序列使用应用主题;模板色相仅作为辅助色、浅背景、图表第二序列或装饰色 |
100
- | 生成色盘与应用主题不同 | `应用主题主导,生成色彩作为辅助色` | 保留模板视觉 DNA、布局、密度和组件语言,不把页面主色改成与应用主题冲突的色相 |
99
+ | 平台导航 / 应用菜单可见 | `跟随应用主题` | 主按钮、链接、选中态、重点标签、图表主序列使用应用主题;风格色相仅作为辅助色、浅背景、图表第二序列或装饰色 |
100
+ | 生成色盘与应用主题不同 | `应用主题主导,生成色彩作为辅助色` | 保留所选风格的视觉 DNA、布局、密度和组件语言,不把页面主色改成与应用主题冲突的色相 |
101
101
  | 用户要求全局换肤 / 导航也一起变色 | `应用级换肤` | 输出 `themeScope=app`,实现阶段更新应用主题或壳层主题;自定义色盘写 `customThemeStyle.tokens` |
102
102
  | 隐藏平台导航、独立品牌页、活动页、公开落地页 | `页面级独立色盘` | 输出 `themeScope=page` 和独立色盘原因,页面内注入 `style#yida-global-theme` 或 scoped CSS vars |
103
103
 
104
104
  ## 输出字段
105
105
 
106
- Step 5 生成 `design.md`,并让 PRD 的每个自定义展示页只引用它:
106
+ `design.md` 是应用级视觉设计契约,PRD 的每个自定义展示页只引用它:
107
107
 
108
108
  | 字段 | 写入位置 | 写法 |
109
109
  | --- | --- | --- |
110
- | baseDesignSource | design.md | `references/style-designs/<selected-template>.md`;所有模板不适用时才写 `generated-from-business-context` |
111
- | styleDesignSelection | design.md | 只记录模板来源、视觉策略、视觉强调、选中模板、实现约束和置信度;候选比较和拒绝理由默认不写入 |
110
+ | baseDesignSource | design.md | `references/style-designs/<selected-style>.md`;所有内置风格不适用时才写 `generated-from-business-context` |
111
+ | styleDesignSelection | design.md | 只记录风格来源、视觉策略、视觉强调、选中风格、实现约束和置信度;候选比较和排除理由默认不写入 |
112
112
  | themeAdaptationResult | design.md | 记录输入主题色、换肤策略、替换 token、保留 DNA 和保留机制 |
113
113
  | designFile | PRD pageSpecHandoff | `prd/<项目名>/design.md` |
114
114
  | designRefs | PRD pageSpecHandoff | 当前页面引用 design.md 的章节 ID |
@@ -125,7 +125,7 @@ Step 5 生成 `design.md`,并让 PRD 的每个自定义展示页只引用它
125
125
 
126
126
  | design.md 内容 | 实现落点 |
127
127
  | --- | --- |
128
- | styleDesignSelection | 理解视觉母体来源和禁止偏移点;实现阶段不再回读模板目录 |
128
+ | styleDesignSelection | 理解视觉母体来源和禁止偏移点;实现阶段不再回读风格目录 |
129
129
  | themeAdaptationResult | CSS token、按钮、链接、选中态、图表辅助色和运行时主题注入 |
130
130
  | 视觉 DNA | 首屏、指标、列表、图表、侧栏、状态标签 |
131
131
  | 布局配方 | 页面栅格、区域顺序、区块比例 |
@@ -168,7 +168,7 @@ modules:
168
168
 
169
169
  # Aqua Service Progress Dashboard DESIGN.md
170
170
 
171
- > front matter 是给流程和生成器读取的结构化配置;人工评审优先阅读下方正文。若两者冲突,模板选择、换色策略和 token 数值以前面的 YAML 为准,使用边界和业务取舍以正文为准。
171
+ > front matter 是给流程和生成器读取的结构化配置;人工评审优先阅读下方正文。若两者冲突,风格选择、换色策略和 token 数值以前面的 YAML 为准,使用边界和业务取舍以正文为准。
172
172
 
173
173
  ## 1. 快速理解
174
174
 
@@ -178,9 +178,9 @@ modules:
178
178
 
179
179
  适用于服务门户、进度追踪、资源支持、位置上下文、报告概览等页面。不适合纯表格后台、高压交易台、密集筛选页面或暗色大屏。禁止复制视觉材料中的具体行业、人员、项目、指标名、数值、位置名和服务文案。
180
180
 
181
- ## 3. 模板选择与换色逻辑
181
+ ## 3. 设计风格选择与换色逻辑
182
182
 
183
- 当 PRD 有“状态摘要 + 时间节点 + 进度评分 + 资源入口 + 上下文地图或媒体”的结构时选择该模板。主题色只改写徽章、时间轴、渐变卡、进度条和图表填充;白色面板、浅背景、低饱和边界、大圆角和透明叠层保持。
183
+ 当 PRD 有“状态摘要 + 时间节点 + 进度评分 + 资源入口 + 上下文地图或媒体”的结构时选择该风格。主题色只改写徽章、时间轴、渐变卡、进度条和图表填充;白色面板、浅背景、低饱和边界、大圆角和透明叠层保持。
184
184
 
185
185
  ## 4. 视觉 DNA
186
186
 
@@ -170,7 +170,7 @@ modules:
170
170
 
171
171
  # Blue Insight Operations Dashboard DESIGN.md
172
172
 
173
- > front matter 是给流程和生成器读取的结构化配置;人工评审优先阅读下方正文。若两者冲突,模板选择、换色策略和 token 数值以前面的 YAML 为准,使用边界和业务取舍以正文为准。
173
+ > front matter 是给流程和生成器读取的结构化配置;人工评审优先阅读下方正文。若两者冲突,风格选择、换色策略和 token 数值以前面的 YAML 为准,使用边界和业务取舍以正文为准。
174
174
 
175
175
  ## 1. 快速理解
176
176
 
@@ -180,9 +180,9 @@ modules:
180
180
 
181
181
  适用于运营概览、管理看板、团队状态、活动追踪和指标分析。不适合单一表单、强媒体页面、暗色大屏或低信息门户。禁止复制任何视觉材料中的业务标题、人名、职位、项目、日期、金额、百分比和洞察文案。
182
182
 
183
- ## 3. 模板选择与换色逻辑
183
+ ## 3. 设计风格选择与换色逻辑
184
184
 
185
- 当 PRD 有多个 KPI、一个主趋势、若干洞察提醒、活动记录和进度列表时选择该模板。主题色只替换主图表、火花线、链接、focus ring 和部分图标底;背景、卡片、表格分隔线、低饱和洞察卡结构保持。
185
+ 当 PRD 有多个 KPI、一个主趋势、若干洞察提醒、活动记录和进度列表时选择该风格。主题色只替换主图表、火花线、链接、focus ring 和部分图标底;背景、卡片、表格分隔线、低饱和洞察卡结构保持。
186
186
 
187
187
  ## 4. 视觉 DNA
188
188
 
@@ -168,7 +168,7 @@ modules:
168
168
 
169
169
  # Blue Productivity Insight Workbench DESIGN.md
170
170
 
171
- > front matter 是给流程和生成器读取的结构化配置;人工评审优先阅读下方正文。若两者冲突,模板选择、换色策略和 token 数值以前面的 YAML 为准,使用边界和业务取舍以正文为准。
171
+ > front matter 是给流程和生成器读取的结构化配置;人工评审优先阅读下方正文。若两者冲突,风格选择、换色策略和 token 数值以前面的 YAML 为准,使用边界和业务取舍以正文为准。
172
172
 
173
173
  ## 1. 快速理解
174
174
 
@@ -178,9 +178,9 @@ modules:
178
178
 
179
179
  适合任务中心、周期分析、行动跟进、团队或项目概览等中高密工作台。不适合营销页、图片页面、沉浸大屏、纯表单。不得复制视觉材料中的个人名、专属活动名、工具品牌、具体日期、时间、数量或文案。没有行动队列时,不要强行渲染右侧栏。
180
180
 
181
- ## 3. 模板选择与换色逻辑
181
+ ## 3. 设计风格选择与换色逻辑
182
182
 
183
- 当 PRD 同时包含核心指标、周期图表、右侧焦点卡和记录列表时选择该模板。主题色替换 `brand`、图表柱、按钮和 focus ring;背景、白色面板、浅灰边框、表格分隔线和右栏堆叠结构保持。
183
+ 当 PRD 同时包含核心指标、周期图表、右侧焦点卡和记录列表时选择该风格。主题色替换 `brand`、图表柱、按钮和 focus ring;背景、白色面板、浅灰边框、表格分隔线和右栏堆叠结构保持。
184
184
 
185
185
  ## 4. 视觉 DNA
186
186
 
@@ -193,7 +193,7 @@ modules:
193
193
 
194
194
  # Command Filter Card Console DESIGN.md
195
195
 
196
- > front matter 是给流程和生成器读取的结构化配置;人工评审优先阅读下方正文。若两者冲突,模板选择、换色策略和 token 数值以前面的 YAML 为准,使用边界和业务取舍以正文为准。
196
+ > front matter 是给流程和生成器读取的结构化配置;人工评审优先阅读下方正文。若两者冲突,风格选择、换色策略和 token 数值以前面的 YAML 为准,使用边界和业务取舍以正文为准。
197
197
 
198
198
  ## 1. 快速理解
199
199
 
@@ -201,13 +201,13 @@ modules:
201
201
 
202
202
  ## 2. 使用边界
203
203
 
204
- 适合管理型对象目录、资源库、状态筛选列表、可搜索集合和分页浏览控制台。若页面需要强图片陈列、品牌叙事、复杂图表或单一步骤表单,不应选择该模板。
204
+ 适合管理型对象目录、资源库、状态筛选列表、可搜索集合和分页浏览控制台。若页面需要强图片陈列、品牌叙事、复杂图表或单一步骤表单,不应选择该风格。
205
205
 
206
206
  不要为了套用视觉槽位创造 PRD 没有的状态切换、筛选分组、新建命令、更多菜单或分页。具体字段、对象名称、状态名称、数值和操作必须来自 PRD。
207
207
 
208
- ## 3. 模板选择与换色逻辑
208
+ ## 3. 设计风格选择与换色逻辑
209
209
 
210
- 当任务重心是“管理一批对象并快速定位/操作”时选择该模板。它比柔和画廊更偏控制台,强调顶部命令、左侧筛选、卡片操作和分页闭环。
210
+ 当任务重心是“管理一批对象并快速定位/操作”时选择该风格。它比柔和画廊更偏控制台,强调顶部命令、左侧筛选、卡片操作和分页闭环。
211
211
 
212
212
  主题色只作用于复选框、范围滑块、色点选中环、微状态点和 focus ring。主命令按钮可以保持深色高对比,也可以在 PRD 或主题策略要求时映射为主题色,但不能把整个工具条染色。
213
213
 
@@ -172,7 +172,7 @@ modules:
172
172
 
173
173
  # Contrast Command Analytics Workbench DESIGN.md
174
174
 
175
- > front matter 是给流程和生成器读取的结构化配置;人工评审优先阅读下方正文。若两者冲突,模板选择、换色策略和 token 数值以前面的 YAML 为准,使用边界和业务取舍以正文为准。
175
+ > front matter 是给流程和生成器读取的结构化配置;人工评审优先阅读下方正文。若两者冲突,风格选择、换色策略和 token 数值以前面的 YAML 为准,使用边界和业务取舍以正文为准。
176
176
 
177
177
  ## 1. 快速理解
178
178
 
@@ -180,13 +180,13 @@ modules:
180
180
 
181
181
  ## 2. 使用边界
182
182
 
183
- 适用于运营首页、资源管理工作台、事件处理台、协同看板和带搜索明细的管理页面。若 PRD 同时包含概览指标、列表队列、快捷命令或推荐操作、明细记录,该模板匹配度较高。
183
+ 适用于运营首页、资源管理工作台、事件处理台、协同看板和带搜索明细的管理页面。若 PRD 同时包含概览指标、列表队列、快捷命令或推荐操作、明细记录,该风格匹配度较高。
184
184
 
185
185
  不适合纯表单、单一表格、品牌落地页和需要暗色大屏的场景。禁止复制任何视觉材料中的具体人名、行业名、记录名、金额、日期、地址、状态文案或页面标题。没有命令输入需求时,不要强行创建命令面板,可用同等质感的深色洞察或快捷操作区替代。
186
186
 
187
- ## 3. 模板选择与换色逻辑
187
+ ## 3. 设计风格选择与换色逻辑
188
188
 
189
- 选择该模板时优先看信息拓扑:顶部身份与全局操作、左上表现分析、右上事件流、下方命令面板和明细表。如果 PRD 只有图表或只有表格,不应硬套完整结构。
189
+ 选择该风格时优先看信息拓扑:顶部身份与全局操作、左上表现分析、右上事件流、下方命令面板和明细表。如果 PRD 只有图表或只有表格,不应硬套完整结构。
190
190
 
191
191
  主题色只替换分段图表、图例点、快捷命令图标、focus ring、正向状态和少量标签。页面背景、白色面板、黑色命令区、中性文字、浅边框、圆角和阴影保持不变。不要把主题色铺满所有卡片。
192
192
 
@@ -4,7 +4,7 @@ template_type: visual_dna_preset
4
4
  name: dark-stage-analytic-dashboard
5
5
  design_id: dark-stage-analytic-dashboard
6
6
  design_status: draft
7
- description: 可被流程选择和换色的深色指标舞台型分析仪表盘视觉 DNA 模板。
7
+ description: 可被流程选择和换色的深色指标舞台型分析仪表盘视觉 DNA 风格。
8
8
  scenes: [仪表盘, 数据工作台, 管理后台首页, 分析看板]
9
9
  density: medium-high
10
10
  layout: hero_metric_stage_with_analysis_grid
@@ -211,7 +211,7 @@ modules:
211
211
 
212
212
  # Dark Stage Analytic Dashboard DESIGN.md
213
213
 
214
- > front matter 是给流程和生成器读取的结构化配置;人工评审优先阅读下方正文。若两者冲突,模板选择、换色策略和 token 数值以前面的 YAML 为准,使用边界和业务取舍以正文为准。
214
+ > front matter 是给流程和生成器读取的结构化配置;人工评审优先阅读下方正文。若两者冲突,风格选择、换色策略和 token 数值以前面的 YAML 为准,使用边界和业务取舍以正文为准。
215
215
 
216
216
  ## 1. 快速理解
217
217
 
@@ -231,13 +231,13 @@ PRD 是内容来源。页面标题、指标含义、筛选项、图表维度、
231
231
 
232
232
  DESIGN.md 不决定业务信息架构,不强制页面必须有指标、热力图、对比图或表格。它只在 PRD 存在对应内容时,规定这些内容如何落到高品质 UI 中。
233
233
 
234
- 禁止复用模板来源中的具体业务字段、示例数据、分类名称、人名、机构名和页面专属文案。需要样例时只能使用中性槽位名,例如 `primary_metrics`、`primary_content_panel`、`supporting_panel`、`detail_table`。
234
+ 禁止复用风格来源中的具体业务字段、示例数据、分类名称、人名、机构名和页面专属文案。需要样例时只能使用中性槽位名,例如 `primary_metrics`、`primary_content_panel`、`supporting_panel`、`detail_table`。
235
235
 
236
236
  如果 PRD 没有量化数据,不要硬造数字;如果没有明细数据,不要硬造表格;如果没有全局操作,不要为了视觉完整而补按钮。
237
237
 
238
- ## 3. 模板选择与换色逻辑
238
+ ## 3. 设计风格选择与换色逻辑
239
239
 
240
- 上游流程可在用户需要“数据总览 + 图表分析 + 明细追踪”的页面时选择本模板。它尤其适合首屏需要形成强焦点、同时下方仍要保持高密度扫描效率的产品界面。
240
+ 上游流程可在用户需要“数据总览 + 图表分析 + 明细追踪”的页面时选择本风格。它尤其适合首屏需要形成强焦点、同时下方仍要保持高密度扫描效率的产品界面。
241
241
 
242
242
  不要把默认强调色理解成固定风格。这个视觉母体的关键是深浅反差、圆角尺度、玻璃卡、数据纹理和小面积强调,而不是某一种具体色相。
243
243
 
@@ -279,9 +279,9 @@ PRD 决定列和行操作。长文本必须截断或折叠,不能撑高整行
279
279
 
280
280
  ## 5. 视觉品质基线
281
281
 
282
- 本模板的品质下限不是“有卡片、有图表、有表格”,而是每个模块都带有清晰的微观设计信号。
282
+ 本风格的品质下限不是“有卡片、有图表、有表格”,而是每个模块都带有清晰的微观设计信号。
283
283
 
284
- - PRD 包含多个核心摘要时,必须优先落地深色全宽指标舞台。没有这个舞台,模板识别度会明显下降。
284
+ - PRD 包含多个核心摘要时,必须优先落地深色全宽指标舞台。没有这个舞台,风格识别度会明显下降。
285
285
  - PRD 包含 3 个以上摘要项时,指标卡应使用玻璃态卡组:等高、等宽、图标容器、细边框、数值强层级。
286
286
  - PRD 包含时间、频率、分布或密度数据时,优先使用浅色热力网格面板。若数据不适合热力图,可改成同等精度的轻网格趋势图或分布图。
287
287
  - PRD 包含比例、目标、构成或分组对比时,优先使用纹理化对比图面板。斜纹、悬浮标签和圆角条是品质信号,不要退化为裸柱状图。
@@ -366,4 +366,4 @@ PRD 决定列和行操作。长文本必须截断或折叠,不能撑高整行
366
366
  - [ ] hover、focus、selected、loading、empty、error、disabled 状态完整。
367
367
  - [ ] 移动端没有文本、按钮、tooltip、图表和表格互相遮挡。
368
368
  - [ ] 主题色只替换强调色、图表阶梯、状态辅助色和 focus ring。
369
- - [ ] 最终 UI 没有默认后台模板感,具备可见的精致微细节。
369
+ - [ ] 最终 UI 没有默认后台感,具备可见的精致微细节。
@@ -227,7 +227,7 @@ modules:
227
227
 
228
228
  # Filterable Card Catalog DESIGN.md
229
229
 
230
- > front matter 是给流程和生成器读取的结构化配置;人工评审优先阅读下方正文。若两者冲突,模板选择、换色策略和 token 数值以前面的 YAML 为准,使用边界和业务取舍以正文为准。
230
+ > front matter 是给流程和生成器读取的结构化配置;人工评审优先阅读下方正文。若两者冲突,风格选择、换色策略和 token 数值以前面的 YAML 为准,使用边界和业务取舍以正文为准。
231
231
 
232
232
  ## 1. 快速理解
233
233
 
@@ -239,15 +239,15 @@ PRD 决定内容、功能、信息架构、业务优先级和模块是否存在
239
239
 
240
240
  DESIGN.md 约束的是视觉 DNA:并列式页面骨架、筛选控件层级、结果工具条、胶囊条件、卡片网格、媒体框比例、信息密度、强调色使用边界、响应式折叠和可访问性。
241
241
 
242
- 禁止复制任何模板材料中的具体字段、示例数据、品牌词、对象名称、分类名称或页面专属文案。所有标题、字段、数值和操作名称都必须来自 PRD。
242
+ 禁止复制任何风格材料中的具体字段、示例数据、品牌词、对象名称、分类名称或页面专属文案。所有标题、字段、数值和操作名称都必须来自 PRD。
243
243
 
244
- ## 3. 模板选择与换色逻辑
244
+ ## 3. 设计风格选择与换色逻辑
245
245
 
246
- 当页面主要任务是“筛选一组候选对象并浏览比较”,且内容可以被拆成重复卡片时,优先选择该模板。典型信息拓扑是:左侧筛选条件、顶部结果摘要与排序控制、已选条件胶囊、主内容卡片网格、卡片内主值与辅助信息、卡片级快捷操作。
246
+ 当页面主要任务是“筛选一组候选对象并浏览比较”,且内容可以被拆成重复卡片时,优先选择该风格。典型信息拓扑是:左侧筛选条件、顶部结果摘要与排序控制、已选条件胶囊、主内容卡片网格、卡片内主值与辅助信息、卡片级快捷操作。
247
247
 
248
248
  默认强调色只代表“可操作、已选中、关键动作”的视觉层级,不是 DNA 本身。主题色输入后,只改写 `brand`、`brand-soft`、`focus-ring`、滑块活动轨道、按钮 hover/pressed 和少量状态辅助色。页面背景、卡片底、媒体框、浅边框、中性文字、卡片圆角、等高网格和侧栏结构必须保持不变。
249
249
 
250
- 不要把主题色铺满页面背景、筛选栏底色、卡片底色或媒体框。该模板的品质来自大量中性留白与小面积高饱和强调之间的对比。
250
+ 不要把主题色铺满页面背景、筛选栏底色、卡片底色或媒体框。该风格的品质来自大量中性留白与小面积高饱和强调之间的对比。
251
251
 
252
252
  ## 4. 视觉 DNA
253
253
 
@@ -176,7 +176,7 @@ modules:
176
176
 
177
177
  # Green Timeline Progress Workbench DESIGN.md
178
178
 
179
- > front matter 是给流程和生成器读取的结构化配置;人工评审优先阅读下方正文。若两者冲突,模板选择、换色策略和 token 数值以前面的 YAML 为准,使用边界和业务取舍以正文为准。
179
+ > front matter 是给流程和生成器读取的结构化配置;人工评审优先阅读下方正文。若两者冲突,风格选择、换色策略和 token 数值以前面的 YAML 为准,使用边界和业务取舍以正文为准。
180
180
 
181
181
  ## 1. 快速理解
182
182
 
@@ -186,9 +186,9 @@ modules:
186
186
 
187
187
  适合进度追踪、阶段管理、周期任务、运营概览和记录管理。不适合没有时间或阶段语义的普通后台、纯表单、媒体页或暗色大屏。禁止复制视觉材料中的具体业务词、记录名、日期、数值、路线、对象名和表格字段。
188
188
 
189
- ## 3. 模板选择与换色逻辑
189
+ ## 3. 设计风格选择与换色逻辑
190
190
 
191
- 当 PRD 包含主进度、多个辅助指标、节点或日程、趋势分析和明细记录时选择该模板。主题色替换摘要卡、选中节点、主折线和状态点;背景、白色卡片、浅灰表头、中性文字和圆角机制保持。
191
+ 当 PRD 包含主进度、多个辅助指标、节点或日程、趋势分析和明细记录时选择该风格。主题色替换摘要卡、选中节点、主折线和状态点;背景、白色卡片、浅灰表头、中性文字和圆角机制保持。
192
192
 
193
193
  ## 4. 视觉 DNA
194
194
 
@@ -1,8 +1,8 @@
1
- # style-design 内置模板注册表
1
+ # style-design 风格注册表
2
2
 
3
- 本目录提供 `yida-design` Step 5 生成 `prd/<项目名>/design.md` 时可选择的内置视觉 DNA 模板。生成 `design.md` 时必须先判断内容兼容性,再根据视觉策略选择唯一一个 `style-designs/*.md` 作为基础视觉母体,最后结合主题色和当前 PRD 生成最终自包含的 `design.md`。
3
+ 本目录为完整应用的 `prd/<项目名>/design.md` 提供内置设计风格注册表。生成 `design.md` 时必须先判断内容兼容性,再根据视觉策略选择唯一风格,并把对应 `style-designs/*.md` 记录为 `baseDesignSource`,最后结合主题色和当前 PRD 生成最终自包含的视觉设计契约。
4
4
 
5
- `_design-md-template.md` 仍是结构模板;它不参与视觉风格选择。实现阶段只读取当前项目的 `prd.md` 和 `design.md`,不回读本目录。
5
+ `_design-md-template.md` 仍是结构参考文件;它不参与视觉风格选择。实现阶段只读取当前项目的 `prd.md` 和 `design.md`,不回读本目录。
6
6
 
7
7
  默认审美方向是“圆润、高密且有呼吸感”:卡片 padding 默认 22-28px 且必须大于 20px,卡片与卡片的 gap 默认 12-18px 且必须小于 20px,卡片圆角范围 0-32px,控件使用 10-14px 圆角,状态摘要、动作条、列表行和空态保持紧凑;页面主区、右栏、工具条和列表之间要有稳定分组节奏。呼吸感不是大留白;不得用额外 margin、超高空态或超宽空状态框撑出页面面积。
8
8
 
@@ -12,45 +12,45 @@
12
12
  | --- | --- | --- | --- |
13
13
  | `_design-md-template.md` | structure-template | `design.md` 完整结构和字段完整度参考 | 必读;最终产物章节和字段完整度必须对齐它 |
14
14
 
15
- ## 可选 style-design 模板
15
+ ## 可选设计风格
16
16
 
17
- | 模板 | 视觉策略 | 可承载内容 | 强选择触发 | 近邻边界 |
17
+ | 风格文件 | 视觉策略 | 可承载内容 | 强选择触发 | 近邻边界 |
18
18
  | --- | --- | --- | --- | --- |
19
- | `soft-analytic-workbench.md` | `soft_neutral` 均衡办公 | 指标、轻图表、右侧辅助列表、明细表、普通入口 | 用户明确需要低噪声、均衡、朴素办公感;所有模块视觉优先级接近 | 通用兜底,有泛化惩罚;若需要重点舞台、趋势洞察、行动队列、常驻右栏或规整边框,应输给对应模板 |
19
+ | `soft-analytic-workbench.md` | `soft_neutral` 均衡办公 | 指标、轻图表、右侧辅助列表、明细表、普通入口 | 用户明确需要低噪声、均衡、朴素办公感;所有模块视觉优先级接近 | 通用兜底,有泛化惩罚;若需要重点舞台、趋势洞察、行动队列、常驻右栏或规整边框,应输给对应风格 |
20
20
  | `soft-bordered-analytic-workbench.md` | `bordered_enterprise` 规整控制台 | 命令栏、深色摘要区、图表洞察、分区明细 | 页面需要边界清晰、系统化、控制台感,搜索筛选和全局命令是稳定入口 | 若只是均衡办公输给 `soft-analytic`;若深色舞台是主记忆点输给 `dark-stage` |
21
21
  | `soft-modular-analytic-workbench.md` | `bordered_enterprise` 模块化复杂工作台 | 多模块、多指标、趋势、洞察卡、明细表 | 页面模块很多,需要规整网格和混合尺度承载,不希望单一大舞台主导 | 若模块少且均衡输给 `soft-analytic`;若趋势图是主视觉输给 `blue-insight` |
22
- | `soft-progress-analytics-workbench.md` | `progress_narrative` 进度分析 | 优先级指标、周期节点、趋势、明细表 | 阶段、周期、进度是核心体验,但整体仍偏分析工作台 | 若没有阶段推进语义输给非进度模板;若服务资源和媒体上下文更强输给 `aqua-service` |
23
- | `soft-timeline-analytics-workbench.md` | `progress_narrative` 时间轴工作台 | 指标栈、时间轴、趋势、明细表 | 时间轴本身是页面骨架,用户需要按阶段/里程碑阅读 | 若时间轴只是辅助提示输给 `soft-progress` 或非进度模板 |
22
+ | `soft-progress-analytics-workbench.md` | `progress_narrative` 进度分析 | 优先级指标、周期节点、趋势、明细表 | 阶段、周期、进度是核心体验,但整体仍偏分析工作台 | 若没有阶段推进语义输给非进度风格;若服务资源和媒体上下文更强输给 `aqua-service` |
23
+ | `soft-timeline-analytics-workbench.md` | `progress_narrative` 时间轴工作台 | 指标栈、时间轴、趋势、明细表 | 时间轴本身是页面骨架,用户需要按阶段/里程碑阅读 | 若时间轴只是辅助提示输给 `soft-progress` 或非进度风格 |
24
24
  | `teal-rail-analytics-workbench.md` | `teal_fresh_rail` 常驻洞察右栏 | 左侧主工作区、右侧洞察栏、标签筛选、明细表 | 右侧洞察栏是持续结构,用于提醒、排名、状态、上下文,而非普通补充列表 | 若右栏只是辅助列表输给 `soft-analytic`;若行动队列更强输给 `blue-productivity` |
25
25
  | `dark-stage-analytic-dashboard.md` | `dark_accent_stage` 局部深色重点舞台 | 指标、图表、表格、待办、右侧上下文 | 浅色页面中需要一个强记忆点,突出核心判断、风险、目标完成度或经营结果 | 不要求用户明确说深色;若只是全模块均衡扫描输给 `soft-analytic`,若命令处理更强输给 `contrast-command` |
26
26
  | `contrast-command-analytics-workbench.md` | `action_command` 高对比指挥 | 大标题、表现图、事件流、深色命令面板、媒体化明细 | 页面需要指挥感、推荐处理、助手面板、日程协同或高能量主操作 | 若只是待办列表输给 `blue-productivity`;若只是核心指标舞台输给 `dark-stage` |
27
27
  | `blue-productivity-insight-workbench.md` | `action_command` 生产力行动队列 | 指标、柱状图、右侧行动栏、记录表 | 指标之后立刻驱动今日处理、待办、跟进、确认、分派等动作 | 若主图表洞察更强输给 `blue-insight`;若右栏是洞察而非行动输给 `teal-rail` |
28
- | `aqua-service-progress-dashboard.md` | `progress_narrative` 服务进度 | 状态头、时间轴、进度评分、渐变状态卡、媒体/上下文卡 | 服务、资源、场地、设备、交付进度或上下文媒体共同构成体验 | 若是密集后台或纯表格处理输给工作台模板;若只是阶段管理输给 timeline/progress 模板 |
28
+ | `aqua-service-progress-dashboard.md` | `progress_narrative` 服务进度 | 状态头、时间轴、进度评分、渐变状态卡、媒体/上下文卡 | 服务、资源、场地、设备、交付进度或上下文媒体共同构成体验 | 若是密集后台或纯表格处理输给工作台风格;若只是阶段管理输给 timeline/progress 风格 |
29
29
  | `blue-insight-operations-dashboard.md` | `blue_insight` 趋势洞察 | 火花线指标、主趋势图、洞察卡、活动表、进度列表 | 主要记忆点是趋势、分析、经营洞察,图表不只是轻量状态分布 | 若数据不足以支撑趋势图输给 `soft-analytic`;若行动队列更强输给 `blue-productivity` |
30
- | `green-timeline-progress-workbench.md` | `progress_narrative` 清爽阶段推进 | 主摘要指标栈、浮动日期时间轴、趋势图、全宽表格 | 阶段推进明确,同时希望气质更清爽、轻运营、低压 | 若没有时间/阶段语义输给非进度模板;若需要更中性时间轴输给 `soft-timeline` |
31
- | `filterable-card-catalog.md` | `catalog_browse` 高密筛选目录 | 左筛选栏、结果工具条、条件胶囊、等高卡片矩阵 | 主体验是搜索、筛选、比较、选择对象;卡片比表格更适合承载结果 | 若只是工作台里的辅助筛选输给 analytic 模板;若需要大图陈列输给 `soft-curated-filter-gallery` |
30
+ | `green-timeline-progress-workbench.md` | `progress_narrative` 清爽阶段推进 | 主摘要指标栈、浮动日期时间轴、趋势图、全宽表格 | 阶段推进明确,同时希望气质更清爽、轻运营、低压 | 若没有时间/阶段语义输给非进度风格;若需要更中性时间轴输给 `soft-timeline` |
31
+ | `filterable-card-catalog.md` | `catalog_browse` 高密筛选目录 | 左筛选栏、结果工具条、条件胶囊、等高卡片矩阵 | 主体验是搜索、筛选、比较、选择对象;卡片比表格更适合承载结果 | 若只是工作台里的辅助筛选输给 analytic 风格;若需要大图陈列输给 `soft-curated-filter-gallery` |
32
32
  | `soft-curated-filter-gallery.md` | `catalog_browse` 视觉精选画廊 | 大标题、分类切换、柔和筛选、大图卡片、收藏/徽标 | 主体验是视觉浏览、候选挑选、精选展示,图片或视觉对象重要 | 若需要高密管理和批量操作输给 `command-filter-card-console` 或 `filterable-card-catalog` |
33
33
  | `command-filter-card-console.md` | `catalog_browse` 管理型卡片控制台 | 边框筛选、状态标签、紧凑管理卡片、分页 | 主体验是对象管理、状态筛选、批量查看,卡片是管理单元而非展示物 | 若偏视觉陈列输给 `soft-curated-filter-gallery`;若偏普通结果浏览输给 `filterable-card-catalog` |
34
34
 
35
35
  ## 消费硬规则
36
36
 
37
37
  1. 先读取 `_design-md-template.md`,按当前业务生成新的 `prd/<项目名>/design.md`。
38
- 2. 每次优先选择唯一一个 `style-designs/*.md` 作为 `baseDesignSource`;若所有模板都不适合,才写 `generated-from-business-context`,并记录拒绝原因。
39
- 3. 配色由模型根据行业、品牌、应用主题、业务情绪和用户偏好生成;主题色只换 token 和强调色,不改变模板 DNA、布局机制和组件机制。
38
+ 2. 每次优先选择唯一设计风格,并把对应 `style-designs/*.md` 写入 `baseDesignSource`;若所有内置风格都不适合,才写 `generated-from-business-context`,并记录排除原因。
39
+ 3. 配色由模型根据行业、品牌、应用主题、业务情绪和用户偏好生成;主题色只换 token 和强调色,不改变风格 DNA、布局机制和组件机制。
40
40
  4. 圆角、间距、密度和呼吸感必须由当前业务决定,但卡片数值要明确:卡片 padding >20px、卡片间 gap <20px、卡片圆角 0-32px、控件 10-14px、状态摘要 64-88px、列表行 44-56px、空态 88-120px 内。
41
41
  5. `design_id` 使用当前项目生成的 slug,例如 `<业务域>-<体验关键词>-generated`。
42
42
  6. 每个自定义页面最终只读取当前项目 `prd.md` 和 `design.md`;实现阶段不回读本目录。
43
43
 
44
44
  ## 选择原则
45
45
 
46
- 1. 先从业务需求判断内容兼容性,再推演视觉策略、视觉强调、密度气质和交互重心;不要按行业、主题色或公共内容组件直接选模板。
47
- 2. 主题色只作为所选模板的 `theme_adaptation` 输入,用于替换强调色 token;主题色不是选择模板的主要依据。
48
- 3. 指标卡、图表、表格、待办、筛选器、右侧栏、状态标签、快捷入口、时间线等公共组件只用于判断 `contentCompatibility`,不得作为模板强匹配理由。
49
- 4. 每次必须选择唯一一个 `style-designs/*.md` 作为 `baseDesignSource`。若所有模板都不适合,仍读取 `_design-md-template.md` 输出 `baseDesignSource=generated-from-business-context`,并在 `styleDesignSelection.rejectedStyleDesigns` 说明原因。
50
- 5. 不得为了套模板凭空创造 PRD 未要求的图表、右侧栏、时间轴、深色舞台或快捷入口;模板只能决定已有业务内容的视觉承载方式。
46
+ 1. 先从业务需求判断内容兼容性,再推演视觉策略、视觉强调、密度气质和交互重心;不要按行业、主题色或公共内容组件直接选风格。
47
+ 2. 主题色只作为所选风格的 `theme_adaptation` 输入,用于替换强调色 token;主题色不是选择风格的主要依据。
48
+ 3. 指标卡、图表、表格、待办、筛选器、右侧栏、状态标签、快捷入口、时间线等公共组件只用于判断 `contentCompatibility`,不得作为风格强匹配理由。
49
+ 4. 每次必须选择唯一设计风格,并把对应 `style-designs/*.md` 写入 `baseDesignSource`。若所有内置风格都不适合,仍读取 `_design-md-template.md` 输出 `baseDesignSource=generated-from-business-context`,并在 `styleDesignSelection.rejectedStyleDesigns` 说明原因。
50
+ 5. 不得为了套风格凭空创造 PRD 未要求的图表、右侧栏、时间轴、深色舞台或快捷入口;风格只能决定已有业务内容的视觉承载方式。
51
51
  6. `dark-stage-analytic-dashboard` 是局部深色重点舞台,不是全页面深色沉浸。不得仅以“用户未要求深色”为理由拒绝它;只能在页面不需要强视觉焦点时拒绝。
52
52
  7. `soft-analytic-workbench` 是 `soft_neutral` 均衡办公风格,不是所有工作台的默认答案。选择它时必须在内部选择草稿中确认其他更强视觉策略证据不足。
53
- 8. 最终 `design.md` 必须自包含:包含模板来源、选择依据、主题换肤结果、视觉 DNA、token、组件、状态、响应式、可访问性和实现契约。
53
+ 8. 最终 `design.md` 必须自包含:包含风格来源、选择依据、主题换肤结果、视觉 DNA、token、组件、状态、响应式、可访问性和实现契约。
54
54
 
55
55
  ## 选择评分建议
56
56
 
@@ -58,24 +58,24 @@
58
58
  | --- | --- | --- |
59
59
  | 视觉策略匹配 | 45% | 页面需要 `soft_neutral`、`dark_accent_stage`、`blue_insight`、`bordered_enterprise`、`teal_fresh_rail`、`action_command`、`progress_narrative` 还是 `catalog_browse` |
60
60
  | 视觉强调与密度 | 15% | 首屏是均衡扫描、核心舞台、趋势洞察、行动队列、常驻右栏、阶段推进还是目录筛选;密度是高密、规整、舒展还是展示型 |
61
- | 布局兼容性 | 15% | 当前页面是否能稳定承载该模板的舞台、右栏、命令栏、进度骨架、目录网格或趋势面板 |
62
- | 内容兼容性 | 15% | 模板是否支持当前已有指标、图表、表格、待办、筛选、右栏、时间线、卡片和媒体内容 |
61
+ | 布局兼容性 | 15% | 当前页面是否能稳定承载该风格的舞台、右栏、命令栏、进度骨架、目录网格或趋势面板 |
62
+ | 内容兼容性 | 15% | 风格是否支持当前已有指标、图表、表格、待办、筛选、右栏、时间线、卡片和媒体内容 |
63
63
  | 多样性或用户偏好 | 10% | 用户语气、品牌气质、应用主题和候选分差接近时,避免所有工作台都落到 `soft-analytic-workbench` |
64
64
  | 风险扣分 | -5% | 是否会强行制造不存在的模块、过度依赖图表、右侧栏、时间轴、深色舞台或图片素材 |
65
65
 
66
- 内容兼容性和布局兼容性合计不得超过 30%。如果多个模板都能承载相同内容,必须让视觉策略、视觉强调和近邻边界决定最终选择。
66
+ 内容兼容性和布局兼容性合计不得超过 30%。如果多个风格都能承载相同内容,必须让视觉策略、视觉强调和近邻边界决定最终选择。
67
67
 
68
68
  ## 输出记录
69
69
 
70
- 生成 `design.md` 前必须先形成内部选择草稿,用来防止公共组件误导模板选择。内部选择草稿不写入最终 `design.md`,除非用户要求调试或评估选择过程。
70
+ 生成 `design.md` 前必须先形成内部选择草稿,用来防止公共组件误导风格选择。内部选择草稿不写入最终 `design.md`,除非用户要求调试或评估选择过程。
71
71
 
72
72
  ```yaml
73
73
  selectionScratchpad:
74
74
  topCandidates:
75
- - name: <template-name>
75
+ - name: <style-name>
76
76
  evidence: <短句或枚举,不写长解释>
77
77
  rejectedCloseNeighbors:
78
- - name: <template-name>
78
+ - name: <style-name>
79
79
  evidence: <短句或枚举>
80
80
  softAnalyticCheck:
81
81
  strongerVisualStrategyExists: <true / false>
@@ -85,7 +85,7 @@ selectionScratchpad:
85
85
  最终 `design.md` 只记录可交接给实现阶段的精简选择摘要:
86
86
 
87
87
  ```yaml
88
- baseDesignSource: references/style-designs/<selected-template>.md
88
+ baseDesignSource: references/style-designs/<selected-style>.md
89
89
  styleDesignSelection:
90
90
  inferredUserTask: <判断 / 处理 / 追踪 / 分析 / 展示 / 汇报>
91
91
  contentCompatibility:
@@ -97,21 +97,21 @@ styleDesignSelection:
97
97
  requiredVisualDNA:
98
98
  - <dna-id>
99
99
  selectedStyleDesign:
100
- name: <template-name>
101
- source: references/style-designs/<template>.md
100
+ name: <style-name>
101
+ source: references/style-designs/<style>.md
102
102
  implementationConstraints:
103
103
  - <必须保留的视觉约束,例如局部深色舞台 / 常驻右栏 / 行动队列 / 大趋势面板>
104
104
  selectionNotes: <可选,一句话以内;默认省略>
105
105
  selectionConfidence: <high / medium / low>
106
106
  ```
107
107
 
108
- ## 新增模板规则
108
+ ## 新增风格规则
109
109
 
110
110
  新增 `style-designs/*.md` 时,必须包含:
111
111
 
112
112
  - front matter 中的 `template_type: visual_dna_preset`。
113
113
  - `selection.best_for`、`selection.user_intent`、`selection.visual_tone`、`selection.avoid_for`。
114
- - registry 中必须为新模板补充 `视觉策略`、`可承载内容`、`强选择触发` 和 `近邻边界`,避免只写宽泛适用场景。
114
+ - registry 中必须为新风格补充 `视觉策略`、`可承载内容`、`强选择触发` 和 `近邻边界`,避免只写宽泛适用场景。
115
115
  - 2-5 个可稳定复用的 `visual_dna`,每个 DNA 要有 `id`、`hooks`、`invariant`、`variable`。
116
116
  - `theme_adaptation`,明确 `replace_tokens`、`derive_tokens`、`preserve_tokens` 和换肤规则。
117
117
  - `quality_anchors`、`layout_stability`、`components` 和 `modules`,让最终 `design.md` 能抽取为可实现规则。
@@ -4,7 +4,7 @@ template_type: visual_dna_preset
4
4
  name: soft-analytic-workbench
5
5
  design_id: soft-analytic-workbench
6
6
  design_status: draft
7
- description: 可被流程选择、可换主题色、内容中立的轻量分析工作台视觉 DNA 模板。
7
+ description: 可被流程选择、可换主题色、内容中立的轻量分析工作台视觉 DNA 风格。
8
8
  scenes: [工作台, 仪表盘, 管理后台首页, 数据概览, 列表分析页]
9
9
  density: medium-high
10
10
  layout: asymmetric_analytic_grid
@@ -218,7 +218,7 @@ modules:
218
218
 
219
219
  # Soft Analytic Workbench DESIGN.md
220
220
 
221
- > front matter 是给流程和生成器读取的结构化配置;人工评审优先阅读下方正文。若两者冲突,模板选择、换色策略和 token 数值以前面的 YAML 为准,使用边界和业务取舍以正文为准。
221
+ > front matter 是给流程和生成器读取的结构化配置;人工评审优先阅读下方正文。若两者冲突,风格选择、换色策略和 token 数值以前面的 YAML 为准,使用边界和业务取舍以正文为准。
222
222
 
223
223
  ## 1. 快速理解
224
224
 
@@ -236,9 +236,9 @@ PRD 决定内容、功能、信息架构、业务优先级、字段结构、模
236
236
 
237
237
  当 PRD 没有图表数据时,可以使用同等品质的主内容面板承载摘要、流程、状态分布或核心列表,但仍要保留浅面板、稳定高度、精细分隔和小面积强调。
238
238
 
239
- ## 3. 模板选择与换色逻辑
239
+ ## 3. 设计风格选择与换色逻辑
240
240
 
241
- 上游流程应在页面需要高密度扫描、摘要与明细并存、趋势或对比信息明确时选择该模板。若需求主要是品牌展示、长文阅读、海报式视觉、低密度单任务表单,则不应选择。
241
+ 上游流程应在页面需要高密度扫描、摘要与明细并存、趋势或对比信息明确时选择该风格。若需求主要是品牌展示、长文阅读、海报式视觉、低密度单任务表单,则不应选择。
242
242
 
243
243
  默认强调色只是初始 token,不是视觉 DNA。主题色只替换 `brand`、`brand-soft`、`focus-ring`、图表序列和少量状态辅助色;背景、白色面板、中性文字、浅边框、大圆角、轻阴影和稳定网格必须保留。
244
244
 
@@ -427,7 +427,7 @@ page_shell
427
427
 
428
428
  ## 12. 快捷入口区域
429
429
 
430
- 截图未出现独立快捷入口,但该页面类型通常需要 `quick_actions`。本模板按整体视觉 DNA 推断快捷入口,置信度为 `inferred`。
430
+ 截图未出现独立快捷入口,但该页面类型通常需要 `quick_actions`。本风格按整体视觉 DNA 推断快捷入口,置信度为 `inferred`。
431
431
 
432
432
  - 位置:放在 `primary_metrics` 之后、`main_grid` 之前;或放在 `right_rail` 顶部作为辅助操作面板。不要抢占 `metric_card` 和主图表。
433
433
  - 容器:白色软边框面板,圆角 24-28px,内边距 20-24px,阴影同普通面板。
@@ -241,7 +241,7 @@ modules:
241
241
 
242
242
  # Soft Bordered Analytic Workbench DESIGN.md
243
243
 
244
- > front matter 是给流程和生成器读取的结构化配置;人工评审优先阅读下方正文。若两者冲突,模板选择、换色策略和 token 数值以前面的 YAML 为准,使用边界和业务取舍以正文为准。
244
+ > front matter 是给流程和生成器读取的结构化配置;人工评审优先阅读下方正文。若两者冲突,风格选择、换色策略和 token 数值以前面的 YAML 为准,使用边界和业务取舍以正文为准。
245
245
 
246
246
  ## 1. 快速理解
247
247
 
@@ -253,7 +253,7 @@ PRD 决定页面要呈现什么内容、有什么功能、信息优先级如何
253
253
 
254
254
  它适合需要快速扫描状态、对比趋势、查看明细并执行少量命令的界面;不适合低信息量品牌叙事、沉浸式内容展示或强营销落地页。
255
255
 
256
- 编码结果必须具备精细边框、稳定面板高度、清晰数字层级、图标化扫描点和轻量图表纹理,不能退化成普通后台模板。
256
+ 编码结果必须具备精细边框、稳定面板高度、清晰数字层级、图标化扫描点和轻量图表纹理,不能退化成普通后台套路。
257
257
 
258
258
  ## 2. 使用边界
259
259
 
@@ -263,9 +263,9 @@ DESIGN.md 只负责视觉 DNA、布局气质、组件形态、密度、状态、
263
263
 
264
264
  禁止复用非 PRD 的具体业务字段、示例数值、人名、机构名、分类名、品牌表达或页面专属文案。所有内容都必须来自 PRD,或使用中性占位槽位等待 PRD 填充。
265
265
 
266
- ## 3. 模板选择与换色逻辑
266
+ ## 3. 设计风格选择与换色逻辑
267
267
 
268
- 当页面需要在首屏内同时承载搜索/筛选、核心摘要、高频操作、图表或主内容面板、并列指标卡和明细列表时,优先选择该模板。
268
+ 当页面需要在首屏内同时承载搜索/筛选、核心摘要、高频操作、图表或主内容面板、并列指标卡和明细列表时,优先选择该风格。
269
269
 
270
270
  不要把默认强调色理解成视觉 DNA。视觉 DNA 是“浅背景 + 软边框 + 深色摘要舞台 + 稳定模块栅格 + 小面积高亮”的机制,主题色只能替换强调色相与派生状态色。
271
271