cardbuddy 0.13.3 → 0.14.1
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 +7 -3
- package/dist/cli.js +4 -4
- package/dist/config.js +7 -7
- package/dist/init.js +15 -4
- package/dist/portGuard.js +2 -2
- package/dist/preview-editor/assets/index-DnXqKrCc.js +307 -0
- package/dist/preview-editor/assets/index-cbTCHp8J.css +1 -0
- package/dist/preview-editor/index.html +2 -2
- package/dist/standalone.js +14 -6
- package/dist/vendored/card-editor/api.js +6 -6
- package/dist/vendored/mcp/client.mjs +53 -3
- package/dist/vendored/mcp/tools.mjs +17 -1
- package/dist/vendored/server/core/ai-chat.js +1443 -271
- package/dist/vendored/server/core/cardFiles.js +271 -39
- package/dist/vendored/server/core/cardImportMeta.js +16 -0
- package/dist/vendored/server/core/chatHistory.js +122 -0
- package/dist/vendored/server/core/index.js +10 -3
- package/dist/vendored/server/core/turnJournal.js +386 -0
- package/dist/vendored/skills/card-skill-trainer/SKILL.md +399 -222
- package/dist/vendored/skills/card-skill-trainer/scripts/build_dataset.py +103 -19
- package/dist/vendored/skills/card-skill-trainer/scripts/diagnose_case.mjs +378 -200
- package/dist/vendored/skills/card-skill-trainer/scripts/lib/runs.mjs +147 -0
- package/dist/vendored/skills/card-skill-trainer/scripts/lib/scoring.mjs +297 -4
- package/dist/vendored/skills/card-skill-trainer/scripts/plan_next_round.mjs +484 -0
- package/dist/vendored/skills/card-skill-trainer/scripts/round_diff.mjs +77 -96
- package/dist/vendored/skills/card-skill-trainer/scripts/run_round.mjs +237 -62
- package/dist/vendored/skills/card-skill-trainer/scripts/score_round.mjs +74 -35
- package/dist/vendored/skills/dsl-card-ai/SKILL.md +15 -2
- package/dist/vendored/skills/dsl-card-generator/SKILL.md +5 -3
- package/dist/vendored/skills/dsl-card-generator/references/generation_pitfalls.md +120 -0
- package/dist/vendored/skills/dsl-card-generator/references/previewer_contract.md +10 -0
- package/dist/vendored/skills/dsl-card-generator/references/quickref.md +15 -1
- package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/canvas-radar.json +2 -2
- package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/scatter-pill-band.json +10 -0
- package/dist/vendored/skills/dsl-card-generator/references/recipes.md +43 -1
- package/dist/vendored/skills/dsl-card-generator/references/rules.md +33 -6
- package/dist/vendored/skills/dsl-card-generator/references/slices_convention.md +12 -5
- package/dist/vendored/skills/dsl-card-generator/scripts/add_component.mjs +5 -10
- package/dist/vendored/skills/dsl-card-generator/scripts/crop_slices.mjs +47 -10
- package/dist/vendored/skills/dsl-card-generator/scripts/expand_ir.mjs +12 -4
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/design_sample.mjs +388 -328
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/slice_pixels.mjs +109 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/render_card.mjs +45 -7
- package/dist/vendored/skills/dsl-card-generator/scripts/route_input.mjs +7 -3
- package/dist/vendored/skills/dsl-card-generator/scripts/spec_audit.mjs +110 -23
- package/dist/vendored/skills/dsl-card-generator/scripts/spec_to_schema_v3.mjs +2954 -127
- package/dist/vendored/skills/dsl-card-generator/scripts/spec_tree.mjs +128 -3
- package/dist/vendored/skills/dsl-card-generator/scripts/validate_schema.py +28 -0
- package/dist/vendored/skills/finmall-card-sync/SKILL.md +1 -1
- package/dist/vendored/skills/finmall-session-navigator/SKILL.md +1 -1
- package/dist/vendored/skills/finmall-session-navigator/scripts/session-manager.mjs +1 -1
- package/dist/vendored/skills/shared/finmall-config.mjs +4 -4
- package/dist/vendored/skills/sketch-spec-to-card/SKILL.md +2 -2
- package/dist/vendored/skills/sketch-spec-to-card/scripts/parse_meaxure.py +29 -2
- package/dist/vendored/tools/finmall-env.mjs +6 -6
- package/package.json +1 -1
- package/dist/preview-editor/assets/index-CQScMhyg.css +0 -1
- package/dist/preview-editor/assets/index-pW1J4vP3.js +0 -276
- package/dist/vendored/skills/card-skill-trainer/baselines/v3-r038n.json +0 -43
- package/dist/vendored/skills/card-skill-trainer/baselines/v3-r039n.json +0 -47
- package/dist/vendored/skills/card-skill-trainer/baselines/v3-r050n.json +0 -48
|
@@ -1,18 +1,27 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
+
// 轮次汇总:指标均值、失败签名/归因直方图、掩膜覆盖率、晋级门(roundGate)与 summary.md 图廊。
|
|
3
|
+
// 门与签名口径全部取自 lib/scoring.mjs(唯一来源),轮次读取取自 lib/runs.mjs。
|
|
4
|
+
// 用法:node score_round.mjs --run training/runs/r262 [--quiet]
|
|
2
5
|
import fs from 'node:fs'
|
|
3
6
|
import path from 'node:path'
|
|
7
|
+
import {
|
|
8
|
+
evaluatePassGate, evaluateRoundGate, failureSignature, MASK_REVIEW_THRESHOLD,
|
|
9
|
+
} from './lib/scoring.mjs'
|
|
10
|
+
import { loadRunReports } from './lib/runs.mjs'
|
|
4
11
|
|
|
5
12
|
const repoRoot = path.resolve(import.meta.dirname, '../../..')
|
|
6
|
-
const
|
|
13
|
+
const argv = process.argv.slice(2)
|
|
14
|
+
const flagValue = (name) => {
|
|
15
|
+
const index = argv.indexOf(name)
|
|
16
|
+
return index >= 0 ? (argv[index + 1] || '') : ''
|
|
17
|
+
}
|
|
18
|
+
const runDir = path.resolve(flagValue('--run') || '')
|
|
19
|
+
const quiet = argv.includes('--quiet')
|
|
7
20
|
const reportDir = path.join(runDir, 'reports')
|
|
8
21
|
if (!fs.existsSync(reportDir)) throw new Error(`No reports at ${reportDir}`)
|
|
9
22
|
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
.filter((file) => !/summary|skipped|review|semantic/.test(file))
|
|
13
|
-
.map((file) => JSON.parse(fs.readFileSync(path.join(reportDir, file), 'utf8')))
|
|
14
|
-
// 只认带 caseId 的案例报告,防止 skipped-*.json 等附属产物混入统计
|
|
15
|
-
.filter((item) => item && !Array.isArray(item) && typeof item.caseId === 'string')
|
|
23
|
+
// 只认带 caseId 的案例报告,附属产物(summary/skipped/review/semantic/inherited…)由 lib 过滤
|
|
24
|
+
const reports = [...loadRunReports(runDir).values()]
|
|
16
25
|
|
|
17
26
|
const count = (predicate) => reports.filter(predicate).length
|
|
18
27
|
const average = (values) => values.length ? values.reduce((a, b) => a + b, 0) / values.length : null
|
|
@@ -74,41 +83,46 @@ summary.correctorRejected = correctorRejected
|
|
|
74
83
|
summary.correctorCoverage = reports.length ? correctorAttempts / reports.length : null
|
|
75
84
|
summary.correctorAcceptRate = correctorAttempts ? correctorAccepted / correctorAttempts : null
|
|
76
85
|
|
|
86
|
+
// --- 失败签名 / 未达标维度直方图 / 失败类分布 ---
|
|
87
|
+
// 签名口径 v2(lib/scoring.mjs):取归一化缺口最大的维度,而非固定优先级顺序。
|
|
88
|
+
// 旧口径会把 comp=0.42 / pos=0.42 的缺组件卡报成 duplicate-content-detected(重影只超 1 处),
|
|
89
|
+
// 把下一轮修复方向带偏;跨轮签名趋势对比请以口径 v2 之后的轮次为界。
|
|
77
90
|
const signatures = {}
|
|
91
|
+
const gateHistogram = {}
|
|
92
|
+
const classHistogram = {}
|
|
78
93
|
for (const report of reports.filter((item) => !item.passed)) {
|
|
79
|
-
const signature = report
|
|
80
|
-
(report.validate?.errors ? `validate-errors:${report.validate.errors}` : '') ||
|
|
81
|
-
(report.lint?.errors ? `lint-errors:${report.lint.errors}` : '') ||
|
|
82
|
-
((report.duplication?.overall ?? 1) < .95 ? 'duplicate-content-detected' : '') ||
|
|
83
|
-
(report.fidelity?.position < .80 ? 'position-accuracy-below-80%' : '') ||
|
|
84
|
-
(report.fidelity?.textOverflow < .90 ? 'text-overflow-detected' : '') ||
|
|
85
|
-
(report.pixel?.ratio > .08 ? 'pixel-diff-over-8%' : '') ||
|
|
86
|
-
(report.pixel?.dimension < .95 ? 'aspect-ratio-mismatch' : '') ||
|
|
87
|
-
(report.pixel?.color < .90 ? 'color-distribution-mismatch' : '') ||
|
|
88
|
-
(report.pixel?.structure < .85 ? 'layout-structure-mismatch' : '') ||
|
|
89
|
-
(report.fidelity?.components < .75 ? 'component-count-mismatch' : '') ||
|
|
90
|
-
(report.fidelity?.overall < .85 ? 'overall-fidelity-below-85%' : 'metric-gate')
|
|
94
|
+
const signature = failureSignature(report) || 'metric-gate'
|
|
91
95
|
signatures[signature] = (signatures[signature] || 0) + 1
|
|
96
|
+
// 旧报告没有 gateFailures 字段:按同一把尺子现算,保证直方图跨轮可比
|
|
97
|
+
const failures = Array.isArray(report.gateFailures) && report.gateFailures.length
|
|
98
|
+
? report.gateFailures
|
|
99
|
+
: evaluatePassGate(report).failures
|
|
100
|
+
for (const failure of failures) gateHistogram[failure.key] = (gateHistogram[failure.key] || 0) + 1
|
|
101
|
+
const failureClass = report.failureClass || 'UNCLASSIFIED'
|
|
102
|
+
classHistogram[failureClass] = (classHistogram[failureClass] || 0) + 1
|
|
92
103
|
}
|
|
104
|
+
const histogram = (buckets) => Object.entries(buckets)
|
|
105
|
+
.sort((a, b) => b[1] - a[1])
|
|
106
|
+
.map(([key, value]) => ({ key, count: value }))
|
|
93
107
|
summary.failureSignatures = Object.entries(signatures)
|
|
94
108
|
.sort((a, b) => b[1] - a[1]).slice(0, 10)
|
|
95
109
|
.map(([signature, count]) => ({ signature, count }))
|
|
110
|
+
summary.gateFailureHistogram = histogram(gateHistogram)
|
|
111
|
+
summary.failureClasses = histogram(classHistogram)
|
|
96
112
|
|
|
97
|
-
// ---
|
|
98
|
-
const
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
upstreamFailures: { target: 0, actual: summary.upstreamFailures, met: summary.upstreamFailures === 0 },
|
|
111
|
-
}
|
|
113
|
+
// --- 掩膜覆盖率:靠掩膜过门的案例必须点名复核 ---
|
|
114
|
+
const coverages = reports
|
|
115
|
+
.map((item) => ({ caseId: item.caseId, total: item.exclusionCoverage?.total, passed: !!item.passed }))
|
|
116
|
+
.filter((item) => typeof item.total === 'number')
|
|
117
|
+
summary.avgExclusionCoverage = average(coverages.map((item) => item.total))
|
|
118
|
+
summary.highMaskCases = coverages
|
|
119
|
+
.filter((item) => item.total >= MASK_REVIEW_THRESHOLD)
|
|
120
|
+
.sort((a, b) => b.total - a.total)
|
|
121
|
+
.map((item) => ({ caseId: item.caseId, coverage: Number(item.total.toFixed(4)), passed: item.passed }))
|
|
122
|
+
summary.maskReviewThreshold = MASK_REVIEW_THRESHOLD
|
|
123
|
+
|
|
124
|
+
// --- 轮级晋级门(目标值唯一来源:lib/scoring.mjs::ROUND_GATE_TARGETS)---
|
|
125
|
+
const ROUND_GATE = evaluateRoundGate({ ...summary, minFidelity, below80 })
|
|
112
126
|
const roundGateAllMet = Object.values(ROUND_GATE).every((g) => g.met)
|
|
113
127
|
summary.roundGate = ROUND_GATE
|
|
114
128
|
summary.roundGatePassed = roundGateAllMet
|
|
@@ -146,6 +160,21 @@ for (const [gateName, gate] of Object.entries(ROUND_GATE)) {
|
|
|
146
160
|
lines.push(`- **总门禁: ${roundGateAllMet ? 'PASS' : 'FAIL'}**`, '', '## 失败签名', '')
|
|
147
161
|
for (const item of summary.failureSignatures) lines.push(`- ${item.count} × ${item.signature}`)
|
|
148
162
|
|
|
163
|
+
lines.push('', '## 未达标维度直方图(下一轮该修哪一维)', '')
|
|
164
|
+
if (summary.gateFailureHistogram.length) {
|
|
165
|
+
for (const item of summary.gateFailureHistogram) lines.push(`- ${item.key}: ${item.count} 例`)
|
|
166
|
+
} else lines.push('- (无失败案例)')
|
|
167
|
+
lines.push('', '## 失败类分布(修复落点路由)', '')
|
|
168
|
+
if (summary.failureClasses.length) {
|
|
169
|
+
for (const item of summary.failureClasses) lines.push(`- ${item.key}: ${item.count} 例`)
|
|
170
|
+
} else lines.push('- (无失败案例)')
|
|
171
|
+
lines.push('', `## 高掩膜案例(≥${(MASK_REVIEW_THRESHOLD * 100).toFixed(0)}% 面积不计分,通过结论需人工复核)`, '')
|
|
172
|
+
if (summary.highMaskCases.length) {
|
|
173
|
+
for (const item of summary.highMaskCases) {
|
|
174
|
+
lines.push(`- ${item.caseId}: 掩膜 ${(item.coverage * 100).toFixed(1)}%(${item.passed ? 'PASS' : 'FAIL'})`)
|
|
175
|
+
}
|
|
176
|
+
} else lines.push('- (无)')
|
|
177
|
+
|
|
149
178
|
// —— 逐案截图对比图廊 ——
|
|
150
179
|
lines.push('', '## 截图对比', '')
|
|
151
180
|
const sortedReports = [...reports].sort((a, b) =>
|
|
@@ -192,4 +221,14 @@ for (const report of sortedReports) {
|
|
|
192
221
|
}
|
|
193
222
|
|
|
194
223
|
fs.writeFileSync(path.join(reportDir, 'summary.md'), lines.join('\n') + '\n')
|
|
195
|
-
|
|
224
|
+
if (quiet) {
|
|
225
|
+
const unmet = Object.entries(ROUND_GATE).filter(([, gate]) => !gate.met).map(([key]) => key)
|
|
226
|
+
const fid = summary.avgFidelity == null ? 'N/A' : `${(summary.avgFidelity * 100).toFixed(1)}%`
|
|
227
|
+
const pix = summary.avgPixelDiff == null ? 'N/A' : `${(summary.avgPixelDiff * 100).toFixed(1)}%`
|
|
228
|
+
console.log(`[${path.basename(runDir)}] pass ${summary.passed}/${summary.total} (${(summary.passRate * 100).toFixed(1)}%) avgFid ${fid} avgPix ${pix} gate ${roundGateAllMet ? 'PASS' : `FAIL(${unmet.join(',')})`}`)
|
|
229
|
+
if (summary.highMaskCases.length) {
|
|
230
|
+
console.log(`[mask] ${summary.highMaskCases.length} 例掩膜 ≥${(MASK_REVIEW_THRESHOLD * 100).toFixed(0)}%,通过结论需复核:${summary.highMaskCases.slice(0, 5).map((item) => item.caseId).join(',')}`)
|
|
231
|
+
}
|
|
232
|
+
} else {
|
|
233
|
+
console.log(JSON.stringify(summary, null, 2))
|
|
234
|
+
}
|
|
@@ -71,7 +71,7 @@ Claude / Cursor 等用 JSON 形式的等价配置:`{"mcpServers":{"dsl-card":{
|
|
|
71
71
|
```bash
|
|
72
72
|
printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
|
|
73
73
|
| npm run --silent mcp # 消费者工程换成 ./node_modules/.bin/cardbuddy --mcp
|
|
74
|
-
# 健康:回一行 JSON,result.tools 共
|
|
74
|
+
# 健康:回一行 JSON,result.tools 共 17 个
|
|
75
75
|
```
|
|
76
76
|
|
|
77
77
|
排查时加 `CARDBUDDY_MCP_VERBOSE=1`:注入后的 `root=` / `apiBase=` 会打到 **stderr**(不污染协议流)。
|
|
@@ -85,6 +85,7 @@ printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
|
|
|
85
85
|
| `card_read` | 单卡 schema.json + data.json | 直接读盘 |
|
|
86
86
|
| `card_node_models` | **字段结构树**(Task #5 暴露):每节点 `{componentId, className, properties, style, directives, eventactions, components}` | 不支持(需 dev server) |
|
|
87
87
|
| `card_write` | 写回 schema/data;默认自动 `verify`(validate + render_status)一并返回 | 直接写盘 + 本地 Python 硬校验 |
|
|
88
|
+
| `card_rename` | 改本地目录名 `src/cards/<id>` → `<newId>` 并写回 `schema.name/desc`(只改描述时省略 `newId`);**唯一**会同步搬迁对话记录 `.cache/ai-chats/<id>.json`、回合日志 `.cache/ai-turns/<id>.jsonl`、封面 `<id>.png` 与侧车 `.import-meta.json.cardCode` 的改名路径。⚠️ 改名后**后续所有调用必须改用返回的新 id**,旧 id 已不存在;`schema.pageId`(远端身份)不变 | 直接改盘(同一份 `renameCard` 实现) |
|
|
88
89
|
| `card_validate` | Python 硬契约校验 `{ok, errors, warnings}` | 直接跑 Python |
|
|
89
90
|
| `card_render_status` | SSR 自检:结构统计 + `bindingErrors` / `runtimeErrors` / `jsapiCalls` | 不支持 |
|
|
90
91
|
| `card_screenshot` | 无头截图(json `{base64}` / png 图片) | 优先 dev server;未起时降级到包内独立离线渲染器(返回 `source:'standalone'`),渲染器也失败才报 `dev-server-required` |
|
|
@@ -93,6 +94,18 @@ printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
|
|
|
93
94
|
| `card_sync` | 从 FinMall 远端拉最新卡写回 `src/cards/` | 不支持 |
|
|
94
95
|
| `card_save` | 把卡片经已登录浏览器写回 FinMall(IDC10010) | 不支持 |
|
|
95
96
|
| `card_route_input` | **建卡输入形态判定**(Workflow D):`kind`(`meaxure-export` / `ui-bundle` / `card-dir` / `image` / `unknown`)+ `evidence` 判定证据 + `next` 下一步命令 + `preprocess`(是否需要先跑 sketch-spec-to-card、稿名、产物路径) | 纯离线(无需 dev server) |
|
|
97
|
+
| `card_scaffold` | 新建卡骨架双模:`intent`(`blank`/`list`/`detail`/`form`/`dialog`/`tab`/`canvas-head` 的合法最小骨架,`data.json` 由 `inputParams` 反推自洽)或 `from`(整卡模板克隆,只重写 pageId/name,版式纪律与绑定范式原样继承);返回 `{ok, id, dir, intent 或 from, note?}` | 纯离线(无需 dev server) |
|
|
98
|
+
| `card_add_component` | 向指定**容器**节点(有 slots,或 ListLayout/GridLayout)的默认插槽追加一个合法最小组件;返回 `{ok, inserted:{componentId, className, parentId, parentClassName}, setProps, dir, validate}` —— 插完即离线跑 Python 硬校验并带回。纪律:只增不改、不重排 componentId、不碰孤儿字段 | 纯离线(无需 dev server) |
|
|
99
|
+
| `card_import_meta` | 单卡的「导入来源」侧车(Phase E 可追溯性):`{source, interface, baseUrl, appId, workspaceId, cardId, cardCode, cardName, syncedAt, tool, dirty, lastExport}`,据此判断这张卡是否从远端同步来、何时导入、上次导出读回校验是否通过;无侧车(本地新建 / 未同步)返回 `{error:"import-meta not found"}`。只读,不污染 DSL | 不支持(需 dev server) |
|
|
100
|
+
| `card_slice_upload` | 把该卡引用的本地切图(`src/slices`)经已登录浏览器上传到 FinMall 图片库(CC0000.do),写「本地文件 ↔ 线上地址」映射 `src/slices/manifest.json`,并把 schema/data 里的 `"/slices/<name>"` 改写为 `@filestore/…`;按 sha256 判重,内容未变的切图复用已有地址不重复上传,本地切图真源保留不动 | 不支持(需 dev server **且**已登录 FinMall) |
|
|
101
|
+
|
|
102
|
+
> **分工提示**:`card_scaffold` / `card_add_component` 属**生成侧**(P5 脚手架),权威用法在
|
|
103
|
+
> `dsl-card-generator`(其 SKILL.md §8 Workflow 0 是建卡入口路由的准绳)。本技能只在 Workflow D
|
|
104
|
+
> 判完输入形态后把生成工作**交接**过去,不在「读 → 改 → 写回」的编辑闭环里调它们。
|
|
105
|
+
>
|
|
106
|
+
> `card_slice_upload` **仅按需调用、不存在自动上传**:推版本 / 出真机预览前,若卡片仍引用
|
|
107
|
+
> `/slices/`,先跑本工具,否则线上卡片取不到图。`card_import_meta` 是只读侧车,用于回答
|
|
108
|
+
> 「这张卡从哪来、是否已回写」。
|
|
96
109
|
|
|
97
110
|
> 错误归类沿用 `card-runtime` 的 `EVENT_ERROR_KINDS`(customAction / listener / syncRemote / saveCard / refresh)。改卡时重点看 `card_render_status` 的 `bindingErrors`(绑定表达式求值错误明细:path / expr / message)。
|
|
98
111
|
|
|
@@ -205,7 +218,7 @@ node skills/dsl-card-generator/scripts/describe_card.mjs --id <cardId> --json
|
|
|
205
218
|
| `card-dir` | 已存在卡片目录(含 `schema.json`) | 不是建卡是改卡 → 转本技能 Workflow A(修绑定)/ Workflow B(批量改) |
|
|
206
219
|
| `unknown` | 判不出形态(`ok:false`) | **不要猜**:向用户确认输入形态,或让其显式给出 `UI/<画板>/spec.json` 与 `card-N.png` |
|
|
207
220
|
|
|
208
|
-
> **多画板选择门禁(铁律 §十三)**:`meaxure-export` / `ui-bundle` 判定为多画板输入时,**UI 产物可全量生成**(上游前处理一次跑完整份导出),但**产卡必须以单个画板 / 单个 cardKey 为单位**。用户未指定目标画板时:先机械取全量画板(未前处理 → `parse_meaxure.py --src <导出目录> --list`,展示 1 起;已前处理 → `manifest.json` 的 `canvases[]` + `clusters.json` 的 `cards[]`),按 **`1..n` 编号列出 + 末尾追加
|
|
221
|
+
> **多画板选择门禁(铁律 §十三)**:`meaxure-export` / `ui-bundle` 判定为多画板输入时,**UI 产物可全量生成**(上游前处理一次跑完整份导出),但**产卡必须以单个画板 / 单个 cardKey 为单位**。用户未指定目标画板时:先机械取全量画板(未前处理 → `parse_meaxure.py --src <导出目录> --list`,展示 1 起;已前处理 → `manifest.json` 的 `canvases[]` + `clusters.json` 的 `cards[]`),按 **`1..n` 编号列出 + 末尾追加 `全部`**;**没有弹选项工具**(不存在 `request_user_input`,**不要去调用或寻找**),一律在正文列出清单 + 一句纯文本提问后**停止输出、等用户回序号**再继续。**UI 产物可回 `全部` 全量生成**;**产卡默认单画板 / 单 cardKey**,用户回 `全部` 才视为显式批量授权——**禁止**自行挑画板、禁止未经同意批量 `card_write`。系统级选择弹窗不可实现,「正文列清单 / 停下等序号」即等价物;清单**逐行配图**(每画板行下紧跟它自己的预览图绝对路径,缺图显式标缺失,禁止把图堆在清单末尾),转给用户时逐条内联 Markdown 图片看图选。
|
|
209
222
|
|
|
210
223
|
### 6.3 交接生成与收口
|
|
211
224
|
|
|
@@ -37,8 +37,9 @@ description: 生成、编辑并以 AI 辅助 FinMall/YNet 低代码卡片 schema
|
|
|
37
37
|
10. **标注 + 图像交叉验证(模型多模态能力)**:生成卡片时必须**同时读取 spec.json 标注和 card-N.png 聚焦截图**——标注提供精确数值(坐标/字号/颜色),图像提供视觉真相(相对位置/留白/层级关系)。两者冲突时标注优先但标记缺陷;标注缺失时从图像推断(如垂直居中推算 Tab 高度 = 文字高度 + 上下间距 × 2)。详见 `references/ui_fidelity_rules.md §8`。
|
|
38
38
|
11. **透明度禁止表达式(铁律 R57)**:移动端渲染不支持 `style.other.opacity` 走表达式(`itemValueFrom:"1"`),预览构建产物更是完全不消费组件级 opacity(截图查不出来)。透明度需随状态变化时走**固定范式**:按用到的透明度取值生成等量**静态变体节点**,统一套一层 Row/Column 容器——**容器宽高 = 被展示节点宽高 + `other.overflow:"hidden"`**,**点击等事件挂在容器上**,变体用**互斥 v-show** 显隐切换实现视觉透明度变化。lint `r57-opacity-expression` ERROR;机械改写 `scripts/apply_opacity_pattern.mjs --id <卡id>`。详见 `recipes.md §17` / `recipe_snippets/opacity-switch.json`(serviceEvaluation 为首个落地卡)。
|
|
39
39
|
12. **非 UI 变更不做视觉验证(铁律)**:视觉验证(`render_card.mjs` / `card_screenshot` / Playwright 截图)只在变更会改变画面时做。改 `inputParams` / 绑定表达式取值逻辑 / `eventactions` 事件代码 / `data.json` / 文档脚本 → 只跑 validate + lint + `derive_data_json --check`,再用**单元断言**收口(`evalExpr` 比对表达式返回值;`new Function(code).call(假 this)` 跑 customAction 断言 `state`,`code` 与 `compiled` 两份都要跑)。改 `style.*` / 节点增删移动 / 静态文案 / 图片资源 / v-show 条件 → 才做视觉收口。边界:改动副作用会改变布局几何(文案变长换行、`width:"100%"` 内容变长、v-show 改变可见节点集合)时仍按 UI 变更处理。详见 `references/rules.md §七.1`。
|
|
40
|
-
13. **画板聚焦(多画板必须先选卡,铁律 §十三)**:设计稿含多个画板而用户未指定目标时——**UI 产物允许全量生成**(sketch-spec-to-card 管线一次跑完全部画板),但**卡片生成必须以单个画板 / 单个 UI 产物为单位**:先用 `parse_meaxure.py --src <导出目录> --list`
|
|
40
|
+
13. **画板聚焦(多画板必须先选卡,铁律 §十三)**:设计稿含多个画板而用户未指定目标时——**UI 产物允许全量生成**(sketch-spec-to-card 管线一次跑完全部画板),但**卡片生成必须以单个画板 / 单个 UI 产物为单位**:先用 `spec_tree.mjs --list-cards <UI目录>`(按「画板序号.卡片序号」展开每个画板下的卡片)或 `parse_meaxure.py --src <导出目录> --list` / `UI/<稿名>/manifest.json`(`canvases[]`)/ `clusters.json`(`cards[]`)机械取全量画板,按 **`画板序号.卡片序号` 编号列出(序号 1 起;一个画板含 N 张卡则展开为 K.1 ~ K.N,详见 §13.4)+ 末尾追加一项 `全部`**;**让用户选的方式 = 正文里逐条写出清单 + 一句明确提问,然后停止输出、等用户回序号再继续**——编辑器助手面板**没有**弹选项工具(不存在 `request_user_input`,**不要去调用或寻找它**),更不要替用户挑;宿主若自带同名工具才可优先弹选项,但那不是前提,不要依赖。**UI 产物允许回 `全部` 全量生成**(sketch-spec-to-card 管线整份导出全跑);**卡片生成默认以单个画板 / 单个 cardKey 为单位**,用户回 `全部` 才视为显式批量授权(交付说明产了几张卡)。**禁止**自行挑画板、**禁止**未经同意批量产卡、**禁止**「先建一张看看」。系统级弹窗不可实现,「正文列清单 + 兜底 `1..n + 全部` → 停下等序号」即等价物;清单**逐行配图**(每画板行下紧跟它自己的预览图绝对路径,缺图显式标缺失,禁止堆末尾),转给用户时逐条内联 Markdown 图片看图选。详见 `references/rules.md §十三`。
|
|
41
41
|
14. **数字语义变量提取(中文+数字混排串铁律 §十四)**:每个落盘文本先过 **AI 语义解析**——串里含**运行期数字信息**(金额含千分号 / 笔数 / 利率 / 期限 / 日期等,判定看「数字是否随数据变化」而非「是否含数字」;版本号 / 固定营销话术不提取)时,关键数字抽成 `inputParams` 变量(金额 `type:"number"` + **原始数字** defaultValue),原混排串用**表达式拼接**展示(`'静态文案' + <数字表达式> + '静态文案'`,`itemValueFrom:"1"` + `itemDefaultValue` 兜底);**格式化后带千分号的金额照惯例 = 原始数字变量 + `amount_formatting.md` §3 格式化表达式**(中文前后缀拼在表达式外)。**禁止**整串写死、整串绑一个 string 变量、把格式化串写进字典、正则见数字就拆。lint `r61-text-numeric-literal` 提醒级复核。详见 `references/rules.md §十四`。
|
|
42
|
+
15. **图表绘制层序(铁律 R62)**:Canvas 即时模式后画压先画 → **出码顺序必须 = 底 → 顶**:**坐标系/参考系线条(柱状图网格线与轴线、折线图网格与刻度线、雷达图环与辐射线、环形底环/轨道)最底层 → 数据标记(柱/折线/多边形/扇区/高亮弧)→ 文字标签(轴标签/值标签/中心分数)最上层**。**禁止**「先填充后画网格」反范式;spec 元素顺序不可照抄(标注导出常把网格线排在数据图元之后)。数据标记半透明(spec `opacity<1`)把透明度**乘进颜色/渐变 stop**(代理 ctx 无 `globalAlpha`),底层参考线才透得出来。生成器 `chartBarCanvasCode` 已用 `chartPaintLayers` 强制分层,护栏 `tools/tests/chart-layer-order.test.mjs`。详见 `references/rules.md §十五` / `recipes.md §15/§18`。
|
|
42
43
|
|
|
43
44
|
## 0.5 速查优先
|
|
44
45
|
|
|
@@ -83,7 +84,7 @@ description: 生成、编辑并以 AI 辅助 FinMall/YNet 低代码卡片 schema
|
|
|
83
84
|
- **URL 保留字符必须编码**:扁平文件名中的 `#`、`?` 是 URL 分隔符;写入 schema 前分别转成 `%23`、`%3F`。否则浏览器只请求片段前路径,切图会表现为 404。
|
|
84
85
|
- **仅引用才拷贝**:`generate_cards.mjs` 写卡后自动把**该卡 schema 实际引用**的切图(遍历 `view` 收集 `/slices/` 引用)扁平汇聚到 `src/slices/`,未引用的切图不落地。全量回归开始时还会先清空 `src/slices` 再重建,杜绝历史残留。
|
|
85
86
|
- **语义化命名(落地即重命名,强制)**:切图名由**实际功能与作用**决定,不由素材原名决定——`<角色><业务对象>[@Nx].png`(`iconArrowRight@3x.png` / `bgCardHeaderDiffuse@3x.png` / `logoBank@3x.png`)。**禁止**沿用设计稿图层名与导出目录前缀(`编组 4.png`、`矩形 4.png`、`8.icon_通用_箭头右@3x.png`、`99.切图_…`)、中文名、空格、副本后缀(`icon (2).png`、`xxx_alt2`)、裸通用名(`icon.png`、`image1.png`)。同一张图**全项目只有一个名字**(不允许一卡一名);改名要成套做(文件名 + 所有卡片 schema/data 引用 + `manifest.json`,用 `lib/slice_dedupe.mjs → rewriteSliceRefs`),禁止新旧并存。上游 `UI/<画板>/slices/` 保留导出原名作来源证据。lint `r59-slice-semantic-name` 告警。详见 `references/slices_convention.md §1.1`。
|
|
86
|
-
- **落地前判重:已存在则直接引用,不重复导入(强制)**:拷贝进 `src/slices/` 前必须判重——**内容 sha256
|
|
87
|
+
- **落地前判重:已存在则直接引用,不重复导入(强制)**:拷贝进 `src/slices/` 前必须判重——**内容 sha256 是字节级快路径**(一致即同图 → 复用既有文件 + 把引用改写到既有名,不新增副本);sha 未命中必须再做**像素容差判重**(裁切派生图与导出资产/已重命名共用切图像素同内容但字节不同,`lib/slice_pixels.mjs`);按名查找走 manifest 别名(`renamedFrom`/`mergedFrom`)。尺寸 w×h / 字节数只作快速预筛,来源只作辅助证据与命名依据。派生裁切先按指纹分组、再逐组像素复用(`spec_audit.mjs` / `crop_slices.mjs`,pitfalls §15)。`expand_ir.mjs`(`syncReferencedSlices`)与 `generate_cards.mjs`(`collectSlicesToSrcSlices`)已机械执行并回写 schema/data;lint `r60-slice-duplicate-content` 兜底,`lint_card.mjs --all | grep r60` 列全仓重复组。存量教训:`src/slices/` 60 个文件仅 50 份唯一内容(7 组同图多名),已用 `scripts/slices_normalize.mjs --write` 归一化收敛(改名 + 合并副本 + 成套改写引用/manifest,默认 dry-run 可复查)。详见 `references/slices_convention.md §3.1`。
|
|
87
88
|
- **上传去重:共用切图只上传一次(强制)**:`slice_upload.mjs` 按内容 sha256 判重且**不认文件名**——多卡共用同一张图只上传一次,其余卡引用改写为**同一个** `@filestore/...` 地址;同内容不同名的副本、同批次内的同内容文件也复用(`manifest.json` 记 `reusedFrom`),**绝不为同一张图产生第二个线上地址**(`--force` 才重传)。上传复用是兜底,真正的去重在落地阶段完成。详见 `references/slices_convention.md §3.2` + `skills/finmall-card-sync/SKILL.md`「幂等与共享切图」。
|
|
88
89
|
- **本地预览可访问**:自包含 `vendor/vite.config.mjs` 与 `scripts/render_card.mjs` 把 `/slices/*` 映射到宿主 `src/slices/*`,离线截图可直接加载卡片切图,无需先同步远端;宿主若另有 dev server(如 cardbuddy:8787)也只需挂载同款 `/slices/*` 静态中间件。
|
|
89
90
|
- **导出目录切图(`99.切图/*`)不渲染**:MeaXure 导出会在图层里塞入 `99.切图/...` 组(导出清单/占位,非卡片内容),几乎每张卡都有。渲染阶段(`buildLeaf`、`imageFromSlice`)跳过图层名以 `99.切图` 开头的 slice,避免凭空注入切换语音/箭头等图标并误引用(曾导致 `切换语音@3x.png` 被 200+ 次错误引用)。过滤只看图层名前缀,不看导出路径。
|
|
@@ -217,7 +218,7 @@ node scripts/route_input.mjs <用户给的输入路径> [--json] # 传目录
|
|
|
217
218
|
>
|
|
218
219
|
> `route_input.mjs` 退出码:0 = 已路由;3 = `unknown`(判不出形态);1 = 用法/路径错误。拿到 `unknown` 时不要猜形态,先向用户确认输入。
|
|
219
220
|
>
|
|
220
|
-
> **多画板选择门禁(铁律 §十三)**:判出 `meaxure-export` / `ui-bundle`(多画板)后,**UI 产物可全量生成**(前处理一次跑完整份导出),但**产卡前必须锁定单个画板 / 单个 cardKey**——用户未指定时先机械列清单(`parse_meaxure.py --src <导出目录> --list`,或 `UI/<稿名>/manifest.json` 的 `canvases[]`、`clusters.json` 的 `cards[]`)按 **`1..n` 编号列出(序号 1 起)+ 末尾追加
|
|
221
|
+
> **多画板选择门禁(铁律 §十三)**:判出 `meaxure-export` / `ui-bundle`(多画板)后,**UI 产物可全量生成**(前处理一次跑完整份导出),但**产卡前必须锁定单个画板 / 单个 cardKey**——用户未指定时先机械列清单(`parse_meaxure.py --src <导出目录> --list`,或 `UI/<稿名>/manifest.json` 的 `canvases[]`、`clusters.json` 的 `cards[]`)按 **`1..n` 编号列出(序号 1 起)+ 末尾追加 `全部`**;**没有弹选项工具**(不存在 `request_user_input`,**不要去调用或寻找**),一律在正文列出清单 + 一句纯文本提问后**停止输出、等用户回序号**。**UI 产物可回 `全部` 全量生成**;**产卡默认单画板 / 单 cardKey**,用户回 `全部` 才算显式批量授权。**禁止**自行挑画板、禁止未经同意批量产卡。选定后再进 Workflow A / A.5。详见 `references/rules.md §十三`。
|
|
221
222
|
|
|
222
223
|
> **快路径总则**:建卡前先 `route_input.mjs <输入路径>` 定入口(`meaxure-export` 必须先经 `sketch-spec-to-card` 前处理,见 Workflow 0),再 `resolve_card_template.mjs <意图>` 查模板库(命中即 `--from` 克隆跳过生成);未命中走 Workflow A 六步闭环——AI 读图 + `spec_tree.mjs` 理解布局 → `scaffold_card.mjs` 出骨架 → `add_component.mjs` 逐区填充 → **validate + lint 双门禁**(结构合法性 + 行为规则零 ERROR)→ `render_diff.mjs` 视觉对比修正(核心闭环)→ 交付。交付时判断:本卡是否首次出现的布局/交互模式?是则跑 `register_card_template.mjs --id <cardId> --check`,确认新颖后经用户同意登记入模板库。改卡用 `add_component.mjs` / `card_node_models` 定位;范式读 `recipe_snippets/`;校验-修复用 `autofix_schema.py` 压成 1 轮。
|
|
223
224
|
>
|
|
@@ -320,6 +321,7 @@ node scripts/preflight.mjs --spec UI/<画板>/spec.json --id <卡id> # 必须
|
|
|
320
321
|
> - **R54**:ListLayout/GridLayout item 事件直接改绑定数据(this.setData/setRootData/state 赋值)→ 铁律要求 `postMessage('globalSet', patch)`(patch 与 setData 入参一致)+ 根节点 onReady `addEventListener('globalSet')` 代写;用 globalSet 但根无监听同样 ERROR(lint 拦截)
|
|
321
322
|
> - **R55**:customAction 事件脚本出现 `$$`(含 `this.state.$$` / `$$.field` / 「$$ 兜底判断」)→ 铁律要求 slotScope item 字段在事件里直接 `this.state.<field>` 读取(平台保证展开到 state),禁止任何 `$$` 写法(lint ERROR 拦截)
|
|
322
323
|
> - **R57**:`style.other.opacity` 用表达式/绑定(`itemValueFrom:"1"`)→ 移动端不支持透明度表达式,必须走透明度切换固定范式(静态变体 ×N + 等宽高 overflow:hidden 容器 + 事件上移 + 互斥 v-show;`apply_opacity_pattern.mjs` 可机械改写)(lint ERROR 拦截)
|
|
324
|
+
> - **R62**:图表 Canvas 把坐标系/参考线(网格线/轴线/雷达环与辐射线/环形轨道)画在数据标记之上 → 铁律要求出码顺序 = 底 → 顶(参考线最底、数据标记居中、文字标签最顶);半透明数据标记把 opacity 乘进颜色/渐变(代理 ctx 无 globalAlpha)(生成器 `chartPaintLayers` 强制分层 + `tools/tests/chart-layer-order.test.mjs` 护栏)
|
|
323
325
|
- **R56**:customAction 事件脚本用 `window.ynet` 前缀或 `typeof window` 存在性守卫调 JSAPI → 铁律要求直接裸调 `ynet.callJSAPI(name, params, cb)`(ynet 为平台注入全局,无需前缀与守卫)(lint ERROR 拦截)
|
|
324
326
|
> - **R49**:inputParams 缺少必填字段(key/name/type/defaultValue/desc/rule/children)→ validate ERROR;expand_ir 自动补全(pitfalls §R49)
|
|
325
327
|
>
|
|
@@ -926,3 +926,123 @@ gen-card-test 第一轮就把收支占比条写成了静态 `43%` / `57%` 的 `D
|
|
|
926
926
|
- **处理**:IR 里直接写语义名(`pi.value: "/slices/iconArrowRight@3x.png"`);机械产线(`sliceRefPath` / v3)产出的导出扁平名属过渡形态,交付前**成套改名**(文件名 + `lib/slice_dedupe.mjs → rewriteSliceRefs` 改写全部卡片 schema/data + 同步 `manifest.json`),**禁止新旧两份并存**。`expand_ir.mjs`(`syncReferencedSlices`)与 `generate_cards.mjs`(`collectSlicesToSrcSlices`)落地时已自动做同内容复用 + 引用回写并打印 `[slices] 内容已存在 → 复用 …`。`crop_slices.mjs --from-audit` 派生的 `_alt` 名内容确实不同(不算重复,见 §13 R-e),但仍是过渡名,建议改成语义名。
|
|
927
927
|
- **验收**:`node scripts/lint_card.mjs --id <卡id>` 无 `r59-slice-semantic-name` / `r60-slice-duplicate-content` 新增告警;`--all | grep r60` 为空;切图上传后 `src/slices/manifest.json` 里同一 sha256 只有一个 `url`(同内容副本记 `reusedFrom`)。
|
|
928
928
|
- **规则详情**:`slices_convention.md §1.1(命名)/ §3.1(落地判重)/ §3.2(上传去重)`;共享实现 `scripts/lib/slice_dedupe.mjs`;上传侧 `skills/finmall-card-sync/scripts/slice_upload.mjs`。
|
|
929
|
+
|
|
930
|
+
## 15. 重复裁切根治:共用切图已落地仍被裁出 `_altN` 副本(2026-09-18 ynet-card 事故)
|
|
931
|
+
|
|
932
|
+
**事故**:新工程 `src/slices/` 已有共用图标(`编组 4.png` 语义重命名为 `icon_arrow_right_add_external.png` 等),AI 建卡仍从设计稿裁出 `编组 4_alt2..alt7.png` 六份副本——其中五份字节级相同,且与已重命名的共用切图同内容。
|
|
933
|
+
|
|
934
|
+
**根因链**(三个缺陷叠加):
|
|
935
|
+
1. `spec_audit.mjs` 的「同一切图复用但内容不同」判定只把每个矩形跟 `rects[0]` 比指纹:内容相同的 5 个矩形各自拿一个 `_altN` 名 → 建议裁 5 张同内容图(应按指纹**分组**,一组一张)。
|
|
936
|
+
2. 派生缺口只做**按名**查找:共用切图语义重命名后名字对不上(`编组 4.png` → `icon_arrow_right_add_external.png`),审计/裁切认不出「内容已存在」→ 重裁。
|
|
937
|
+
3. 判重只信 **sha256 字节**:裁切图与导出资产像素同内容但编码器不同 → sha 不同 → 去重漏判 → 副本进 `src/slices/`。
|
|
938
|
+
叠加伤害:`d435b3c` 把 `expand_ir.mjs` / `add_component.mjs` 的 shebang 撕成 `#` 首行 + `!/usr/bin/env node` 残行、`run_round.mjs` 重复 import → 三个脚本语法错误随 cardbuddy 包发布,去重链路在新工程里根本没跑起来。
|
|
939
|
+
|
|
940
|
+
**根治**(均已落盘):
|
|
941
|
+
- `spec_audit.mjs`:矩形按设计稿指纹**分组**(同组共用一张派生图,`alsoRects`);每组先对既有切图做**像素级复用**(`lib/slice_pixels.mjs → findPixelTwin`,命中 `reuseOf` 不裁切);按名查找走 `manifest.json` 别名(`buildAliasMap`)。
|
|
942
|
+
- `crop_slices.mjs`:落盘前批内判重 + `--reuse-dir`/工程 `src/slices` 像素判重,命中只报 `reused[]`(`引用改绑 /slices/<existing>`)不写盘。
|
|
943
|
+
- `expand_ir.mjs syncReferencedSlices`:sha 未命中补像素级 twin(裁切图 ≡ 已重命名共用切图 → 改写引用不拷贝)。
|
|
944
|
+
- `parse_meaxure.py`:`__artboard_crop__` 按字节 sha 在 crop 目录内去重(`artboard-crop-reused`)。
|
|
945
|
+
- 语法回归修复 + 全仓 `.mjs` 语法扫描进交付前检查(`for f in $(rg --files -g '*.mjs' skills); do node --check $f; done`)。
|
|
946
|
+
|
|
947
|
+
**纪律**:`_altN` 只允许表示「同名切图在设计稿里确实标到了内容不同的多组位置」;**任何**派生/拷贝动作落盘前必须先过内容判重(sha → 像素容差 → 都不命中才写新文件)。看到 `src/slices/` 出现同内容多份 = 链路缺陷复发,先修链路再清存量(`slices_normalize.mjs --dedupe --write`)。
|
|
948
|
+
|
|
949
|
+
|
|
950
|
+
## 16. 图表矢量簇(柱状图)回放:flex 原生优先、Canvas 仅兜底(2026-09-18,r213-r221 沉淀,r242-r247 升级见 §19)
|
|
951
|
+
|
|
952
|
+
**事故**:综合推荐/保险保障卡的柱状图(窄柱 + 网格线 + 轴标签/值标签)在 spec 里是纯矢量
|
|
953
|
+
shape/text,DSL 无图表组件,生成器此前把柱体静默丢弃、网格线当 Divider 错排——整块图表区
|
|
954
|
+
(约占卡高 25%)像素全错,position 分崩塌。
|
|
955
|
+
|
|
956
|
+
**规则(spec_to_schema_v3.mjs 已实现,纯几何判定)**:
|
|
957
|
+
- `detectChartClusters`:同基线(底沿 ±3)窄柱(宽 4-48 / 高 4-260 / 圆角 <8)≥4 根 + 横向近等距
|
|
958
|
+
+ 网格线(h≤2 且与柱区横向重叠 ≥60%)≥3 或簇内标签 ≥4 → 判为柱状图簇;
|
|
959
|
+
- 整簇(柱 + 网格线 + 簇 bbox 扩边内的文本标签)从通用文本/形状流摘出,改由一个 Canvas
|
|
960
|
+
(`rect` = 簇 bbox,`flexShrink:0`)在 onMeasured 里按簇内相对坐标回放:柱 = 四角 arc 拼路径
|
|
961
|
+
(预览器白名单**无 roundRect**)+ `fill()`;网格线 = `moveTo/lineTo/stroke`;标签 = `fillText`
|
|
962
|
+
(`textAlign/textBaseline` 按标注);渐变柱用 `createLinearGradient` + 原生 `addColorStop`。
|
|
963
|
+
- **绘制层序(铁律 R62)**:出码顺序 = 底 → 顶——绘图区底板 → 网格线/轴线(`stroke`)→ 数据柱/多边形(`fill`)→ 文字标签。spec 元素顺序常把网格线排在柱之后(assetAllocRadar 雷达 34-39 网格、40 数据多边形),照抄会把参考线盖在数据上;`chartBarCanvasCode` 已用 `chartPaintLayers` 强制分层(任一维 ≤2px 细线 = 参考线、覆盖簇 bbox 一半以上的填充 = 底板、其余 = 数据标记),数据标记 `opacity<1` 时把透明度乘进颜色/渐变(代理 ctx 无 `globalAlpha`)。
|
|
964
|
+
- 簇必须登记 `addSemanticBound(y, y+height, container=true)`:Canvas 是流内真实高度,不登记则
|
|
965
|
+
下文所有 section 的顶距从更早的底沿起算(实测下一节被推偏 200+px)。
|
|
966
|
+
|
|
967
|
+
**预览器 ctx 铁律(本次最大坑)**:`event.canvas` 是**画布包装对象**而不是 ctx!必须先
|
|
968
|
+
`var cv = event.canvas.getContext('2d')` 拿代理 ctx(export-proven 范式见 assetAllocRadar 的
|
|
969
|
+
gaugeCanvas/radarCanvas)。直接把 `event.canvas` 当 ctx 调 `fillRect/arc` 会**静默无输出**
|
|
970
|
+
(不抛错、画布全空白),排查成本极高。另:`canvas.width = event.width` 是 no-op 但无害。
|
|
971
|
+
|
|
972
|
+
**连带护栏(同轮沉淀)**:
|
|
973
|
+
- 列表模板签名护栏:重复行并表前按结构签名(行图标/复合金额对/行右沿/行内操作)取多数签名,
|
|
974
|
+
少数签名行退出 ListLayout——半宽对比面板与全宽产品行曾被并成一表,模板字段错位
|
|
975
|
+
(desc 落 title 槽竖排换行 + 缺键渲染「这是一个文本」占位)且对比块双份渲染。
|
|
976
|
+
- 列表标题桥接 padding:标题与列表之间夹着其它语义块时,标题行**不得**把间距桥接进
|
|
977
|
+
paddingBottom(中间块自己的 semanticTopGap 负责衔接),否则中间块整体下移。
|
|
978
|
+
- 卡底色采样改左右 margin 条带众数:此前采底部 6% 中条,会把「最后一行彩色行壳」误当卡底色,
|
|
979
|
+
整卡被染成行壳色(保险保障卡整卡泛绿事故)。
|
|
980
|
+
|
|
981
|
+
## 17. 列表行壳 / 行右图标 / 面板壳认领(2026-09-18,r226-r236 训练沉淀)
|
|
982
|
+
|
|
983
|
+
**事故**:保险保障卡三行产品行(渐变壳 + 右侧 48px 产品图标)渲染成白底无图标 + 多余分割线;
|
|
984
|
+
修复过程中「我的账户」卡又崩(pos 0.876→0.335)——满宽无圆角纯平填充的**分区背景板**被当行壳认领,
|
|
985
|
+
padRight 被算成 303px 把左栏压没。
|
|
986
|
+
|
|
987
|
+
**规则(spec_to_schema_v3.mjs 已实现)**:
|
|
988
|
+
- **行壳视觉判定 shellVisual**:圆角 ≥4 或带渐变或宽 ≤ 卡宽-8 才算行壳;满宽 + 无圆角 + 无渐变 =
|
|
989
|
+
分区背景板,只参与行高/行顶,不参与底色/内边距/分割线决策。
|
|
990
|
+
- **行内边距按 rowContentRight 推导**(全部行文本 + 左右图标 + 操作件右沿最大值);只按金额/时间
|
|
991
|
+
右沿会把标题行卡的 padRight 算成几百 px。
|
|
992
|
+
- **壳间分离(相邻壳间隙 ≥2)= 设计用间隙分行**:模板不发 Divider,ListLayout `row-spacing` 承间隙中位;
|
|
993
|
+
列表按壳左右沿用 wrap Row 内缩到壳宽。
|
|
994
|
+
- **逐行壳色不同**(蓝/橙/绿 tint):模板背景改绑 `$rowBg`(渐变取 stop 均值近似纯色),静态壳色才用
|
|
995
|
+
applyShellBackground。
|
|
996
|
+
- **行右大图标**(行壳右沿锚定 32-72px 切片/符号)→ `$rightIcon` 数据驱动进 rightRow;
|
|
997
|
+
**icon 内嵌小徽标(¥ 角标)不是行尾 affordance**:逐行 affordance 挂接与 listAffordanceSlice 静态
|
|
998
|
+
兜底都必须按「落在 rightIcon 盒内 ±6」排除,否则徽标挤占左栏宽度致 desc 换行(实测 228px desc 被挤到 207)。
|
|
999
|
+
- **对比面板壳/圆点/状态 tag**:extract 已产出 `formRows[].panelShell/dot/tag` 字段(壳 100-260×48-120
|
|
1000
|
+
圆角填充、label 左 6-14px 圆点、壳内短文本 + 描边小壳),emit 侧几何(壳内左右 padding 与值列对齐)
|
|
1001
|
+
待下一轮标定——**不要**在没量好几何前贸然 emit(r233/r234 实测 pos 崩 0.49 后回滚)。
|
|
1002
|
+
|
|
1003
|
+
## 18. 对比面板并排壳:一壳一行抽取 + 并排合成一条绝对带(2026-09-18,r238-r247 训练沉淀)
|
|
1004
|
+
|
|
1005
|
+
设计稿常见「并排对比小卡」(持仓比例 | 箭头 | 建议比例):壳内左对齐两行(圆点+标签行、金额+状态 tag 行)。
|
|
1006
|
+
- **抽取**:通用「label + 同行右簇 value」配对会**跨壳**把两条标签配成一行(持仓比例↔建议比例)、值行同理,壳底色/圆角/圆点/tag 全丢。故在 labelCands 之前按壳几何预抽取(radius≥4、100-260×48-120、壳内≥2 行文本),每壳一行并消费其文本;同位双层标注(编组+矩形)与内层装饰壳去重保留实体填充 shape。
|
|
1007
|
+
- **emit**:y 带重叠≥50% 的壳合成**一条**带;逐壳成行会把并排面板堆成上下两块(高度翻倍、位置全错,r233 pos 0.487 即此)。带内壳宽/间隙/连接件全部按 spec 几何:壳间 spacer 承设计间隙;跨壳连接件(对比箭头)作**末尾**子节点 + 负 marginLeft 拉回设计 x(末尾保证绘制在两侧壳背景之上),竖直居中于带高。
|
|
1008
|
+
- 值行与**标签文本**左对齐(圆点只缩进标签行):缺这段 line2 内缩金额会顶到壳左沿。
|
|
1009
|
+
- 状态 tag 壳 fill 常报成描边同色(实为浅底):fill 与字色亮度差<0.08 时按描边色 8% tint 还原,否则彩字隐入同色底。
|
|
1010
|
+
|
|
1011
|
+
## 19. 柱状图 flex 原生回放:Canvas 只作兜底(2026-09-18,r242-r247 训练沉淀)
|
|
1012
|
+
|
|
1013
|
+
Canvas 自绘柱状图会让标注文本在组件计数中**消失**(schemaComponents 只数 Text 节点),textComponents 被系统性压低(实测 0.4375),且 canvas 字体渲染与设计稿偏差大。柱状图簇改 flex 原生组件树:
|
|
1014
|
+
- 轴列:Column(space-between, align flex-end) 承刻度文本;绘图区 Row(align flex-end) 按「类目标签中心中点」切槽位;槽内柱列宽=max(柱宽, 值标签宽+4)(渲染字形比标注 rect 略宽,不留余量会折行 h16→30 整列上移 13px),相邻标签水平重叠用负 marginLeft 拉回柱中心;值标签在柱顶之上(Column justify flex-end 流内自然落位)。
|
|
1015
|
+
- 网格线=绘图区**硬停线性渐变背景**(坐标系线条在绘制层最底部,与 R62 同旨);类目行按槽位居中、比柱对宽时撑开 + 负 margin 锚柱对中心 + 槽位列 overflow visible。
|
|
1016
|
+
- 不满足柱状图形态(柱<4 / 网格线<2 / 缺轴或类目标签)才回退 chartBarCanvasCode。
|
|
1017
|
+
|
|
1018
|
+
## 20. 预览渲染器契约四铁律(2026-09-18 实测固化,vendor/preview standalone)
|
|
1019
|
+
|
|
1020
|
+
1. **无绝对定位**:style 解析器只认 rect/flex/background/padding/margin/borderRadius/border/shadow/transform/other;`position` 组被**整体忽略**(AbsoluteLayout 子节点 left/top 全失效、堆在 0,0)。二维散布只能「行 + 负 margin」或「列 + paddingTop」组合表达。
|
|
1021
|
+
2. **overflow 默认 hidden**(parseOther:`t.overflow = e.overflow || 'hidden'`):任何「溢出可见」必须显式 other.overflow=visible;靠溢出叠图的方案默认被裁。
|
|
1022
|
+
3. **负 margin 可用**(margin 组 marginType=1 逐边):flex 行内唯一可重叠/回拉手段;人力卡(holdFinancialProducts 等)亦在用。
|
|
1023
|
+
4. **style 组同名子项唯一**:makeStyle 已带空 backgroundColor/backgroundGradient 子项,绑定值必须**改写**该子项(itemValue=$x + itemValueFrom=1);追加第二个同名子项会让渲染器取到空值/绑定串原样进 doColor → 背景透明(列表逐行壳色 $rowBg 曾因此整片消失,pix 0.237→0.085 即修复此 bug)。
|
|
1024
|
+
|
|
1025
|
+
## 21. 散点带:中心媒体 + 环绕胶囊簇按三列重建(2026-09-18,r250-r255 训练沉淀)
|
|
1026
|
+
- **形态**:≥4 个 pill 按钮(radius≥10、h≤40、有底色/渐变)分 ≥2 行环绕一个近方形中心媒体(雷达/环图裁切图,orphanBlocks 60-200 近方)。「五笔钱」类布局即此。
|
|
1027
|
+
- **根因**:通用按钮行把胶囊 space-between 压成一行截断(ovf 0.808),金额/标签掉进 midAux/footAux 散落错行(v7 AB04 r249 pos 0.532、pix 0.1348)。
|
|
1028
|
+
- **emit**:三列 Column(左/中/右 = pill 中心 vs 媒体左右缘),列宽=成员外接宽,列间**负 marginLeft**(marginType=1!)还原设计水平重叠;列内逐成员成 Row,paddingTop=spec y 差、paddingLeft=成员 x−列min;**列首行顶距相对带顶**(min 全列成员 y)而非列首成员,否则左右列下移偏移丢失。
|
|
1029
|
+
- **胶囊**=Row 壳(底色+透明度烘进 backgroundColor、圆角、固定 w/h)+ 文本 + 行尾箭头切片;justify flex-start + padLeft=文本x−pillx(居中会让文本偏半个箭头宽,校正器被迫整带平移)。
|
|
1030
|
+
- **绑定**:金额 addParam(number)+amountExpr 千分表达式;状态标签 addParam(string)+`$var`;禁裸字面量(lint r61)。
|
|
1031
|
+
- **消费**:pills/金额/标签/中心媒体/箭头切片全部从 sem.buttons、postAmountTexts、orphanBlocks、slices、isolatedBlocks 摘除,防通用通道重影。
|
|
1032
|
+
- 证据:945b562caad1f0f4 r249 pos 0.532/pix 0.1348 → r255 pos 0.897/pix 0.0685 全门禁过;anchor r256 44/44 0 回归。
|
|
1033
|
+
|
|
1034
|
+
## 22. 段落壳归属:panelRows 让位 richBlock,尾部链接行归段落(2026-09-18,r253-r255)
|
|
1035
|
+
- 灰底圆角壳内若含 richBlock 碎片/容器(建议段落类),panelRows 再认领会把壳内链接行(查看详细建议)抢成面板行插到段落**之前**:DOM 顺序颠倒、段落裸排无壳、链接丢箭头。
|
|
1036
|
+
- 判据:panelRows map 内 `richInside`(shell 内含 blk.container 或任一 fragment)→ return null 让壳;richBlock emit 末尾补**尾部链接行**(壳内、段落底沿之下的文本 + 行尾箭头切片),壳 paddingBottom 重算到链接行底。
|
|
1037
|
+
- 证据:945b562caad1f0f4 r249 建议段落 dy=491、查看详细建议 dy=360 顺序颠倒 → r253 归位。
|
|
1038
|
+
|
|
1039
|
+
## 23. 行锚点认几何、行尾切片随行(2026-09-18,r252-r253)
|
|
1040
|
+
- **aux 行锚点**:midAux/footAux 的 justify 不能只认 textAlign——标注 textAlign=right 但几何中心在卡左 1/3 的链接文案(添加外部资产)会被甩到右缘;textAlign 描述盒内对齐不是行锚点 → 几何中心 relX<0.4 强制 flex-start + padLeft=spec x−卡左。
|
|
1041
|
+
- **行尾随切片**:文本右邻 8-32px 小切片(箭头/ⓘ,右距 ≤56px、竖直中心对齐)必须随行 append 并消费(appendInlineTrailSlice),否则掉进孤立媒体兜底渲染成独立行,撑高头部并推偏下文节奏。midAux/footAux/散点胶囊/richBlock 链接行统一接入。
|
|
1042
|
+
- **margin 组逐边负值必须 marginType='1'**:只设 marginLeft 不设 marginType 时渲染器按统一 margin 解析,负值静默失效(散点带列重叠全丢、R/C 列右漂 43px,r253→r254)。新增负 margin 点位必伴 marginType。
|
|
1043
|
+
|
|
1044
|
+
## 24. 评分仪表盘路由:拆分标注识别 + 零流高叠放(2026-09-18,r258-r261)
|
|
1045
|
+
- 弧矢量 shape(Combined Shape 环)无渲染通道、分数文本无语义归属 → 仪表盘整块静默丢失(comp/pixel 双扣)。recipe `canvas-gauge-score.json` 早已存在但无路由。
|
|
1046
|
+
- **识别兼容拆分标注**:allTexts 里「70分」常被拆成 大号纯数字(fs≥20) + 同基线右邻「分」单位两个条目;判据 = 数字 + 单位 + 下方 fs≤13 标签,三者均未被任何通道消费。allTexts 条目是归一化形状(顶层 fontSize/color + sourceEl),几何/样式必须双源回退(anyRect/anyFs/anyColor),只认 rect()/textStyle 会全 null 静默跳过。
|
|
1047
|
+
- **零流高叠放**:仪表盘与金额行竖直重叠 → 行 marginTop=semanticTopGap(gy)、marginBottom=−(84+顶距)(marginType=1),流式高度归零不推偏头部;addSemanticBound(container=true) 让带内行忽略该边界、带下行以其底沿为间距基准。
|
|
1048
|
+
- Canvas 出码按 `self.state.score/scoreLabel` 字面读:变量被 uniqueKey 重命名(命名冲突)时放弃仪表盘,禁改出码。
|
|
@@ -22,12 +22,14 @@
|
|
|
22
22
|
- 绝对布局容器自身高度必须 ≥ 子内容最大下沿,否则裁切。
|
|
23
23
|
|
|
24
24
|
## 3. Canvas 约束(画图表必读)
|
|
25
|
+
- **`event.canvas` 是画布包装对象,不是 ctx**:onMeasured 里必须 `var cv = event.canvas.getContext('2d')` 拿代理 ctx 再画图。把 `event.canvas` 当 ctx 直接调 `fillRect/arc/fillText` 会静默无输出(不抛错、整块空白)——r214 实测踩坑。白名单方法见 `card-editor/runtime/canvas-context.js` DESCRIPTORS:**无 roundRect/quadraticCurveTo**,圆角矩形用四角 `arc` 拼路径;渐变对象是原生对象,`addColorStop` 可直接用。
|
|
25
26
|
|
|
26
27
|
- ctx 是**代理对象**,只代理白名单方法(vendor canvas-context.js DESCRIPTORS):
|
|
27
28
|
- **禁 `save/restore/scale/transform/translate/drawImage`** —— 落到原生 ctx 会因 this 绑定抛 `Illegal Invocation`。
|
|
28
29
|
- 需要变换效果时用数学等价实现(如弧线角度换算,不要 rotate)。
|
|
29
30
|
- `canvas.width = event.width` 赋值是 **no-op**(底层 buffer 已由 doPaint 按 dpr 设好)——写了无害但别依赖。
|
|
30
31
|
- 坐标系 = 设计稿 px,**不要乘 DPR**。
|
|
32
|
+
- **图表绘制层序(铁律 R62)**:坐标系 / 参考系线条(柱状图网格线与轴线、折线图网格与刻度线、雷达图环与辐射线、环形底环/轨道)画在**最底层**,数据标记(柱 / 折线 / 多边形 / 扇区 / 高亮弧)在其上,文字标签最上层。Canvas 是即时模式绘制——后画的压先画的,**出码顺序必须 = 底 → 顶**;spec 元素顺序不可照抄(标注导出常把网格线排在数据图元之后)。数据标记半透明(spec `opacity<1`)时把透明度**乘进颜色/渐变 stop**(代理 ctx 无 `globalAlpha`),底层参考线才透得出来(assetAllocRadar 雷达 0.8 实例)。
|
|
31
33
|
- **Canvas 字体可用真实系统字体族**:`ctx.font='500 28px "Helvetica Neue", "PingFang SC", sans-serif'`。设计稿特殊字体(Helvetica Neue 等 macOS 系统字体)按 spec 字体族直写;CJK 字符自动回落到栈中后序字体。
|
|
32
34
|
- Canvas 读的卡片数据走 `self.state.xxx`(闭包别名 `this` / `self` / `that` / `_this` 均可)。
|
|
33
35
|
lint 的 `unused-input-param` 已把事件脚本里的 `<别名>.state.x` / `<别名>.data.x` 计入引用,
|
|
@@ -52,3 +54,11 @@
|
|
|
52
54
|
- **量化先行**:凡「渲染与设计不一致」的判断,先用 `scripts/diff_bands.mjs`(文本带/总高/底色量化比对)或像素测量证实,再动手改。本次 2 次幻影调查("仪表盘镜像"、"字重未生效")均为肉眼误判,合计浪费 ~40min。
|
|
53
55
|
- 弧线/图表类对比:用圆拟合 + 角度分布(黄弧起止角),不要看缩略图感觉。
|
|
54
56
|
- 颜色对比:抽样像素 RGB(容差 ±4),不要凭屏幕观感。
|
|
57
|
+
|
|
58
|
+
|
|
59
|
+
## 渲染器 style 解析契约(2026-09-18 实测,vendor/preview standalone)
|
|
60
|
+
|
|
61
|
+
- 解析组白名单:rect / flex / background / padding / margin / borderRadius / border / shadow / transform / other。**position 组被整体忽略**——AbsoluteLayout 子节点的 left/top 不生效(全部堆叠在 0,0),二维散布只能用「行/列 + 负 margin + paddingTop」表达。
|
|
62
|
+
- other.overflow 缺省为 hidden:需要溢出可见(标签宽于槽位等)必须显式写 other.overflow=visible。
|
|
63
|
+
- margin 组(marginType=1 逐边)支持负值,是 flex 行内唯一回拉/重叠手段。**逐边负值必须显式 marginType='1'**:只写 marginLeft 时渲染器按统一 margin 解析,负值静默失效(散点带列重叠还原全丢,r253→r254 实测)。
|
|
64
|
+
- 同一 style 组内同名子项必须唯一:绑定值改写 makeStyle 自带子项(itemValueFrom=1),追加同名子项会导致取值错乱(背景透明实测)。
|
|
@@ -24,13 +24,14 @@
|
|
|
24
24
|
|---|---|
|
|
25
25
|
| **输入路由(建卡第一步)** | `node scripts/route_input.mjs <输入路径> [--json]`:判输入形态并直接给出下一步命令。`meaxure-export`(Sketch MeaXure 标注导出:index.html + preview/ + assets/)→ **必须先跑 sketch-spec-to-card 前处理**,工具会打印 `parse_meaxure.py --src --draft --build` + `cluster_states.py --out UI/<稿名>` 两条命令(若 `UI/*/manifest.json` 的 `export` 已匹配该导出则跳过前处理、直接给存量产物路径);`ui-bundle` → Workflow A 逐卡;`image` → Workflow A 纯视觉;`card-dir` → Workflow B 改卡;`unknown`(exit 3) → 先问用户别猜。见 SKILL.md §8 Workflow 0 |
|
|
26
26
|
| 秒出合法骨架 | `node scripts/scaffold_card.mjs --intent <blank\|list\|detail\|form\|dialog\|tab\|canvas-head> --id <卡id> --name <名称>` |
|
|
27
|
-
| **列画板 + 选卡门禁(多画板)** | 取清单:未前处理 `python3 skills/sketch-spec-to-card/scripts/parse_meaxure.py --src <导出目录> --list`(**展示 1 起**,传 `--indices` 时 -1);已前处理 `cat UI/<稿名>/manifest.json`(`canvases[].order` **1 起**/`name`/`artboardType`/`status`)+ `clusters.json`(`cards[].cardKey`/`pageId`/`stateNames`/`recommendedBase`)。交互:按 **`1..n` 列出 + 末尾 `全部`** →
|
|
27
|
+
| **列画板 + 选卡门禁(多画板)** | 取清单:未前处理 `python3 skills/sketch-spec-to-card/scripts/parse_meaxure.py --src <导出目录> --list`(**展示 1 起**,传 `--indices` 时 -1);已前处理 `cat UI/<稿名>/manifest.json`(`canvases[].order` **1 起**/`name`/`artboardType`/`status`)+ `clusters.json`(`cards[].cardKey`/`pageId`/`stateNames`/`recommendedBase`)。交互:按 **`1..n` 列出 + 末尾 `全部`** → 一句纯文本提问 → **停止输出等用户回序号**(**没有** `request_user_input`,不要去找弹窗工具)。**清单逐行配图**(每画板行下 `图: <绝对路径>`,缺图标缺失,禁止堆末尾);**机械卡点**:`parse_meaxure.py` 不带范围参数的生成运行直接 **exit 4** 并打印清单;用户回复序号 k → `--indices <k-1>`、「全部」→ `--scope-all`(「全部」只能是用户的回答,Agent 不得默认全量)。**UI 产物可回 `全部` 全量生成;产卡默认单画板 / 单 cardKey,回 `全部` 才算显式批量授权**;禁止自行挑画板。见 `rules.md §十三` |
|
|
28
28
|
| **设计稿层级树(AI 读图)** | `node scripts/spec_tree.mjs --spec UI/<画板>/spec.json [--card 1] [--max-depth 3] [--compact]`:把 `elements` 按矩形包含关系几何重建为 AI 可读的缩进树(类型+名称+尺寸+样式+文案)。Workflow A 步骤 1 用 |
|
|
29
29
|
| **设计稿 vs 渲染对比(视觉闭环)** | `node scripts/render_diff.mjs --card <卡id> --design UI/<画板>/card-1.png [--out diff.png] [--json]`:并排合成对比图(左=设计稿,右=渲染),Workflow A 步骤 5 核心工具;省略 `--width` 自动读 `schema.view.width` |
|
|
30
30
|
| **一条龙迭代(首选)** | `node scripts/iterate.mjs --ir <IR> --out src/cards/<卡id>/ --design <card-N.png> --width 343 [--spec <spec.json>] [--elements] [--slices-dir <要素包 slices 目录>]`:单进程 expand+lint+preflight+render+pixel-diff(含切图汇聚 + 同内容去重)。结果 JSON 带 `gate`(机器门禁判定)、`pixelDiff.hotspots`(>3% 差异热区,1× 设计 px)、`contentOffset1x`+`contentOffsetHint`(内容整体平移)、`renderImage`(渲染原图)、`lint.warningDetails`、`preflight`、`stalled`(连轮无进展 ⇒ 照 hint 换证据链)。多卡连生成用 `--keep-alive`(stdin 逐行 JSON) |
|
|
31
31
|
| **收敛判定(收尾必跑)** | `node scripts/iterate.mjs --gate --out src/cards/<卡id>/`:读 `.cache/ai-scratch/<卡id>.iterate.json` 做机器判定(match≥95 ∧ heightDelta=0 ∧ widthDelta=0 ∧ \|contentOffset1x\|≤2 ∧ 零 error,且 schema 未在报告后变更),未达标 exit 1。正文只引用它的 verdict,禁止自述「门禁全绿」 |
|
|
32
32
|
| **IR 微调随迭代下发** | `iterate.mjs` 加 `--set 'children.0.children.2.children.1.s.margin.marginTop="7"'`(可重复):点路径(数字段=数组下标)定位 + 原子写回 IR(tmp+rename,崩溃不留半状态),随后照常 expand→lint→render→diff 一次完成。中间路径不存在会响亮报错且不写文件 |
|
|
33
33
|
| **量化偏差比对(防幻影调查)** | `node scripts/diff_bands.mjs --id <卡id> --design <card-N.png> [--tol 2] [--out report.json]`:输出文本带逐条 dy/dh、总高/内容底边/尾部留白、上中下分区主色直方图(背景色错误直接定位分区)。凡「渲染与设计不一致」、或 iterate 报告出现 `stalled` / `heightDelta≠0` / match 卡住,**先跑它拿证据再改**,不要肉眼下结论、不要手写 node -e 像素脚本;已有渲染图可 `--render <png>`(iterate 报告的 `renderImage` 就是现成渲染原图)跳过重渲 |
|
|
34
|
+
| **切图判重三层(强制)** | 落盘/裁切前依次:① sha256 字节;② **像素容差**(裁切图 ≡ 导出资产/已重命名共用切图,`lib/slice_pixels.mjs`);③ 都不命中才写新文件。审计缺口按指纹**分组**派生(同组一张图),`_altN` 仅限真不同内容组;按名查找走 manifest 别名(`renamedFrom`)。见 `slices_convention.md §3.1`、`pitfalls §15` |
|
|
34
35
|
| **数字语义变量提取(中文+数字混排,强制)** | 落盘文本先过 **AI 语义解析**:含**运行期数字**(金额含千分号 / 笔数 / 利率 / 期限;判定看数字是否随数据变化,版本号 / 固定话术不提取)→ 数字抽 `inputParams`(金额 `type:"number"` + 原始数字 defaultValue),混排串用表达式拼接 `'静态文案' + <expr> + '静态文案'`(`itemValueFrom:"1"` + `itemDefaultValue` 兜底);**带千分号金额 = 原始数字变量 + 格式化表达式**(`amount_formatting.md §3.4b`,中文前后缀拼表达式外)。禁止整串写死 / 整串绑 string / 格式化串进字典 / 正则见数字就拆。lint `r61` 提醒级。见 `rules.md §十四` |
|
|
35
36
|
| **切图命名 + 去重(强制)** | 落地名按**实际功能/作用**取语义名(`iconArrowRight@3x.png` / `bgCardHeaderDiffuse@3x.png`),禁止沿用素材原名(中文名 / `编组 N` / `8.icon_通用_…` 导出前缀 / `xxx_alt2` 副本后缀)。拷进 `src/slices/` 前按**内容 sha256** 判重:命中即复用既有文件并改写引用(`expand_ir.mjs` / `generate_cards.mjs` 已自动做 + 回写 schema);上传同内容**只传一次**(`manifest.json` 记 `reusedFrom`,共用卡不重复上传)。告警:`node scripts/lint_card.mjs --id <卡id> \| grep -E 'r59\|r60'`;存量清理:`node scripts/slices_normalize.mjs`(默认 dry-run,`--write` 落盘)。见 `slices_convention.md §1.1/§3.1/§3.2` |
|
|
36
37
|
| **设计稿归档(自动)** | 生成时自动把对应 `card-N.png` 复制到卡片目录并重命名为 `<卡id>.png`(UI 原件保留)。`iterate.mjs` 取 `--design` 的 `card-N.png`;`expand_ir.mjs --ir X --out Y --design Z` 可选传入;`generate_cards.mjs` 按多卡序号自动匹配 |
|
|
@@ -195,3 +196,16 @@ $title.length * 16 // 按文字长度算宽度
|
|
|
195
196
|
- **space-between Row 子元素需显式像素宽**:两张并列卡在 Row `justifyContent:"space-between"` 中必须各设显式 `width`(从 spec 读像素值如 `"152"`),不可用 `width:"100%"`——两个 100% 互相挤占溢出。至少一侧设 `flexShrink:"1"` 满足 R35。
|
|
196
197
|
- **对比表行范式**:左值(强调色 `textAlign:"right"` `width:"100%"` `flexShrink:"1"`)+ 中间标签(灰底圆角徽章 `width:"72"` `bg:rgba(245,245,245,1)` `radius:"6"` `flexShrink:"0"`)+ 右值(对比色 `textAlign:"left"` `width:"100%"` `flexShrink:"1"`),父 Row `justifyContent:"space-between"`。
|
|
197
198
|
- **分段标题范式(Divider 居中夹 Text)**:标题如「基本信息」用 Row(`justifyContent:"center"` `alignItems:"center"`)包裹 `Divider(flexShrink:"1")` + `Text(flexShrink:"0", margin:左右8)` + `Divider(flexShrink:"1")`,两条线自适应居中。
|
|
199
|
+
- **柱状图/网格线/轴标签 = Canvas 自绘回放**:DSL 无图表组件,矢量柱体此前被静默丢弃。生成器已按纯几何识别柱状图簇(同基线窄柱 ≥4 + 网格线/标签佐证)整簇交 Canvas 回放;手写时记住 `event.canvas.getContext('2d')` 才是 ctx、白名单无 roundRect(四角 arc 拼路径)、簇高要登记语义边界。详见 `generation_pitfalls.md §16`。
|
|
200
|
+
- **列表行壳/行右图标认领**:行壳 = 圆角≥4 或渐变或宽≤卡宽-8(满宽无圆角平填充=分区背景板,禁认领);壳间有间隙 → 不发 Divider、row-spacing 承间隙、列表按壳宽内缩;逐行壳色不同绑 $rowBg;行右 32-72px 图标 = $rightIcon;icon 内嵌徽标不是 affordance(按 rightIcon 盒排除)。详见 `generation_pitfalls.md §17`。
|
|
201
|
+
- **图表绘制层序(铁律 R62)**:出码顺序 = 底 → 顶——坐标系/参考线(网格线、轴线、雷达环与辐射线、环形轨道)最底层 → 数据标记(柱/折线/多边形/扇区/高亮弧)→ 文字标签最上层;禁止「先填充后画网格」。半透明数据标记把 `opacity` 乘进颜色/渐变(代理 ctx 无 `globalAlpha`)。spec 元素顺序不可照抄。详见 `rules.md §十五`。
|
|
202
|
+
- **重复行并表前先比模板签名**:行图标/复合金额对/行右沿/行内操作不同的行不能进同一个 ListLayout(半宽对比面板混进全宽产品行 → 字段错位竖排换行 + 占位文案 + 双份渲染)。
|
|
203
|
+
- **卡底色看左右 margin**:采样卡底色只信左右边缘条带(内缩壳盖不到),别采底部中条(会采到最后一行彩色行壳)。
|
|
204
|
+
|
|
205
|
+
- 对比面板并排壳:预抽取每壳一行(壳内标签行+值行+圆点+tag),y 带重叠合成一条带;连接件末尾子节点+负 marginLeft;见 pitfalls §18。
|
|
206
|
+
- 柱状图走 flex 原生(轴列+槽位柱列+硬停渐变网格线),Canvas 仅兜底;值标签列宽=标签宽+4 防折行;见 pitfalls §19。
|
|
207
|
+
- 渲染器契约:position 组被忽略(无绝对定位)/overflow 默认 hidden/负 margin 可用(**逐边负值必伴 marginType=1**,否则静默失效)/style 组同名子项唯一(绑定改写不追加);见 pitfalls §20/§23。
|
|
208
|
+
- 散点带(≥4 pill 分 ≥2 行 + 中心近方媒体):三列 Column + 列间负 margin 还原重叠,列内行 paddingTop=spec y 差;胶囊=Row 壳+文本+行尾箭头;金额/标签走变量绑定;见 pitfalls §21 / recipes §18。
|
|
209
|
+
- 半环评分仪表盘(大号数字+「分」单位+下标签,均未被消费)→ Canvas recipe 出码,零流高叠放(marginTop+负 marginBottom,marginType=1);见 pitfalls §24 / recipes §14。
|
|
210
|
+
- 段落壳(灰底圆角含富文本碎片)归 richBlock:panelRows 不认领;尾部链接行(查看详细建议+箭头)随段落壳内补行;见 pitfalls §22。
|
|
211
|
+
- aux 行锚点认 spec x 几何(textAlign=right 但几何在左 1/3 → 左锚);行尾 8-32px 小切片随行消费不孤立成行;见 pitfalls §23。
|
package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/canvas-radar.json
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
"source": "export-proven:assetAllocRadar(radarCanvas 100x100,5 维资产配置雷达)",
|
|
5
5
|
"structureNote": "Canvas rect 固定(如 100x100)+ flexShrink:0,放在 AbsoluteLayout 内用 margin 精确定位;周围维度标签用 label-col-modes 范式另布,不画进 canvas。",
|
|
6
6
|
"dataContractNote": "radarData: array,[{name, ratio}],ratio 0-1,顺序对应顶点角表。",
|
|
7
|
-
"onMeasuredDrawCode": "var self = this;\nvar canvas = event.canvas;\nvar ctx = canvas.getContext('2d');\nctx.imageSmoothingEnabled = true;\nctx.imageSmoothingQuality = 'high';\nvar cx = 50;\nvar cy = 50;\nvar R = 49;\nvar angles = [270, 342, 54, 126, 198];\nfunction pt(a, r) {\n var rad = a * Math.PI / 180;\n return [cx + r * Math.cos(rad), cy + r * Math.sin(rad)];\n}\nvar ratios = [];\nvar rd = self.state.radarData || [];\nfor (var i = 0; i < 5; i++) {\n var v = rd[i] ? Number(rd[i].ratio) : 0;\n ratios.push(isNaN(v) ? 0 : Math.min(Math.max(v, 0), 1));\n}\nvar pts = [];\nvar top = cy;\nvar bottom = cy;\nfor (var i = 0; i < 5; i++) {\n var p = pt(angles[i], R * ratios[i]);\n pts.push(p);\n if (p[1] < top) { top = p[1]; }\n if (p[1] > bottom) { bottom = p[1]; }\n}\nvar grad = ctx.createLinearGradient(0, top, 0, bottom);\ngrad.addColorStop(0, 'rgba(255,132,1,
|
|
8
|
-
"calibrationNote": "顶点角表 [270,342,54,126,198] = 正上起顺时针五等分(标准 canvas 角)。环比例 [1, 0.714, 0.449] 按设计稿实测内环半径÷外环半径。渐变方向按数据多边形包围盒(top→bottom
|
|
7
|
+
"onMeasuredDrawCode": "var self = this;\nvar canvas = event.canvas;\nvar ctx = canvas.getContext('2d');\nctx.imageSmoothingEnabled = true;\nctx.imageSmoothingQuality = 'high';\nvar cx = 50;\nvar cy = 50;\nvar R = 49;\nvar angles = [270, 342, 54, 126, 198];\nfunction pt(a, r) {\n var rad = a * Math.PI / 180;\n return [cx + r * Math.cos(rad), cy + r * Math.sin(rad)];\n}\nctx.strokeStyle = '#DCDCDC';\nvar rings = [1, 0.714, 0.449];\nfor (var k = 0; k < rings.length; k++) {\n ctx.beginPath();\n for (var i = 0; i < 5; i++) {\n var q = pt(angles[i], R * rings[k]);\n if (i === 0) { ctx.moveTo(q[0], q[1]); } else { ctx.lineTo(q[0], q[1]); }\n }\n ctx.closePath();\n ctx.stroke();\n}\nfor (var i = 0; i < 5; i++) {\n var v2 = pt(angles[i], R);\n ctx.beginPath();\n ctx.moveTo(cx, cy);\n ctx.lineTo(v2[0], v2[1]);\n ctx.stroke();\n}var ratios = [];\nvar rd = self.state.radarData || [];\nfor (var i = 0; i < 5; i++) {\n var v = rd[i] ? Number(rd[i].ratio) : 0;\n ratios.push(isNaN(v) ? 0 : Math.min(Math.max(v, 0), 1));\n}\nvar pts = [];\nvar top = cy;\nvar bottom = cy;\nfor (var i = 0; i < 5; i++) {\n var p = pt(angles[i], R * ratios[i]);\n pts.push(p);\n if (p[1] < top) { top = p[1]; }\n if (p[1] > bottom) { bottom = p[1]; }\n}\nvar grad = ctx.createLinearGradient(0, top, 0, bottom);\ngrad.addColorStop(0, 'rgba(255,132,1,0.8)');\ngrad.addColorStop(1, 'rgba(255,232,207,0.8)');\nctx.beginPath();\nfor (var i = 0; i < 5; i++) {\n if (i === 0) { ctx.moveTo(pts[i][0], pts[i][1]); } else { ctx.lineTo(pts[i][0], pts[i][1]); }\n}\nctx.closePath();\nctx.fillStyle = grad;\nctx.fill();\nctx.strokeStyle = 'rgba(255,132,1,0.28)';\nctx.lineWidth = 1;\nctx.stroke();\n",
|
|
8
|
+
"calibrationNote": "顶点角表 [270,342,54,126,198] = 正上起顺时针五等分(标准 canvas 角)。环比例 [1, 0.714, 0.449] 按设计稿实测内环半径÷外环半径。渐变方向按数据多边形包围盒(top→bottom)纵向。层序(铁律 R62):先画网格(环+辐射线)再画数据多边形——参考线永远最底层,数据在上;spec 标注 opacity:0.8 的半透明多边形把透明度乘进渐变/描边色(代理 ctx 无 globalAlpha),网格从多边形下透出来。",
|
|
9
9
|
"notes": "同 canvas-gauge-score 的 ctx 白名单约束;渐变起止色按 spec 标注(本例 rgba(255,132,1,1)→rgba(255,232,207,1))。"
|
|
10
10
|
}
|
package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/scatter-pill-band.json
ADDED
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "散点带:中心媒体 + 环绕胶囊簇(三列负 margin 重建)",
|
|
3
|
+
"when": "≥4 个胶囊按钮(radius≥10、h≤40、底色/渐变)分 ≥2 行环绕一个近方形中心媒体(雷达/环图裁切图);金额+状态标签贴在各自胶囊下方或右邻(「五笔钱」类布局)",
|
|
4
|
+
"source": "train-proven:v7 AB04(945b562caad1f0f4,r250-r261)",
|
|
5
|
+
"structureNote": "Row(band, width100%, align flex-start, padLeft=左列minX) > 3×Column(L/C/R, flexShrink 0, overflow visible, width=成员外接宽);C/R 列负 marginLeft(marginType=1!)= 列minX - 前列右缘,还原设计水平重叠。列内逐成员 Row(flexShrink 0, width=列宽):paddingTop=spec y 差(列首行相对带顶=min 全列成员 y)、paddingLeft=成员x-列min。胶囊=Row 壳(flexShrink 0, 固定 w/h, 底色+透明度烘进 backgroundColor, 圆角) + 文本 + 行尾箭头切片(justify flex-start + padLeft=文本x-pillx;居中会偏半个箭头)。金额行=金额 Text(+gap+标签 Text 同行) 或金额行+标签行(标签比金额低 >14px 时拆两行居中于金额下)。中心媒体 Image 固定 w/h 进 C 列。",
|
|
6
|
+
"dataContractNote": "金额 addParam(number) + amountExpr 千分格式化表达式绑定;状态标签 addParam(string) + $var;胶囊文案 constProp。禁裸字面量金额(lint r61)。",
|
|
7
|
+
"consumptionNote": "检出即消费:pills 出 sem.buttons、金额/标签 出 postAmountTexts、中心媒体 出 orphanBlocks、箭头切片 出 slices+isolatedBlocks;否则通用按钮行/aux 行/孤立媒体兜底重影。",
|
|
8
|
+
"calibrationNote": "列宽与负 margin 全部由 spec 成员外接矩形算出(勿手写);渲染字形比标注 rect 略宽时靠列 overflow visible 溢出,不扩列宽(扩宽会推偏负 margin 链)。",
|
|
9
|
+
"notes": "见 generation_pitfalls §21;margin 逐边负值必须 marginType='1'(§23)。"
|
|
10
|
+
}
|
|
@@ -742,7 +742,7 @@ node scripts/render_card.mjs --id <cardId> --width 375 --out render.png
|
|
|
742
742
|
|
|
743
743
|
要点(export-proven:assetAllocRadar):
|
|
744
744
|
- 顶点角表 `[270,342,54,126,198]`(正上起顺时针五等分);环比例按设计实测(本例 `[1,0.714,0.449]`)。
|
|
745
|
-
- 数据多边形按 ratio
|
|
745
|
+
- 数据多边形按 ratio 缩放顶点半径;**绘制层序(铁律 R62):先画网格(环 + 辐射线)再画数据多边形**——参考线永远最底层、数据在上(Canvas 后画压先画,出码顺序 = 底 → 顶)。spec 标 `opacity:0.8` 的半透明多边形把透明度乘进渐变 stop 与描边色(代理 ctx 无 `globalAlpha`),网格从多边形下透出来——设计稿正是这个效果。
|
|
746
746
|
- 渐变沿数据包围盒纵向:`createLinearGradient(0, top, 0, bottom)`。
|
|
747
747
|
- 维度标签**不画进 canvas**,用 §16 标签列范式环绕布局,数据驱动。
|
|
748
748
|
|
|
@@ -795,3 +795,45 @@ node scripts/apply_opacity_pattern.mjs --id <cardId> --node comp_8 --container C
|
|
|
795
795
|
验证口径:**预览器不消费组件级 opacity**(截图看不出透明度差异),视觉效果只能真机核对;预览侧验证「结构等价」——改写前后 `render_card.mjs` 截图应逐字节一致(serviceEvaluation 已验证:10 个表情 Image 改写前后 default/选中态渲染均 byte-identical)。
|
|
796
796
|
|
|
797
797
|
完整可复制子树见 `recipe_snippets/opacity-switch.json`(serviceEvaluation 表情档实例)。
|
|
798
|
+
|
|
799
|
+
|
|
800
|
+
## 18. 散点带:中心媒体 + 环绕胶囊簇(scatter-pill-band,train-proven:v7 AB04)
|
|
801
|
+
|
|
802
|
+
用途:「五笔钱」类布局——≥4 个胶囊按钮分 ≥2 行环绕中心雷达/环图媒体,金额+状态标签贴胶囊。骨架与消费纪律见 `recipe_snippets/scatter-pill-band.json`,踩坑根因见 pitfalls §21。
|
|
803
|
+
|
|
804
|
+
要点:
|
|
805
|
+
- 三列 Column + 列间**负 marginLeft(marginType=1)**还原水平重叠;列宽=成员外接宽,溢出靠 overflow visible。
|
|
806
|
+
- 列内行 paddingTop=spec y 差、**列首行相对带顶**;胶囊=Row 壳+文本+行尾箭头(左锚不居中)。
|
|
807
|
+
- 金额/标签走变量绑定(千分表达式/字符串变量);检出即消费 pills/金额/标签/媒体/箭头防重影。
|
|
808
|
+
|
|
809
|
+
## 19. 柱状图 Canvas 自绘回放(bar-chart replay,export-proven 同族:assetAllocRadar gauge/radar)
|
|
810
|
+
|
|
811
|
+
设计稿出现「同基线窄柱 + 水平网格线 + 轴/值标签」的柱状图 → DSL 无图表组件,用一个 Canvas
|
|
812
|
+
按簇 bbox 自绘回放(生成器 `detectChartClusters` + `chartBarCanvasCode` 已自动化;手写范式如下)。
|
|
813
|
+
|
|
814
|
+
机制:
|
|
815
|
+
- Canvas `rect` = 簇 bbox 像素(`flexShrink:"0"`),外层 Row 用 `padding` 把左/顶对齐到 spec 坐标;
|
|
816
|
+
- onMeasured 代码**第一行必须** `var cv = event.canvas.getContext('2d');`(`event.canvas` 是包装对象);
|
|
817
|
+
- 坐标全部相对簇原点;柱 = 圆角顶路径(白名单无 roundRect):
|
|
818
|
+
`rr(x,y,w,h,tl,tr,br,bl)` 用 `moveTo/lineTo/arc/closePath` 拼,再 `cv.fill()`;
|
|
819
|
+
- 网格线 = `strokeStyle` + `lineWidth` + `moveTo/lineTo/stroke`;标签 = `fillStyle` + `font` +
|
|
820
|
+
`textAlign` + `textBaseline='top'` + `fillText`;
|
|
821
|
+
- 簇高必须进语义边界(生成器 `addSemanticBound(y, y+h, true)`),否则下文顶距从更早底沿起算整段推偏。
|
|
822
|
+
- **绘制层序(铁律 R62)**:出码顺序 = 底 → 顶(绘图区底板 → 网格线/轴线 → 柱/折线/多边形 → 轴标签/值标签);生成器 `chartBarCanvasCode` 已用 `chartPaintLayers` 强制分层,手写同口径。半透明数据标记把 `opacity` 乘进颜色/渐变(代理 ctx 无 `globalAlpha`)。
|
|
823
|
+
|
|
824
|
+
```jsonc
|
|
825
|
+
{ "componentId": "canvas_chart", "className": "Canvas",
|
|
826
|
+
"style": { "properties": [
|
|
827
|
+
{ "itemId":"200","itemKey":"rect","itemValue":{},"itemChildren":{ "properties":[
|
|
828
|
+
{ "itemId":"003","itemKey":"width","itemValueFrom":"0","itemValue":"319" },
|
|
829
|
+
{ "itemId":"004","itemKey":"height","itemValueFrom":"0","itemValue":"179" } ] } },
|
|
830
|
+
{ "itemId":"100","itemKey":"flex","itemValue":{},"itemChildren":{ "properties":[
|
|
831
|
+
{ "itemId":"006","itemKey":"flexShrink","itemValueFrom":"0","itemValue":"0" } ] } } ] },
|
|
832
|
+
"eventactions": [ { "event": { "eventKey":"onMeasured", "eventName":"初始化渲染" },
|
|
833
|
+
"action": { "actionType":"customAction", "properties":[
|
|
834
|
+
{ "itemId":"001","itemKey":"function","itemValueFrom":"0",
|
|
835
|
+
"itemValue": { "code": "var self = this;var canvas = event.canvas;var cv = canvas.getContext('2d');cv.clearRect(0,0,event.width,event.height);cv.fillStyle='rgba(252,200,0,1)';cv.beginPath();cv.moveTo(42,83);cv.lineTo(54,83);cv.arc(54,83,2,Math.PI*1.5,Math.PI*2);cv.lineTo(56,148);cv.arc(56,148,0,0,Math.PI*0.5);cv.lineTo(40,148);cv.arc(40,148,0,Math.PI*0.5,Math.PI);cv.lineTo(40,83);cv.arc(42,83,2,Math.PI,Math.PI*1.5);cv.closePath();cv.fill();" } } ] } } ] }
|
|
836
|
+
```
|
|
837
|
+
|
|
838
|
+
数据驱动升级路径:柱高/标签改绑 `$chartBars[i].value` 表达式 + onMeasured 读 `self.state`
|
|
839
|
+
(与 radar 范式同),静态回放仅作为标注缺省值首帧。
|