@agile-team/wl-skills-kit 2.1.1 → 2.1.3

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [2.1.3] - 2026-04-27
+
+### 🔒 安全修复 + 依赖清理
+
+#### env.local.json 双重保护
+- `init` / `update` 遇到已存在的 `env.local.json` 不再覆盖（用户填写的 token / gatewayPath 等敏感数据不丢失）
+- `init` / `update` 完成后自动向业务项目 `.gitignore` 追加 `env.local.json` 保护条目（若尚未包含），防止 token 意外提交到远端仓库
+- `--help` 保护路径说明新增 `env.local.json` 条目
+
+#### 依赖清理
+- 移除 `devDependencies` 中的 `xlsx`（CLI 本身不使用；`xlsx` 是业务项目的依赖，已在 SKILL.md 中说明安装方式）
+
+---
+
+## [2.1.2] - 2026-04-26
+
+### 🔧 消除 npm 发布警告
+
+- `package.json` bin 路径去掉 `./` 前缀（`"./bin/wl-skills.js"` → `"bin/wl-skills.js"`），符合 npm 规范化要求，消除发布时的 `warn: script name was invalid` 提示
+
+---
+
 ## [2.1.1] - 2026-04-26
 
 ### 🔧 修复与迁移增强

package/README.md

@@ -225,11 +225,12 @@ npx @agile-team/wl-skills-kit update
 
 ## 受保护路径
 
-| 命令                     | 保护路径                          | 说明                       |
-| ------------------------ | --------------------------------- | -------------------------- |
-| `init` / `update`        | `.github/reports/*.md`            | 已存在则跳过，不覆盖累积   |
-| `clean`（默认）          | `src/components/` + `src/types/`  | 业务代码必需，永不删除     |
-| `clean --keep-reports`   | + `.github/reports/`              | 保留菜单/字典/权限基线     |
+| 命令                     | 保护路径                                               | 说明                       |
+| ------------------------ | --------------------------------------------------- | -------------------------- |
+| `init` / `update`        | `.github/reports/*.md`                              | 已存则跳过，不覆盖累积   |
+| `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

@@ -51,7 +51,8 @@ if (showHelp) {
     npx @agile-team/wl-skills-kit clean --dry-run       预览将要清理哪些文件
 
   保护路径（init / update 不覆盖已存在的）:
-    .github/reports/   AI 生成报告（团队累积数据，存在则跳过）
+    .github/reports/                               AI 生成报告（团队累积数据，存在则跳过）
+    .github/skills/sync/menu-sync/env/env.local.json  用户本地配置（token 等，已存在则跳过）
 
   清理保护路径（clean 不删除）:
     src/components/    通用组件（被业务页面 import，构建必需）
@@ -162,6 +163,14 @@ function isReportFile(relPath) {
   return relPath.startsWith(".github/reports/") && relPath.endsWith(".md");
 }
 
+// 用户本地配置：init/update 遇到已存在不覆盖（含 token / gatewayPath 等敏感信息）
+const USER_LOCAL_CONFIGS = [
+  ".github/skills/sync/menu-sync/env/env.local.json",
+];
+function isUserLocalConfig(relPath) {
+  return USER_LOCAL_CONFIGS.includes(relPath);
+}
+
 // ─── 旧版遗留路径（v1.x/v2.0 → v2.1 迁移清理）───────────────────────────
 // update 时自动检测并移除，避免旧结构与新结构并存产生歧义。
 const LEGACY_PATHS = [
@@ -283,6 +292,13 @@ function runInstall(incremental) {
       continue;
     }
 
+    // 用户本地配置：已存在则跳过（含 token / gatewayPath 等敏感信息，不覆盖）
+    if (isUserLocalConfig(relPath) && fs.existsSync(dest)) {
+      preserved++;
+      if (dryRun) console.log("  保留  " + relPath + "  (用户本地配置，不覆盖)");
+      continue;
+    }
+
     // update 模式: 跳过内容相同的文件
     if (incremental && fs.existsSync(dest)) {
       if (srcHash === fileMd5(dest)) {
@@ -300,6 +316,24 @@ 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 gitignorePath = path.join(TARGET_DIR, ".gitignore");
+  if (!dryRun && fs.existsSync(gitignorePath)) {
+    const giContent = fs.readFileSync(gitignorePath, "utf8");
+    if (!giContent.includes(ENV_LOCAL_GITIGNORE_ENTRY)) {
+      fs.appendFileSync(
+        gitignorePath,
+        "\n# wl-skills-kit: 本地敏感配置（token / gatewayPath，不入 git）\n" +
+          ENV_LOCAL_GITIGNORE_ENTRY +
+          "\n",
+      );
+      console.log("  ✔ .gitignore 已追加 env.local.json 保护条目");
+    }
+  }
+
   // ── Step 2: 动态生成编辑器配置文件 ────────────────────────────────
 
   const INSTRUCTIONS_SRC = path.join(

package/files/.github/guides/README.md

@@ -1,13 +1,13 @@
-# Guides 指南目录
-
-本目录下文档由 `wl-skills-kit` 安装到业务项目的 `.github/guides/`，作为团队成员人工维护的指南类文档。
-
-| 文件              | 内容                                           |
-| ----------------- | ---------------------------------------------- |
-| `usage.md`        | 全套 Skill 使用说明（团队成员上手必读）        |
-| `architecture.md` | 整体架构设计与决策记录（含菜单同步等设计内容） |
-
-> 与 `kit-internal/`（仅 wl-skills-kit 仓库可见的维护文档）严格区分：
->
-> - `guides/` → 业务项目使用方阅读
-> - `kit-internal/` → wl-skills-kit 仓库维护者阅读，**不安装到业务项目**
+# Guides 指南目录
+
+本目录下文档由 `wl-skills-kit` 安装到业务项目的 `.github/guides/`，作为团队成员人工维护的指南类文档。
+
+| 文件              | 内容                                           |
+| ----------------- | ---------------------------------------------- |
+| `usage.md`        | 全套 Skill 使用说明（团队成员上手必读）        |
+| `architecture.md` | 整体架构设计与决策记录（含菜单同步等设计内容） |
+
+> 与 `kit-internal/`（仅 wl-skills-kit 仓库可见的维护文档）严格区分：
+>
+> - `guides/` → 业务项目使用方阅读
+> - `kit-internal/` → wl-skills-kit 仓库维护者阅读，**不安装到业务项目**