@agile-team/wl-skills-kit 1.1.6 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## [1.2.0] - 2026-04-10
+
+### 新增：CLI v2.0 — update 增量更新 + clean 构建清理
+
+- **`update` 命令**：基于 MD5 增量更新，仅覆盖有变化的文件
+  - 对比 `.wl-skills-manifest.json` 清单中的 MD5 哈希
+  - 输出新增/更新/未变文件数 + 版本变化提示
+  - 支持 `--dry-run` 预览
+- **`clean` 命令**：构建前清理 AI 开发辅助文件
+  - 删除 `.github/`、`docs/`、`demo/`、编辑器配置等非组件文件
+  - **保护路径**：`src/components/` + `src/types/` 永远不会被清理
+  - 删除空父目录（自动清理目录树）
+  - 清除 `.wl-skills-manifest.json` 自身
+  - 支持 `--dry-run` 预览
+- **Manifest 清单系统**（`.wl-skills-manifest.json`）：
+  - `init` / `update` 执行后自动生成，记录版本 + 文件路径 → MD5 映射
+  - 供 `update` 做增量比对、`clean` 做精准删除
+  - 已加入 `.gitignore`
+- CLI 重构为 3 个子命令：`init`（默认，向后兼容）、`update`、`clean`
+- README.md 新增「CLI 命令」章节，更新「快速开始」「更新策略」「安装行为说明」
+
+## [1.1.7] - 2026-04-10
+
+### 修复：menu-sync SKILL.md 漏同步
+
+- `files/.github/skills/menu-sync/SKILL.md` 未随 v1.1.6 同步源仓库版本
+- 修复内容：sysAppNo 字段补齐（配置模板/表格/示例）、`{appNo}` → `{sysAppNo}` 变量统一、响应码说明补充
+- 全量审计确认 19 个同步文件 + 9 个 TPL 模板零差异
+
 ## [1.1.6] - 2026-04-10
 
 ### 修复：menu-config.md 残留引用 + env 模板字段缺失

package/README.md

@@ -15,11 +15,14 @@ npx @agile-team/wl-skills-kit
 # 预览将写入哪些文件（不实际写入）
 npx @agile-team/wl-skills-kit --dry-run
 
-# 更新到最新版
-npx @agile-team/wl-skills-kit@latest
+# 增量更新（仅覆盖有变化的文件）
+npx @agile-team/wl-skills-kit@latest update
+
+# 构建前清理 AI 开发辅助文件（保留组件代码）
+npx @agile-team/wl-skills-kit clean
 ```
 
-就这样。108 个文件按原始路径导入到你的项目，**无其他副作用**。
+117 个文件按原始路径导入到你的项目，**无其他副作用**。
 
 ---
 
@@ -240,6 +243,61 @@ npx @agile-team/wl-skills-kit
 
 ---
 
+## CLI 命令
+
+### `init`（默认）
+
+首次安装或完整重装 — 全量写入所有文件。
+
+```bash
+npx @agile-team/wl-skills-kit              # 等同于 init
+npx @agile-team/wl-skills-kit init
+npx @agile-team/wl-skills-kit --dry-run    # 预览模式
+```
+
+### `update`
+
+增量更新 — 基于 MD5 比对，仅覆盖有变化的文件，跳过未变化的文件。
+
+```bash
+npx @agile-team/wl-skills-kit@latest update
+npx @agile-team/wl-skills-kit update --dry-run
+```
+
+输出示例：
+```
+✔ 完成!
+  新增: 3 个文件      ← 新版本新增的文件
+  更新: 5 个文件      ← 内容有变化，已覆盖
+  未变: 109 个文件    ← MD5 一致，未动
+```
+
+> 需要先执行过 `init` 才能使用 `update`（依赖 `.wl-skills-manifest.json` 清单文件）。
+
+### `clean`
+
+构建前清理 — 移除 AI 开发辅助文件（Skill、文档、样例、编辑器配置），**保留组件代码**。
+
+```bash
+npx @agile-team/wl-skills-kit clean
+npx @agile-team/wl-skills-kit clean --dry-run
+```
+
+**保护路径**（永远不会被清理）：
+- `src/components/` — 全局/局部/远程组件
+- `src/types/` — 类型桶文件
+
+**清理范围**：
+- `.github/` — Skill 文件 + 设计文档
+- `docs/` — 组件 API 文档
+- `demo/` — 领域样例
+- 编辑器配置 — `.cursorrules` / `AGENTS.md` / `CLAUDE.md` 等 8 个文件
+- `.wl-skills-manifest.json` — 清单文件自身
+
+> 适用于 CI/CD 构建流程：`npx @agile-team/wl-skills-kit clean && npm run build`
+
+---
+
 ## 安装行为说明
 
 | ✅ 会做                             | ❌ 不会做                    |
@@ -247,7 +305,7 @@ npx @agile-team/wl-skills-kit
 | 写入 `.github/` `docs/` `src/` `demo/` | 不修改 `package.json`      |
 | 已存在的同名文件会被覆盖           | 不修改 `node_modules/`       |
 | 自动创建不存在的目录               | 不执行 postinstall           |
-|                                     | 不删除任何文件               |
+| 生成 `.wl-skills-manifest.json` 清单 | 不删除任何文件（init/update） |
 
 ### 安全路径（不会被覆盖）
 
@@ -310,13 +368,25 @@ import { AbstractPageQueryHook, BaseQueryItemDesc, ActionButtonDesc, TableColumn
 ### 5. 更新策略
 
 ```bash
