@anov/gis-skills-cli 0.3.0 → 0.3.4

package/CHANGELOG.md

@@ -4,6 +4,30 @@
 
 ## [Unreleased]
 
+## [0.3.4] - 2026-11-02
+
+- feat: setup 按检测到的智能体安装 skill 与 MCP，修 Codex 装错目录 (`1379891`)
+
+
+## [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

@@ -44,10 +44,10 @@ anov-gis-skills setup
 
 ```bash
 # 装到哪（默认用户级，任何项目都能用）
-npx @anov/gis-skills-cli setup              # → ~/.claude/skills/ 等
+npx @anov/gis-skills-cli setup              # → 探测到的智能体各自的 skill 目录
 npx @anov/gis-skills-cli setup --project    # → ./.claude/skills/，可提交进项目仓库
 
-# 装给谁（默认全部检测到的智能体）
+# 装给谁（默认：探测到的所有智能体）
 npx @anov/gis-skills-cli setup --agent claude-code
 npx @anov/gis-skills-cli setup --agent claude-code --agent codex
 
@@ -60,13 +60,35 @@ npx @anov/gis-skills-cli setup --print
 
 ### A.3 各智能体的落点
 
-| 智能体 | skill 装到 | MCP 配置写到 |
-|---|---|---|
-| Claude Code | `~/.claude/skills/` | `~/.claude.json` 的 `mcpServers`（项目级 → `./.mcp.json`） |
-| Codex | `~/.codex/skills/` | `~/.codex/config.toml` 的 `[mcp_servers.anov-gis]` |
-| Cursor | `~/.agents/skills/` | `~/.cursor/mcp.json`（项目级 → `./.cursor/mcp.json`） |
-| VS Code | `~/.agents/skills/` | `./.vscode/mcp.json` 的 `servers` |
-| Cline / Windsurf / Continue 等 | `~/.agents/skills/` | 不支持（打印片段自行粘贴） |
+`setup` 探测本机装了哪些智能体 —— **判定标准是「配置目录存在且非空」**（空目录不算），只装给探测到的那些：
+
+| 智能体 | 探测目录 | skill 装到 | MCP 配置写到 |
+|---|---|---|---|
+| Claude Code | `~/.claude` | `~/.claude/skills/` | `~/.claude.json` 的 `mcpServers`（项目级 → `./.mcp.json`） |
+| Codex | `~/.codex` | `~/.codex/skills/` | `~/.codex/config.toml` 的 `[mcp_servers.anov-gis]` |
+| Cursor | `~/.cursor` | `~/.cursor/skills/` | `~/.cursor/mcp.json`（项目级 → `./.cursor/mcp.json`） |
+| OpenClaw | `~/.openclaw` | `~/.openclaw/skills/` | 不支持 |
+| Hermes Agent | `~/.hermes` | `~/.hermes/skills/` | 不支持 |
+| Trae | `~/.trae` | `~/.trae/skills/` | 不支持 |
+| Trae CN | `~/.trae-cn` | `~/.trae-cn/skills/` | 不支持 |
+| Gemini CLI | `~/.gemini` | `~/.gemini/skills/` | 不支持 |
+| Antigravity | `~/.gemini/config` | `~/.gemini/config/skills/` | 不支持 |
+| GitHub Copilot | `~/.copilot` | `~/.copilot/skills/` | 不支持 |
+| VS Code | `./.vscode` | 不支持 | `./.vscode/mcp.json` 的 `servers`（仅项目级） |
+| Claude 桌面端 | `%APPDATA%/Claude` | 不支持（只能在 UI 里上传） | `claude_desktop_config.json` 的 `mcpServers` |
+| 共享目录 | `~/.kimi-code` / `~/.cline` / `~/.dexto` / `~/.loaf` / `~/.warp` 等任一 | `~/.agents/skills/` | 不支持 |
+
+> **落点为什么不全信上游。** 底层 `skills` CLI 把所有「项目级 skill 目录是 `.agents/skills`」的智能体归成一族，
+> 用户级一律装到 `~/.agents/skills`。这对 Codex / Cursor / Gemini CLI / Antigravity / Copilot 都是错的 ——
+> 它们各有自己的用户级目录（如 Codex 只读 `~/.codex/skills`）。这几个由本 CLI 直接复制到正确位置，
+> 装完还会核对一遍落点，上游算错就兜底。
+
+> **几个容易搞混的读法。**
+> - Cursor 同时读 `~/.agents/skills/` 和 `~/.cursor/skills/`，但**只有 `~/.cursor/skills/` 会同步到 Cloud Agents**。
+> - Codex 只读 `~/.codex/skills`（`~/.agents/skills` 是项目级路径）。
+> - Antigravity 的 App / CLI / IDE 现在共用 `~/.gemini/config/skills/`，**App 不读 `~/.gemini/skills/`**。
+> - Claude Code 桌面版（Code 标签页）与 CLI 共享 `~/.claude/skills`，装一次两边都有。
+> - 「Claude 桌面端」指 claude.ai 桌面聊天端，它的 skill 只能在 UI 里上传，本 CLI 只能帮它写 MCP。
 
 底层 `skills` CLI 版本**锁定在 `skills@1.5.18`**（不是 latest）：1.6.0+ 的 `engines` 要求 `node >= 22.20.0`，而团队环境实测是 node 22.19.0，锁低版本才能在 node ≥ 18 全覆盖。
 
@@ -87,12 +109,12 @@ npx @anov/gis-skills-cli setup --print
 
 ### A.5 MCP 接入
 
-`setup` 默认会写一条 MCP 配置（stdio 直连 `anov-gis-mcp`）。单独管理：
+`setup` 默认给**探测到的**每个智能体各写一条 MCP 配置（stdio 直连 `anov-gis-mcp`）—— 没装的智能体不会留配置，避免「MCP 配好了但一个 skill 都没有」的半装状态。单独管理：
 
 ```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               # 补上（默认写给检测到的智能体 + 用户级）
