@qilitt-mickey/vue3-temp-skill 1.1.43 → 1.1.45
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/SKILL.md +1 -0
- package/bin/cli.js +1 -1
- package/mapping/component/button.json +8 -3
- package/mapping/component/card.json +31 -0
- package/mapping/component/input.json +4 -1
- package/mapping/component/pagination.json +34 -0
- package/mapping/component/tag.json +2 -1
- package/mapping/scenes/admin/content.json +34 -6
- package/mapping/scenes/admin/layout.json +15 -5
- package/package.json +1 -1
- package/parser/fixtures/changeset-registry-gap.json +29 -0
- package/parser/fixtures/changeset-v32-fields.json +9 -2
- package/parser/fixtures/registry-bad.json +11 -0
- package/parser/fixtures/registry-sample.json +15 -0
- package/parser/index.js +416 -31
- package/parser/regression.js +30 -6
- package/parser/validator.js +4 -4
- package/references/cobalt-admin-restore.changeset.json +468 -0
- package/references/code-quality.md +8 -3
- package/references/design-apply.md +74 -13
|
@@ -71,9 +71,9 @@ parser match(确定性翻译)→ 施工坐标 → AI 按坐标改代码 →
|
|
|
71
71
|
"position": "right", // 可选:相对方位(left/right/top/bottom)
|
|
72
72
|
"form": "card", // 可选:形态切换(见条目 forms 枚举)
|
|
73
73
|
"style": { "menu_bg": "钴蓝-9" }, // 可选:抽象样式字段(词典 css_vars/custom_style_map key;值 = 语义名或 hex)
|
|
74
|
-
"apply_via": "admin.layout.sidebar.menu", //
|
|
75
|
-
"layer": { "menu_text": "host" }, //
|
|
76
|
-
"structure_ops": [ //
|
|
74
|
+
"apply_via": "admin.layout.sidebar.menu", // 可选:本声明引用的锚点来源条目(缺省 = 自身;值 = 语义 ID,不是选择器)
|
|
75
|
+
"layer": { "menu_text": "host" }, // 可选:落点层级(host 宿主盒 / inner 内层文本盒);可为字符串(整条生效)或「字段 → 层级」对象
|
|
76
|
+
"structure_ops": [ // 可选:结构施工声明(数据 / 结构驱动点位必须给,只写 CSS = 无效声明)
|
|
77
77
|
{ "op": "render_branch", "node": "status_tag", "source": "row.status" }
|
|
78
78
|
]
|
|
79
79
|
}
|
|
@@ -84,7 +84,7 @@ parser match(确定性翻译)→ 施工坐标 → AI 按坐标改代码 →
|
|
|
84
84
|
}
|
|
85
85
|
```
|
|
86
86
|
|
|
87
|
-
**
|
|
87
|
+
** 三个声明维度**(补齐「由哪个通道落地 / 被压时怎么赢 / 需要改结构时落在哪」):
|
|
88
88
|
|
|
89
89
|
| 字段 | 作用 | 值域 |
|
|
90
90
|
|---|---|---|
|
|
@@ -135,7 +135,7 @@ node parser/index.js match --batch <changesets-dir>
|
|
|
135
135
|
|
|
136
136
|
`缺口清单` 只承载第二类,且必须给出点位 ID + 缺失字段名。
|
|
137
137
|
|
|
138
|
-
|
|
138
|
+
**转换计划新增四类输出()**:每条 L1/L2 点位除样式指令外,还会输出——
|
|
139
139
|
|
|
140
140
|
| 输出 | 含义 | 施工含义 |
|
|
141
141
|
|---|---|---|
|
|
@@ -145,9 +145,10 @@ node parser/index.js match --batch <changesets-dir>
|
|
|
145
145
|
| `▸ 前置条件 preconditions` | 值成立依赖的宿主前提 | 施工前必须满足,否则「值对了也不生效」 |
|
|
146
146
|
| `▸ 覆写优先级 priority` | 该点位的提权策略 | 按策略取胜,禁止逐点硬堆 `!important` |
|
|
147
147
|
|
|
148
|
-
**验收基线输出**:转换计划末尾另打印 `=== 验收基线 oracle ===`(效果图路径 +
|
|
148
|
+
**验收基线输出**:转换计划末尾另打印 `=== 验收基线 oracle ===`(效果图路径 + 待比对点位)与 `=== 覆盖率 coverage ===`(登记项 R / 适用 A / 已兑现 C)。有 `oracle` → 落地后必须跑第 6 步 `verify`;缺 `oracle` / `coverage` → 输出提示,把「补基线 / 补登记覆盖率」回流设计侧(场景还原应给)。
|
|
149
|
+
**覆盖率校验**:`coverage.covered` 必须等于 `coverage.applicable`、`gaps` 为空,否则打印缺口清单——`C < A` 即**欠声明**(有规范子项未落进 `changes[]`/`visible`/`pending`),属设计侧交付不完整,必须回流,不得在项目侧"猜着补"。
|
|
149
150
|
|
|
150
|
-
### 第 1 步附加 ·
|
|
151
|
+
### 第 1 步附加 · 挂载点审计(,静态查三类隐性缺口)
|
|
151
152
|
|
|
152
153
|
```bash
|
|
153
154
|
node parser/index.js audit --project <目标项目根目录> [<changeset.json…>]
|
|
@@ -163,6 +164,30 @@ node parser/index.js audit --project <目标项目根目录> [<changeset.json…
|
|
|
163
164
|
|
|
164
165
|
审计报错 = **能力缺口**:当场按 `structure_ops` 补挂载 / 补消费者,交付说明单列申报;不得以「词典没建」为由跳过。审计通过 ≠ 还原达标——**静态审计查不出「值对了、位置不对」**,那要靠第 6 步渲染态验收。
|
|
165
166
|
|
|
167
|
+
### 第 1 步附加(之二)· 登记表覆盖率(子项级细闸 · )
|
|
168
|
+
|
|
169
|
+
组级台账(`restore-checklist`)只能防「整组忘光」;**组内子项**是否被静默丢失,用登记表计数。
|
|
170
|
+
|
|
171
|
+
```bash
|
|
172
|
+
node parser/index.js match <cs.json> --registry <restore-registry.json> # 匹配 + 覆盖率当场重算
|
|
173
|
+
node parser/index.js registry <restore-registry.json> [--verbose] # 只核验登记表对词典的通道就绪度
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
| 量 | 定义 | 谁重算 |
|
|
177
|
+
|---|---|---|
|
|
178
|
+
| **R 登记项** | 登记表条数(= 规范里带样式结论的子项数) | 读表 |
|
|
179
|
+
| **A 适用** | `always:true` 的子项 ∪ 效果图已标注同名 `data-sid` 的子项 | parser 当场算 |
|
|
180
|
+
| **C 兑现** | A 中在 `changes[]` / `visible:false` / `pending[].proposed_id` 出现者 | parser 当场算 |
|
|
181
|
+
| **缺口** | `A − C`,逐条列出 `rule + sid + dims`(同组超过 6 条需加 `--verbose` 展开) | parser 当场算 |
|
|
182
|
+
|
|
183
|
+
**关键口径**:A/C **由 parser 以登记表为权威当场重算,设计侧自报的 `coverage` 数字不参与**——所以「把 applicable 写小」蒙混不过去。有缺口 → `exit 1`,属**交付不完整**,回流设计侧补齐后重跑。
|
|
184
|
+
|
|
185
|
+
另有一项**效果图标注缺口**告警:`always:true` 的子项若在效果图里找不到同名 `data-sid`,基线根本抽不出来(效果图标注粒度必须与登记表同分辨率,否则第 6 步的 oracle 必然残缺)。
|
|
186
|
+
|
|
187
|
+
`registry` 子命令单独回答「这张登记表里有多少必登项在项目侧真有承载字段」:
|
|
188
|
+
- **硬缺口**(引用了词典不存在的点位且未标 `pending`)→ `exit 1`;
|
|
189
|
+
- **通道缺口**(设计侧维度在词典无对应字段)→ 列出,属**项目侧补词典**事项,补齐后还原度才可达 100%。
|
|
190
|
+
|
|
166
191
|
### 第 2 步 · 结构先行(visible / position / form)
|
|
167
192
|
|
|
168
193
|
**先改结构,后改样式**——结构变了选择器才稳定,样式才有处可落。
|
|
@@ -188,7 +213,7 @@ node parser/index.js audit --project <目标项目根目录> [<changeset.json…
|
|
|
188
213
|
- 设计要求换掉出厂卡片容器(去卡片、改通栏、改内部排布)→ **照做,不打折**:页面根声明 `data-content-mode`,把 `data-fill` **平移**到新容器及其「体」层,视觉全落设计层文件。此路径下 `tableHeight` 几何实测照常成立。
|
|
189
214
|
- **双向禁止**:① 以「保高度」为由拒绝改容器/内边距/去卡片(= 放弃设计还原);② 为凑还原效果改写壳层结构层规则、或在视觉层重写/压掉 `[data-fill]` / `.main-content[data-content-mode]`(= 高度链断裂,返工项)。
|
|
190
215
|
|
|
191
|
-
#### 第 2 步附加 · 结构施工(structure_ops
|
|
216
|
+
#### 第 2 步附加 · 结构施工(structure_ops)与优先级策略()
|
|
192
217
|
|
|
193
218
|
**A. 结构施工 `structure_ops`(数据 / 结构驱动点位)**——有些点位**换不掉也写不出来**,因为呈现由数据源或模板结构决定。变更集给出 `structure_ops` 时必须照做,**只写 CSS = 无效声明**:
|
|
194
219
|
|
|
@@ -242,7 +267,16 @@ node parser/index.js audit --project <目标项目根目录> [<changeset.json…
|
|
|
242
267
|
|
|
243
268
|
### 第 3 步附加 · 设计层落点文件(强制)
|
|
244
269
|
|
|
245
|
-
所有「新增的 CSS 规则」一律写入 **`src/styles/design-shell.scss`**(出厂空文件,经 `index.scss` 末位 `@use`
|
|
270
|
+
所有「新增的 CSS 规则」一律写入 **`src/styles/design-shell.scss`**(出厂空文件,经 `index.scss` 末位 `@use` 加载),或写入页面级 `<style scoped>`;**不得**写进 `sidebar.scss` / `element-plus.scss` / `theme.scss` / `lay-*.vue` 等出厂文件去表达某张效果图的结论。
|
|
271
|
+
|
|
272
|
+
⚠ **「末位加载」只决定「同源、同特异度」时的先后,压不过两类对手**——这是「规则明明写了却不生效」的头号成因:
|
|
273
|
+
|
|
274
|
+
| 对手 | 为什么本文件会输 | 取胜方式 |
|
|
275
|
+
|---|---|---|
|
|
276
|
+
| **组件 `<style scoped>`** | Vite 下组件样式在全局样式**之后**动态注入;scoped 选择器末元素带 `[data-v-x]`(按一个类计权)。同特异度时后注入者胜 → 本文件出局 | 提权(≥3 层作用域限定 / 叠加属性伪类)——**不是靠文件顺序** |
|
|
277
|
+
| **出厂规则里的 `!important`** | `!important` 高于任何特异度,提权无效 | 本点位也必须 `!important`,或改走通道变量 |
|
|
278
|
+
|
|
279
|
+
每写一条新规则前,先按第 1 步输出的 `▸ 覆写优先级 priority` 判定对手类型与取胜方式(见下节)。
|
|
246
280
|
|
|
247
281
|
写入纪律:
|
|
248
282
|
|
|
@@ -252,6 +286,27 @@ node parser/index.js audit --project <目标项目根目录> [<changeset.json…
|
|
|
252
286
|
- 出厂 `--vts-theme-menu-active-before` 默认 `transparent` 且无消费者 → 声明 `form=indicator_*` 时必须在此文件内**同时**落地「关胶囊令牌 `menu_active_bg: transparent`」与「新建 `::after` 消费者」,缺一即未施工成功。
|
|
253
287
|
- **自举(项目被还原到出厂时必做,幂等)**:文件不存在 → 新建(仅保留文件头纪律注释,无任何设计结论)+ 在 `src/styles/index.scss` **末位**补 `@use 'design-shell';`(必须末位,靠后置压出厂)。此动作属「补通道」,交付说明单列申报。**文件缺失时径直把设计规则写进 `element-plus.scss` / `sidebar.scss` / `theme.scss` = 污染出厂文件,禁止**(这也是「设计还原度为零」的常见成因:规则无处可落)。
|
|
254
288
|
|
|
289
|
+
### 第 3 步附加(之二)· 覆写优先级消费( 硬步骤)
|
|
290
|
+
|
|
291
|
+
第 1 步输出的 `▸ 覆写优先级 priority` **不是提示,是落地写法的硬要求**。每落一条规则前先按策略决定写法;写法错了,规则就是「写了不生效」。历史缺口「面包屑 `visible:false` 写了 `display:none` 却照旧显示」「页签关闭钮 `opacity` 写了却仍要 hover 才显」全部源于此——两条规则本身都没写错,是**赢了才是硬道理**这一步没人做。
|
|
292
|
+
|
|
293
|
+
| `priority.strategy` | 对手 | 必须的写法 | 自检判据 |
|
|
294
|
+
|---|---|---|---|
|
|
295
|
+
| `scope_qualified` | 无(词典 selector 已带作用域限定) | 按词典 selector 原样落 | 若实测仍被覆盖 → 升格按 `deep_qualified` 处理 |
|
|
296
|
+
| `deep_qualified` | 组件 `<style scoped>`(平手 + 后注入) | **禁止裸类名**。≥3 层作用域限定(如 `html .a .b`)或叠加属性/伪类;仍平手才对本条补 `!important` | 写前自问:这条与组件 scoped 谁特异度高?**平手即错** |
|
|
297
|
+
| `self_plus_important` | 出厂规则带 `!important` | 本条必须 `!important` + 注释写明「对手带 `!important`」;能改走通道变量时优先改通道 | 只抬特异度无效,别白费 |
|
|
298
|
+
|
|
299
|
+
落地写法模板(每条规则标注来源 + 取胜依据):
|
|
300
|
+
|
|
301
|
+
```scss
|
|
302
|
+
/* <语义 ID> · <变更条目> · 取胜依据:deep_qualified(对手 lay-*.vue scoped) */
|
|
303
|
+
html .navbar .navbar-breadcrumb-wrap {
|
|
304
|
+
display: none; /* visible:false · 存在性收口,不删出厂代码行 */
|
|
305
|
+
}
|
|
306
|
+
```
|
|
307
|
+
|
|
308
|
+
**`!important` 只允许出现在两种情形**:① `strategy = self_plus_important`(对手带 `!important`);② 对手是组件 scoped 且提权后**实测**仍平手。其余一律靠作用域限定解决——逐点堆 `!important` 会让点位互相耦合、副作用累积成漂移,也就是「越改越乱」的机理。
|
|
309
|
+
|
|
255
310
|
### 第 4 步 · L3 新模块处理(分级布局)
|
|
256
311
|
|
|
257
312
|
- **L3 是施工指令,不是待办**:词典未命中的点位一律当场落地、交付说明申报「补映射」,不留待确认。新模块按「定制布局」三步走:① 基于全局规范生成结构(继承命名/作用域/组件规范)② 原子层字段(色彩/圆角/组件级)从 `basic/` + `component/` 词典借力 ③ 场景专属点位生成后**立即写入 mapping/ 对应场景域**(临时映射),累计复用 ≥3 次建议升级标准(由人工评审)。
|
|
@@ -263,7 +318,7 @@ node parser/index.js audit --project <目标项目根目录> [<changeset.json…
|
|
|
263
318
|
|
|
264
319
|
- [ ] 变更集外的任何点位**零改动**(diff 只含变更集提到的文件/选择器)
|
|
265
320
|
- [ ] `visible: false` 的模块代码仍存在(只是隐藏)
|
|
266
|
-
- [ ]
|
|
321
|
+
- [ ] **`!important` 使用合规**:新增 `!important` 仅允许两种情形——① 词典 `priority.strategy = self_plus_important`(对手带 `!important`);② 对手为组件 scoped 且提权后**实测**仍平手;且每条带理由注释。其余一律靠作用域限定解决。无内联 style 硬编码色值(全部走变量)
|
|
267
322
|
- [ ] 未修改 `src/components/`(Re* 组件库源码——**底线一**)
|
|
268
323
|
- [ ] 未改动业务逻辑层(API/状态/事件——**底线二**;样式与结构通道内的 DOM 调整除外)
|
|
269
324
|
- [ ] 两层样式全部落在 `style_scope` 作用域内,无全局泄漏
|
|
@@ -286,9 +341,12 @@ node parser/index.js audit --project <目标项目根目录> [<changeset.json…
|
|
|
286
341
|
- 表头 / 行 / 分页都在视口内,仅表格体内滚动,无外层滚动条、无拉伸 / 塌陷 / 双滚动条,`tableHeight > 0`;
|
|
287
342
|
- **结构层 diff 为空**:`lay-content/index.vue` 的 `.main-content[data-content-mode]` 与 `element-plus.scss` 的 `[data-fill]` 未被改动;同时确认没有「为保高度而放弃设计还原」(出厂卡片 / 内边距 / 内部排布原样未动而变更集声明了改动)——两个方向任一命中即返工
|
|
288
343
|
- [ ] **映射通道活性检查(杂必查)**:样式落地引用的每个 CSS 变量必须在项目样式中**存在消费者**(`变量名` 有 `var(--xxx)` 引用点);只定义不消费的变量 = 通道死路,翻译再准也不生效(menu_active_indicator 曾因 --vts-theme-menu-active-before 无消费者而「映射了却没效果」)。施工时 grep 核对,无消费者时改走消费者存在的作用域或补挂载点并申报。
|
|
344
|
+
- [ ] **同权重失效检查( · 专查「写了不生效」)**:逐条核对设计层新增规则是否真能取胜——① 对手是组件 `<style scoped>` 时,本条特异度必须**严格高于**它(**平手即错**,因为组件样式在全局之后注入);② 对手带 `!important` 时本条必须同样 `!important`,或改走通道变量。**判定方法(必须真数,不许目测)**:对每条新规则与其对手分别数出选择器权重,权重相同一律判为「失效」并提权。历史缺口全部命中本项:面包屑 `display:none`(与组件 scoped 同为 0,2,0)→ 照旧显示;页签关闭钮 `opacity`(同为 0,5,0)→ 仍要 hover 才显;页签项 `padding`(对手带 `!important`)→ 无论怎么抬特异度都改不动
|
|
345
|
+
- [ ] **oracle 基线可用性检查**:变更集带 `oracle` 时——① `oracle.mockup` 必须与**本次主题、本次页面**一致(禁止复用异主题效果图:主题错配会让逐点比对必然全红);② `oracle.sids` 与 `changes[]` **双向闭合**:效果图里有、changes[] 未声明 = **欠声明**(该点位永远不可能被还原);changes[] 已声明、效果图无 sid = **无基线**(落地后无法机器验收)。两类出现即回流设计侧补齐,**不得直接开工**(`parser match` 已自动报出)
|
|
289
346
|
- [ ] **dark.scss 暗色同步**:新增视觉规则在 `html.dark` 有对应覆盖
|
|
290
347
|
- [ ] **缺口清单只含意图缺口**:清单每一项都必须是「设计侧未给值 / 值非法」且已注明「回流设计侧补齐」;能力缺口(词典缺 ID / 缺字段枚举 / 缺 form)不得出现在清单里——出现即把可落地项搁置
|
|
291
348
|
- [ ] **台账逐行兑现对账(对账闸门)**:把设计侧交付的提取台账逐行过一遍,每行必须有落地结论——已落地(写明落在哪个文件/选择器)或已入缺口清单(写明缺失字段)。存在「台账有行、落地无结论」的行 = 交付不完整,与红线同级
|
|
349
|
+
- [ ] **登记表覆盖率对账(子项级细闸,)**:带登记表交付时必须跑 `match --registry`——`C = A` 且无缺口才可交付;同时确认无「效果图标注缺口」(`always:true` 子项在效果图上都有同名 `data-sid`)。**禁止采信设计侧自报的 `coverage` 数字**(parser 会当场重算,自报数不参与);缺口逐条点名回流设计侧
|
|
292
350
|
- [ ] **零搁置交付**:最终回复不含「待确认」类停顿项;交付说明的「补映射 / 补通道 / 缺口回流」三段齐全(无内容写「无」)
|
|
293
351
|
- [ ] `node parser/index.js build --dry` 通过(mapping 若有临时新增)
|
|
294
352
|
|
|
@@ -334,7 +392,7 @@ node parser/index.js audit --project <目标项目根目录> [<changeset.json…
|
|
|
334
392
|
## 端到端回归(改 parser/mapping 后必跑)
|
|
335
393
|
|
|
336
394
|
```bash
|
|
337
|
-
node parser/regression.js # 一键跑完 A-
|
|
395
|
+
node parser/regression.js # 一键跑完 A-O 十五步(自动断言退出码与关键输出,任一失败 exit 1 并回显详情)
|
|
338
396
|
npm run regression # 等价写法
|
|
339
397
|
```
|
|
340
398
|
|
|
@@ -350,12 +408,15 @@ node parser/index.js match parser/fixtures/changeset-neg3.json # F. 负例3
|
|
|
350
408
|
node parser/index.js match parser/fixtures/changeset-legacy.json # G. 旧协议:exit 0 + layout 键/schema 历史值两条告警
|
|
351
409
|
node parser/index.js match parser/fixtures/changeset-fullpage-restore.json # H. 整页场景还原样例:exit 0;壳层+内容区全模块 L1 命中;数值字面量(40px 等)透传无 ⚠
|
|
352
410
|
node parser/index.js build --dry # I. 产物链自检
|
|
353
|
-
node parser/index.js match parser/fixtures/changeset-v32-fields.json # J.
|
|
411
|
+
node parser/index.js match parser/fixtures/changeset-v32-fields.json # J. 声明维:exit 0;输出「结构施工 structure_ops」与 layer / apply_via
|
|
354
412
|
node parser/index.js audit --project parser/fixtures/fake-project parser/fixtures/changeset-v32-fields.json # K. 静态审计:夹具项目存在挂载点缺失/死通道 → exit 1
|
|
355
413
|
node parser/index.js verify --oracle parser/fixtures/verify/oracle.json --actual parser/fixtures/verify/actual.json # L. 渲染态验收:夹具含三类故意缺口 → exit 1;归因计数 选择器落空1/权重被压1/语境错位2
|
|
414
|
+
node parser/index.js match --registry parser/fixtures/registry-sample.json parser/fixtures/changeset-registry-gap.json # M. 登记表覆盖率细闸:夹具欠声明 2 条恒存在子项 → exit 1
|
|
415
|
+
node parser/index.js registry parser/fixtures/registry-sample.json # N. 登记表通道核验:点位全部命中 → exit 0;输出含「登记表通道核验」
|
|
416
|
+
node parser/index.js registry parser/fixtures/registry-bad.json # O. 登记表硬缺口:引用不存在且未标 pending 的点位 → exit 1
|
|
356
417
|
```
|
|
357
418
|
|
|
358
|
-
通过标准:regression.js 输出 `A✔ B✔ …
|
|
419
|
+
通过标准:regression.js 输出 `A✔ B✔ … O✔` 且 exit 0;分步跑时各步符合注释预期。夹具含义见各文件 `$comment`。
|
|
359
420
|
|
|
360
421
|
## 配套工具(作者/维护侧)
|
|
361
422
|
|