@agile-team/wl-skills-kit 2.1.5 → 2.1.6

package/README.md

@@ -1,6 +1,8 @@
 # @agile-team/wl-skills-kit
 
-**AI Skill 模板包 v2.1.5** — 一条命令将 13 条编码规范、6 个 AI Skill、组件文档、领域样例导入 Vue 3 项目。
+[![npm version](https://img.shields.io/npm/v/@agile-team/wl-skills-kit?label=wl-skills-kit&color=brightgreen)](https://www.npmjs.com/package/@agile-team/wl-skills-kit)
+
+**AI Skill 模板包 v2.1.6** — 一条命令将 13 条编码规范、6 个 AI Skill、组件文档、领域样例导入 Vue 3 项目。
 
 让 AI 编辑器（Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae / 通用 Agents）**真正理解项目规范**，从原型/详设到完整页面代码全流程自动化。
 
@@ -195,7 +197,7 @@ npx @agile-team/wl-skills-kit update
 | `convention-audit` | ✅ 启用    | `skills/core/convention-audit/`          | 13 条规范扫描 + 双报告        |
 | `template-extract` | ✅ 启用    | `skills/core/template-extract/`          | 现有页面 → 领域模板           |
 | `menu-sync`        | ✅ 启用    | `skills/sync/menu-sync/`                 | 菜单基线 ↔ 后端接口          |
-| `dict-sync`        | ⏳ PLANNED | `skills/sync/dict-sync/`                 | 字典基线 ↔ 后端接口          |
+| `dict-sync`        | 🔧 待激活 | `skills/sync/dict-sync/`                 | 字典基线 ↔ 后端接口（API 端点已验证，配置后即用）|
 | `permission-sync`  | ⏳ PLANNED | `skills/sync/permission-sync/`           | 权限基线 ↔ 后端接口          |
 | `code-fix`         | ⏳ PLANNED | `skills/ops/code-fix/`                   | 受控自动修复偏差              |
 
@@ -203,6 +205,24 @@ npx @agile-team/wl-skills-kit update
 
 ---
 
+## AGGrid cid 唯一性规则
+
+> 21 个系统共享同一浏览器 origin（localStorage 共用），cid 碰撞会导致列配置互相覆盖。
+
+```typescript
+// ✅ 正确：Date.now().toString(36) — 毫秒级唯一，永不重复，约 9 位 base-36
+cid="mca-lhfge5hc"                    // 表格级：{页面首字母缩写}-{base36时间戳}
+cid: 'mca-customerName'               // 列级：{表格缩写}-{fieldName}
+
+// ❌ 错误：截断十进制后6位（每11.5天循环一次，且不同页面缩写易碰撞）
+cid="mca-745831"
+```
+
+**Pre-flight 中 AI 自动输出**：`✅ cid 已生成：mca-lhfge5hc（mmwr-customer-archive）`  
+`convention-audit` 遇到旧格式 cid 会标记为 🟡 偏差提示。
+
+---
+
 ## 技能触发 & 验证
 
 > **所有编辑器使用相同的触发词**，无需区分编辑器类型。Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae 读取各自对应的配置文件，内容完全一致，仅 frontmatter 格式不同。
@@ -295,7 +315,8 @@ npx @agile-team/wl-skills-kit update
 | 命令                     | 保护路径                                               | 说明                       |
 | ------------------------ | --------------------------------------------------- | -------------------------- |
 | `init` / `update`        | `.github/reports/*.md`                              | 已存则跳过，不覆盖累积   |
-| `init` / `update`        | `.github/skills/sync/menu-sync/env/env.local.json`  | 已存则跳过，保护用户配置 |
+| `init` / `update`        | `.github/skills/sync/env.local.json`                | 已存则跳过，保护同步配置（菜单+字典+权限统一） |
+| `init` / `update`        | `.github/skills/sync/menu-sync/env/env.local.json`  | 旧版兼容，已存则跳过     |
 | `clean`（默认）          | `src/components/` + `src/types/`                    | 业务代码必需，永不删除     |
 | `clean --keep-reports`   | + `.github/reports/`                                | 保留菜单/字典/权限基线     |
 

package/bin/wl-skills.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * wl-skills-kit CLI v2.1.5
+ * wl-skills-kit CLI v2.1.6
  *
  * 命令:
  *   init      全量安装（默认，向后兼容）
@@ -165,7 +165,8 @@ function isReportFile(relPath) {
 
 // 用户本地配置：init/update 遇到已存在不覆盖（含 token / gatewayPath 等敏感信息）
 const USER_LOCAL_CONFIGS = [
-  ".github/skills/sync/menu-sync/env/env.local.json",
+  ".github/skills/sync/env.local.json",               // 统一配置（v2.1.5+，菜单+字典+权限共用）
+  ".github/skills/sync/menu-sync/env/env.local.json",  // 老版兼容
 ];
 function isUserLocalConfig(relPath) {
   return USER_LOCAL_CONFIGS.includes(relPath);
@@ -318,16 +319,21 @@ function runInstall(incremental) {
 
   // ── Step 1.5: .gitignore 安全修补（防止 env.local.json 意外入 git）────────
 
-  const ENV_LOCAL_GITIGNORE_ENTRY =
-    ".github/skills/sync/menu-sync/env/env.local.json";
+  const ENV_LOCAL_GITIGNORE_ENTRIES = [
+    ".github/skills/sync/env.local.json",               // 统一配置（v2.1.5+）
+    ".github/skills/sync/menu-sync/env/env.local.json", // 老版兼容
+  ];
   const gitignorePath = path.join(TARGET_DIR, ".gitignore");
   if (!dryRun && fs.existsSync(gitignorePath)) {
     const giContent = fs.readFileSync(gitignorePath, "utf8");
-    if (!giContent.includes(ENV_LOCAL_GITIGNORE_ENTRY)) {
+    const missing = ENV_LOCAL_GITIGNORE_ENTRIES.filter(
+      (e) => !giContent.includes(e)
+    );
+    if (missing.length > 0) {
       fs.appendFileSync(
         gitignorePath,
         "\n# wl-skills-kit: 本地敏感配置（token / gatewayPath，不入 git）\n" +
-          ENV_LOCAL_GITIGNORE_ENTRY +
+          missing.join("\n") +
           "\n",
       );
       console.log("  ✔ .gitignore 已追加 env.local.json 保护条目");

package/files/.github/guides/architecture.md

@@ -2,7 +2,7 @@
 
 > **读者**：团队技术负责人 / wl-skills-kit 维护者 / 对体系设计感兴趣的团队成员  
 > **更新方式**：重大架构变更后追加对应章节，旧章节原文保留（历史可溯）  
-> **当前版本**：v2.1.5（2026-04-27）
+> **当前版本**：v2.1.6（2026-04-27）
 
 ---
 

package/files/.github/reports/SYS_DICT_INFO.md

@@ -1,19 +1,50 @@
-# SYS_DICT_INFO — 字典数据汇总 [PLANNED]
+# SYS_DICT_INFO — 字典数据基线
 
-> ⚠️ 本文件为 [PLANNED] 状态。等 `dict-sync` Skill 转正后启用。
->
-> 设计草稿：`.github/skills/sync/dict-sync/SKILL.draft.md`
+> **写入方**：`dict-sync pull` 模式从线上拉取后覆盖；`dict-sync push` 完成后追加新增字典
+> **读取方**：`dict-sync push / audit` 模式对比本地 vs 线上差异
+> **格式约定**：每个字典码一个二级标题块，字典项以表格形式列出
 
 ---
 
-## 预期格式
+## 字典码命名规范
+
+```
+全大写 + 下划线分隔，例如：ORDER_STATUS / SALES_COMPANY / PRODUCT_NAME
+```
 
-```markdown
-| 字典编码 | 字典名称 | 字典项编码 | 字典项名称 | 排序 | 备注 |
-| -------- | -------- | ---------- | ---------- | ---- | ---- |
-| status   | 状态     | 1          | 启用       | 1    |      |
-| status   | 状态     | 0          | 停用       | 2    |      |
+data.ts 中引用方式：
+```typescript
+{ logicType: BusLogicDataType.dict, logicValue: "ORDER_STATUS" }
 ```
 
-写入方：dict-collect Skill（PLANNED）从代码扫描汇总
-读取方：dict-sync Skill（PLANNED）调用后端批量导入接口
+---
+
+## 字典数据
+
+> ⚠️ 基线为空。请执行以下任一方式初始化：
+>
+> 1. **从线上拉取**：对 AI 说「刷新字典基线」→ dict-sync pull 模式自动填充此文件
+> 2. **手动维护**：按以下格式手动添加，后续 push 模式以此为数据源
+
+---
+
+<!-- 以下为示例格式，执行 pull 后将被真实数据替换 -->
+
+<!--
+## ORDER_STATUS（订单状态）
+
+| 值（value） | 显示名称（label） | 排序 | 备注 |
+| ---------- | ---------------- | ---- | ---- |
+| 0          | 草稿             | 1    |      |
+| 1          | 待审核           | 2    |      |
+| 2          | 审核通过         | 3    |      |
+| 3          | 已驳回           | 4    |      |
+
+## SALES_COMPANY（销售公司）
+
+| 值（value） | 显示名称（label） | 排序 | 备注 |
+| ---------- | ---------------- | ---- | ---- |
+| 01         | 华北公司         | 1    |      |
+| 02         | 华南公司         | 2    |      |
+-->
+

package/files/.github/skills/_registry.md

@@ -46,7 +46,7 @@ skills/
 | convention-audit | ✅ 启用    | `skills/core/convention-audit/SKILL.md`      | 规范审计 / 代码审计 / 规范检查 / 对齐规范 / 规范偏差 / 接手新项目 / 存量代码分析 / 项目体检 |
 | template-extract | ✅ 启用    | `skills/core/template-extract/SKILL.md`      | 提取模板 / 抽取模板 / 沉淀模板 / 模板贡献                                  |
 | menu-sync        | ✅ 启用    | `skills/sync/menu-sync/SKILL.md`             | 创建菜单 / 注册菜单 / 同步菜单 / 补菜单                                    |
-| dict-sync        | ⏳ PLANNED | `skills/sync/dict-sync/SKILL.draft.md`       | （草稿，不参与调度）                                                       |
+| dict-sync        | 🔧 待激活 | `skills/sync/dict-sync/SKILL.md`             | 同步字典 / 创建字典 / 刷新字典基线 / 字典对比 / 字典审计（**API 端点确认后自动生效**）|
 | permission-sync  | ⏳ PLANNED | `skills/sync/permission-sync/SKILL.draft.md` | （草稿，不参与调度）                                                       |
 | code-fix         | ⏳ PLANNED | `skills/ops/code-fix/SKILL.draft.md`         | （草稿，不参与调度）                                                       |
 

package/files/.github/skills/core/convention-audit/SKILL.md

@@ -57,7 +57,7 @@ description: "Use when: auditing project source code against the 13 modular stan
 | 09   | TypeScript                   | 滥用 any（>3 处/页） → 🟡                                            |
 | 10   | Pinia                        | data.ts 内 import Store → 🔴                                         |
 | 11   | 表单校验                     | FORM_ROUTE 缺 validate / resetFields → 🔴                            |
-| 12   | BaseTable + cid              | 用 el-table / 缺 render-type / cid 缺失或重复 → 🔴                   |
+| 12   | BaseTable + cid              | 用 el-table / 缺 render-type / cid 缺失或重复 → 🔴；cid 后缀使用旧格式（十进制截断后6位）→ 🟡 提示改为 base-36 完整值 |
 | 13   | 平台组件合规                 | 用 el-form/el-table/el-date-picker 替代封装 → 🔴；3+ 复用 → 提取建议 |
 
 ---

package/files/.github/skills/sync/dict-sync/SKILL.md

@@ -0,0 +1,451 @@
+---
+name: dict-sync
+description: "Use when: syncing data dictionary entries to the backend, pulling the current online dictionary baseline, or checking which dictionaries used in data.ts are missing from the system. Triggers on: 同步字典, 创建字典, 刷新字典基线, 字典对比, 字典审计, dict sync, create dict."
+---
+
+# Skill: 字典同步（dict-sync）
+
+将 `data.ts` 中引用的数据字典（`logicType: BusLogicDataType.dict, logicValue: "DICT_CODE"`）同步到后端字典表，保持本地基线与线上一致。
+
+> **与 menu-sync 的关系**：机制完全对称——同样读取本地基线报告 → 与线上对比 → 补齐差异。  
+> 配置直接复用 `skills/sync/env.local.json` 统一配置文件，无需重复填写。
+
+---
+
+## 配置（统一配置文件，无需重复填写）
+
+读取 `.github/skills/sync/env.local.json`（已在 .gitignore，不入 git）：
+
+```json
+{
+  "gatewayPath": "http://192.168.10.50:9000",
+  "sysAppNo": "QjQuXy1kbKxZyjhS5N2",
+  "token": "eyJhbGci...",
+  "dict": {
+    "moduleId": "7C909G0U2F8HI7E305LV0135LSJ3UBIO"
+  }
+}
+```
+
+`moduleId` 获取方式：进入低代码平台「数据字典」模块 → 新增一条字典 → DevTools Network → 查找 `moduleId` 字段值。
+
+**向下兼容**：如上述文件不存在，回落到 `skills/sync/menu-sync/env/env.local.json`（老版本路径）。
+
+---
+
+## Pre-flight 声明（执行前必须输出）
+
+```
+🚀 已触发技能 dict-sync/SKILL.md → 字典同步
+✅ 已读取 skills/sync/env.local.json   → 网关地址、token、sysAppNo、dict.moduleId
+✅ 已读取 reports/SYS_DICT_INFO.md     → 本地字典基线
+✅ 操作模式：{pull / push / audit}
+✅ 目标字典码：{用户指定 / 从 data.ts 扫描到的字典码列表}
+```
+
+---
+
+## API 调用规范
+
+所有接口使用以下 Headers：
+
+```
+Authorization: Bearer {token}
+Sysappno: {sysAppNo}
+Content-Type: application/json
+```
+
+**成功判断**：`response.code === 2000`  
+**Token 失效**：`code === 401` 或 `code` 不在 `[200, 2000]` 且 message 含 "token" → 停止执行，提示用户更新 token。
+
+---
+
+## 三种工作模式
+
+### pull — 刷新本地基线
+
+**触发词**：`刷新字典基线` / `拉字典`
+
+```
+调用 GET {gatewayPath}/system/business/dict/getDictionaryTreeData
+→ 解析 data.data.dictionary.children（递归，无 children 的节点为字典叶节点）
+→ 整理为 SYS_DICT_INFO.md 格式覆盖写入
+→ 输出：共拉取 N 个字典码，M 个字典项
+```
+
+**接口**：
+```
+GET {gatewayPath}/system/business/dict/getDictionaryTreeData
+Headers:
+  Authorization: Bearer {token}
+  Sysappno: {sysAppNo}
+```
+
+**响应结构**：
+```json
+{
+  "code": 2000,
+  "data": {
+    "dictionary": {
+      "children": [
+        {
+          "id": "节点ID",
+          "strSn": "字典编码或模块编码",
+          "strName": "字典名称",
+          "children": [...]
+        }
+      ]
+    }
+  }
+}
+```
+叶节点（无 `children`）= 实际字典，取其 `id`（用于后续创建字典项）和 `strSn`。
+
+---
+
+### push — 推送新增字典（核心模式）
+
+**触发词**：`同步字典` / `创建字典` / `补字典`
+
+#### Step 1：扫描 data.ts 中的字典引用
+
+从用户指定范围扫描所有：
+```typescript
+logicType: BusLogicDataType.dict, logicValue: "DICT_CODE"
+```
+收集所有 `logicValue` 值去重，得到「当前用到的字典码集合」。
+
+#### Step 2：与本地基线 + 线上对比（去重双保险）
+
+```
+① 读取 reports/SYS_DICT_INFO.md → 已知字典码（本地已记录，大概率线上有）
+② 调用 getDictionaryTreeData → 当前线上实际存在的字典码（strSn 列表）
+③ 待创建 = 用到的字典码 - 线上已有字典码
+```
+
+> **多人协同说明**：每人各自的 env.local.json 不入 git，各人用自己的 token。  
+> 去重通过 Step ② 线上实时查询保证：A 创建了，B 运行时线上已有，自动跳过，**不会重复创建**。  
+> 即使极端并发（两人同一秒执行），后端 `strSn` 字段有唯一约束，第二次创建会返回"已存在"，Skill 将其视为成功跳过。
+
+#### Step 3：Pre-flight 输出清单，等待确认
+
+```
+📋 待同步字典清单：
+  新建：ORDER_STATUS（订单状态）— 含 4 项
+  新建：SALES_COMPANY（销售公司）— 含 3 项
+  跳过（线上已有）：PRODUCT_SEGMENT
+
+确认执行？(yes/no)
+```
+
+#### Step 4：创建字典码
+
+```
+POST {gatewayPath}/system/business/dict/save
+Headers: Authorization / Sysappno / Content-Type
+
+Body:
+{
+  "strSn": "ORDER_STATUS",
+  "strName": "订单状态",
+  "intIsVisible": 1,
+  "intSort": 0,
+  "moduleId": "{dict.moduleId}"
+}
+```
+
+成功后再次调用 `getDictionaryTreeData` 获取新创建字典的 `id`（用于下一步）。
+
+#### Step 5：创建字典项
+
+**逐条**调用（服务端会跳过重复的 strKey）：
+
+```
+POST {gatewayPath}/system/dictDtl/save
+Headers: Authorization / Sysappno / Content-Type
+
+Body:
+{
+  "strKey": "1",
+  "strValue": "待审核",
+  "strSn": "ORDER_STATUS",
+  "dictId": "{上一步获取的字典 id}"
+}
+```
+
+#### Step 6：输出结果表 + 更新基线
+
+| 字典码 | 字典名称 | 字典项数 | 状态 |
+|--------|---------|---------|------|
+| ORDER_STATUS | 订单状态 | 4 | ✅ created |
+| SALES_COMPANY | 销售公司 | 3 | ✅ created |
+| PRODUCT_SEGMENT | 产品板块 | - | ⏭️ skipped（线上已有） |
+
+执行完成后，将新建字典追加写入 `reports/SYS_DICT_INFO.md`。
+
+---
+
+### audit — 仅检查，不调接口
+
+**触发词**：`字典审计` / `检查字典`
+
+```
+1. 扫描指定范围的 data.ts，收集所有 logicValue 字典码
+2. 对比 SYS_DICT_INFO.md 本地基线
+3. 输出三类：
+   ✅ 已在基线中（无需操作）
+   ⚠️ data.ts 中用到但不在基线中（建议执行 push）
+   💤 在基线中但未被任何 data.ts 使用（可能已废弃）
+4. 不调用任何接口
+```
+
+---
+
+## SYS_DICT_INFO.md — 本地基线格式
+
+路径：`.github/reports/SYS_DICT_INFO.md`
+
+```markdown
+## ORDER_STATUS（订单状态）
+
+| 值（strKey） | 显示名称（strValue） | 备注 |
+| ----------- | ------------------- | ---- |
+| 0           | 草稿                |      |
+| 1           | 待审核              |      |
+| 2           | 审核通过            |      |
+```
+
+**字典码命名规范**：全大写 + 下划线，如 `ORDER_STATUS` / `SALES_COMPANY`（来自项目实际 data.ts 用法）。
+
+---
+
+## 与其他 Skill 联动
+
+| Skill | 联动方式 |
+|-------|---------|
+| **page-codegen** | 生成 data.ts 时，如 `logicValue` 不在基线中，报告末尾提示"建议运行 dict-sync 补齐" |
+| **convention-audit** | 可调用 audit 模式，"字典码未在基线"列为 🟡 偏差 |
+| **menu-sync** | 共享 `skills/sync/env.local.json`，gatewayPath / token / sysAppNo 同一份配置 |
+
+
+# Skill: 字典同步（dict-sync）
+
+将 `data.ts` 中引用的数据字典（`logicType: BusLogicDataType.dict`）同步到后端字典表，保持本地基线与线上一致。
+
+> **与 menu-sync 的关系**：机制完全对称——同样读取本地基线报告 → 与线上对比 → 补齐差异。
+> 配置直接复用 `menu-sync/env/env.local.json`，无需重复填写。
+
+---
+
+## ⚠️ 激活前请确认 3 个 API 端点
+
+在开始使用本 Skill 前，请与后端团队核实以下 3 个接口路径，并将正确路径填入本文件对应位置（搜索 `TODO_CONFIRM`）：
+
+| # | 用途 | 草稿路径（待确认） | 确认方式 |
+|---|------|--------------------|---------|
+| 1 | 查询全量字典列表（去重用） | `GET /system/dict/list` | DevTools → 进入"数据字典"列表页 → 查看 Network |
+| 2 | 创建/更新单个字典码 | `POST /system/dict/save` | DevTools → 新增一条字典 → 查看 Request URL + Body |
+| 3 | 批量保存字典项（value/label） | `POST /system/dictItem/save` | DevTools → 为字典添加项 → 查看 Request URL + Body |
+
+确认完成后，删除此区块即可正式使用。
+
+---
+
+## 配置（复用 menu-sync，无需重复填写）
+
+本 Skill 读取顺序：
+
+1. 优先读取 `skills/sync/dict-sync/env/env.local.json`（如存在）
+2. 回落到 `skills/sync/menu-sync/env/env.local.json`（_inherit 机制）
+
+**绝大多数情况下无需单独创建字典配置**——menu-sync 配置的 `gatewayPath`、`token`、`sysAppNo` 完全共用。
+
+仅当字典接口需要独立 token 或不同网关时，才在 `dict-sync/env/env.local.json` 单独配置：
+
+```json
+{
+  "gatewayPath": "http://网关地址:端口",
+  "sysAppNo": "应用编码",
+  "token": "Bearer Token（不含 bearer 前缀）"
+}
+```
+
+---
+
+## Pre-flight 声明（执行前必须输出）
+
+```
+🚀 已触发技能 dict-sync/SKILL.md → 字典同步
+✅ 已读取 menu-sync/env/env.local.json  → 网关地址、token、sysAppNo
+✅ 已读取 reports/SYS_DICT_INFO.md       → 本地字典基线
+✅ 操作模式：{pull / push / audit}
+✅ 目标字典码：{用户指定 / 从 data.ts 扫描到的字典码列表}
+```
+
+---
+
+## SYS_DICT_INFO.md — 本地基线格式
+
+路径：`.github/reports/SYS_DICT_INFO.md`
+
+写入规范（每次 pull 后覆盖更新，push 后追加）：
+
+```markdown
+## {DICT_CODE}（{字典中文名}）
+
+| 值（value） | 显示名称（label） | 排序 | 备注 |
+| ---------- | ---------------- | ---- | ---- |
+| 0          | 草稿             | 1    |      |
+| 1          | 待审核           | 2    |      |
+| 2          | 审核通过         | 3    |      |
+| 3          | 已驳回           | 4    |      |
+```
+
+**字典码命名规范**（来自项目 data.ts 分析）：
+
+| 风格 | 正确 ✅ | 错误 ❌ |
+|------|---------|---------|
+| 全大写+下划线 | `ORDER_STATUS` / `SALES_COMPANY` | `orderStatus` / `salesCompany` |
+
+---
+
+## 三种工作模式
+
+### pull — 刷新本地基线
+
+**触发词**：`刷新字典基线` / `拉字典`
+
+```
+1. 调用 GET {TODO_CONFIRM: /system/dict/list?size=500} → 获取全量字典
+2. 整理为 SYS_DICT_INFO.md 格式
+3. 覆盖写入 reports/SYS_DICT_INFO.md
+4. 输出：共拉取 N 个字典码，M 个字典项
+```
+
+**接口调用**：
+```
+GET {gatewayPath}/system/dict/list?current=1&size=500       ← TODO_CONFIRM 路径
+Headers:
+  authorization: bearer {token}
+  Sysappno: {sysAppNo}
+```
+
+**响应处理**：取 `data.records`（或 `data.list`，以实际为准），`code === 2000` 为成功。
+
+---
+
+### push — 推送新增字典（核心模式）
+
+**触发词**：`同步字典` / `创建字典` / `补字典`
+
+#### Step 1：扫描当前 data.ts 中的字典引用
+
+从用户指定范围（单文件 / 整个 src/views/）扫描所有：
+```typescript
+logicType: BusLogicDataType.dict, logicValue: "DICT_CODE"
+```
+收集所有 `logicValue` 值，去重后得到「当前用到的字典码集合」。
+
+#### Step 2：与本地基线对比
+
+读取 `reports/SYS_DICT_INFO.md`，找出「未在基线中的字典码」（即需要新建的字典）。
+
+> 若本地基线为空或过期，提示用户先执行 `pull` 模式拉取基线。
+
+#### Step 3：Pre-flight 输出待新建清单
+
+在执行任何 API 调用前，输出：
+
+```
+📋 待同步字典清单：
+  新建字典码：ORDER_STATUS（订单状态）— 含 4 个字典项
+  新建字典码：SALES_COMPANY（销售公司）— 含 3 个字典项
+  跳过（已在基线中）：PRODUCT_SEGMENT
+
+确认执行？(yes/no)
+```
+
+等待用户确认后再执行。
+
+#### Step 4：逐条创建字典码
+
+```
+POST {gatewayPath}/system/dict/save      ← TODO_CONFIRM 路径
+Headers:
+  authorization: bearer {token}
+  Sysappno: {sysAppNo}
+  Content-Type: application/json
+
+Body（待确认字段名）:
+{
+  "dictCode": "ORDER_STATUS",
+  "dictName": "订单状态",
+  "remark": ""
+}
+```
+
+#### Step 5：批量写入字典项
+
+```
+POST {gatewayPath}/system/dictItem/save  ← TODO_CONFIRM 路径
+Headers:
+  authorization: bearer {token}
+  Sysappno: {sysAppNo}
+  Content-Type: application/json
+
+Body（待确认字段名，按实际接口响应调整）:
+{
+  "dictCode": "ORDER_STATUS",
+  "items": [
+    { "dictItemValue": "0", "dictItemLabel": "草稿",   "sortNo": 1 },
+    { "dictItemValue": "1", "dictItemLabel": "待审核", "sortNo": 2 }
+  ]
+}
+```
+
+#### Step 6：输出结果表
+
+| 字典码 | 字典名称 | 字典项数 | 状态 |
+|--------|---------|---------|------|
+| ORDER_STATUS | 订单状态 | 4 | ✅ created |
+| SALES_COMPANY | 销售公司 | 3 | ✅ created |
+| PRODUCT_SEGMENT | 产品板块 | 5 | ⏭️ skipped（已存在） |
+
+执行完成后，将新建字典追加写入 `reports/SYS_DICT_INFO.md`。
+
+---
+
+### audit — 仅检查，不调接口
+
+**触发词**：`字典审计` / `检查字典`
+
+```
+1. 扫描指定范围的 data.ts，收集所有 logicValue 字典码
+2. 与 SYS_DICT_INFO.md 基线对比
+3. 输出三个清单：
+   ✅ 已在基线中（无需操作）
+   ⚠️ 在 data.ts 中使用但不在基线中（建议执行 push）
+   💤 在基线中但未被任何 data.ts 使用（可能已废弃）
+4. 不调用任何接口
+```
+
+---
+
+## 冲突处理原则
+
+| 场景 | 策略 |
+|------|------|
+| 本地新增字典，线上不存在 | 调接口创建 |
+| 字典码已存在，字典名不同 | 询问用户：以本地为准（更新）/ 保留线上 / 跳过 |
+| 字典项 value 相同，label 不同 | 询问用户：以本地为准 / 以线上为准 / 跳过 |
+| 线上存在，本地无记录 | 仅在 audit 中报告，**绝不主动删除** |
+
+---
+
+## 与其他 Skill 联动
+
+| Skill | 联动方式 |
+|-------|---------|
+| **page-codegen** | 生成 data.ts 时，如发现 `logicValue` 字典码不在基线中，报告末尾追加"⚠️ 建议运行 dict-sync 补齐以下字典" |
+| **convention-audit** | 审计 12 号规范时，可调用 dict-sync audit 模式，将"字典码未在基线中"列为 🟡 偏差 |
+| **menu-sync** | 共享 env.local.json 配置，无需重复填写 |

package/files/.github/skills/sync/env.local.json

@@ -0,0 +1,22 @@
+{
+  "_readme": "wl-skills-kit 同步配置 — 已加入 .gitignore，请勿提交此文件。详细说明见 menu-sync/env/guide.md",
+
+  "gatewayPath": "http://你的网关地址:端口",
+  "sysAppNo": "应用编码（从已有菜单接口响应中获取，非明文）",
+  "token": "你的Bearer Token（不含bearer前缀）",
+
+  "menu": {
+    "_comment": "menu-sync 专属配置",
+    "parentMenuId": "父级菜单ID（从菜单管理后台获取）"
+  },
+
+  "dict": {
+    "_comment": "dict-sync 专属配置",
+    "moduleId": "字典所属模块ID（从字典管理后台获取，如 7C909G0U2F8HI7E305LV0135LSJ3UBIO）"
+  },
+
+  "permission": {
+    "_comment": "permission-sync 专属配置 — 待启用，字段待确认",
+    "parentPermissionId": ""
+  }
+}

package/files/.github/skills/sync/menu-sync/SKILL.md

@@ -23,24 +23,29 @@ description: "Use when: creating system menus for newly generated pages, batch r
 | `parentMenuNameCode`                             | API 自动查询               | AI 调 children 接口获取，无需手填       |
 | **gatewayPath、parentMenuId、sysAppNo、token**   | `env.local.json`           | 每套环境不同，唯一需要手动维护的 4 个值 |
 
-### 配置文件（只需填 4 个字段）
+### 配置文件（统一维护，菜单/字典/权限共用）
 
-`.github/skills/sync/menu-sync/env/env.local.json`（已加入 `.gitignore`，本地维护，不提交）
+优先读取 `.github/skills/sync/env.local.json`（v2.1.5+ 统一配置）：
 
 ```json
 {
   "gatewayPath": "http://网关地址:端口",
-  "parentMenuId": "父级菜单ID",
   "sysAppNo": "应用编码（从已有菜单的sysAppNo字段获取，非明文）",
-  "token": "Bearer Token（不含bearer前缀）"
+  "token": "Bearer Token（不含bearer前缀）",
+  "menu": {
+    "parentMenuId": "父级菜单ID"
+  }
 }
 ```
 
+> 向下兼容：如上述文件不存在，回落读取 `menu-sync/env/env.local.json`（旧版路径）。  
 > 字段说明及获取方式见 `env/guide.md`
 
+menu-sync 读取规则：`parentMenuId` 优先从 `menu.parentMenuId` 读取，回落到根级 `parentMenuId`。
+
 ### 使用步骤
 
-1. **首次**：按 `env/guide.md` 填写 `env.local.json` 的 4 个字段
+1. **首次**：按 `env/guide.md` 填写 `skills/sync/env.local.json` 的字段
 2. **之后**：直接对 AI 说「帮我创建菜单」/「同步菜单」/「补菜单」
 3. AI 自动执行：读 `reports/SYS_MENU_INFO.md` → 读 `env.local.json` → 查父级已有子节点 → 逐条对比去重 → 调 `/system/menu/save` → 输出 created/skipped 结果表
 4. **全程无需手动执行任何命令**

package/files/.github/skills/sync/menu-sync/env/env.local.json

@@ -1,4 +1,5 @@
 {
+  "_notice": "【已迁移】请改用 skills/sync/env.local.json（菜单+字典+权限统一配置）。此文件仍受保护，向下兼容保留。",
   "gatewayPath": "http://你的网关地址:端口",
   "parentMenuId": "父级菜单ID",
   "sysAppNo": "应用编码（从已有菜单接口响应中获取，非明文）",

package/files/.github/standards/12-base-table.md

@@ -26,28 +26,34 @@
 
 ## cid 命名规则（核心）
 
-AGGrid 通过 `cid` 持久化列配置（列宽、顺序、显示），**cid 必须全局唯一**。
+AGGrid 通过 `cid` 持久化列配置（列宽、顺序、显示），**cid 必须跨全部系统全局唯一**。
+
+> ⚠️ 本项目包含 21 个 Module Federation 子应用，共享同一浏览器 origin（localStorage 共用）。
+> 采用简短十进制后缀存在两个致命问题：①后 6 位每 ~11.5 天循环一次；②不同页面的首字母缩写高概率碰撞（如 `mca`、`dto`）。
+> 因此后缀必须使用 **完整 base-36 时间戳**，保证毫秒级全局唯一且永不重复。
 
 ### 表格级 cid
 
 ```
-格式：{页面目录首字母缩写}-{Unix秒后6位}
+格式：{页面目录首字母缩写}-{Date.now().toString(36)}
 ```
 
 **生成规则（AI 执行）**：
 
 1. 取页面 kebab-case 目录名，每个单词取首字母拼接为缩写
-2. 取 `Math.floor(Date.now() / 1000).toString().slice(-6)` 作为 6 位时间戳后缀
+2. 执行 `Date.now().toString(36)`，将结果完整追加（当前约 9 位 base-36，只增不减）
 3. 用 `-` 连接
 
 **示例**：
 
-| 页面目录                 | 缩写 | cid               |
-| ------------------------ | ---- | ----------------- |
-| `mmwr-customer-archive`  | mca  | `mca-745831`      |
-| `domestic-trade-order`   | dto  | `dto-745832`      |
-| 同页面第二个表格（子表） | mca  | `mca-745831-sub1` |
-| 同页面第三个表格         | mca  | `mca-745831-sub2` |
+| 页面目录                 | 缩写 | cid（base-36后缀）      |
+| ------------------------ | ---- | ----------------------- |
+| `mmwr-customer-archive`  | mca  | `mca-lhfge5hc`          |
+| `domestic-trade-order`   | dto  | `dto-lhfge5hi`          |
+| 同页面第二个表格（子表） | mca  | `mca-lhfge5hc-sub1`     |
+| 同页面第三个表格         | mca  | `mca-lhfge5hc-sub2`     |
+
+> **为什么不截断**：截断后缀（如后 6 位）会引入循环碰撞。完整 base-36 值为单调递增，毫秒级唯一，9 位 base-36 ≈ 2199 亿组合，同一毫秒只生成一次。
 
 ### 列级 cid
 
@@ -81,7 +87,7 @@ columnsDef(): TableColumnDesc<any>[] {
 ## Pre-flight 声明示例
 
 ```
-✅ cid 已生成：mca-745831（mmwr-customer-archive）
+✅ cid 已生成：mca-lhfge5hc（mmwr-customer-archive）
 ✅ 列级 cid 前缀：mca-
 ```
 
@@ -95,7 +101,7 @@ columnsDef(): TableColumnDesc<any>[] {
   <BaseTable
     ref="tableRef"
     render-type="agGrid"
-    cid="mca-745831"
+    cid="mca-lhfge5hc"
     :data="list"
     :columns="columns"
     showToolbar

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agile-team/wl-skills-kit",
-  "version": "2.1.5",
+  "version": "2.1.6",
   "description": "AI Skill 模板包 — 一键导入 AI 指令 + 组件文档 + 通用组件 + 领域样例，覆盖 Copilot/Cursor/Windsurf/Kiro 等主流 AI 编辑器",
   "main": "./bin/wl-skills.js",
   "bin": {
@@ -26,6 +26,7 @@
   ],
   "author": "JHLC Frontend Team",
   "license": "UNLICENSED",
+  "homepage": "https://github.com/ChenyCHENYU/wl-skills-kit#readme",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ChenyCHENYU/wl-skills-kit.git"