+npx @anov/gis-skills-cli mcp add --mcp-agent cursor
 npx @anov/gis-skills-cli mcp remove            # 拿掉
 ```
 
@@ -100,7 +122,7 @@ npx @anov/gis-skills-cli mcp remove            # 拿掉
 
 | 参数 | 说明 |
 |---|---|
-| `--mcp-agent <名字>` | `claude-code`（默认）/ `codex` / `cursor` / `vscode` |
+| `--mcp-agent <名字...>` | `claude-code` / `codex` / `cursor` / `vscode` / `claude-desktop`，可指定多个；不指定就只写检测到的 |
 | `--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`） |
@@ -121,17 +143,28 @@ npx @anov/gis-skills-cli mcp remove            # 拿掉
 npx @anov/gis-skills-cli doctor
 ```
 
-逐个目录报：
+逐个落点报：
 
 ```
 包内 skill 数：27
 
-── Claude Code ──  C:\Users\你\.claude\skills
-  ✓ 27 个 skill 齐全
+── skill 落点 ──
+  ✓ Claude Code      C:\Users\你\.claude\skills —— 27/27 齐全
+  ✓ frontmatter 全部可被严格 YAML 解析
+  ✓ Codex            C:\Users\你\.codex\skills —— 27/27 齐全
   ✓ frontmatter 全部可被严格 YAML 解析
+  · Cursor           C:\Users\你\.cursor\skills —— 未安装该智能体
+
+── MCP ──
 
-── MCP · Claude Code（用户级） ──  C:\Users\你\.claude.json
+  Claude Code（用户级） —— C:\Users\你\.claude.json
   ✓ 已配置（stdio）
+
+  Codex（用户级） —— C:\Users\你\.codex\config.toml
+  ✓ 已配置（stdio）
+
+── 一致性 ──
+  ✓ 没有「MCP 配了但 skill 缺失」的半装状态
 ```
 
 | 检查项 | 不通过意味着 |
@@ -139,6 +172,7 @@ npx @anov/gis-skills-cli doctor
 | skill 齐全 | 装漏了，或只装了一部分（单独装部分 skill 时跨 skill 链接会失效） |
 | frontmatter 可被严格 YAML 解析 | 某些 agent 的 skill 加载器会**整个跳过**这个 skill（v0.2.17 踩过：只发现 10/12） |
 | MCP 已配置 | 少了条目 —— 跑 `mcp add` |
+| 一致性 | 该智能体 MCP 配了但一个 skill 都没有 —— 跑 `setup` 补上 |
 
 有问题会逐条列出并以退出码 1 结束。
 
@@ -241,7 +275,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.4`。精确锁定后**不会自动升级**，每次发版都要人工改这一行 —— 这正是 v0.2.15 之前"发完版还要挨个催"的原因。
 
 ### B.4 插件缓存位置
 
@@ -294,7 +328,8 @@ npx skills add <repo-url> -l
 npx skills update
 ```
 
-- 装到 `~/.claude/skills/`（Claude Code）、`~/.codex/skills/`（Codex）等标准位置
+- 装到 `~/.claude/skills/`（Claude Code）、`~/.agents/skills/`（Codex / Cursor / Cline 等共用一个目录）等位置
+  —— 上游把「项目级目录是 `.agents/skills`」的一族都归到共享目录，Codex 的 `~/.codex/skills`、Cursor 的 `~/.cursor/skills` 不会被填；要装对请用 §方式 A
 - 默认**拷贝**（`--copy` 是显式开关，默认行为随版本变化）；加 `--copy` 强制拷贝
 - **不带 cesiumjs-skills** —— 这条路没有 marketplace 的 `dependencies` 机制，Cesium 原生 skill 要单独装（见 §方式 B.5）
 
@@ -448,9 +483,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.4` 这种精确锁定**不会自动升级**，必须改这一行 |
 | 提示 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.4`（降级同理） |
 
 ### 查看当前版本
 
@@ -461,7 +496,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.4 的破坏性变更**：无。所有 v0.1.1 skill 在 v0.3.4 仍然可用；v0.2.0 新增 3 个 skill + DOMAINS 强化；v0.2.1–v0.3.4 为修复性版本（skill 名称与目录结构未变）。
 
 ---
 
@@ -474,5 +509,7 @@ git clone https://github.com/CesiumGS/cesiumjs-skills.git ~/.codex/skills/cesium
 | 插件装了但 skill 一个都没出现 | frontmatter 没被严格 YAML 解析 | 跑 `npx @anov/gis-skills-cli doctor` 看哪几条断了 |
 | skill 只有一部分能用 | 单独装了部分 skill，指向兄弟 skill 的相对链接失效 | 全量装（12 个同级），别只装一个 |
 | `doctor` 报 skill 不齐 | 只装了一部分 | 重跑 `setup`；仓库侧跑 `node scripts/build-npm.mjs` 复查 |