-# 拉取最新模板（会覆盖内置文件，不动安全路径）
+# 方式一：增量更新（推荐 — 仅覆盖变化的文件，速度快）
+npx @agile-team/wl-skills-kit@latest update
+
+# 方式二：全量重装（适合版本跨度大、或清单文件丢失的情况）
 npx @agile-team/wl-skills-kit@latest
 ```
 
 - **通用改进** → 提 PR 到 wl-skills-kit 仓库，合并后所有项目受益
 - **领域专有** → 放在安全路径下，永远不会被覆盖
 
+### 6. Manifest 清单文件
+
+`init` 和 `update` 执行后会在项目根目录生成 `.wl-skills-manifest.json`，记录所有写入的文件路径及 MD5 哈希。该文件用于：
+
+- `update` 命令的增量比对（跳过未变化的文件）
+- `clean` 命令的精准删除（只删除 Skill 体系写入的文件）
+
+> 建议将 `.wl-skills-manifest.json` 加入 `.gitignore`（每台开发机独立维护即可）。
+
 ---
 
 ## 技术栈适配

package/bin/wl-skills.js

@@ -1,52 +1,61 @@
 #!/usr/bin/env node
 
 /**
- * wl-skills-kit CLI v1.1
+ * wl-skills-kit CLI v2.0
  *
- * 功能：
- *   1. 将 files/ 目录下的所有文件按原始路径拷贝到当前工作目录
- *   2. 从 copilot-instructions.md 动态生成多编辑器配置文件
- *      覆盖 Cursor / Windsurf / Kiro / Trae / Claude Code / Roo/Cline / AGENTS.md
- *
- * 用法：npx @agile-team/wl-skills-kit [--dry-run]
+ * 命令:
+ *   init      全量安装（默认，向后兼容）
+ *   update    增量更新（仅覆盖有变化的文件，展示 diff 摘要）
+ *   clean     构建清理（移除 AI 指令/文档/样例，保留组件和类型）
+ *   --help    帮助
+ *   --dry-run 预览模式（所有命令均支持）
  */
 
 const fs = require("fs");
 const path = require("path");
+const crypto = require("crypto");
 
 const FILES_DIR = path.resolve(__dirname, "..", "files");
 const TARGET_DIR = process.cwd();
+const MANIFEST_NAME = ".wl-skills-manifest.json";
+const MANIFEST_PATH = path.join(TARGET_DIR, MANIFEST_NAME);
+const PKG = require("../package.json");
 const args = process.argv.slice(2);
 const dryRun = args.includes("--dry-run");
 const showHelp = args.includes("--help") || args.includes("-h");
+const command = args.find((a) => !a.startsWith("-")) || "init";
 
 if (showHelp) {
   console.log(`
-  wl-skills-kit — AI Skill 模板包
+  wl-skills-kit v${PKG.version} — AI Skill 模板包
 
   用法:
