用途：此技能负责把 cartog 二进制安装或升级到插件锁定的版本，触发方式为用户输入 /cartog-install，或提出“install cartog”“update cartog”等请求。
主要能力：先探测当前状态，再走对应处理路径。1）运行 cartog --version，记录退出码与版本号。2）若二进制缺失或返回非零退出，运行捆绑安装脚本：bash "${CLAUDE_PLUGIN_ROOT}/skills/cartog/scripts/install.sh" $PLUGIN_VERSION；安装后运行 hash -r，再以 cartog --version 确认版本；若仍失败需检查安装目录是否在 PATH，并让用户添加 export PATH="<dir>:$PATH"；最后提示用户重启 Claude Code，因为 MCP 服务器无法在会话中途重连。3）若已存在但低于 0.14.0，用同一捆绑安装脚本重装固定版本，再验证并提示重启。4）若版本在 0.14.0–0.20.0 之间（有 self update 但不支持 --apply-pending），用重装脚本覆盖，不能用延迟更新。5）若支持 --apply-pending（>=0.20.0），运行 cartog self update 并按退出码处理：0 提示已升级并重启；3 说明通过 cargo 安装，需运行 cargo install cartog --force；6 表示有另一个 cartog 进程（会话内通常即 cartog MCP 服务器）在运行，改为执行 cartog self update --defer --to $PLUGIN_VERSION，并提示会话结束时更新；其他退出码输出退出码与 stderr，再用捆绑安装脚本恢复。6）若版本已与 PLUGIN_VERSION 一致，提示无需操作。
注意：$PLUGIN_VERSION 是文件顶部 PLUGIN_VERSION= 行的值，需要手动替换，并非 Bash 环境变量。安装脚本必须带固定版本参数，否则会安装 GitHub 最新版、偏离插件的锁定版本。此技能只写入 cartog 的二进制的安装目录，不改动项目的 .cartog.toml、索引数据库或用户文件。${CLAUDE_PLUGIN_ROOT} 需按字面使用，不要替换为猜测路径。离线或需先审查的安装方式可让用户下载并检查 https://www.cartog.dev/install.sh。资料中未提供收费、价格与其他平台信息。