@anov/gis-skills-cli 0.3.0 → 0.3.3

package/CHANGELOG.md

@@ -4,6 +4,25 @@
 
 ## [Unreleased]
 
+## [0.3.3] - 2026-11-02
+
+- fix: README 文档链接改绝对 URL，修 npm 包页面点不开的问题 (`a118366`)
+- feat: npm run release 自动打 tag 并推送 (`018027d`)
+- feat: npm run release 自动提交并推送发版文件 (`e6c5bb1`)
+
+
+## [0.3.2] - 2026-10-30
+
+- chore: 新增 npm run release 一键发版脚本 (`e147f1d`)
+- fix: setup 只装已检测智能体，MCP 默认写 Claude Code + Codex (`ee704ee`)
+
+
+## [0.3.1] - 2026-10-30
+
+- chore: 新增 npm run release 一键发版脚本 (`e147f1d`)
+- fix: setup 只装已检测智能体，MCP 默认写 Claude Code + Codex (`ee704ee`)
+
+
 ## [0.3.0] - 2026-10-30
 
 分发体系改造：npm 包内置 Cesium skill（vendor 15 个，Apache-2.0）、CLI 命令族重写为 setup/mcp/doctor/uninstall、MCP 配置自动写入各智能体

package/INSTALL.md

@@ -47,7 +47,7 @@ anov-gis-skills setup
 npx @anov/gis-skills-cli setup              # → ~/.claude/skills/ 等
 npx @anov/gis-skills-cli setup --project    # → ./.claude/skills/，可提交进项目仓库
 
-# 装给谁（默认全部检测到的智能体）
+# 装给谁（默认：共享目录 ~/.agents/skills + 已装的 Claude Code）
 npx @anov/gis-skills-cli setup --agent claude-code
 npx @anov/gis-skills-cli setup --agent claude-code --agent codex
 
@@ -87,12 +87,12 @@ npx @anov/gis-skills-cli setup --print
 
 ### A.5 MCP 接入
 
-`setup` 默认会写一条 MCP 配置（stdio 直连 `anov-gis-mcp`）。单独管理：
+`setup` 默认给 **Claude Code 和 Codex** 各写一条 MCP 配置（stdio 直连 `anov-gis-mcp`）。单独管理：
 
 ```bash
 npx @anov/gis-skills-cli mcp show              # 看当前状态
-npx @anov/gis-skills-cli mcp add               # 补上（默认 Claude Code + 用户级）
-npx @anov/gis-skills-cli mcp add --mcp-agent codex
+npx @anov/gis-skills-cli mcp add               # 补上（默认 Claude Code + Codex + 用户级）
+npx @anov/gis-skills-cli mcp add --mcp-agent cursor
 npx @anov/gis-skills-cli mcp remove            # 拿掉
 ```
 
@@ -100,7 +100,7 @@ npx @anov/gis-skills-cli mcp remove            # 拿掉
 
 | 参数 | 说明 |
 |---|---|
-| `--mcp-agent <名字>` | `claude-code`（默认）/ `codex` / `cursor` / `vscode` |
+| `--mcp-agent <名字...>` | `claude-code` / `codex`（默认这两个都写）/ `cursor` / `vscode`，可指定多个 |
 | `--mcp-mode stdio\|http` | 默认 `stdio`（本地起进程）；`http` 连服务器 |
 | `--mcp-url <地址>` | HTTP 模式必填，例如 `http://192.168.11.164:3000/mcp` |
 | `--mcp-command` / `--mcp-arg` | 自定义 stdio 启动命令（默认 `npx -y anov-gis-mcp --stdio`） |
@@ -132,6 +132,9 @@ npx @anov/gis-skills-cli doctor
 
 ── MCP · Claude Code（用户级） ──  C:\Users\你\.claude.json
   ✓ 已配置（stdio）