-    npx @agile-team/wl-skills-kit           安装/更新模板文件到当前项目
-    npx @agile-team/wl-skills-kit --dry-run  预览将要写入的文件（不实际写入）
-
-  安装后写入:
-    .github/         AI 指令 + Skills + 文档（GitHub Copilot）
-    docs/            组件 API 文档
-    src/             通用组件 + 类型定义
-    demo/            领域样例（AI 学习参考）
-    AGENTS.md        通用 AI 编辑器兜底（Linux Foundation 标准）
-    CLAUDE.md        Claude Code / Claude CLI
-    .clinerules      Roo Code / Cline
-    .cursorrules     Cursor（legacy）
-    .cursor/rules/   Cursor（新格式）
-    .windsurfrules   Windsurf (Cascade)
-    .kiro/steering/  Kiro
-    .trae/rules/     Trae
+    npx @agile-team/wl-skills-kit [命令] [选项]
+
+  命令:
+    init       全量安装模板文件到当前项目（默认）
+    update     增量更新（仅覆盖有变化的文件，展示变更摘要）
+    clean      构建清理（移除开发期 AI 文件，保留 src/components + src/types）
+
+  选项:
+    --dry-run  预览模式，不实际写入/删除任何文件
+    --help     显示帮助
+
+  示例:
+    npx @agile-team/wl-skills-kit                安装全量文件
+    npx @agile-team/wl-skills-kit update         仅更新有变化的文件
+    npx @agile-team/wl-skills-kit clean          清理开发期文件
+    npx @agile-team/wl-skills-kit clean --dry-run 预览将要清理哪些文件
+
+  清理保护路径（clean 不删除）:
+    src/components/    通用组件（被业务页面 import，构建必需）
+    src/types/         类型桶文件（构建必需）
   `);
   process.exit(0);
 }
 
 /**
- * 递归遍历目录，返回所有文件的相对路径
+ * 递归遍历目录，返回所有文件的相对路径（正斜杠）
  */
 function walkDir(dir, baseDir, fileList) {
   fileList = fileList || [];
@@ -56,12 +65,22 @@ function walkDir(dir, baseDir, fileList) {
     if (entry.isDirectory()) {
       walkDir(fullPath, baseDir, fileList);
     } else {
-      fileList.push(path.relative(baseDir, fullPath));
+      fileList.push(path.relative(baseDir, fullPath).replace(/\\/g, "/"));
     }
   }
   return fileList;
 }
 
+/** 计算文件 md5 */
+function fileMd5(fp) {
+  return crypto.createHash("md5").update(fs.readFileSync(fp)).digest("hex");
+}
+
+/** 计算字符串内容 md5 */
+function contentMd5(c) {
+  return crypto.createHash("md5").update(c, "utf8").digest("hex");
+}
+
 /**
  * 写入文件（自动创建目录）
  * @returns {"created"|"updated"}
@@ -78,121 +97,245 @@ function writeFile(destPath, content) {
   return exists ? "updated" : "created";
 }
 
-// ─── 主逻辑 ────────────────────────────────────────────────────────────────
-
-console.log("");
-console.log("  wl-skills-kit v" + require("../package.json").version);
-console.log("  目标目录: " + TARGET_DIR);
-console.log("");
-
-if (!fs.existsSync(FILES_DIR)) {
-  console.error("  ✖ files/ 目录不存在，包可能已损坏");
-  process.exit(1);
+/** 复制文件（自动创建目录） */
+function copyFileSafe(srcPath, destPath) {
+  const destDir = path.dirname(destPath);
+  if (!fs.existsSync(destDir)) {
+    fs.mkdirSync(destDir, { recursive: true });
+  }
+  const exists = fs.existsSync(destPath);
+  if (!dryRun) {
+    fs.copyFileSync(srcPath, destPath);
+  }
+  return exists ? "updated" : "created";
 }
 
-let created = 0;
-let updated = 0;
-
-// ── Step 1: 复制 files/ 静态文件 ─────────────────────────────────────────
+/** 删除文件，并向上清理空父目录 */
+function removeFileAndEmptyParents(filePath) {
+  if (fs.existsSync(filePath)) fs.unlinkSync(filePath);
+  let dir = path.dirname(filePath);
+  while (dir !== TARGET_DIR && dir.length > TARGET_DIR.length) {
+    try {
+      if (fs.readdirSync(dir).length === 0) {
+        fs.rmdirSync(dir);
+        dir = path.dirname(dir);
+      } else { break; }
+    } catch (e) { break; }
+  }
+}
 
-const files = walkDir(FILES_DIR, FILES_DIR);
+/** 读取 manifest */
+function readManifest() {
+  if (fs.existsSync(MANIFEST_PATH)) {
+    try { return JSON.parse(fs.readFileSync(MANIFEST_PATH, "utf8")); }
+    catch (e) { return null; }
+  }
+  return null;
+}
 
-if (dryRun) {
-  console.log("  [Step 1] files/ 静态文件:\n");
+/** 写入 manifest */
+function writeManifest(data) {
+  fs.writeFileSync(MANIFEST_PATH, JSON.stringify(data, null, 2), "utf8");
 }
 
-for (const file of files) {
-  const src = path.join(FILES_DIR, file);
-  const dest = path.join(TARGET_DIR, file);
-  const destDir = path.dirname(dest);
+// 受保护路径（clean 不删除）
+const PROTECTED_PREFIXES = ["src/components/", "src/types/"];
+function isProtected(relPath) {
+  return PROTECTED_PREFIXES.some((p) => relPath.startsWith(p));
+}
 
-  if (!fs.existsSync(destDir)) {
-    fs.mkdirSync(destDir, { recursive: true });
-  }
+// ─── 编辑器配置生成 ─────────────────────────────────────────────────────
 
-  const exists = fs.existsSync(dest);
-  if (!dryRun) {
-    fs.copyFileSync(src, dest);
-  }
+const AUTO_HEADER =
+  "<!-- 由 @agile-team/wl-skills-kit 自动生成。源文件：.github/copilot-instructions.md -->\n" +
+  "<!-- 请勿手动编辑本文件，更新时重新执行：npx @agile-team/wl-skills-kit@latest -->\n\n";
 
-  if (dryRun) {
-    console.log("  " + (exists ? "覆盖" : "新增") + "  " + file);
-  } else {
-    exists ? updated++ : created++;
-  }
-}
+const CURSOR_MDC_HEADER =
+  "---\n" +
+  'description: "项目编码规范（由 wl-skills-kit 自动生成）"\n' +
+  "alwaysApply: true\n" +
+  "---\n\n" +
+  AUTO_HEADER;
 
-// ── Step 2: 动态生成多编辑器配置文件 ────────────────────────────────────
-
-// 读取 copilot-instructions.md（来自 files/ 包内，保证内容与安装文件一致）
-const INSTRUCTIONS_SRC = path.join(
-  FILES_DIR,
-  ".github",
-  "copilot-instructions.md"
-);
-
-if (fs.existsSync(INSTRUCTIONS_SRC)) {
-  const raw = fs.readFileSync(INSTRUCTIONS_SRC, "utf8");
-  const AUTO_HEADER =
-    "<!-- 由 @agile-team/wl-skills-kit 自动生成。源文件：.github/copilot-instructions.md -->\n" +
-    "<!-- 请勿手动编辑本文件，更新时重新执行：npx @agile-team/wl-skills-kit@latest -->\n\n";
-
-  // Cursor 新格式 .mdc 需要 YAML frontmatter
-  const CURSOR_MDC_HEADER =
-    "---\n" +
-    'description: "项目编码规范（由 wl-skills-kit 自动生成）"\n' +
-    "alwaysApply: true\n" +
-    "---\n\n" +
-    AUTO_HEADER;
-
-  // [目标相对路径, 文件内容]
-  const editorConfigs = [
-    // 通用兜底（Linux Foundation 标准，绝大多数 AI 工具均支持）
+function getEditorConfigs(raw) {
+  return [
     ["AGENTS.md", AUTO_HEADER + raw],
-    // Claude Code / Claude CLI
     ["CLAUDE.md", AUTO_HEADER + raw],
-    // Roo Code / Cline
     [".clinerules", AUTO_HEADER + raw],
-    // Cursor — legacy（根目录，仍被新版支持）
     [".cursorrules", AUTO_HEADER + raw],
-    // Cursor — 新格式（带 frontmatter 的 .mdc）
     [".cursor/rules/conventions.mdc", CURSOR_MDC_HEADER + raw],
-    // Windsurf (Cascade)
     [".windsurfrules", AUTO_HEADER + raw],
-    // Kiro
     [".kiro/steering/conventions.md", AUTO_HEADER + raw],
-    // Trae
-    [".trae/rules/conventions.md", AUTO_HEADER + raw]
+    [".trae/rules/conventions.md", AUTO_HEADER + raw],
   ];
+}
 
-  if (dryRun) {
-    console.log("\n  [Step 2] 多编辑器配置文件（从 copilot-instructions.md 生成）:\n");
+// ─── 命令: init / update ────────────────────────────────────────────────
+
+function runInstall(incremental) {
+  const label = incremental ? "update" : "init";
+  console.log("");
+  console.log("  wl-skills-kit v" + PKG.version + "  [" + label + "]");
+  console.log("  目标目录: " + TARGET_DIR);
+  if (dryRun) console.log("  模式: --dry-run（预览）");
+  console.log("");
+
+  if (!fs.existsSync(FILES_DIR)) {
+    console.error("  ✖ files/ 目录不存在，包可能已损坏");
+    process.exit(1);
   }
 
-  for (const [relPath, content] of editorConfigs) {
+  const oldManifest = readManifest();
+  const newManifest = { version: PKG.version, files: {} };
+  let created = 0, updated = 0, unchanged = 0;
+
+  // ── Step 1: 复制 files/ 静态文件 ───────────────────────────────────
+
+  const files = walkDir(FILES_DIR, FILES_DIR);
+  if (dryRun) console.log("  [Step 1] files/ 静态文件:\n");
+
+  for (const relPath of files) {
+    const src = path.join(FILES_DIR, relPath);
     const dest = path.join(TARGET_DIR, relPath);
-    const exists = fs.existsSync(dest);
+    const srcHash = fileMd5(src);
+    newManifest.files[relPath] = srcHash;
+
+    // update 模式: 跳过内容相同的文件
+    if (incremental && fs.existsSync(dest)) {
+      if (srcHash === fileMd5(dest)) { unchanged++; continue; }
+    }
+
+    if (dryRun) {
+      const exists = fs.existsSync(dest);
+      console.log("  " + (exists ? "覆盖" : "新增") + "  " + relPath);
+      exists ? updated++ : created++;
+    } else {
+      copyFileSafe(src, dest) === "created" ? created++ : updated++;
+    }
+  }
+
+  // ── Step 2: 动态生成编辑器配置文件 ────────────────────────────────
+
+  const INSTRUCTIONS_SRC = path.join(FILES_DIR, ".github", "copilot-instructions.md");
+  if (fs.existsSync(INSTRUCTIONS_SRC)) {
+    const raw = fs.readFileSync(INSTRUCTIONS_SRC, "utf8");
+    const editorConfigs = getEditorConfigs(raw);
+
     if (dryRun) {
-      console.log("  " + (exists ? "覆盖" : "新增") + "  [编辑器] " + relPath);
+      console.log("\n  [Step 2] 编辑器配置文件（从 copilot-instructions.md 生成）:\n");
+    }
+
+    for (const [ecPath, ecContent] of editorConfigs) {
+      const ecDest = path.join(TARGET_DIR, ecPath);
+      const ecHash = contentMd5(ecContent);
+      newManifest.files[ecPath] = ecHash;
+
+      if (incremental && fs.existsSync(ecDest)) {
+        if (ecHash === fileMd5(ecDest)) { unchanged++; continue; }
+      }
+
+      if (dryRun) {
+        const ecExists = fs.existsSync(ecDest);
+        console.log("  " + (ecExists ? "覆盖" : "新增") + "  [编辑器] " + ecPath);
+        ecExists ? updated++ : created++;
+      } else {
+        writeFile(ecDest, ecContent) === "created" ? created++ : updated++;
+      }
+    }
+  }
+
+  // ── Step 3: 写 manifest ────────────────────────────────────────────
+
+  if (!dryRun) writeManifest(newManifest);
+
+  // ── 输出统计 ──────────────────────────────────────────────────────
+
+  const total = created + updated + unchanged;
+  if (dryRun) {
+    console.log("");
+    if (incremental) {
+      console.log("  共 " + total + " 个文件（新增 " + created + "，变更 " + updated + "，未变 " + unchanged + "）（未实际写入）");
+    } else {
+      console.log("  共 " + total + " 个文件（未实际写入）");
+    }
+  } else {
+    console.log("  ✔ 完成!");
+    if (incremental) {
+      console.log("    新增: " + created + " 个文件");
+      console.log("    更新: " + updated + " 个文件");
+      console.log("    未变: " + unchanged + " 个文件");
+      if (oldManifest && oldManifest.version !== PKG.version) {
+        console.log("    版本: " + oldManifest.version + " → " + PKG.version);
+      }
     } else {
-      const result = writeFile(dest, content);
-      result === "created" ? created++ : updated++;
+      console.log("    新增: " + created + " 个文件");
+      console.log("    覆盖: " + updated + " 个文件");
+      console.log("    总计: " + (created + updated) + " 个文件");
     }
   }
+  console.log("");
 }
 
-if (dryRun) {
-  const editorCount = fs.existsSync(INSTRUCTIONS_SRC) ? 8 : 0;
-  console.log(
-    "\n  共 " +
-      (files.length + editorCount) +
-      " 个文件（未实际写入）"
-  );
-  process.exit(0);
+// ─── 命令: clean ────────────────────────────────────────────────────────
+
+function runClean() {
+  console.log("");
+  console.log("  wl-skills-kit v" + PKG.version + "  [clean]");
+  console.log("  目标目录: " + TARGET_DIR);
+  if (dryRun) console.log("  模式: --dry-run（预览）");
+  console.log("");
+
+  const manifest = readManifest();
+  if (!manifest) {
+    console.log("  ⚠ 未找到 " + MANIFEST_NAME);
+    console.log("  请先执行 npx @agile-team/wl-skills-kit init 安装一次。");
+    console.log("");
+    process.exit(1);
+  }
+
+  const allFiles = Object.keys(manifest.files);
+  const toRemove = allFiles.filter((f) => !isProtected(f));
+  const toKeep = allFiles.filter((f) => isProtected(f));
+
+  if (dryRun) {
+    console.log("  将要删除（" + toRemove.length + " 个文件）:\n");
+    for (const f of toRemove) {
+      const exists = fs.existsSync(path.join(TARGET_DIR, f));
+      console.log("  " + (exists ? "删除" : "跳过(不存在)") + "  " + f);
+    }
+    console.log("\n  保留（" + toKeep.length + " 个文件）:\n");
+    for (const f of toKeep) {
+      console.log("  保留  " + f);
+    }
+  } else {
+    let removed = 0, skipped = 0;
+    for (const f of toRemove) {
+      const fullPath = path.join(TARGET_DIR, f);
+      if (fs.existsSync(fullPath)) {
+        removeFileAndEmptyParents(fullPath);
+        removed++;
+      } else {
+        skipped++;
+      }
+    }
+    // 删除 manifest 自身
+    if (fs.existsSync(MANIFEST_PATH)) fs.unlinkSync(MANIFEST_PATH);
+
+    console.log("  ✔ 清理完成!");
+    console.log("    删除: " + removed + " 个文件");
+    if (skipped > 0) console.log("    跳过: " + skipped + " 个（已不存在）");
+    console.log("    保留: " + toKeep.length + " 个文件（src/components/ + src/types/）");
+  }
+  console.log("");
 }
 
-console.log("  ✔ 完成!");
-console.log("    新增: " + created + " 个文件");
-console.log("    覆盖: " + updated + " 个文件");
-console.log("    总计: " + (created + updated) + " 个文件");
-console.log("");
+// ─── 主路由 ─────────────────────────────────────────────────────────────
+
+switch (command) {
+  case "init":   runInstall(false); break;
+  case "update": runInstall(true);  break;
+  case "clean":  runClean();        break;
+  default:
+    console.error('  ✖ 未知命令: "' + command + '"，请使用 --help 查看可用命令');
+    process.exit(1);
+}

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

@@ -21,9 +21,9 @@ description: "Use when: creating system menus for newly generated pages, batch r
 | ------------------------------------------------ | ------------------ | --------------------------------------- |
 | 菜单名称、路径、组件、权限、隐藏、排序、应用编码 | `SYS_MENU_INFO.md` | 原型/详设阶段自动生成，AI 直接读取      |
 | `parentMenuNameCode`                             | API 自动查询       | AI 调 children 接口获取，无需手填       |
-| **gatewayPath、parentMenuId、token**             | `env.local.json`   | 每套环境不同，唯一需要手动维护的 3 个值 |
+| **gatewayPath、parentMenuId、sysAppNo、token**    | `env.local.json`   | 每套环境不同，唯一需要手动维护的 4 个值 |
 
-### 配置文件（只需填 3 个字段）
+### 配置文件（只需填 4 个字段）
 
 `.github/skills/menu-sync/env/env.local.json`（已加入 `.gitignore`，本地维护，不提交）
 
@@ -31,6 +31,7 @@ description: "Use when: creating system menus for newly generated pages, batch r
 {
   "gatewayPath": "http://网关地址:端口",
   "parentMenuId": "父级菜单ID",
+  "sysAppNo": "应用编码（从已有菜单的sysAppNo字段获取，非明文）",
   "token": "Bearer Token（不含bearer前缀）"
 }
 ```