+| `doctor` 报「MCP 配了但 skill 缺失」 | MCP 写了但 skill 没装上（0.3.3 的 bug：只装 Claude Code，MCP 却写了 Codex） | 重跑 `setup`（当前版本起按检测结果装齐） |
+| Codex 里看不到 skill | skill 被装到了 `~/.agents/skills`，而 Codex 只读 `~/.codex/skills` | 重跑 `setup`（当前版本起直装到 `~/.codex/skills`） |
 | 已装过官方 `cesiumjs-skills` 导致触发混乱 | 官方版与内网镜像版注册了同名 skill | 见 §方式 B.5 的卸载步骤二选一 |
 | Chrome DevTools MCP 起不来 | 内网访问不了 npm registry | 不影响 skill 本身，可忽略 |

package/README.md

@@ -23,8 +23,8 @@ 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`
+1. 探测本机装了哪些智能体（配置目录存在且非空），把 **27 个 skill** 装到它们各自读 skill 的目录
+2. 写 **MCP 配置**（只写探测到的智能体，stdio 直连 `anov-gis-mcp`）—— 不想要就加 `--no-mcp`
 
 不需要预先 `npm i -g`，也不需要 clone 本仓库。
 
@@ -32,13 +32,14 @@ npx @anov/gis-skills-cli setup      # 27 个 skill + MCP 接入
 
 ```bash
 npx @anov/gis-skills-cli setup --project          # 装到当前项目（默认用户级）
-npx @anov/gis-skills-cli setup --agent cursor     # 只装给某个智能体
+npx @anov/gis-skills-cli setup --agent cursor     # 只装给某个智能体（跳过探测）
+npx @anov/gis-skills-cli setup --agent codex --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（默认写给检测到的智能体）
 npx @anov/gis-skills-cli uninstall                # 清理（只删自己的）
 ```
 
-完整参数见 [INSTALL.md](INSTALL.md)。
+完整参数见 [INSTALL.md](https://cdn.jsdelivr.net/npm/@anov/gis-skills-cli@0.3.4/INSTALL.md)。
 
 
 ### 验证
@@ -47,11 +48,11 @@ npx @anov/gis-skills-cli uninstall                # 清理（只删自己的）
 npx @anov/gis-skills-cli doctor
 ```
 
-逐个目录报：27 个 skill 是否齐全、frontmatter 能否被严格 YAML 解析、MCP 条目写没写对。
+逐个落点报：27 个 skill 是否齐全、frontmatter 能否被严格 YAML 解析、MCP 条目写没写对，以及有没有「MCP 配了但 skill 缺失」的半装状态。
 
 新开一个会话提问"flowPolyline 颜色怎么改"，应自动激活 `anovgis-materials` 并给出溯源 snippet。
 