+
+── MCP · Codex（用户级） ──  C:\Users\你\.codex\config.toml
+  ✓ 已配置（stdio）
 ```
 
 | 检查项 | 不通过意味着 |
@@ -241,7 +244,7 @@ Claude Code 走 marketplace，多两个好处：**发版后自动升级**、**
 
 > ⚠️ **版本约束只对 `enabledPlugins` 生效**。`/plugin install` 与 `claude plugin install` 的参数只接受 `插件名` 或 `插件名@市场名`（第三段会被丢弃），所以**命令行装的时候锁不住版本** —— 要锁版本就靠 settings 里的 `enabledPlugins`。
 
-**完全锁死（不推荐）**：把约束写成精确版本 `anov-gis-skills@anov-gis-skills@0.3.0`。精确锁定后**不会自动升级**，每次发版都要人工改这一行 —— 这正是 v0.2.15 之前"发完版还要挨个催"的原因。
+**完全锁死（不推荐）**：把约束写成精确版本 `anov-gis-skills@anov-gis-skills@0.3.3`。精确锁定后**不会自动升级**，每次发版都要人工改这一行 —— 这正是 v0.2.15 之前"发完版还要挨个催"的原因。
 
 ### B.4 插件缓存位置
 
@@ -448,9 +451,9 @@ git clone https://github.com/CesiumGS/cesiumjs-skills.git ~/.codex/skills/cesium
 | 场景 | 说明 |
 |---|---|
 | 首次开启 `autoUpdate` | 2026-10 之前装的，`known_marketplaces.json` 里 `autoUpdate` 默认是 `false`（第三方 marketplace 的默认值）。改一次 §方式 B.2 的配置或跑一次 `/plugin marketplace update` 即可 |
-| 用了精确锁版本 | `anov-gis-skills@anov-gis-skills@0.3.0` 这种精确锁定**不会自动升级**，必须改这一行 |
+| 用了精确锁版本 | `anov-gis-skills@anov-gis-skills@0.3.3` 这种精确锁定**不会自动升级**，必须改这一行 |
 | 提示 restart required | 重开 Claude Code 会话 |
-| 想立刻跳到指定版本 | `/plugin install anov-gis-skills@anov-gis-skills@0.3.0`（降级同理） |
+| 想立刻跳到指定版本 | `/plugin install anov-gis-skills@anov-gis-skills@0.3.3`（降级同理） |
 
 ### 查看当前版本
 
@@ -461,7 +464,7 @@ git clone https://github.com/CesiumGS/cesiumjs-skills.git ~/.codex/skills/cesium
 
 ### 破坏性变更
 
-**从 v0.1.1 升级到 v0.3.0 的破坏性变更**：无。所有 v0.1.1 skill 在 v0.3.0 仍然可用；v0.2.0 新增 3 个 skill + DOMAINS 强化；v0.2.1–v0.3.0 为修复性版本（skill 名称与目录结构未变）。
+**从 v0.1.1 升级到 v0.3.3 的破坏性变更**：无。所有 v0.1.1 skill 在 v0.3.3 仍然可用；v0.2.0 新增 3 个 skill + DOMAINS 强化；v0.2.1–v0.3.3 为修复性版本（skill 名称与目录结构未变）。
 
 ---
 

package/README.md

@@ -24,7 +24,7 @@ npx @anov/gis-skills-cli setup      # 27 个 skill + MCP 接入
 `setup` 做两件事：
 
 1. 把 **27 个 skill** 落到各智能体的标准目录（`~/.claude/skills/`、`~/.agents/skills/` 等）
-2. 写一条 **MCP 配置**（默认 Claude Code，stdio 直连 `anov-gis-mcp`）—— 不想要就加 `--no-mcp`
+2. 写 **MCP 配置**（默认 Claude Code + Codex，stdio 直连 `anov-gis-mcp`）—— 不想要就加 `--no-mcp`
 
 不需要预先 `npm i -g`，也不需要 clone 本仓库。
 
@@ -34,11 +34,11 @@ npx @anov/gis-skills-cli setup      # 27 个 skill + MCP 接入
 npx @anov/gis-skills-cli setup --project          # 装到当前项目（默认用户级）
 npx @anov/gis-skills-cli setup --agent cursor     # 只装给某个智能体
 npx @anov/gis-skills-cli setup --no-mcp           # 只装 skill，不碰 MCP
-npx @anov/gis-skills-cli mcp add --mcp-agent codex  # MCP 单独接到 Codex
+npx @anov/gis-skills-cli mcp add --mcp-agent cursor  # MCP 接到 Cursor（默认 Claude Code + Codex）
 npx @anov/gis-skills-cli uninstall                # 清理（只删自己的）
 ```
 