@@ -39,7 +40,7 @@ description: "Use when: creating system menus for newly generated pages, batch r
 
 ### 使用步骤
 
-1. **首次**：按 `env/guide.md` 填写 `env.local.json` 的 3 个字段
+1. **首次**：按 `env/guide.md` 填写 `env.local.json` 的 4 个字段
 2. **之后**：直接对 AI 说「帮我创建菜单」/「同步菜单」/「补菜单」
 3. AI 自动执行：读 `SYS_MENU_INFO.md` → 读 `env.local.json` → 查父级已有子节点 → 逐条对比去重 → 调 `/system/menu/save` → 输出 created/skipped 结果表
 4. **全程无需手动执行任何命令**
@@ -90,18 +91,20 @@ description: "Use when: creating system menus for newly generated pages, batch r
 GET {gatewayPath}/system/menu/children?current=1&size=100&menuId={parentMenuId}
 Headers:
   authorization: bearer {token}
-  Sysappno: {appNo}
+  Sysappno: {sysAppNo}
 ```
 
 #### Step 2: 逐条创建菜单
 
 对于每条待创建的菜单，先检查是否与已有菜单重名（`menuName` 或 `path` 相同），重复则跳过。
 
+> **响应码说明**：后端成功响应为 `code: 2000`（非标准 HTTP 200），判断成功应检查 `response.body.code === 2000` 或 `message` 包含"成功"。
+
 ```
 POST {gatewayPath}/system/menu/save
 Headers:
   authorization: bearer {token}
-  Sysappno: {appNo}
+  Sysappno: {sysAppNo}
   Content-Type: application/json
 
 Body:
@@ -112,12 +115,12 @@ Body:
   "hidden": false,
   "type": "C",
   "parentId": "{parentMenuId}",
-  "sysAppNo": "{appNo}",
+  "sysAppNo": "{sysAppNo}",
   "orderNum": {nextOrder},
   "menuName": "客户档案",
   "menuNameCode": "{parentMenuNameCode}:{pinyinName}",
   "path": "mmwrCustomerArchive",
-  "permission": "produce:mmwrCustomerArchive:list",
+  "permission": "mmwrCustomerArchive",
   "component": "produce/production-mmwr/aiflow/mmwr-customer-archive/index.vue"
 }
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agile-team/wl-skills-kit",
-  "version": "1.1.6",
+  "version": "1.2.0",
   "description": "AI Skill 模板包 — 一键导入 AI 指令 + 组件文档 + 通用组件 + 领域样例，覆盖 Copilot/Cursor/Windsurf/Kiro 等主流 AI 编辑器",
   "bin": {
     "wl-skills-kit": "./bin/wl-skills.js"