-安装排错见 [INSTALL.md](INSTALL.md#排错)；地图黑屏 / Workers 404 / 材质不生效等问题看下面的「报错排查」。
+安装排错见 [INSTALL.md](https://cdn.jsdelivr.net/npm/@anov/gis-skills-cli@0.3.4/INSTALL.md) 的「排错」一节；地图黑屏 / Workers 404 / 材质不生效等问题看下面的「报错排查」。
 
 ---
 
@@ -77,7 +78,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.4/skills/using-anovgis/DEMO-SKILL-MAP.md)。
 
 直接跟 AI 说文件名 + 想改什么，它会自动路由：
 
@@ -143,7 +144,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.4/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

@@ -5,12 +5,18 @@
 //   anov-gis-skills setup        装全部 skill（+ 写 MCP 配置）
 //   anov-gis-skills mcp add      只写 MCP 配置
 //   anov-gis-skills mcp remove   删掉 MCP 配置
-//   anov-gis-skills mcp show      看当前配置状态
-//   anov-gis-skills doctor        自检
-//   anov-gis-skills uninstall     清理
+//   anov-gis-skills mcp show     看当前配置状态
+//   anov-gis-skills doctor       自检
+//   anov-gis-skills uninstall    清理
 //
-// 底层用 vercel-labs 的 skills CLI（npm 包 `skills`）搬 skill —— 它管着 30+ 智能体的
-// skills 目录映射。锁 1.5.18 而不是 latest：1.6.0+ 的 engines 要求 node >= 22.20.0，
+// 装到哪、写到哪，都由 lib/agents.mjs 的一张表决定：探测本机装了哪些智能体
+// （配置目录存在且非空），只装给它们，MCP 也只写给它们。
+//
+// 底层用 vercel-labs 的 skills CLI（npm 包 `skills`）搬 skill —— 但只用于它能
+// 算对落点的那些 agent。它把所有 skillsDir === ".agents/skills" 的 agent 归进
+// universal 一族、一律装到 ~/.agents/skills，会把 codex / cursor / gemini-cli
+// 这些另有独立目录的 agent 装错地方，那些由我们自己 copy（见 lib/agents.mjs）。
+// 锁 1.5.18 而不是 latest：1.6.0+ 的 engines 要求 node >= 22.20.0，
 // 而团队环境实测是 node 22.19.0，锁低版本才能在 node >= 18 全覆盖。
 //
 // MCP 配置由我们自己写（lib/mcp-config.mjs），不引第三方库 —— 只覆盖我们真正常用的
@@ -20,7 +26,6 @@ import { spawnSync } from "node:child_process";
 import { readdirSync, existsSync, readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { dirname, join, resolve } from "node:path";
-import { homedir } from "node:os";
 
 import {
   MCP_SERVER_NAME,
@@ -33,17 +38,30 @@ import {
   writeServer,
 } from "../lib/mcp-config.mjs";
 
+import {
+  SKILL_TARGETS,
+  detectMcpAgents,
+  detectSkillTargets,
+  resolveSkillDir,
+  installSelf,
+  uninstallSelf,
+} from "../lib/agents.mjs";
+
 const PKG_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
 const SKILLS_DIR = join(PKG_ROOT, "skills");
 const CESIUM_DIR = join(PKG_ROOT, "vendor", "cesiumjs-skills", "skills");
 const SKILLS_CLI = "skills@1.5.18";
 
-const MCP_PACKAGE = "anov-gis-mcp";
+// 用 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";
@@ -54,13 +72,18 @@ function parseArgs(argv) {
     else if (a === "--no-mcp") out.noMcp = true;
     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];
+      // 只在真的吃到值时才推进 i —— 否则下一个 "-" 开头的 flag 会被连同位置
+      // 一起跳过（`--agent codex --no-mcp` 会把 --no-mcp 吞掉）
+      while (i + 1 < argv.length && !argv[i + 1].startsWith("-")) out.agents.push(argv[++i]);
+    } else if (a === "--mcp-agent") {
+      while (i + 1 < argv.length && !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") {
-      while (argv[++i] && !argv[i].startsWith("-")) out.mcpArgs.push(argv[i]);
+      while (i + 1 < argv.length && !argv[i + 1].startsWith("-")) out.mcpArgs.push(argv[++i]);
     } else if (a === "-h" || a === "--help") out.help = true;
     else if (a.startsWith("-")) out.unknown.push(a);
     else out._.push(a);
@@ -68,26 +91,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 <名字...>    只装给指定智能体（默认：本机检测到的智能体）
   -y, --yes                跳过所有交互
   --print                  只打印要写的内容，不落盘
 
 MCP 选项
-  --mcp-agent <名字>       写到哪个智能体（${SUPPORTED_AGENTS.join(" / ")}，默认 claude-code）
+  --mcp-agent <名字...>    写到哪个智能体（${SUPPORTED_AGENTS.join(" / ")}；默认：检测到的）
   --mcp-mode stdio|http    连接方式（默认 stdio）
   --mcp-url <地址>         HTTP 模式的服务地址（stdio 模式不需要）
   --mcp-command <命令>     stdio 模式的启动命令（默认 npx）
@@ -97,17 +120,18 @@ MCP 选项
 
 // ---------------------------------------------------------------- 基础工具
 
-function skillNames(dir) {
+/** 一个 skill 的来源：名字 + 它在包里的目录。 */
+function skillSources(dir) {
   if (!existsSync(dir)) return [];
   return readdirSync(dir, { withFileTypes: true })
     .filter((d) => d.isDirectory() && existsSync(join(dir, d.name, "SKILL.md")))
-    .map((d) => d.name)
-    .sort();
+    .map((d) => ({ name: d.name, srcDir: dir }))
+    .sort((a, b) => a.name.localeCompare(b.name));
 }
 
 /** 本包提供的全部 skill：anov-gis 12 个 + Cesium 15 个。 */
 function allSkillNames() {
-  return [...skillNames(SKILLS_DIR), ...skillNames(CESIUM_DIR)];
+  return [...skillSources(SKILLS_DIR), ...skillSources(CESIUM_DIR)].map((s) => s.name);
 }
 
 function runSkillsCLI(extra, { quiet = false } = {}) {
@@ -129,16 +153,32 @@ function scopeFlags(scope) {
   return scope === "global" ? ["--global"] : [];
 }
 
-function targetFlags(agents) {
-  return agents.length ? ["--agent", ...agents] : ["--all"];
+/** 目标落点。scope=project 时相对当前目录，global 时按表里的用户级落点。 */
+function targetDir(target, scope = "global") {
+  return resolveSkillDir(target, scope);
+}
+
+/** --agent 的名字 → 安装目标。同时接受我们的 id 和上游的 agent 名。 */
+function targetsByName(names) {
+  const out = [];
+  for (const name of names) {
+    const t = SKILL_TARGETS.find((x) => x.id === name || x.upstream === name);
+    if (!t) {
+      console.error(`✗ 不支持的智能体：${name}`);
+      console.error(`  可用：${SKILL_TARGETS.map((x) => x.id).join(" / ")}`);
+      process.exit(2);
+    }
+    if (!out.includes(t)) out.push(t);
+  }
+  return out;
 }
 
 // ---------------------------------------------------------------- setup
 
 function cmdSetup(opts) {
   const scope = opts.scope ?? "global";
-  const anov = skillNames(SKILLS_DIR);
-  const cesium = skillNames(CESIUM_DIR);
+  const anov = skillSources(SKILLS_DIR);
+  const cesium = skillSources(CESIUM_DIR);
 
   if (!anov.length) {
     console.error("✗ 包内找不到 skill（skills/ 目录缺失或为空）");
@@ -149,23 +189,58 @@ function cmdSetup(opts) {
     process.exit(1);
   }
 
+  const detected = detectSkillTargets();
+  const targets = opts.agents.length ? targetsByName(opts.agents) : detected;
+
   console.log(`\n安装 ${anov.length + cesium.length} 个 skill`);
   console.log(`  anov-gis  ${anov.length} 个`);
   console.log(`  cesiumjs  ${cesium.length} 个`);
   console.log(`  范围      ${scope === "global" ? "用户级（任何项目可用）" : "项目级（当前目录）"}`);
+  if (targets.length) {
+    console.log(`  智能体    ${opts.agents.length ? "（指定）" : "（检测到）"}`);
+    for (const t of targets) console.log(`    · ${t.label.padEnd(16)} ${targetDir(t, scope)}`);
+  } else {
+    console.log("  智能体    未检测到任何智能体 —— 用 --agent 指定");
+  }
 
-  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"]);
-    if (code !== 0) {
-      console.error(`✗ ${label} 安装失败（退出码 ${code}）`);
-      process.exit(code);
+  if (!targets.length) {
+    console.error("\n✗ 没有目标智能体可装");
+    process.exit(1);
+  }
+
+  // 走上游的：它能算对这些 agent 的落点
+  const upstreamTargets = targets.filter((t) => t.upstream);
+  if (upstreamTargets.length) {
+    const agentNames = upstreamTargets.map((t) => t.upstream);
+    for (const [label, dir] of [["anov-gis", SKILLS_DIR], ["cesiumjs", CESIUM_DIR]]) {
+      console.log(`\n── ${label} ──`);
+      const code = runSkillsCLI(["add", dir, "--agent", ...agentNames, ...scopeFlags(scope), "-y"]);
+      if (code !== 0) {
+        console.error(`✗ ${label} 安装失败（退出码 ${code}）`);
+        process.exit(code);
+      }
+    }
+  }
+
+  // 自己 copy 的：上游会把它们装错目录
+  const skills = [...anov, ...cesium];
+  const fallback = targets.filter((t) => !t.upstream);
+  for (const t of upstreamTargets) {
+    // 上游装完核对落点 —— 它要是算错了目录，这里兜住
+    const dir = targetDir(t, scope);
+    if (!skills.every((s) => existsSync(join(dir, s.name, "SKILL.md")))) fallback.push(t);
+  }
+  if (fallback.length) {
+    console.log(`\n── 直装（上游落点有误，改为直接复制）──`);
+    for (const t of fallback) {
+      const dir = targetDir(t, scope);
+      installSelf({ skillDir: dir }, skills);
+      console.log(`  ✓ ${t.label}：${skills.length} 个 → ${dir}`);
     }
   }
 
   if (!opts.noMcp) {
     const mode = opts.mcpMode ?? "stdio";
-    const agent = opts.mcpAgent ?? "claude-code";
     const config = buildServerConfig({
       mode,
       url: opts.mcpUrl,
@@ -173,32 +248,79 @@ function cmdSetup(opts) {
       args: opts.mcpArgs.length ? opts.mcpArgs : undefined,
       env: collectEnv(),
     });
-    writeMcp(agent, scope, config, opts.print);
+    writeMcp(mcpAgents(opts, scope), 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);
+/** 默认只写探测到的智能体；--mcp-agent 显式点名时用点名的那些。 */
+function mcpAgents(opts, scope = "global") {
+  if (opts.mcpAgents.length) return opts.mcpAgents;
+  const detected = new Set(detectMcpAgents(scope).map((a) => a.id));
+  return SUPPORTED_AGENTS.filter((a) => detected.has(a) && agentTargets(a, scope).length);
+}
+
+/**
+ * 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)}`);
   }
-  return targets;
+  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)}`);
+  }
+  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 +331,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, scope);
+  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 +348,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 +369,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✓ 完成。重启智能体生效。");
 }
 
@@ -267,43 +390,32 @@ function frontmatterOk(text) {
   return { ok: true, name: name[1] };
 }
 
-/** 智能体的 skills 目录（用户级 / 项目级），与 skills CLI 的落点一致。 */
-function installedSkillDirs(scope) {
-  const home = homedir();
-  const bases =
-    scope === "global"
-      ? [
-          ["Claude Code", join(home, ".claude", "skills")],
-          ["Codex", join(home, ".codex", "skills")],
-          ["通用 / Cursor", join(home, ".agents", "skills")],
-        ]
-      : [
-          ["Claude Code", join(process.cwd(), ".claude", "skills")],
-          ["Codex / 通用", join(process.cwd(), ".agents", "skills")],
-        ];
-  return bases.filter(([, dir]) => existsSync(dir));
-}
-
 function cmdDoctor(opts) {
   const scope = opts.scope ?? "global";
   const expected = allSkillNames();
+  const detected = detectSkillTargets();
   let problems = 0;
 
   console.log(`\n检查 @anov/gis-skills-cli\n`);
   console.log(`包内 skill 数：${expected.length}`);
 
-  for (const [label, dir] of installedSkillDirs(scope)) {
+  console.log(`\n── skill 落点 ──`);
+  const skillStatus = new Map();
+  for (const target of SKILL_TARGETS) {
+    const dir = targetDir(target, scope);
+    const installed = detected.some((d) => d.id === target.id);
     const present = expected.filter((n) => existsSync(join(dir, n, "SKILL.md")));
-    console.log(`\n── ${label} ──  ${dir}`);
-    if (!present.length) {
-      console.log("  · 该目录没装本包的 skill（跳过）");
+    skillStatus.set(target.id, { dir, installed, present: present.length });
+
+    if (!installed) {
+      console.log(`  · ${target.label.padEnd(16)} ${dir} —— 未安装该智能体`);
       continue;
     }
     if (present.length === expected.length) {
-      console.log(`  ✓ ${present.length} 个 skill 齐全`);
+      console.log(`  ✓ ${target.label.padEnd(16)} ${dir} —— ${present.length}/${expected.length} 齐全`);
     } else {
       const missing = expected.filter((n) => !present.includes(n));
-      console.log(`  ! 只装了 ${present.length}/${expected.length} 个，缺：${missing.join(", ")}`);
+      console.log(`  ! ${target.label.padEnd(16)} ${dir} —— 只装了 ${present.length}/${expected.length}，缺：${missing.join(", ")}`);
       problems++;
     }
 
@@ -319,21 +431,36 @@ function cmdDoctor(opts) {
     if (bad) problems++;
   }
 
+  console.log(`\n── MCP ──`);
+  const mcpConfigured = new Set();
   for (const agent of SUPPORTED_AGENTS) {
     for (const target of agentTargets(agent, scope)) {
       const existing = readServer(target, MCP_SERVER_NAME);
-      console.log(`\n── MCP · ${target.label} ──  ${target.file}`);
+      console.log(`\n  ${target.label} —— ${target.file}`);
       if (existing) {
+        mcpConfigured.add(agent);
         console.log(`  ✓ 已配置（${existing.type ?? "unknown"}）`);
       } else {
-        console.log("  · 未配置 —— anov-gis-skills mcp add");
+        console.log(`  · 未配置 —— ${CLI_CMD} mcp add`);
       }
     }
   }
 
+  // 半装检查：MCP 配了但对应智能体一个 skill 都没有
+  console.log(`\n── 一致性 ──`);
+  let half = 0;
+  for (const agent of mcpConfigured) {
+    const st = skillStatus.get(agent);
+    if (!st || !st.installed || st.present > 0) continue;
+    console.log(`  ! ${agent}：MCP 已配置但 ${st.dir} 下没有本包的 skill —— 跑 ${CLI_CMD} setup 补上`);
+    half++;
+  }
+  if (!half) console.log("  ✓ 没有「MCP 配了但 skill 缺失」的半装状态");
+  problems += half;
+
   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");
@@ -350,15 +477,21 @@ function cmdUninstall(opts) {
   }
 
   console.log(`\n移除 ${names.length} 个 skill（${scope === "global" ? "用户级" : "项目级"}）`);
+  // 不传 --agent：上游的语义是从所有智能体删，正好清掉历史上 --all 铺出去的残留。
   // 只按名字删本包提供的 skill —— skills remove --skill '*' 会连别的来源的一起删掉
-  const code = runSkillsCLI(["remove", ...names, ...targetFlags(opts.agents), ...scopeFlags(scope), "-y"]);
+  const code = runSkillsCLI(["remove", ...names, ...scopeFlags(scope), "-y"]);
   if (code !== 0) {
     console.error(`✗ 移除 skill 失败（退出码 ${code}）`);
     process.exit(code);
   }
 
-  const agent = opts.mcpAgent ?? "claude-code";
-  for (const target of mcpTargets(agent, scope)) {
+  // 上游不认识 Antigravity 的新落点，这几个自己删
+  for (const target of SKILL_TARGETS.filter((t) => !t.upstream)) {
+    uninstallSelf({ skillDir: targetDir(target, scope) }, names);
+  }
+
+  const agents = mcpAgents(opts, scope);
+  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}`);
   }
@@ -378,8 +511,8 @@ function main() {
     return;
   }
   if (opts.unknown.length) {
-    console.error(`✗ 未知选项：${opts.unknown.join(", ")}`);
-    console.error("  用 anov-gis-skills --help 看用法");
+    console.error(`✗ 未知选项：${opts.unknown.join(" ")}`);
+    console.error(`  用 anov-gis-skills --help 看用法`);
     process.exit(2);
   }
 

package/lib/agents.mjs

@@ -0,0 +1,236 @@
+// 各智能体的 skill 落点、检测规则、以及「MCP 配置写到哪」。
+//
+// 落点一律按各家官方文档定，不抄上游 skills CLI 的 --agent 映射 ——
+// 上游把所有 skillsDir === ".agents/skills" 的 agent 归进 universal 一族，
+// 装的时候一律落到 ~/.agents/skills，会把 codex / cursor / gemini-cli
+// 这些另有独立目录的 agent 装错地方：
+//
+//   codex       上游装到 ~/.agents/skills，但 Codex 用户级只读 ~/.codex/skills
+//   cursor      上游装到 ~/.agents/skills，但 Cursor 只有 ~/.cursor/skills 才同步云端
+//   gemini-cli  上游装到 ~/.agents/skills，但 Gemini CLI 读 ~/.gemini/skills
+//
+// 所以「自己装」= 绕开上游、直接把 skill 目录 copy 到正确位置。
+//
+// 判定「已安装」= 探测目录存在且非空。上游用的是纯 existsSync，家目录里
+// 躺个同名空壳文件夹就会被认成已装 —— 实测能误判 50+ 个。
+
+import { existsSync, readdirSync, cpSync, mkdirSync, rmSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, dirname, basename } from "node:path";
+
+/** 把 ~ / %APPDATA% 展开成绝对路径。 */
+export function expand(p) {
+  if (p === "~") return homedir();
+  if (p.startsWith("~/")) return join(homedir(), p.slice(2));
+  if (p.startsWith("%APPDATA%/")) {
+    const base = process.env.APPDATA || join(homedir(), "AppData", "Roaming");
+    return join(base, p.slice("%APPDATA%/".length));
+  }
+  return p;
+}
+
+/**
+ * 目录存在且非空才算「装了这个智能体」。
+ * ignore 里的子项不计入 —— Gemini CLI 和 Antigravity 共用 ~/.gemini，
+ * 只装了 Antigravity 时 ~/.gemini 也非空，但那不代表装了 Gemini CLI。
+ */
+export function dirHasContent(p, ignore = []) {
+  try {
+    return readdirSync(p).some((name) => !ignore.includes(name));
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * skill 的安装目标。一个目标 = 一个落点。
+ *
+ * probes     判定「已安装」用的目录，任一非空即命中
+ * skillDir   用户级落点（字符串模板，或由命中目录推导的函数）
+ * projectDir 项目级落点（相对当前目录）
+ * upstream   交给上游 skills CLI 装的 agent 名；null = 我们自己 copy
+ */
+export const SKILL_TARGETS = [
+  {
+    id: "claude-code",
+    label: "Claude Code",
+    probes: ["~/.claude"],
+    skillDir: "~/.claude/skills",
+    projectDir: ".claude/skills",
+    upstream: "claude-code",
+  },
+  {
+    id: "codex",
+    label: "Codex",
+    probes: ["~/.codex"],
+    skillDir: "~/.codex/skills",
+    projectDir: ".codex/skills",
+    upstream: null,
+  },
+  {
+    id: "cursor",
+    label: "Cursor",
+    probes: ["~/.cursor"],
+    skillDir: "~/.cursor/skills",
+    projectDir: ".cursor/skills",
+    upstream: null,
+  },
+  {
+    id: "openclaw",
+    label: "OpenClaw",
+    probes: ["~/.openclaw", "~/.clawdbot", "~/.moltbot"],
+    skillDir: (probe) => join(probe, "skills"),
+    projectDir: "skills",
+    upstream: "openclaw",
+  },
+  {
+    id: "hermes-agent",
+    label: "Hermes Agent",
+    probes: ["~/.hermes"],
+    skillDir: "~/.hermes/skills",
+    projectDir: ".hermes/skills",
+    upstream: "hermes-agent",
+  },
+  {
+    id: "trae",
+    label: "Trae",
+    probes: ["~/.trae"],
+    skillDir: "~/.trae/skills",
+    projectDir: ".trae/skills",
+    upstream: "trae",
+  },
+  {
+    id: "trae-cn",
+    label: "Trae CN",
+    probes: ["~/.trae-cn"],
+    skillDir: "~/.trae-cn/skills",
+    projectDir: ".trae/skills",
+    upstream: "trae-cn",
+  },
+  {
+    id: "gemini-cli",
+    label: "Gemini CLI",
+    probes: ["~/.gemini"],
+    ignore: ["antigravity", "antigravity-cli", "config"],
+    skillDir: "~/.gemini/skills",
+    projectDir: ".gemini/skills",
+    upstream: null,
+  },
+  {
+    id: "antigravity",
+    label: "Antigravity",
+    // App / CLI / IDE 现在共用 ~/.gemini/config/skills；IDE 另兼容旧的
+    // ~/.gemini/antigravity/skills，但 App 明确不读 ~/.gemini/skills。
+    probes: ["~/.gemini/config", "~/.gemini/antigravity", "~/.gemini/antigravity-cli"],
+    skillDir: "~/.gemini/config/skills",
+    projectDir: ".agents/skills",
+    upstream: null,
+  },
+  {
+    id: "github-copilot",
+    label: "GitHub Copilot",
+    probes: ["~/.copilot"],
+    skillDir: "~/.copilot/skills",
+    projectDir: ".copilot/skills",
+    upstream: null,
+  },
+  {
+    id: "agents-shared",
+    label: "共享目录",
+    // 这几个 agent 共用 ~/.agents/skills，装一次覆盖全部
+    probes: [
+      "~/.kimi-code",
+      "~/.kimi",
+      "~/.cline",
+      "~/.dexto",
+      "~/.loaf",
+      "~/.warp",
+      "~/.config/zed",
+      "%APPDATA%/Zed",
+    ],
+    skillDir: "~/.agents/skills",
+    projectDir: ".agents/skills",
+    upstream: "cline",
+  },
+];
+
+/**
+ * 目标落点。项目级直接相对当前目录；用户级看 skillDir —— 字符串模板直接展开，
+ * 函数则用第一个存在的探测目录推导。
+ */
+export function resolveSkillDir(target, scope = "global", cwd = process.cwd()) {
+  if (scope === "project") return join(cwd, target.projectDir);
+  if (typeof target.skillDir !== "function") return expand(target.skillDir);
+  for (const probe of target.probes) {
+    const abs = expand(probe);
+    if (existsSync(abs)) return target.skillDir(abs);
+  }
+  return target.skillDir(expand(target.probes[0]));
+}
+
+/** 探测本机装了哪些智能体，返回命中的目标（含实际落点）。 */
+export function detectSkillTargets() {
+  const out = [];
+  for (const target of SKILL_TARGETS) {
+    for (const probe of target.probes) {
+      const abs = expand(probe);
+      const dir =
+        typeof target.skillDir === "function" ? target.skillDir(abs) : expand(target.skillDir);
+      // skill 落点就在探测目录底下时，别把我们自己装的那份算成「已安装」的证据
+      const ignore = [...(target.ignore ?? [])];
+      if (dirname(dir) === abs) ignore.push(basename(dir));
+      if (!dirHasContent(abs, ignore)) continue;
+      out.push({ ...target, probe: abs, skillDir: dir, ignore });
+      break;
+    }
+  }
+  return out;
+}
+
+/** 把 skill 目录直接 copy 到目标落点（上游装错位置的走这条路）。 */
+export function installSelf(target, skills) {
+  mkdirSync(target.skillDir, { recursive: true });
+  for (const s of skills) {
+    cpSync(join(s.srcDir, s.name), join(target.skillDir, s.name), { recursive: true, force: true });
+  }
+}
+
+/** 删掉自己 copy 出去的 skill。 */
+export function uninstallSelf(target, names) {
+  for (const name of names) {
+    rmSync(join(target.skillDir, name), { recursive: true, force: true });
+  }
+}
+
+// ---------------------------------------------------------------- MCP
+
+/**
+ * 支持写 MCP 配置的智能体。落点由 lib/mcp-config.mjs 负责（各家格式不同）。
+ * probes 是「这个智能体装了没」的判据 —— 默认集合只写探测到的那些。
+ */
+export const MCP_AGENTS = [
+  { id: "claude-code", label: "Claude Code", probes: ["~/.claude"], skillTarget: "claude-code" },
+  { id: "codex", label: "Codex", probes: ["~/.codex"], skillTarget: "codex" },
+  { id: "cursor", label: "Cursor", probes: ["~/.cursor"], skillTarget: "cursor" },
+  {
+    id: "claude-desktop",
+    label: "Claude 桌面端",
+    probes: ["%APPDATA%/Claude", "~/Library/Application Support/Claude", "~/.config/Claude"],
+    skillTarget: null,
+  },
+  { id: "vscode", label: "VS Code", probes: ["<cwd>/.vscode"], skillTarget: null },
+];
+
+/** 探测装了哪些支持 MCP 的智能体。scope=project 时只看项目级目录。 */
+export function detectMcpAgents(scope = "global", cwd = process.cwd()) {
+  const out = [];
+  for (const agent of MCP_AGENTS) {
+    for (const probe of agent.probes) {
+      const abs = probe === "<cwd>/.vscode" ? join(cwd, ".vscode") : expand(probe);
+      if (!dirHasContent(abs)) continue;
+      out.push({ ...agent, probe: abs });
+      break;
+    }
+  }
+  return out;
+}

package/lib/mcp-config.mjs

@@ -4,10 +4,11 @@
 // 格式适配，收益却只落在少数人身上。
 //
 // 支持的 agent 与配置位置：
-//   claude-code  用户级 ~/.claude.json 的 mcpServers / 项目级 <cwd>/.mcp.json 的 mcpServers
-//   codex        用户级 ~/.codex/config.toml 的 [mcp_servers.<name>]
-//   cursor       项目级 <cwd>/.cursor/mcp.json / 用户级 ~/.cursor/mcp.json 的 mcpServers
-//   vscode       项目级 <cwd>/.vscode/mcp.json 的 servers（VS Code 用 servers，不是 mcpServers）
+//   claude-code     用户级 ~/.claude.json 的 mcpServers / 项目级 <cwd>/.mcp.json 的 mcpServers
+//   codex           用户级 ~/.codex/config.toml 的 [mcp_servers.<name>]
+//   cursor          项目级 <cwd>/.cursor/mcp.json / 用户级 ~/.cursor/mcp.json 的 mcpServers
+//   vscode          项目级 <cwd>/.vscode/mcp.json 的 servers（VS Code 用 servers，不是 mcpServers）
+//   claude-desktop  用户级 claude_desktop_config.json 的 mcpServers（Claude 桌面聊天端）
 //
 // 写入原则：读现有文件 → 只动自己那一个条目 → 原子写回。别人的条目一律不碰。
 
@@ -55,12 +56,34 @@ export function agentTargets(agent, scope, cwd = process.cwd()) {
       return scope === "global"
         ? []
         : [{ file: resolve(cwd, ".vscode", "mcp.json"), key: "servers", label: "VS Code（项目级）" }];
+    case "claude-desktop": {
+      if (scope !== "global") return [];
+      return [
+        {
+          file: claudeDesktopConfig(),
+          key: "mcpServers",
+          label: "Claude 桌面端（用户级）",
+        },
+      ];
+    }
     default:
       return [];
   }
 }
 
-export const SUPPORTED_AGENTS = ["claude-code", "codex", "cursor", "vscode"];
+/** Claude 桌面聊天端的 MCP 配置文件（各平台路径不同）。 */
+function claudeDesktopConfig() {
+  if (process.platform === "darwin") {
+    return join(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
+  }
+  if (process.platform === "win32") {
+    const base = process.env.APPDATA || join(homedir(), "AppData", "Roaming");
+    return join(base, "Claude", "claude_desktop_config.json");
+  }
+  return join(homedir(), ".config", "Claude", "claude_desktop_config.json");
+}
+
+export const SUPPORTED_AGENTS = ["claude-code", "codex", "cursor", "vscode", "claude-desktop"];
 
 /** 从当前进程环境里挑出要透传给 MCP 的变量。 */
 export function collectEnv(env = process.env) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anov/gis-skills-cli",
-  "version": "0.3.0",
+  "version": "0.3.4",
   "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.4
 > **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.4**
 > **Skill 数：** **12**（含 `using-anovgis` 入口 + 3 个 v0.2.0 新增 skill）
 > **入口 skill 额外职责**：引导式初始化（AskUserQuestion 向导：底图 / 控件 / 部署；**技术栈固定 Vue 3 + Vite**）