-完整参数见 [INSTALL.md](INSTALL.md)。
+完整参数见 [INSTALL.md](https://cdn.jsdelivr.net/npm/@anov/gis-skills-cli@0.3.3/INSTALL.md)。
 
 
 ### 验证
@@ -51,7 +51,7 @@ npx @anov/gis-skills-cli doctor
 
 新开一个会话提问"flowPolyline 颜色怎么改"，应自动激活 `anovgis-materials` 并给出溯源 snippet。
 
-安装排错见 [INSTALL.md](INSTALL.md#排错)；地图黑屏 / Workers 404 / 材质不生效等问题看下面的「报错排查」。
+安装排错见 [INSTALL.md](https://cdn.jsdelivr.net/npm/@anov/gis-skills-cli@0.3.3/INSTALL.md) 的「排错」一节；地图黑屏 / Workers 404 / 材质不生效等问题看下面的「报错排查」。
 
 ---
 
@@ -77,7 +77,7 @@ npx @anov/gis-skills-cli doctor
 
 ### 改 SDK 自带 demo
 
-团队最常见的场景是「复制 SDK 自带 demo → 改成自己的业务」。137 个 demo 的路由表在 [`skills/using-anovgis/DEMO-SKILL-MAP.md`](skills/using-anovgis/DEMO-SKILL-MAP.md)。
+团队最常见的场景是「复制 SDK 自带 demo → 改成自己的业务」。137 个 demo 的路由表在 [`skills/using-anovgis/DEMO-SKILL-MAP.md`](https://cdn.jsdelivr.net/npm/@anov/gis-skills-cli@0.3.3/skills/using-anovgis/DEMO-SKILL-MAP.md)。
 
 直接跟 AI 说文件名 + 想改什么，它会自动路由：
 
@@ -143,7 +143,7 @@ npx @anov/gis-skills-cli mcp remove    # 拿掉
 | 11 | `anovgis-effects` | 天气 / 漫游 / 动画 / 后期处理（Bloom / 夜视 / 景深 / 黑白）+ 天空盒 | weather、roaming、AroundPoint、FlyManager、bloom、skybox |
 | 12 | `anovgis-pitfalls` | Cesium 1.143 + v1.8.6 典型陷阱（P0–P12）+ 自定义图元报错 | 黑屏、白屏、不生效、报错、Workers 404、AMD、CustomPrimitive |
 
-完整路由（用户意图 → skill）见 `skills/using-anovgis/SKILL.md`；完整 demo 路由（demo 文件名 → skill）见 [`skills/using-anovgis/DEMO-SKILL-MAP.md`](skills/using-anovgis/DEMO-SKILL-MAP.md)。
+完整路由（用户意图 → skill）见 `skills/using-anovgis/SKILL.md`；完整 demo 路由（demo 文件名 → skill）见 [`skills/using-anovgis/DEMO-SKILL-MAP.md`](https://cdn.jsdelivr.net/npm/@anov/gis-skills-cli@0.3.3/skills/using-anovgis/DEMO-SKILL-MAP.md)。
 
 另外 15 个 Cesium skill 由官方 `cesiumjs-skills` 提供（`cesiumjs-3d-tiles` / `cesiumjs-camera` / `cesiumjs-primitives` …），
 `using-cesiumjs-skills` 是它们的入口 —— 由 `using-anovgis` 自动转过去，你一般不用直接调用。

package/RELEASING.md

@@ -79,18 +79,20 @@ node scripts/bump.mjs --check    # 校验所有版本位一致（发版前自检
 10. **结构自检**：`node scripts/check-structure.mjs` —— 相对链接 / 锚点 / frontmatter / 章节完整性，不一致就 exit 1
 11. **npm 包自检**：`node scripts/build-npm.mjs` —— 校验两棵 skill 树的相对链接、无本机绝对路径、vendor 齐全（15 个 skill + LICENSE + NOTICE），不一致就 exit 1
 11b. **vendor 一致性**（改动过 Cesium skill 时）：`node scripts/sync-cesium.mjs --check` —— vendor 与内网镜像不一致就 exit 1；需要更新时去掉 `--check` 重新同步，并核对 `vendor/cesiumjs-skills/NOTICE` 里的版本号
-12. `git commit -am "feat: v<X.Y.Z> — ..."` + `git push`
-13. **手工补 GitLab 侧产物**（本仓库不跑 CI，这步要人工做）：打 `anov-gis-skills--v<版本>` tag，见 §四
+12. **提交推送**：用 `npm run release` 时自动完成 —— 只 `git add` bump 改写的发版文件后 commit + push（`--no-commit` 可只改文件不提交）。手工流程则 `git add` 发版文件 + `git commit -m "chore: release v<X.Y.Z>"` + `git push`
+13. **打 tag**：用 `npm run release` 时自动打 `anov-gis-skills--v<版本>` 注解 tag 并推送；不走 release 时按 §四 手工打
 14. **发 npm 包**（方式 A 的分发源）：`npm publish` —— 发到哪由仓库根 `.npmrc` 决定（内网 / 公网），见 §五
 15. **验证已发布的包**：`node scripts/verify-published.mjs` —— 确认可安装、内容与源码一致、CLI 能发现全部 skill、链接全解析，不一致就 exit 1
 
 > v0.2.15 起，第 8 步之前的手工改版本号（各 manifest + DOMAINS.md + DEMO-SKILL-MAP.md）全部由 `scripts/bump.mjs` 代劳，避免版本漂移。
+>
+> 用 `npm run release` 时，第 8–13 步（bump · 版本校验 · 结构校验 · npm 包校验 · 提交推送 · 打 tag）会一并自动执行；两道结构校验在写文件之前跑，失败则什么都不会改。
 
 ---
 
-## 四、手工打的 tag
+## 四、tag
 
-本仓库**不跑 CI**（内网 GitLab 上没有 runner），下面这步要人工执行。
+本仓库**不跑 CI**（内网 GitLab 上没有 runner），没有流水线帮你打 tag —— `npm run release` 会自动打并推送，手工发版时用下面的命令。
 
 **打 tag** —— 带版本约束的安装串（`"anov-gis-skills@anov-gis-skills@^0.3.0"`）靠这个 tag 解析版本，没有匹配 tag 会报 `no-matching-tag`：
 

package/bin/anov-gis-skills.mjs

@@ -39,11 +39,18 @@ const CESIUM_DIR = join(PKG_ROOT, "vendor", "cesiumjs-skills", "skills");
 const SKILLS_CLI = "skills@1.5.18";
 
 const MCP_PACKAGE = "anov-gis-mcp";
+const DEFAULT_MCP_AGENTS = ["claude-code", "codex"];
+
+// 用 npx 跑时脚本在 npm 缓存的 _npx 目录里，此时 `anov-gis-skills` 不在 PATH 上，
+// 提示语必须给回 npx 形式，否则用户会撞上「不是内部或外部命令」。
+const CLI_CMD = /[\\/]_npx[\\/]/.test(process.argv[1] ?? "")
+  ? "npx @anov/gis-skills-cli"
+  : "anov-gis-skills";
 
 // ---------------------------------------------------------------- 参数解析
 
 function parseArgs(argv) {
-  const out = { _: [], agents: [], mcpArgs: [], unknown: [] };
+  const out = { _: [], agents: [], mcpAgents: [], mcpArgs: [], unknown: [] };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
     if (a === "-g" || a === "--global") out.scope = "global";
@@ -55,8 +62,11 @@ function parseArgs(argv) {
     else if (a === "--mcp") out.mcp = true;
     else if (a === "-a" || a === "--agent") {
       while (argv[++i] && !argv[i].startsWith("-")) out.agents.push(argv[i]);
-    } else if (a === "--mcp-agent") out.mcpAgent = argv[++i];
-    else if (a === "--mcp-mode") out.mcpMode = argv[++i];
+    } else if (a === "--mcp-agent") {
+      while (argv[i + 1] && !argv[i + 1].startsWith("-")) {
+        for (const v of argv[++i].split(",")) if (v.trim()) out.mcpAgents.push(v.trim());
+      }
+    } else if (a === "--mcp-mode") out.mcpMode = argv[++i];
     else if (a === "--mcp-url") out.mcpUrl = argv[++i];
     else if (a === "--mcp-command") out.mcpCommand = argv[++i];
     else if (a === "--mcp-arg") {
@@ -68,26 +78,26 @@ function parseArgs(argv) {
   return out;
 }
 
-const HELP = `anov-gis-skills —— 装 skill + 接 MCP
+const HELP = `${CLI_CMD} —— 装 skill + 接 MCP
 
 用法
-  anov-gis-skills setup              装全部 skill（默认顺带写 MCP 配置）
-  anov-gis-skills mcp add            只写 MCP 配置
-  anov-gis-skills mcp remove         删掉 MCP 配置
-  anov-gis-skills mcp show           看 MCP 配置状态
-  anov-gis-skills doctor             自检（skill 完整性 + MCP 配置）
-  anov-gis-skills uninstall          清理（只删本包与本 MCP 的东西）
+  ${CLI_CMD} setup              装全部 skill（默认顺带写 MCP 配置）
+  ${CLI_CMD} mcp add            只写 MCP 配置
+  ${CLI_CMD} mcp remove         删掉 MCP 配置
+  ${CLI_CMD} mcp show           看 MCP 配置状态
+  ${CLI_CMD} doctor             自检（skill 完整性 + MCP 配置）
+  ${CLI_CMD} uninstall          清理（只删本包与本 MCP 的东西）
 
 通用选项
   --scope global|project   装到哪（默认 global = 用户级，任何项目都能用）
   -g, --global             等价于 --scope global
   --project                等价于 --scope project
-  -a, --agent <名字...>    只装给指定智能体（默认全部检测到的）
+  -a, --agent <名字...>    只装给指定智能体（默认：共享目录 + 已装的 Claude Code）
   -y, --yes                跳过所有交互
   --print                  只打印要写的内容，不落盘
 
 MCP 选项
-  --mcp-agent <名字>       写到哪个智能体（${SUPPORTED_AGENTS.join(" / ")}，默认 claude-code）
+  --mcp-agent <名字...>    写到哪个智能体（${SUPPORTED_AGENTS.join(" / ")}；默认 claude-code + codex）
   --mcp-mode stdio|http    连接方式（默认 stdio）
   --mcp-url <地址>         HTTP 模式的服务地址（stdio 模式不需要）
   --mcp-command <命令>     stdio 模式的启动命令（默认 npx）
@@ -129,14 +139,23 @@ function scopeFlags(scope) {
   return scope === "global" ? ["--global"] : [];
 }
 
+// 上游的自动检测会把 57 个 universal 系智能体全拉进来，其中 PromptScript 没有全局
+// 目录却仍在名单里，每个 skill 刷一条 Failed。所以这里只显式点名：
+// 共享目录 .agents/skills（universal 系智能体本来就读这里）+ 实际存在的 Claude Code。
+function defaultSkillAgents() {
+  return existsSync(join(homedir(), ".claude")) ? ["claude-code"] : ["universal"];
+}
+
+// 传 [] 时不加 --agent：remove 的上游语义是从所有智能体删，正好用来清旧的 symlink。
 function targetFlags(agents) {
-  return agents.length ? ["--agent", ...agents] : ["--all"];
+  return agents.length ? ["--agent", ...agents] : [];
 }
 
 // ---------------------------------------------------------------- setup
 
 function cmdSetup(opts) {
   const scope = opts.scope ?? "global";
+  const agents = opts.agents.length ? opts.agents : defaultSkillAgents();
   const anov = skillNames(SKILLS_DIR);
   const cesium = skillNames(CESIUM_DIR);
 
@@ -153,10 +172,11 @@ function cmdSetup(opts) {
   console.log(`  anov-gis  ${anov.length} 个`);
   console.log(`  cesiumjs  ${cesium.length} 个`);
   console.log(`  范围      ${scope === "global" ? "用户级（任何项目可用）" : "项目级（当前目录）"}`);
+  console.log(`  智能体    ${agents.join(", ")}`);
 
   for (const [label, dir] of [["anov-gis", SKILLS_DIR], ["cesiumjs", CESIUM_DIR]]) {
     console.log(`\n── ${label} ──`);
-    const code = runSkillsCLI(["add", dir, ...targetFlags(opts.agents), ...scopeFlags(scope), "-y"]);
+    const code = runSkillsCLI(["add", dir, "--agent", ...agents, ...scopeFlags(scope), "-y"]);
     if (code !== 0) {
       console.error(`✗ ${label} 安装失败（退出码 ${code}）`);
       process.exit(code);
@@ -165,7 +185,6 @@ function cmdSetup(opts) {
 
   if (!opts.noMcp) {
     const mode = opts.mcpMode ?? "stdio";
-    const agent = opts.mcpAgent ?? "claude-code";
     const config = buildServerConfig({
       mode,
       url: opts.mcpUrl,
@@ -173,32 +192,74 @@ function cmdSetup(opts) {
       args: opts.mcpArgs.length ? opts.mcpArgs : undefined,
       env: collectEnv(),
     });
-    writeMcp(agent, scope, config, opts.print);
+    writeMcp(mcpAgents(opts), scope, config, { printOnly: opts.print, strict: opts.mcpAgents.length > 0 });
   }
 
   console.log("\n✓ 完成");
   if (!opts.noMcp) {
-    console.log("  验证：anov-gis-skills doctor");
+    console.log(`  验证：${CLI_CMD} doctor`);
   }
 }
 
 // ---------------------------------------------------------------- MCP
 
-function mcpTargets(agent, scope) {
-  const targets = agentTargets(agent, scope);
-  if (!targets.length) {
-    console.error(`✗ ${agent} 不支持 ${scope} 级配置`);
-    console.error(`  支持的智能体：${SUPPORTED_AGENTS.join(" / ")}`);
-    process.exit(1);
+/** 默认 Claude Code + Codex；`--mcp-agent` 指定时只用指定的那些。 */
+function mcpAgents(opts) {
+  return opts.mcpAgents.length ? opts.mcpAgents : DEFAULT_MCP_AGENTS;
+}
+
+/**
+ * strict = 用户显式点名了智能体：不支持当前 scope 就直接报错。
+ * 默认集合则静默跳过（如 Codex 没有项目级配置），不算失败。
+ */
+function mcpTargets(agents, scope, strict) {
+  const out = [];
+  for (const agent of agents) {
+    if (!SUPPORTED_AGENTS.includes(agent)) {
+      console.error(`✗ 不支持的智能体：${agent}（可用：${SUPPORTED_AGENTS.join(" / ")}）`);
+      process.exit(2);
+    }
+    const targets = agentTargets(agent, scope);
+    if (!targets.length) {
+      if (strict) {
+        console.error(`✗ ${agent} 不支持 ${scope === "global" ? "用户级" : "项目级"}配置`);
+        process.exit(1);
+      }
+      continue;
+    }
+    out.push(...targets);
+  }
+  return out;
+}
+
+/** --print 的片段按目标格式输出：Codex 是 TOML，其余是 JSON。 */
+function printTarget(target, config) {
+  console.log(`\n# ${target.label} → ${target.file}`);
+  if (target.key !== null) {
+    console.log(JSON.stringify({ [target.key]: { [MCP_SERVER_NAME]: config } }, null, 2));
+    return;
+  }
+  const toml = (v) =>
+    typeof v === "string"
+      ? `"${v.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`
+      : Array.isArray(v)
+        ? `[${v.map(toml).join(", ")}]`
+        : String(v);
+  const lines = [`[mcp_servers.${MCP_SERVER_NAME}]`];
+  for (const [k, v] of Object.entries(config)) {
+    if (k !== "env") lines.push(`${k} = ${toml(v)}`);
+  }
+  if (config.env) {
+    lines.push("", `[mcp_servers.${MCP_SERVER_NAME}.env]`);
+    for (const [k, v] of Object.entries(config.env)) lines.push(`${k} = ${toml(v)}`);
   }
-  return targets;
+  console.log(lines.join("\n"));
 }
 
-function writeMcp(agent, scope, config, printOnly) {
-  for (const target of mcpTargets(agent, scope)) {
+function writeMcp(agents, scope, config, { printOnly = false, strict = false } = {}) {
+  for (const target of mcpTargets(agents, scope, strict)) {
     if (printOnly) {
-      console.log(`\n# ${target.label} → ${target.file}`);
-      console.log(JSON.stringify({ mcpServers: { [MCP_SERVER_NAME]: config } }, null, 2));
+      printTarget(target, config);
       continue;
     }
     writeServer(target, MCP_SERVER_NAME, config);
@@ -209,10 +270,11 @@ function writeMcp(agent, scope, config, printOnly) {
 function cmdMcp(opts) {
   const action = opts._[0] ?? "show";
   const scope = opts.scope ?? "global";
-  const agent = opts.mcpAgent ?? "claude-code";
+  const agents = mcpAgents(opts);
+  const strict = opts.mcpAgents.length > 0;
 
   if (action === "show") {
-    for (const target of mcpTargets(agent, scope)) {
+    for (const target of mcpTargets(agents, scope, strict)) {
       const existing = readServer(target, MCP_SERVER_NAME);
       console.log(`\n${target.label} —— ${target.file}`);
       if (!existing) {
@@ -225,7 +287,7 @@ function cmdMcp(opts) {
   }
 
   if (action === "remove") {
-    for (const target of mcpTargets(agent, scope)) {
+    for (const target of mcpTargets(agents, scope, strict)) {
       const r = removeServer(target, MCP_SERVER_NAME);
       console.log(r.removed ? `  ✓ 已删除：${target.file}` : `  · 本来就没有：${target.file}`);
     }
@@ -246,7 +308,7 @@ function cmdMcp(opts) {
     env: collectEnv(),
   });
   console.log(`\n接入 MCP（${mode}）`);
-  writeMcp(agent, scope, config, opts.print);
+  writeMcp(agents, scope, config, { printOnly: opts.print, strict });
   if (!opts.print) console.log("\n✓ 完成。重启智能体生效。");
 }
 
@@ -326,14 +388,14 @@ function cmdDoctor(opts) {
       if (existing) {
         console.log(`  ✓ 已配置（${existing.type ?? "unknown"}）`);
       } else {
-        console.log("  · 未配置 —— anov-gis-skills mcp add");
+        console.log(`  · 未配置 —— ${CLI_CMD} mcp add`);
       }
     }
   }
 
   console.log("");
   if (problems) {
-    console.error(`✗ 发现 ${problems} 处问题 —— 重装：anov-gis-skills setup\n`);
+    console.error(`✗ 发现 ${problems} 处问题 —— 重装：${CLI_CMD} setup\n`);
     process.exit(1);
   }
   console.log("✓ 检查通过\n");
@@ -357,8 +419,8 @@ function cmdUninstall(opts) {
     process.exit(code);
   }
 
-  const agent = opts.mcpAgent ?? "claude-code";
-  for (const target of mcpTargets(agent, scope)) {
+  const agents = mcpAgents(opts);
+  for (const target of mcpTargets(agents, scope, opts.mcpAgents.length > 0)) {
     const r = removeServer(target, MCP_SERVER_NAME);
     console.log(r.removed ? `  ✓ 已删除 MCP 条目：${target.file}` : `  · 没有 MCP 条目：${target.file}`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anov/gis-skills-cli",
-  "version": "0.3.0",
+  "version": "0.3.3",
   "description": "12 个 @anov/gis (Cesium 1.143) 领域 skill + 15 个 Cesium 原生 skill，外加 anov-gis-mcp 的接入配置。一条命令装到 Claude Code / Codex / Cursor 等智能体。",
   "type": "module",
   "license": "ISC AND Apache-2.0",
@@ -38,6 +38,7 @@
     "cursor"
   ],
   "scripts": {
+    "release": "node scripts/release.cjs",
     "prepublishOnly": "node scripts/bump.mjs --check && node scripts/check-structure.mjs",
     "pack:check": "node scripts/build-npm.mjs"
   }

package/skills/using-anovgis/DEMO-SKILL-MAP.md

@@ -1,7 +1,7 @@
 # DEMO-SKILL-MAP.md — 137 个 demo → Skill 路由矩阵
 
 > **SDK 版本基准：** @anov/gis v1.8.6（基于 Cesium 1.143.0）
-> **Plugin 版本：** anov-gis-skills v0.3.0
+> **Plugin 版本：** anov-gis-skills v0.3.3
 > **Demo 来源：** ANOV-GIS 仓库 `examples/public/examples/html/`（仓库内相对路径）共 137 个 .html 文件，按 13 类目分组
 
 本文档是 demo **文件名** → skill 的**完整版**路由矩阵（`using-anovgis/DEMO-MAP.md` 是场景级的简版）。当用户提到具体 demo 文件名或场景时，按本表路由到对应 skill。

package/skills/using-anovgis/DOMAINS.md

@@ -1,7 +1,7 @@
 # DOMAINS.md — anov-gis-skills 权威归属
 
 > **SDK 版本基准：** @anov/gis **v1.8.6**（基于 Cesium **1.143.0**）
-> **Plugin 版本：** anov-gis-skills **v0.3.0**
+> **Plugin 版本：** anov-gis-skills **v0.3.3**
 > **Skill 数：** **12**（含 `using-anovgis` 入口 + 3 个 v0.2.0 新增 skill）
 > **入口 skill 额外职责**：引导式初始化（AskUserQuestion 向导：底图 / 控件 / 部署；**技术栈固定 Vue 3 + Vite**）