openyida 2026.8.11 → 2026.8.12
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.
package/README.md
CHANGED
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
OpenYida connects AI coding agents with Yida's low-code platform, so developers can create apps, forms, workflows, custom pages, reports, integrations, and deployment configuration from a normal chat-driven development workflow.
|
|
10
10
|
|
|
11
|
-
[Quick Start](#quick-start) · [
|
|
11
|
+
[Quick Start](#quick-start) · [帮助网站&文档](https://demo.aliwork.com/o/openyida/helpCenter) · [Capabilities](#capabilities) · [Full Capability List](https://demo.aliwork.com/o/openyida/helpCenter?openyidaPath=capabilities) · [CLI Reference](https://demo.aliwork.com/o/openyida/helpCenter?openyidaPath=features/skills) · [Examples](https://demo.aliwork.com/o/openyida/helpCenter?openyidaRoute=showcase) · [Contributing](./CONTRIBUTING.md) · [Changelog](https://demo.aliwork.com/o/openyida/helpCenter?openyidaRoute=changelog)
|
|
12
12
|
|
|
13
13
|
[](https://www.npmjs.com/package/openyida)
|
|
14
14
|
[](https://www.npmjs.com/package/openyida)
|
|
@@ -16,7 +16,7 @@ OpenYida connects AI coding agents with Yida's low-code platform, so developers
|
|
|
16
16
|
[](./LICENSE)
|
|
17
17
|
[](https://nodejs.org)
|
|
18
18
|
|
|
19
|
-
|
|
19
|
+
**帮助网站&文档:** [帮助网站&文档](https://demo.aliwork.com/o/openyida/helpCenter)
|
|
20
20
|
|
|
21
21
|
[English README](./README.md) · [简体中文 README](./README_zhCN.md)
|
|
22
22
|
|
|
@@ -163,7 +163,7 @@ openyida/
|
|
|
163
163
|
|
|
164
164
|
## Capabilities
|
|
165
165
|
|
|
166
|
-
For a user-facing list of supported features and matching CLI commands, see [OpenYida 功能完整列表](
|
|
166
|
+
For a user-facing list of supported features and matching CLI commands, see [OpenYida 功能完整列表](https://demo.aliwork.com/o/openyida/helpCenter?openyidaPath=capabilities).
|
|
167
167
|
|
|
168
168
|
### Application and Form Management
|
|
169
169
|
|
|
@@ -194,6 +194,8 @@ Custom page source is authored directly from PRD and design guidance. Code Canva
|
|
|
194
194
|
|
|
195
195
|
For member, department, attachment, and image upload components, choose the page chain first. Code Canvas pages should follow `yida-canvas-custom-page/references/native-components-bridge.md` for feature detection, fallback, and value normalization. 普通自定义页面 JSX/Jsx pages should use `.oyd.jsx`, read `yida-custom-page/references/component-jsx-guide.md`, and read `attachment-upload-guide.md` when upload fields are involved.
|
|
196
196
|
|
|
197
|
+
For the current AI custom page native-component support matrix, see [Yida native components supported by AI custom pages](https://demo.aliwork.com/o/openyida/sample/canvas-native-components).
|
|
198
|
+
|
|
197
199
|
### Workflow, Data, and Permissions
|
|
198
200
|
|
|
199
201
|
```bash
|
package/bin/yida.js
CHANGED
|
@@ -143,7 +143,7 @@ function printHelp() {
|
|
|
143
143
|
console.log(` ${DIM}${RESET} openyida create-form create APP_XXX "${t('help.quickstart_form_name')}" .cache/openyida/forms/fields.json`);
|
|
144
144
|
console.log(` ${DIM}${RESET} openyida dws contact user search --keyword "张三"`);
|
|
145
145
|
console.log('');
|
|
146
|
-
console.log(` ${DIM}${t('help.docs')} https://
|
|
146
|
+
console.log(` ${DIM}${t('help.docs')} https://demo.aliwork.com/o/openyida/helpCenter · https://github.com/openyida/openyida${RESET}`);
|
|
147
147
|
console.log('');
|
|
148
148
|
}
|
|
149
149
|
|
|
@@ -598,7 +598,7 @@ const COMMAND_SIDE_EFFECTS = new Map([
|
|
|
598
598
|
mutates_yida: true,
|
|
599
599
|
mutates_local: false,
|
|
600
600
|
read_actions: ['list'],
|
|
601
|
-
mutating_actions: ['create', 'rename', 'delete', 'move', 'order', 'hide', 'show'],
|
|
601
|
+
mutating_actions: ['create', 'rename', 'delete', 'move', 'order', 'auto-order', 'hide', 'show'],
|
|
602
602
|
})],
|
|
603
603
|
['org', sideEffect('mixed', {
|
|
604
604
|
mutates_yida: false,
|
|
@@ -888,7 +888,7 @@ const COMMAND_PERMISSIONS = new Map([
|
|
|
888
888
|
...permissionEntries([
|
|
889
889
|
'nav-group',
|
|
890
890
|
], actionDependentPermission({
|
|
891
|
-
preauthorized_actions: ['create', 'rename', 'move', 'order', 'hide', 'show'],
|
|
891
|
+
preauthorized_actions: ['create', 'rename', 'move', 'order', 'auto-order', 'hide', 'show'],
|
|
892
892
|
ask_actions: ['delete'],
|
|
893
893
|
})),
|
|
894
894
|
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# 生成 design.md 规则
|
|
2
2
|
|
|
3
|
-
本文件用于在 Step 5 为完整应用生成一份应用级 `prd/<项目名>/design.md
|
|
3
|
+
本文件用于在 Step 5 为完整应用生成一份应用级 `prd/<项目名>/design.md`。生成流程必须先从业务上下文判断内容兼容性，再推演视觉策略，选择唯一一个内置 `style-designs/*.md` 作为基础视觉母体，最后按主题色适配模板并输出自包含的 `design.md`。
|
|
4
4
|
|
|
5
|
-
业务对象、字段、表单、流程、导航、权限和页面结构都从当前 PRD 读取；模板只提供视觉 DNA
|
|
5
|
+
业务对象、字段、表单、流程、导航、权限和页面结构都从当前 PRD 读取；模板只提供视觉 DNA、布局机制、组件机制、质量锚点和主题换肤规则，不提供业务内容。指标卡、图表、表格、待办、筛选器、右侧栏、状态标签、快捷入口、时间线等常见内容组件只能判断模板是否可承载，不得作为风格模板的强匹配理由。
|
|
6
6
|
`style-designs/_design-md-template.md` 是最终结构模板，只约束章节结构、字段完整度和描述粒度；内置 style-design 模板只提供可复用视觉母体。真实项目的配色、业务内容、资源关系、页面结构和实现交接必须从当前 PRD、应用主题和用户要求生成。
|
|
7
7
|
|
|
8
8
|
## 何时使用
|
|
@@ -23,7 +23,10 @@
|
|
|
23
23
|
| --- | --- |
|
|
24
24
|
| 用户任务 | 判断状态、处理待办、追踪阶段、分析趋势、管理明细、展示成果、汇报经营 |
|
|
25
25
|
| 业务对象 | 订单、客户、库存、项目、任务、审批、线索、合同、员工、门店 |
|
|
26
|
-
|
|
|
26
|
+
| 内容兼容性 | 当前页面是否需要指标、图表、表格、待办、筛选、右侧栏、时间线、卡片目录、媒体卡片 |
|
|
27
|
+
| 布局兼容性 | 均衡工作台、重点舞台、右栏工作区、指挥台、趋势看板、进度叙事、目录网格 |
|
|
28
|
+
| 视觉策略 | 柔和办公、深色重点舞台、蓝色洞察、规整边框、清爽右栏、高能指挥、进度叙事、目录浏览 |
|
|
29
|
+
| 视觉强调 | 所有模块均衡、核心指标强强调、行动队列强强调、趋势图强强调、右侧洞察强强调、目录筛选强强调 |
|
|
27
30
|
| 交互重心 | 搜索筛选、待办处理、下钻详情、多入口跳转、趋势比较、异常处置 |
|
|
28
31
|
| 数据形态 | KPI、队列、趋势、排行、明细表、日程、快捷入口、预警、阶段节点 |
|
|
29
32
|
| 页面区块 | 顶部概览、搜索筛选、表格、图表、右侧详情、表单入口、空态 |
|
|
@@ -34,32 +37,48 @@
|
|
|
34
37
|
|
|
35
38
|
1. 读取 [style-designs/registry.md](style-designs/registry.md)，了解可选模板和选择规则。
|
|
36
39
|
2. 读取 [style-designs/_design-md-template.md](style-designs/_design-md-template.md)，用它作为最终 `design.md` 的结构基准。
|
|
37
|
-
3. 从业务上下文推演 `inferredUserTask`、`
|
|
38
|
-
4.
|
|
39
|
-
5.
|
|
40
|
-
6.
|
|
41
|
-
7.
|
|
42
|
-
8.
|
|
43
|
-
9.
|
|
44
|
-
10.
|
|
45
|
-
11.
|
|
46
|
-
12.
|
|
47
|
-
13.
|
|
48
|
-
14.
|
|
49
|
-
15. 写入 `
|
|
50
|
-
16.
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
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`。
|
|
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`。
|
|
48
|
+
11. 读取 [visual-scaffold-recipes.md](visual-scaffold-recipes.md)，把当前页面组合映射到统一 `visualScaffold` 规则。
|
|
49
|
+
12. 读取 [page-quality-gates.md](page-quality-gates.md)，把质量门禁补进 `acceptanceChecks`。
|
|
50
|
+
13. 需要判断详略时参考 `_design-md-template.md` 的字段粒度、registry 的输出记录和所选模板的质量锚点；只学习“写到多细”，不复制示例业务、色盘、字段、页面顺序或组件组合。
|
|
51
|
+
14. 根据行业、品牌、业务情绪、应用主题和用户偏好生成配色。不要固定使用蓝色、绿色、紫色或任何预置色，也不要复用历史样例色盘。
|
|
52
|
+
15. 写入 `densityRule`、`breathingRule`、`spacing` 和 `rounded` 的具体数值。默认业务工具页使用 high density + 圆润形状 + 有呼吸感的分组节奏：页面边距 20-28px，卡片与卡片 gap 12-18px 且必须小于 20px，卡片 padding 默认 22-28px 且必须大于 20px，卡片圆角范围 0-32px；只有品牌展示、官网或用户明确要求舒展时才降低密度。
|
|
53
|
+
16. 写入 `surfaceContrast`：页面背景与卡片背景必须形成明显层次对比，不可相近或相同；默认浅色背景保持清爽，但必须按“白色/浅色背景 + 有边框卡片、浅灰背景（如 `#F3F4F6`）+ 白色无边框卡片、浅彩色背景 + 白色无边框卡片、渐变背景 + 玻璃感卡片”四类方案选择。
|
|
54
|
+
17. 写入 `emptyStateRecipe` 和 `acceptanceChecks`：空态必须是薄行、面板内提示或右侧上下文，不使用 160px 以上大白卡；状态摘要不能是横跨整页且内容稀疏的空矩形。
|
|
55
|
+
18. 如果平台导航可见，页面主按钮、链接、选中态、重点标签和图表主序列默认跟随应用主题；自定义色盘只能作为辅助色、浅背景、图表第二序列或页面级独立主题。
|
|
56
|
+
|
|
57
|
+
## 内容兼容与视觉策略
|
|
58
|
+
|
|
59
|
+
公共内容组件只判断模板是否可承载，不决定最终风格。最终模板必须由视觉策略、视觉强调和近邻比较决定。
|
|
60
|
+
|
|
61
|
+
| 常见内容信号 | 只能用于判断 | 不得直接推出 |
|
|
62
|
+
| --- | --- | --- |
|
|
63
|
+
| 指标卡 / KPI | 是否需要状态摘要、核心舞台、趋势入口、行动队列入口 | `soft-analytic-workbench` |
|
|
64
|
+
| 图表 | 是否需要轻量分布、大趋势图、进度图、纹理化洞察 | dashboard 模板 |
|
|
65
|
+
| 表格 / 明细 | 是否需要主工作区、详情沉淀、搜索结果、记录日志 | analytic 模板 |
|
|
66
|
+
| 右侧栏 | 是辅助上下文、常驻洞察栏还是行动队列 | rail 模板 |
|
|
67
|
+
| 时间线 / 阶段 | 是核心叙事骨架还是普通进度提示 | timeline 模板 |
|
|
68
|
+
| 筛选器 / 标签 | 是主导航还是表格辅助条件 | catalog 模板 |
|
|
69
|
+
|
|
70
|
+
| 视觉策略 | 适用判断 |
|
|
55
71
|
| --- | --- |
|
|
56
|
-
|
|
|
57
|
-
|
|
|
58
|
-
|
|
|
59
|
-
|
|
|
60
|
-
|
|
|
61
|
-
|
|
|
62
|
-
|
|
|
72
|
+
| `soft_neutral` | 低噪声、均衡、朴素办公感；没有强主舞台、强趋势、强指挥或强目录诉求 |
|
|
73
|
+
| `dark_accent_stage` | 浅色页面中需要一个局部深色重点舞台，突出核心判断、风险、目标或经营结果 |
|
|
74
|
+
| `blue_insight` | 需要更强分析感、趋势感、数据洞察感，主图表或趋势面板应成为记忆点 |
|
|
75
|
+
| `bordered_enterprise` | 需要规整、边界清晰、系统化的管理后台气质 |
|
|
76
|
+
| `teal_fresh_rail` | 需要清爽、服务感或常驻右侧洞察栏，右栏是页面稳定结构而非临时补充 |
|
|
77
|
+
| `action_command` | 需要今日行动、命令入口、推荐处理、任务队列或高能量指挥感 |
|
|
78
|
+
| `progress_narrative` | 需要阶段推进、周期节奏、服务进度或里程碑叙事 |
|
|
79
|
+
| `catalog_browse` | 需要以筛选、比较、挑选、卡片目录或视觉浏览作为主体验 |
|
|
80
|
+
|
|
81
|
+
选择 `soft_neutral` / `soft-analytic-workbench` 时必须满足：其他视觉策略都没有更强证据。它是均衡办公风格，不是所有工作台的默认答案。
|
|
63
82
|
|
|
64
83
|
## 主题色应用规则
|
|
65
84
|
|
|
@@ -89,7 +108,7 @@ Step 5 生成 `design.md`，并让 PRD 的每个自定义展示页只引用它
|
|
|
89
108
|
| 字段 | 写入位置 | 写法 |
|
|
90
109
|
| --- | --- | --- |
|
|
91
110
|
| baseDesignSource | design.md | `references/style-designs/<selected-template>.md`；所有模板不适用时才写 `generated-from-business-context` |
|
|
92
|
-
| styleDesignSelection | design.md |
|
|
111
|
+
| styleDesignSelection | design.md | 只记录模板来源、视觉策略、视觉强调、选中模板、实现约束和置信度；候选比较和拒绝理由默认不写入 |
|
|
93
112
|
| themeAdaptationResult | design.md | 记录输入主题色、换肤策略、替换 token、保留 DNA 和保留机制 |
|
|
94
113
|
| designFile | PRD pageSpecHandoff | `prd/<项目名>/design.md` |
|
|
95
114
|
| designRefs | PRD pageSpecHandoff | 当前页面引用 design.md 的章节 ID |
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# style-design 内置模板注册表
|
|
2
2
|
|
|
3
|
-
本目录提供 `yida-design` Step 5 生成 `prd/<项目名>/design.md` 时可选择的内置视觉 DNA 模板。生成 `design.md`
|
|
3
|
+
本目录提供 `yida-design` Step 5 生成 `prd/<项目名>/design.md` 时可选择的内置视觉 DNA 模板。生成 `design.md` 时必须先判断内容兼容性，再根据视觉策略选择唯一一个 `style-designs/*.md` 作为基础视觉母体，最后结合主题色和当前 PRD 生成最终自包含的 `design.md`。
|
|
4
4
|
|
|
5
5
|
`_design-md-template.md` 仍是结构模板；它不参与视觉风格选择。实现阶段只读取当前项目的 `prd.md` 和 `design.md`，不回读本目录。
|
|
6
6
|
|
|
@@ -14,23 +14,23 @@
|
|
|
14
14
|
|
|
15
15
|
## 可选 style-design 模板
|
|
16
16
|
|
|
17
|
-
| 模板 |
|
|
17
|
+
| 模板 | 视觉策略 | 可承载内容 | 强选择触发 | 近邻边界 |
|
|
18
18
|
| --- | --- | --- | --- | --- |
|
|
19
|
-
| `soft-analytic-workbench.md` |
|
|
20
|
-
| `soft-bordered-analytic-workbench.md` |
|
|
21
|
-
| `soft-modular-analytic-workbench.md` |
|
|
22
|
-
| `soft-progress-analytics-workbench.md` |
|
|
23
|
-
| `soft-timeline-analytics-workbench.md` |
|
|
24
|
-
| `teal-rail-analytics-workbench.md` |
|
|
25
|
-
| `dark-stage-analytic-dashboard.md` |
|
|
26
|
-
| `contrast-command-analytics-workbench.md` |
|
|
27
|
-
| `blue-productivity-insight-workbench.md` |
|
|
28
|
-
| `aqua-service-progress-dashboard.md` |
|
|
29
|
-
| `blue-insight-operations-dashboard.md` |
|
|
30
|
-
| `green-timeline-progress-workbench.md` |
|
|
31
|
-
| `filterable-card-catalog.md` |
|
|
32
|
-
| `soft-curated-filter-gallery.md` |
|
|
33
|
-
| `command-filter-card-console.md` |
|
|
19
|
+
| `soft-analytic-workbench.md` | `soft_neutral` 均衡办公 | 指标、轻图表、右侧辅助列表、明细表、普通入口 | 用户明确需要低噪声、均衡、朴素办公感；所有模块视觉优先级接近 | 通用兜底，有泛化惩罚；若需要重点舞台、趋势洞察、行动队列、常驻右栏或规整边框，应输给对应模板 |
|
|
20
|
+
| `soft-bordered-analytic-workbench.md` | `bordered_enterprise` 规整控制台 | 命令栏、深色摘要区、图表洞察、分区明细 | 页面需要边界清晰、系统化、控制台感，搜索筛选和全局命令是稳定入口 | 若只是均衡办公输给 `soft-analytic`；若深色舞台是主记忆点输给 `dark-stage` |
|
|
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` 或非进度模板 |
|
|
24
|
+
| `teal-rail-analytics-workbench.md` | `teal_fresh_rail` 常驻洞察右栏 | 左侧主工作区、右侧洞察栏、标签筛选、明细表 | 右侧洞察栏是持续结构，用于提醒、排名、状态、上下文，而非普通补充列表 | 若右栏只是辅助列表输给 `soft-analytic`；若行动队列更强输给 `blue-productivity` |
|
|
25
|
+
| `dark-stage-analytic-dashboard.md` | `dark_accent_stage` 局部深色重点舞台 | 指标、图表、表格、待办、右侧上下文 | 浅色页面中需要一个强记忆点，突出核心判断、风险、目标完成度或经营结果 | 不要求用户明确说深色；若只是全模块均衡扫描输给 `soft-analytic`，若命令处理更强输给 `contrast-command` |
|
|
26
|
+
| `contrast-command-analytics-workbench.md` | `action_command` 高对比指挥 | 大标题、表现图、事件流、深色命令面板、媒体化明细 | 页面需要指挥感、推荐处理、助手面板、日程协同或高能量主操作 | 若只是待办列表输给 `blue-productivity`；若只是核心指标舞台输给 `dark-stage` |
|
|
27
|
+
| `blue-productivity-insight-workbench.md` | `action_command` 生产力行动队列 | 指标、柱状图、右侧行动栏、记录表 | 指标之后立刻驱动今日处理、待办、跟进、确认、分派等动作 | 若主图表洞察更强输给 `blue-insight`；若右栏是洞察而非行动输给 `teal-rail` |
|
|
28
|
+
| `aqua-service-progress-dashboard.md` | `progress_narrative` 服务进度 | 状态头、时间轴、进度评分、渐变状态卡、媒体/上下文卡 | 服务、资源、场地、设备、交付进度或上下文媒体共同构成体验 | 若是密集后台或纯表格处理输给工作台模板；若只是阶段管理输给 timeline/progress 模板 |
|
|
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` |
|
|
32
|
+
| `soft-curated-filter-gallery.md` | `catalog_browse` 视觉精选画廊 | 大标题、分类切换、柔和筛选、大图卡片、收藏/徽标 | 主体验是视觉浏览、候选挑选、精选展示，图片或视觉对象重要 | 若需要高密管理和批量操作输给 `command-filter-card-console` 或 `filterable-card-catalog` |
|
|
33
|
+
| `command-filter-card-console.md` | `catalog_browse` 管理型卡片控制台 | 边框筛选、状态标签、紧凑管理卡片、分页 | 主体验是对象管理、状态筛选、批量查看，卡片是管理单元而非展示物 | 若偏视觉陈列输给 `soft-curated-filter-gallery`；若偏普通结果浏览输给 `filterable-card-catalog` |
|
|
34
34
|
|
|
35
35
|
## 消费硬规则
|
|
36
36
|
|
|
@@ -43,40 +43,65 @@
|
|
|
43
43
|
|
|
44
44
|
## 选择原则
|
|
45
45
|
|
|
46
|
-
1.
|
|
46
|
+
1. 先从业务需求判断内容兼容性，再推演视觉策略、视觉强调、密度气质和交互重心；不要按行业、主题色或公共内容组件直接选模板。
|
|
47
47
|
2. 主题色只作为所选模板的 `theme_adaptation` 输入，用于替换强调色 token；主题色不是选择模板的主要依据。
|
|
48
|
-
3.
|
|
48
|
+
3. 指标卡、图表、表格、待办、筛选器、右侧栏、状态标签、快捷入口、时间线等公共组件只用于判断 `contentCompatibility`，不得作为模板强匹配理由。
|
|
49
49
|
4. 每次必须选择唯一一个 `style-designs/*.md` 作为 `baseDesignSource`。若所有模板都不适合，仍读取 `_design-md-template.md` 输出 `baseDesignSource=generated-from-business-context`，并在 `styleDesignSelection.rejectedStyleDesigns` 说明原因。
|
|
50
50
|
5. 不得为了套模板凭空创造 PRD 未要求的图表、右侧栏、时间轴、深色舞台或快捷入口；模板只能决定已有业务内容的视觉承载方式。
|
|
51
|
-
6.
|
|
51
|
+
6. `dark-stage-analytic-dashboard` 是局部深色重点舞台，不是全页面深色沉浸。不得仅以“用户未要求深色”为理由拒绝它；只能在页面不需要强视觉焦点时拒绝。
|
|
52
|
+
7. `soft-analytic-workbench` 是 `soft_neutral` 均衡办公风格，不是所有工作台的默认答案。选择它时必须在内部选择草稿中确认其他更强视觉策略证据不足。
|
|
53
|
+
8. 最终 `design.md` 必须自包含：包含模板来源、选择依据、主题换肤结果、视觉 DNA、token、组件、状态、响应式、可访问性和实现契约。
|
|
52
54
|
|
|
53
55
|
## 选择评分建议
|
|
54
56
|
|
|
55
57
|
| 维度 | 权重 | 判断方法 |
|
|
56
58
|
| --- | --- | --- |
|
|
57
|
-
|
|
|
58
|
-
|
|
|
59
|
-
|
|
|
60
|
-
|
|
|
61
|
-
|
|
|
59
|
+
| 视觉策略匹配 | 45% | 页面需要 `soft_neutral`、`dark_accent_stage`、`blue_insight`、`bordered_enterprise`、`teal_fresh_rail`、`action_command`、`progress_narrative` 还是 `catalog_browse` |
|
|
60
|
+
| 视觉强调与密度 | 15% | 首屏是均衡扫描、核心舞台、趋势洞察、行动队列、常驻右栏、阶段推进还是目录筛选；密度是高密、规整、舒展还是展示型 |
|
|
61
|
+
| 布局兼容性 | 15% | 当前页面是否能稳定承载该模板的舞台、右栏、命令栏、进度骨架、目录网格或趋势面板 |
|
|
62
|
+
| 内容兼容性 | 15% | 模板是否支持当前已有指标、图表、表格、待办、筛选、右栏、时间线、卡片和媒体内容 |
|
|
63
|
+
| 多样性或用户偏好 | 10% | 用户语气、品牌气质、应用主题和候选分差接近时，避免所有工作台都落到 `soft-analytic-workbench` |
|
|
64
|
+
| 风险扣分 | -5% | 是否会强行制造不存在的模块、过度依赖图表、右侧栏、时间轴、深色舞台或图片素材 |
|
|
65
|
+
|
|
66
|
+
内容兼容性和布局兼容性合计不得超过 30%。如果多个模板都能承载相同内容，必须让视觉策略、视觉强调和近邻边界决定最终选择。
|
|
62
67
|
|
|
63
68
|
## 输出记录
|
|
64
69
|
|
|
65
|
-
|
|
70
|
+
生成 `design.md` 前必须先形成内部选择草稿，用来防止公共组件误导模板选择。内部选择草稿不写入最终 `design.md`，除非用户要求调试或评估选择过程。
|
|
71
|
+
|
|
72
|
+
```yaml
|
|
73
|
+
selectionScratchpad:
|
|
74
|
+
topCandidates:
|
|
75
|
+
- name: <template-name>
|
|
76
|
+
evidence: <短句或枚举，不写长解释>
|
|
77
|
+
rejectedCloseNeighbors:
|
|
78
|
+
- name: <template-name>
|
|
79
|
+
evidence: <短句或枚举>
|
|
80
|
+
softAnalyticCheck:
|
|
81
|
+
strongerVisualStrategyExists: <true / false>
|
|
82
|
+
result: <select_soft_analytic / choose_stronger_strategy>
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
最终 `design.md` 只记录可交接给实现阶段的精简选择摘要：
|
|
66
86
|
|
|
67
87
|
```yaml
|
|
68
88
|
baseDesignSource: references/style-designs/<selected-template>.md
|
|
69
89
|
styleDesignSelection:
|
|
70
90
|
inferredUserTask: <判断 / 处理 / 追踪 / 分析 / 展示 / 汇报>
|
|
71
|
-
|
|
91
|
+
contentCompatibility:
|
|
92
|
+
supports: [<metrics / charts / tables / todos / filters / side_panel / timeline / catalog_cards / media_cards>]
|
|
93
|
+
commonComponentsAreWeakSignals: true
|
|
94
|
+
layoutCompatibility: <balanced_workbench / stage_workbench / rail_workspace / command_console / insight_dashboard / progress_narrative / catalog_grid>
|
|
95
|
+
visualStyleIntent: <soft_neutral / dark_accent_stage / blue_insight / bordered_enterprise / teal_fresh_rail / action_command / progress_narrative / catalog_browse>
|
|
96
|
+
visualEmphasis: <均衡扫描 / 核心舞台 / 趋势洞察 / 行动队列 / 常驻右栏 / 阶段推进 / 目录筛选>
|
|
72
97
|
requiredVisualDNA:
|
|
73
98
|
- <dna-id>
|
|
74
99
|
selectedStyleDesign:
|
|
75
100
|
name: <template-name>
|
|
76
101
|
source: references/style-designs/<template>.md
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
102
|
+
implementationConstraints:
|
|
103
|
+
- <必须保留的视觉约束，例如局部深色舞台 / 常驻右栏 / 行动队列 / 大趋势面板>
|
|
104
|
+
selectionNotes: <可选，一句话以内；默认省略>
|
|
80
105
|
selectionConfidence: <high / medium / low>
|
|
81
106
|
```
|
|
82
107
|
|
|
@@ -86,6 +111,7 @@ styleDesignSelection:
|
|
|
86
111
|
|
|
87
112
|
- front matter 中的 `template_type: visual_dna_preset`。
|
|
88
113
|
- `selection.best_for`、`selection.user_intent`、`selection.visual_tone`、`selection.avoid_for`。
|
|
114
|
+
- registry 中必须为新模板补充 `视觉策略`、`可承载内容`、`强选择触发` 和 `近邻边界`，避免只写宽泛适用场景。
|
|
89
115
|
- 2-5 个可稳定复用的 `visual_dna`，每个 DNA 要有 `id`、`hooks`、`invariant`、`variable`。
|
|
90
116
|
- `theme_adaptation`，明确 `replace_tokens`、`derive_tokens`、`preserve_tokens` 和换肤规则。
|
|
91
117
|
- `quality_anchors`、`layout_stability`、`components` 和 `modules`，让最终 `design.md` 能抽取为可实现规则。
|