@qilitt-mickey/vue3-temp-skill 1.1.49 → 1.1.50
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/package.json +1 -1
- package/parser/fixtures/changeset-fullpage-restore.json +56 -2
- package/parser/fixtures/changeset-neg4-g8.json +15 -0
- package/parser/fixtures/changeset-neg5-g8-stub.json +26 -0
- package/parser/fixtures/verify//350/277/220/345/215/225/347/256/241/347/220/206-/351/222/264/350/223/235.html +44 -0
- package/parser/index.js +81 -26
- package/parser/regression.js +21 -5
- package/references/design-apply.md +8 -3
package/package.json
CHANGED
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
{
|
|
2
|
-
"$comment": "端到端示例 ·
|
|
2
|
+
"$comment": "端到端示例 · 整页场景还原（对照效果图逐模块提取的完整交付样例，模拟设计技能真实产出）。G8 模式闸正例：mode=restore + scheme + oracle(含 mockup) + coverage(含 registry) 齐备。覆盖：global 主题 + 壳层全模块 + 列表页全字段 + 表格细粒度点位（操作列形态/状态Tag/金额对齐/缩略图）+ pending 新点位。值口径演示：主题色用语义值（钴蓝-N/错误色）、尺寸用数值字面量（28px/40px 等，设计侧 v1.0 协议第 3 条合法通道）、灰阶用临时主题 hex + notes 申报。业务功能差异（新增运单按钮功能、demo 演示按钮去留）不在本变更集范围，走项目侧业务闭环开发（双层交付）。运行：node parser/index.js match <本文件>（cwd 为 skill 根）。",
|
|
3
3
|
"schema": "design.changeset/1.0",
|
|
4
4
|
"changeset_version": "1.0.0",
|
|
5
5
|
"mapping_version": "1.0.0",
|
|
6
6
|
"scene": "admin",
|
|
7
|
+
"scheme": "default",
|
|
8
|
+
"mode": "restore",
|
|
7
9
|
"layout_type": "vertical",
|
|
8
10
|
"global": {
|
|
9
11
|
"brand_primary": "钴蓝-5",
|
|
@@ -26,12 +28,32 @@
|
|
|
26
28
|
}
|
|
27
29
|
},
|
|
28
30
|
{ "id": "admin.layout.header", "style": { "bg": "#FFFFFF" } },
|
|
29
|
-
{
|
|
31
|
+
{
|
|
32
|
+
"id": "admin.layout.header.lang_switch",
|
|
33
|
+
"form": "inline_switch",
|
|
34
|
+
"suppress": ["icon_only"],
|
|
35
|
+
"style": { "icon_size": "16px", "gap": "8px", "text_font_size": "14px" }
|
|
36
|
+
},
|
|
30
37
|
{
|
|
31
38
|
"id": "admin.layout.header.user_profile",
|
|
32
39
|
"style": { "avatar_width": "28px", "avatar_height": "28px", "avatar_radius": "全圆角", "name_font_size": "14px", "name_font_weight": "中等" }
|
|
33
40
|
},
|
|
34
41
|
{ "id": "admin.layout.tabs", "form": "chrome", "style": { "bg": "#FFFFFF" } },
|
|
42
|
+
{
|
|
43
|
+
"id": "admin.content.table.header_cell",
|
|
44
|
+
"style": { "height": "48px", "bg": "#FAFAFA", "font_weight": "中等" }
|
|
45
|
+
},
|
|
46
|
+
{
|
|
47
|
+
"id": "admin.content.table.cell",
|
|
48
|
+
"style": { "padding_y": "8px", "vertical_align": "middle" },
|
|
49
|
+
"layer": { "padding_y": "inner", "vertical_align": "inner" },
|
|
50
|
+
"suppress_inner": true
|
|
51
|
+
},
|
|
52
|
+
{
|
|
53
|
+
"id": "admin.content.table.cell_status",
|
|
54
|
+
"form": "filled",
|
|
55
|
+
"style": { "bg": "#E8F3FF", "text_color": "钴蓝-5", "radius": "小圆角" }
|
|
56
|
+
},
|
|
35
57
|
{
|
|
36
58
|
"id": "admin.content.page_header",
|
|
37
59
|
"style": { "title_size": "20px", "title_weight": "加粗", "desc_color": "钴蓝-3", "actions_gap": "8px" }
|
|
@@ -56,6 +78,38 @@
|
|
|
56
78
|
{ "id": "component.button.danger", "style": { "bg_color": "错误色", "border_color": "错误色", "text_color": "#FFFFFF" } },
|
|
57
79
|
{ "id": "admin.content.pagination", "style": { "active_bg": "钴蓝-5", "active_color": "#FFFFFF" } }
|
|
58
80
|
],
|
|
81
|
+
"oracle": {
|
|
82
|
+
"mockup": "verify/运单管理-钴蓝.html",
|
|
83
|
+
"sids": [
|
|
84
|
+
"admin.layout.sidebar",
|
|
85
|
+
"admin.layout.sidebar.logo_area",
|
|
86
|
+
"admin.layout.sidebar.menu",
|
|
87
|
+
"admin.layout.header",
|
|
88
|
+
"admin.layout.header.lang_switch",
|
|
89
|
+
"admin.layout.header.user_profile",
|
|
90
|
+
"admin.layout.tabs",
|
|
91
|
+
"admin.content.page_header",
|
|
92
|
+
"admin.content.filter_area",
|
|
93
|
+
"admin.content.table.operation_bar",
|
|
94
|
+
"admin.content.table.operation_column",
|
|
95
|
+
"admin.content.table.area",
|
|
96
|
+
"admin.content.table.header_cell",
|
|
97
|
+
"admin.content.table.cell",
|
|
98
|
+
"admin.content.table.cell_status",
|
|
99
|
+
"admin.content.table.cell_amount",
|
|
100
|
+
"admin.content.table.cell_thumb",
|
|
101
|
+
"component.tag.status",
|
|
102
|
+
"component.button.danger",
|
|
103
|
+
"admin.content.pagination"
|
|
104
|
+
]
|
|
105
|
+
},
|
|
106
|
+
"coverage": {
|
|
107
|
+
"registry": "registry-sample.json",
|
|
108
|
+
"registrable": 6,
|
|
109
|
+
"applicable": 4,
|
|
110
|
+
"covered": 4,
|
|
111
|
+
"gaps": []
|
|
112
|
+
},
|
|
59
113
|
"pending": [
|
|
60
114
|
{
|
|
61
115
|
"proposed_id": "admin.content.page_header.greeting",
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$comment": "G8 模式闸负例：mode=restore 但缺 oracle 与 coverage（伪还原变更集，2026-09-20 事故的机检复现件）。预期：match 打印「G8 模式闸」并 exit 1。与 changeset-pos.json 的区别仅此——mode=restore 却没带基线三件套。",
|
|
3
|
+
"schema": "design.changeset/1.0",
|
|
4
|
+
"changeset_version": "1.0.0",
|
|
5
|
+
"mapping_version": "1.0.0",
|
|
6
|
+
"scene": "admin",
|
|
7
|
+
"mode": "restore",
|
|
8
|
+
"layout_type": "vertical",
|
|
9
|
+
"global": { "brand_primary": "钴蓝-5" },
|
|
10
|
+
"changes": [
|
|
11
|
+
{ "id": "admin.layout.sidebar.menu", "style": { "menu_bg": "钴蓝-9", "menu_active_bg": "钴蓝-5" } },
|
|
12
|
+
{ "id": "component.button.primary", "style": { "bg_color": "钴蓝-5" } }
|
|
13
|
+
],
|
|
14
|
+
"notes": "伪还原变更集：只换主题色就宣称场景还原——没有 oracle 验收基线（还原度不可证明）、没有 coverage 登记表记账（组内子项静默丢失不可数）。G8 之前这类变更集只收软提示、一路绿灯，落地后用户看到「只变了主题、布局细节零变化」。"
|
|
15
|
+
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$comment": "G8 强化负例（二轮）：mode=restore，scheme/oracle/coverage 三个对象都在，但 oracle.mockup 与 coverage.registry 为空串 —— 「有壳无芯」的伪基线：验收抽不出效果图、覆盖率无法以登记表重算。预期：match 打印「G8 模式闸」并 exit 1。与 changeset-fullpage-restore.json 的区别仅在此三处。",
|
|
3
|
+
"schema": "design.changeset/1.0",
|
|
4
|
+
"changeset_version": "1.0.0",
|
|
5
|
+
"mapping_version": "1.0.0",
|
|
6
|
+
"scene": "admin",
|
|
7
|
+
"scheme": "default",
|
|
8
|
+
"mode": "restore",
|
|
9
|
+
"layout_type": "vertical",
|
|
10
|
+
"global": { "brand_primary": "钴蓝-5" },
|
|
11
|
+
"changes": [
|
|
12
|
+
{ "id": "admin.layout.sidebar.menu", "style": { "menu_bg": "钴蓝-9", "menu_active_bg": "钴蓝-5" } }
|
|
13
|
+
],
|
|
14
|
+
"oracle": {
|
|
15
|
+
"mockup": "",
|
|
16
|
+
"sids": ["admin.layout.sidebar.menu"]
|
|
17
|
+
},
|
|
18
|
+
"coverage": {
|
|
19
|
+
"registry": "",
|
|
20
|
+
"registrable": 186,
|
|
21
|
+
"applicable": 4,
|
|
22
|
+
"covered": 4,
|
|
23
|
+
"gaps": []
|
|
24
|
+
},
|
|
25
|
+
"notes": "空壳伪基线：oracle/coverage 对象齐全但 mockup 与 registry 为空。过去只校验『对象是否存在』，这类写法能一路绿灯——效果图无从抽取、A/C 无从重算，『完备性可数』形同虚设。G8 强化后予拦截。"
|
|
26
|
+
}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<!-- G8 模式闸正例配套 · 效果图实物（changeset-fullpage-restore.json 的 oracle.mockup 夹具，非真实交付件）。
|
|
3
|
+
文件名带主题词「钴蓝」（oracle 主题一致性校验依据）；每个 data-sid 对应 oracle.sids。
|
|
4
|
+
文末注释内含 1 个同形 data-sid（parser 剥注释后不计数，验证 §7.1 注释兜底防线）。 -->
|
|
5
|
+
<html>
|
|
6
|
+
<head><meta charset="utf-8"><title>运单管理-钴蓝</title></head>
|
|
7
|
+
<body>
|
|
8
|
+
<div class="sidebar-container" data-sid="admin.layout.sidebar">
|
|
9
|
+
<div class="sidebar-logo" data-sid="admin.layout.sidebar.logo_area">LOGO</div>
|
|
10
|
+
<ul class="el-menu" data-sid="admin.layout.sidebar.menu"><li>菜单项</li></ul>
|
|
11
|
+
</div>
|
|
12
|
+
<header class="navbar" data-sid="admin.layout.header">
|
|
13
|
+
<div class="language-trigger" data-sid="admin.layout.header.lang_switch"><span class="language-icon">中</span><span class="language-text">简体中文</span></div>
|
|
14
|
+
<div class="navbar-right el-dropdown-link" data-sid="admin.layout.header.user_profile"><img alt=""><p>张伟</p></div>
|
|
15
|
+
</header>
|
|
16
|
+
<div class="tags-view" data-sid="admin.layout.tabs"><span class="scroll-item">首页</span></div>
|
|
17
|
+
<main class="app-main">
|
|
18
|
+
<div class="vts-page-header" data-sid="admin.content.page_header"><h2>运单管理</h2></div>
|
|
19
|
+
<div class="filter-area" data-sid="admin.content.filter_area"><input></div>
|
|
20
|
+
<div class="table-area">
|
|
21
|
+
<div class="table-bar" data-sid="admin.content.table.operation_bar"><button>新增运单</button></div>
|
|
22
|
+
<table data-sid="admin.content.table.area">
|
|
23
|
+
<thead>
|
|
24
|
+
<tr>
|
|
25
|
+
<th class="el-table__cell" data-sid="admin.content.table.header_cell">列名</th>
|
|
26
|
+
</tr>
|
|
27
|
+
</thead>
|
|
28
|
+
<tbody>
|
|
29
|
+
<tr>
|
|
30
|
+
<td class="el-table__cell" data-sid="admin.content.table.cell">单元格文本</td>
|
|
31
|
+
<td class="operate" data-sid="admin.content.table.operation_column"><a>查看</a><span class="divider"></span><a>更多</a></td>
|
|
32
|
+
<td class="amount" data-sid="admin.content.table.cell_amount">¥1,280.00</td>
|
|
33
|
+
<td><img class="thumb" data-sid="admin.content.table.cell_thumb"></td>
|
|
34
|
+
<td><span class="tag" data-sid="admin.content.table.cell_status">已签收</span><span class="tag global" data-sid="component.tag.status">状态</span></td>
|
|
35
|
+
</tr>
|
|
36
|
+
</tbody>
|
|
37
|
+
</table>
|
|
38
|
+
<button class="danger" data-sid="component.button.danger">批量删除</button>
|
|
39
|
+
<div class="pagination" data-sid="admin.content.pagination">1 2 3</div>
|
|
40
|
+
</div>
|
|
41
|
+
</main>
|
|
42
|
+
<!-- 注释内同形串（剥注释后不计数）：data-sid="admin.content.page_header" -->
|
|
43
|
+
</body>
|
|
44
|
+
</html>
|
package/parser/index.js
CHANGED
|
@@ -104,7 +104,7 @@ function printHelp() {
|
|
|
104
104
|
|
|
105
105
|
用法：
|
|
106
106
|
node parser/index.js build [--dry] 校验映射表并生成 dist/ 产物
|
|
107
|
-
node parser/index.js match <changeset.json...>
|
|
107
|
+
node parser/index.js match <changeset.json...> 对设计变更集执行三级匹配（可多文件；顶层 mode=restore 时 G8 模式闸强制 oracle.mockup + coverage.registry 齐备）
|
|
108
108
|
node parser/index.js match <cs.json> --registry <reg.json>
|
|
109
109
|
匹配 + 登记表覆盖率当场重算（子项级细闸，有缺口 exit 1）
|
|
110
110
|
node parser/index.js match --batch <dir> 项目级批量匹配：目录下全部变更集 + 跨文件汇总
|
|
@@ -241,6 +241,55 @@ function matchOne(file, dataset, batchSummary, opts = {}) {
|
|
|
241
241
|
console.warn(` ⚠ schema "${changeset.schema}" 为历史值，建议设计侧升级为 "design.changeset/1.0"`);
|
|
242
242
|
}
|
|
243
243
|
|
|
244
|
+
// G8 模式闸（2026-09-20 事故机制化）：变更集顶层 mode 声明交付模式。
|
|
245
|
+
// mode=restore（场景还原）→ oracle + coverage 强制齐备，缺失 = exit 1。
|
|
246
|
+
// 事故背景：还原项目后重跑技能，产出「只换主题色」的轻量变更集却以还原之名交付——
|
|
247
|
+
// 186 条登记表、oracle 基线、coverage 记账全部缺席，parser 只打提示不阻断，一路绿灯
|
|
248
|
+
// 落地后用户看到「只变了主题、布局细节零变化」。教训文档化 ≠ 机器闸门：
|
|
249
|
+
// 「场景还原应给」的软提示升级为「mode=restore 必须给」的硬闸。
|
|
250
|
+
// 二轮强化：oracle/coverage 须有「芯」——oracle.mockup 与 coverage.registry 非空，
|
|
251
|
+
// 堵住空壳伪基线（有对象无内容）继续蒙混。
|
|
252
|
+
// mode 缺省 / mode=design → 维持软提示口径（轻量主题调整等规范设计场景不受影响）。
|
|
253
|
+
const MODES = ["design", "restore"];
|
|
254
|
+
const mode = changeset.mode === undefined || changeset.mode === null ? "design" : changeset.mode;
|
|
255
|
+
if (!MODES.includes(mode)) {
|
|
256
|
+
console.error(`✖ mode 应为 "design" / "restore"，实际 "${mode}"`);
|
|
257
|
+
batchSummary?.invalid.push(path.basename(file));
|
|
258
|
+
if (!batchSummary)
|
|
259
|
+
process.exit(1);
|
|
260
|
+
return;
|
|
261
|
+
}
|
|
262
|
+
if (mode === "restore") {
|
|
263
|
+
// G8 强化（2026-09-20 二轮）：不只看「有没有 oracle/coverage 这两个对象」，
|
|
264
|
+
// 还要看**芯**在不在——oracle.mockup 与 coverage.registry 是基线的两根承重梁：
|
|
265
|
+
// · oracle.mockup 空 → 效果图无从抽取，还原度不可证明；
|
|
266
|
+
// · coverage.registry 空 → A/C 无法以登记表为权威当场重算，自报数字即可蒙混，「完备性可数」形同虚设。
|
|
267
|
+
// 空壳写法（{ oracle:{sids:[]}, coverage:{applicable:0,covered:0} }）过去能一路绿灯，现予拦截。
|
|
268
|
+
const hasStr = v => typeof v === "string" && v.trim().length > 0;
|
|
269
|
+
const missing = [];
|
|
270
|
+
if (!hasStr(changeset.scheme))
|
|
271
|
+
missing.push("scheme（设计方案标识——缺它无法定位「方案 × 场景」的清单 / 登记表，还原范围失去锚点）");
|
|
272
|
+
if (!changeset.oracle || typeof changeset.oracle !== "object")
|
|
273
|
+
missing.push("oracle（验收基线：mockup + sids，效果图即 1:1 的验收凭证）");
|
|
274
|
+
else if (!hasStr(changeset.oracle.mockup))
|
|
275
|
+
missing.push("oracle.mockup（效果图路径——空则基线抽不出来，还原度无从证明）");
|
|
276
|
+
if (!changeset.coverage || typeof changeset.coverage !== "object")
|
|
277
|
+
missing.push("coverage（登记表覆盖率记账：registry + registrable/applicable/covered + gaps）");
|
|
278
|
+
else if (!hasStr(changeset.coverage.registry))
|
|
279
|
+
missing.push("coverage.registry（登记表路径——空则 parser 无法以登记表为权威重算 A/C，自报数字形同虚设）");
|
|
280
|
+
if (missing.length > 0) {
|
|
281
|
+
console.error(`\n✖ G8 模式闸：mode=restore（场景还原）但缺少 ${missing.join(" 与 ")} → 拒绝执行。`);
|
|
282
|
+
console.error(` 场景还原的完备性以登记表覆盖率为分母、以 oracle 为验收基线——缺任一项即「伪还原变更集」：`);
|
|
283
|
+
console.error(` 只换主题色也能一路绿灯落地，但布局细节点位从未被声明，还原度不可证明（2026-09-20 实证事故）。`);
|
|
284
|
+
console.error(` 处置：补齐后重跑；若本次确属轻量主题调整而非场景还原，改 mode="design" 并如实声明。`);
|
|
285
|
+
batchSummary?.invalid.push(path.basename(file));
|
|
286
|
+
if (!batchSummary)
|
|
287
|
+
process.exit(1);
|
|
288
|
+
return;
|
|
289
|
+
}
|
|
290
|
+
console.log(` ✔ G8 模式闸：mode=restore，oracle + coverage 齐备（基线三件套完整）`);
|
|
291
|
+
}
|
|
292
|
+
|
|
244
293
|
// 版本校验（mapping_version 缺失或不匹配 → 拒绝。版本恒定 1.0.0，此校验为破坏性升级保险丝：仅双侧同步升版时才会拦截）
|
|
245
294
|
const versions = new Set(
|
|
246
295
|
Object.values(dataset.files).map(d => d.meta?.version).filter(Boolean),
|
|
@@ -344,8 +393,10 @@ function matchOne(file, dataset, batchSummary, opts = {}) {
|
|
|
344
393
|
}
|
|
345
394
|
|
|
346
395
|
// oracle 验收基线（：设计侧给的效果图 + 待比对点位；项目侧落地后跑 verify 逐点 diff）
|
|
347
|
-
|
|
348
|
-
|
|
396
|
+
// mockup 相对路径解析以「变更集同目录」为第一基准（协议约定 oracle 产物与变更集同目录），
|
|
397
|
+
// 其次 cwd / 技能根（历史行为兼容）。
|
|
398
|
+
checkOracle(changeset, plan, valueDict, { strict: mode === "restore", filePath: file });
|
|
399
|
+
checkCoverage(changeset, { strict: mode === "restore" });
|
|
349
400
|
// 登记表覆盖率（子项级细闸）：以登记表为权威、当场重算 A/C，设计侧自报的 coverage 不参与
|
|
350
401
|
const regGaps = checkRegistryCoverage(changeset, plan, opts);
|
|
351
402
|
if (batchSummary)
|
|
@@ -681,10 +732,13 @@ function priorityRequirement(strategy) {
|
|
|
681
732
|
* 反之声明了却不在 sids 里的点位 → 落地后无法机器验收。
|
|
682
733
|
* 两者都属「交付不完整」，与颜色红线同级，必须回流设计侧补齐。
|
|
683
734
|
*/
|
|
684
|
-
function checkOracle(changeset, plan, valueDict) {
|
|
735
|
+
function checkOracle(changeset, plan, valueDict, opts = {}) {
|
|
685
736
|
const oracle = changeset.oracle;
|
|
686
737
|
if (!oracle || typeof oracle !== "object") {
|
|
687
|
-
|
|
738
|
+
if (opts.strict)
|
|
739
|
+
console.error(`\n✖ mode=restore 下 oracle 缺失（G8 模式闸要求，见变更集校验段）——基线三件套不完整，先回设计侧补齐。`);
|
|
740
|
+
else
|
|
741
|
+
console.log(`\n提示：变更集未提供 oracle 验收基线（场景还原应给）—— 落地后无法做 computed style 逐点比对，还原度不可证明，建议回流设计侧补齐。`);
|
|
688
742
|
return;
|
|
689
743
|
}
|
|
690
744
|
|
|
@@ -737,16 +791,16 @@ function checkOracle(changeset, plan, valueDict) {
|
|
|
737
791
|
);
|
|
738
792
|
// 实物闭合兜底（G3）：带登记表时由 checkRegistryCoverage 做权威实物对账；
|
|
739
793
|
// 未带登记表时此处直接打开 mockup 数 data-sid，防止「sids 自报全绿、实物基线为空」。
|
|
794
|
+
// mockup 路径解析复用 resolveFirstExisting（变更集同目录 → cwd → 技能根）。
|
|
740
795
|
if (!changeset.coverage?.registry && mockup) {
|
|
741
|
-
const
|
|
796
|
+
const mockupPath = resolveFirstExisting(mockup, opts.filePath);
|
|
742
797
|
let physical = null;
|
|
743
|
-
|
|
798
|
+
if (mockupPath) {
|
|
744
799
|
try {
|
|
745
|
-
const stripped = readFileSync(
|
|
800
|
+
const stripped = readFileSync(mockupPath, "utf-8").replace(/<!--[\s\S]*?-->/g, "");
|
|
746
801
|
physical = new Set([...stripped.matchAll(/data-sid\s*=\s*["']([^"']+)["']/g)].map(m => m[1]));
|
|
747
|
-
break;
|
|
748
802
|
}
|
|
749
|
-
catch { /*
|
|
803
|
+
catch { /* mockup 不可读，physical 保持 null */ }
|
|
750
804
|
}
|
|
751
805
|
if (physical) {
|
|
752
806
|
const sidNoPhysical = sids.filter(s => !physical.has(s) && !hiddenOnly.has(s));
|
|
@@ -778,10 +832,13 @@ function checkOracle(changeset, plan, valueDict) {
|
|
|
778
832
|
* 这里只做结构一致性校验：covered 必须等于 applicable、gaps 必须为空。
|
|
779
833
|
* 缺 coverage 时无法判断「是否有组内子项被静默丢失」——属交付完整性的信号缺口。
|
|
780
834
|
*/
|
|
781
|
-
function checkCoverage(changeset) {
|
|
835
|
+
function checkCoverage(changeset, opts = {}) {
|
|
782
836
|
const cov = changeset.coverage;
|
|
783
837
|
if (!cov || typeof cov !== "object") {
|
|
784
|
-
|
|
838
|
+
if (opts.strict)
|
|
839
|
+
console.error(`\n✖ mode=restore 下 coverage 缺失（G8 模式闸要求，见变更集校验段）——186 条登记表口径的完备性无从计数，先回设计侧补齐。`);
|
|
840
|
+
else
|
|
841
|
+
console.log(`\n提示：变更集未提供 coverage 覆盖率记账（场景还原应给）—— 无法判断是否有规范子项被静默丢失，完备性不可数，建议回流设计侧补齐。`);
|
|
785
842
|
return;
|
|
786
843
|
}
|
|
787
844
|
const num = v => (typeof v === "number" && Number.isFinite(v) ? v : null);
|
|
@@ -895,23 +952,21 @@ function checkRegistryCoverage(changeset, plan, opts = {}) {
|
|
|
895
952
|
const declaredSids = new Set(Array.isArray(changeset.oracle?.sids) ? changeset.oracle.sids : []);
|
|
896
953
|
|
|
897
954
|
// 实物闭合：打开 oracle.mockup 这个 HTML，数真实存在的 data-sid（不只看设计侧自报的 oracle.sids）
|
|
955
|
+
// mockup 路径解析复用 resolveFirstExisting（变更集同目录 → cwd → 技能根）。
|
|
898
956
|
const mockupRef = changeset.oracle?.mockup;
|
|
899
957
|
let physicalSids = null;
|
|
900
958
|
let mockupFile = null;
|
|
901
|
-
|
|
902
|
-
|
|
903
|
-
|
|
904
|
-
|
|
905
|
-
|
|
906
|
-
|
|
907
|
-
|
|
908
|
-
|
|
909
|
-
|
|
910
|
-
|
|
911
|
-
|
|
912
|
-
}
|
|
913
|
-
catch { /* 该候选路径不可读，试下一个 */ }
|
|
914
|
-
}
|
|
959
|
+
const mockupResolved = resolveFirstExisting(typeof mockupRef === "string" ? mockupRef : null, opts.filePath);
|
|
960
|
+
if (mockupResolved) {
|
|
961
|
+
try {
|
|
962
|
+
const html = readFileSync(mockupResolved, "utf-8");
|
|
963
|
+
// 先剥离 HTML 注释再数 data-sid：注释内的同形串是说明文字、不是点位。
|
|
964
|
+
// 不剥离 → 注释可「兜住」一个实际缺失的标注，闸门全绿而基线为空（详见 mockup-extraction-spec.md §7.1）。
|
|
965
|
+
const stripped = html.replace(/<!--[\s\S]*?-->/g, "");
|
|
966
|
+
physicalSids = new Set([...stripped.matchAll(/data-sid\s*=\s*["']([^"']+)["']/g)].map(m => m[1]));
|
|
967
|
+
mockupFile = mockupResolved;
|
|
968
|
+
}
|
|
969
|
+
catch { /* mockup 不可读，physicalSids 保持 null */ }
|
|
915
970
|
}
|
|
916
971
|
// 比对基准：优先效果图实物；实物读不到时退化为自报清单（并在下方告警）
|
|
917
972
|
const mockupSids = physicalSids || declaredSids;
|
package/parser/regression.js
CHANGED
|
@@ -15,7 +15,9 @@
|
|
|
15
15
|
* E match 负例2（mapping_version 不符） → exit 1
|
|
16
16
|
* F match 负例3（禁词阻断） → exit 1
|
|
17
17
|
* G match 旧协议兼容 → exit 0 且输出含 ⚠ 告警
|
|
18
|
-
* H match
|
|
18
|
+
* H match 整页场景还原样例（mode=restore）→ exit 0 且输出含 #245BFF 与「G8 模式闸」（壳层+内容区全模块 L1）
|
|
19
|
+
* P match G8 负例（mode=restore 缺 oracle/coverage）→ exit 1 且输出含「G8 模式闸」（伪还原变更集拦截）
|
|
20
|
+
* Q match G8 强化负例（mode=restore 但 mockup/registry 为空壳）→ exit 1 且输出含「G8 模式闸」（有壳无芯伪基线拦截）
|
|
19
21
|
* I build --dry 产物链自检 → exit 0 且输出含 dry-run
|
|
20
22
|
* J match 三声明维度 → exit 0 且输出含「结构施工 structure_ops」
|
|
21
23
|
* K audit 挂载点 / 死通道审计 → exit 1（夹具项目故意存在挂载点缺失 / 死通道）
|
|
@@ -98,10 +100,10 @@ const steps = [
|
|
|
98
100
|
},
|
|
99
101
|
{
|
|
100
102
|
key: "H",
|
|
101
|
-
name: "match
|
|
103
|
+
name: "match 整页场景还原样例（mode=restore 基线三件套 + 壳层+内容区全模块 L1 + 数值字面量透传）",
|
|
102
104
|
script: INDEX,
|
|
103
105
|
args: ["match", path.join(FIXTURES, "changeset-fullpage-restore.json")],
|
|
104
|
-
expect: { code: 0, includes: "#245BFF" },
|
|
106
|
+
expect: { code: 0, includes: ["#245BFF", "G8 模式闸"] },
|
|
105
107
|
},
|
|
106
108
|
{
|
|
107
109
|
key: "I",
|
|
@@ -152,12 +154,26 @@ const steps = [
|
|
|
152
154
|
args: ["registry", path.join(FIXTURES, "registry-bad.json")],
|
|
153
155
|
expect: { code: 1, includes: "硬缺口" },
|
|
154
156
|
},
|
|
157
|
+
{
|
|
158
|
+
key: "P",
|
|
159
|
+
name: "match G8 模式闸负例（mode=restore 缺 oracle/coverage = 伪还原变更集 → exit 1）",
|
|
160
|
+
script: INDEX,
|
|
161
|
+
args: ["match", path.join(FIXTURES, "changeset-neg4-g8.json")],
|
|
162
|
+
expect: { code: 1, includes: "G8 模式闸" },
|
|
163
|
+
},
|
|
164
|
+
{
|
|
165
|
+
key: "Q",
|
|
166
|
+
name: "match G8 强化负例（mode=restore 但 oracle.mockup / coverage.registry 为空壳 = 有壳无芯 → exit 1）",
|
|
167
|
+
script: INDEX,
|
|
168
|
+
args: ["match", path.join(FIXTURES, "changeset-neg5-g8-stub.json")],
|
|
169
|
+
expect: { code: 1, includes: "G8 模式闸" },
|
|
170
|
+
},
|
|
155
171
|
];
|
|
156
172
|
|
|
157
173
|
const results = [];
|
|
158
174
|
let failed = 0;
|
|
159
175
|
|
|
160
|
-
console.log("=== A-
|
|
176
|
+
console.log("=== A-Q 端到端一键回归 ===\n");
|
|
161
177
|
|
|
162
178
|
for (const step of steps) {
|
|
163
179
|
const { status, stdout, stderr } = spawnSync(
|
|
@@ -194,4 +210,4 @@ if (failed > 0) {
|
|
|
194
210
|
console.error(`\n✖ ${failed} 步未通过，见上方详情`);
|
|
195
211
|
process.exit(1);
|
|
196
212
|
}
|
|
197
|
-
console.log("\n✔ A-
|
|
213
|
+
console.log("\n✔ A-Q 全部通过，mapping/parser 可提交或发版");
|
|
@@ -62,6 +62,8 @@ parser match（确定性翻译）→ 施工坐标 → AI 按坐标改代码 →
|
|
|
62
62
|
"changeset_version": "1.0.0", // 恒填 "1.0.0"
|
|
63
63
|
"mapping_version": "1.0.0", // 恒填 "1.0.0"：版本由双侧 SKILL.md 体系版本统一管理，词典不单独演进。parser 校验口径 = 变更集值 ∈ 词典版本集合（恒通过）；仅协议破坏性升级时双侧同步升版
|
|
64
64
|
"scene": "admin", // 场景前缀，须与 mapping 场景域一致
|
|
65
|
+
"scheme": "default", // 方案标识（mode=restore 时必填）：取设计侧 page-specs/styles/registry.json 的方案 id；与 scene 共同定位「方案 × 场景」的清单/登记表
|
|
66
|
+
"mode": "restore", // 交付模式（G8 模式闸）：restore=场景还原（scheme + oracle.mockup + coverage.registry 强制必填）；design=显式声明的轻量微调；缺省 design
|
|
65
67
|
"layout_type": "vertical", // 标准布局枚举：vertical / horizontal / mix（字段名固定 layout_type，非 layout）
|
|
66
68
|
"global": { "brand_primary": "钴蓝-5" }, // 可选：全局令牌通道（整套主题切换优先走此节点；值 = 语义名或临时主题 hex）
|
|
67
69
|
"changes": [
|
|
@@ -190,10 +192,11 @@ node parser/index.js match --batch <changesets-dir>
|
|
|
190
192
|
|
|
191
193
|
| 闸 | 触发条件 | 判据来源 | 违规输出 |
|
|
192
194
|
|---|---|---|---|
|
|
195
|
+
| **G8 模式闸** | 变更集顶层 `mode: "restore"`（场景还原）但基线不全：缺 `scheme` / `oracle` / `coverage`，**或 `oracle.mockup` / `coverage.registry` 为空**（有壳无芯的伪基线）——伪还原变更集（只换主题色却以还原之名交付）拒绝执行；`mode` 非法值同样阻断 | 变更集顶层 `scheme` / `mode` / `oracle.mockup` / `coverage.registry` | `G8 模式闸：mode=restore 但缺少 … → 拒绝执行` |
|
|
193
196
|
| **G1 suppress 收口** | 条目声明某 `form`，词典 `suppress_rules[form]`（或 forms 描述「suppress 必含 x」内联标记）要求收口的出厂互斥通道未全部出现在该条目 `suppress[]` | 词典条目 `suppress_rules` | `suppress 缺口：…必须收口出厂互斥通道 [x]，缺 [x]` |
|
|
194
197
|
| **G5 几何语境** | 词典 preconditions 含「几何语境随值迁移」标记 ∧ `style` 含 padding/margin 族几何字段落宿主 ∧ 未声明 `suppress_inner` | 词典条目 preconditions 标记句 | `suppress_inner 缺口：…两层之和 ≠ 设计值` |
|
|
195
198
|
|
|
196
|
-
|
|
199
|
+
三闸与禁词校验同级阻断（`exit 1`）——「新旧形态叠加」「两层 padding 相加」「伪还原只换主题」都是历史事故源（双竖条、28px 列挤压、「还原后布局细节零变化」），不允许靠观感兜底。G8 判据一句话：**「把系统 / 页面改成 X」默认是还原（restore），必须带齐 `scheme` + `oracle.mockup` + `coverage.registry`；只有「显式声明只改主题色、其它不动」才用 `design`**（2026-09-20 事故机制化：还原项目后重跑，无登记表无基线的轻量变更集一路绿灯，落地后「只变了主题、布局细节零变化」；二轮强化再堵住 `oracle`/`coverage` 只给空壳、无 `mockup`/`registry` 芯的写法）。**降级不许静默发生**：变更集 `notes` 与交付说明都须显式写出本次 `mode` 与范围。
|
|
197
200
|
|
|
198
201
|
**验收基线输出**：转换计划末尾另打印 `=== 验收基线 oracle ===`（效果图路径 + 待比对点位）与 `=== 覆盖率 coverage ===`（登记项 R / 适用 A / 已兑现 C）。有 `oracle` → 落地后必须跑第 6 步 `verify`；缺 `oracle` / `coverage` → 输出提示，把「补基线 / 补登记覆盖率」回流设计侧（场景还原应给）。
|
|
199
202
|
**覆盖率校验**：`coverage.covered` 必须等于 `coverage.applicable`、`gaps` 为空，否则打印缺口清单——`C < A` 即**欠声明**（有规范子项未落进 `changes[]`/`visible`/`pending`），属设计侧交付不完整，必须回流，不得在项目侧"猜着补"。
|
|
@@ -496,7 +499,7 @@ html .navbar .navbar-breadcrumb-wrap {
|
|
|
496
499
|
## 端到端回归（改 parser/mapping 后必跑）
|
|
497
500
|
|
|
498
501
|
```bash
|
|
499
|
-
node parser/regression.js # 一键跑完 A-
|
|
502
|
+
node parser/regression.js # 一键跑完 A-Q 十七步（自动断言退出码与关键输出，任一失败 exit 1 并回显详情）
|
|
500
503
|
npm run regression # 等价写法
|
|
501
504
|
```
|
|
502
505
|
|
|
@@ -518,9 +521,11 @@ node parser/index.js verify --oracle parser/fixtures/verify/oracle.json --actual
|
|
|
518
521
|
node parser/index.js match --registry parser/fixtures/registry-sample.json parser/fixtures/changeset-registry-gap.json # M. 登记表覆盖率细闸：夹具欠声明 2 条恒存在子项 → exit 1
|
|
519
522
|
node parser/index.js registry parser/fixtures/registry-sample.json # N. 登记表通道核验：点位全部命中 → exit 0；输出含「登记表通道核验」
|
|
520
523
|
node parser/index.js registry parser/fixtures/registry-bad.json # O. 登记表硬缺口：引用不存在且未标 pending 的点位 → exit 1
|
|
524
|
+
node parser/index.js match parser/fixtures/changeset-neg4-g8.json # P. G8 模式闸负例：mode=restore 缺 oracle/coverage（伪还原变更集）→ exit 1
|
|
525
|
+
node parser/index.js match parser/fixtures/changeset-neg5-g8-stub.json # Q. G8 强化负例：mode=restore 但 mockup/registry 空壳（有壳无芯伪基线）→ exit 1
|
|
521
526
|
```
|
|
522
527
|
|
|
523
|
-
通过标准：regression.js 输出 `A✔ B✔ …
|
|
528
|
+
通过标准：regression.js 输出 `A✔ B✔ … Q✔` 且 exit 0；分步跑时各步符合注释预期。夹具含义见各文件 `$comment`。
|
|
524
529
|
|
|
525
530
|
## 配套工具（作者/维护侧）
|
|
526
531
|
|