| name | laohan-gengxin |
| version | 1 |
| description | 工具版本检查与更新，扫描 npm/brew/pip/uv/GitHub/plugins/skills 逐项对比已装和最新版本，生成带编号报告，确认后才执行更新。Use when 用户说"检查更新""工具版本""看看哪些该更新了""brew有没有过期的""opencli是不是该更新了"或提到工具版本/环境更新。 |
工具版本检查与更新
扫描所有常用工具的版本状态，生成编号报告，等待选择后逐项更新。
核心理念
只检查不自动更新——报告给用户看，确认后才动。因为盲目更新可能破坏环境（openclaw 升级后需补装依赖、插件升级后需重启），每次更新都要用户知情。
不适用场景
- 只检查单个工具版本 → 直接跑
--version 或 npm view <pkg> version，不需要本 skill
- 安装新工具 → 用
brew install / npm install / uv tool install，不走更新流程
工作流程
第0步：发现遗漏
跑 scripts/discover.sh，全量扫描系统（npm/brew/pip/uv/conda/local-bin），过滤依赖库后与 tools.json 做差集。如果有新发现的工具，报告给用户确认是否加入。
发现方法论的完整说明见 references/scan-methodology.md。
第1步：读取工具清单
读取 references/tools.json，获取所有工具的检查方式和更新命令。
第2步：逐项检查版本
按分类并行执行检查命令，对比已装版本和最新版本。检查逻辑：
| 检查源 | 命令 | 说明 |
|---|
| npm | npm view <pkg> version | npm registry 最新版 |
| brew | brew outdated --json=v2 | Homebrew 过期检查 |
| pip | pip3 index versions <pkg> | PyPI 最新版 |
| uv | pip3 index versions <pkg> | PyPI（uv tool 安装的也能查） |
| gh release | gh api repos/<owner>/<repo>/releases/latest --jq .tag_name | GitHub release |
| claude plugins | claude plugins list --json | 插件市场版本 |
第3步：生成编号报告
固定格式，每条一行：
[编号] [分类] [状态标记] [名字]
已装: x.x.x → 最新: y.y.y
作用: 中文说明
频繁度: 高/中/低 | 推荐更新: 是/否 | 推荐卸载: 是/否
更新方式: 具体命令
重大变化: (如果有)
状态标记：
- ✅ 最新
- ⬆️ 落后（推荐更新）
- ⚠️ 落后很多（跨大版本）
- ❓ 未知（检查失败）
分类：核心平台 | npm包 | Homebrew | Python | uv工具 | 插件 | Skills | 运行时
第4步：等待用户选择
报告末尾提示：
输入要更新的编号（用逗号或空格分隔），或输入 "all" 全部更新，"q" 退出：
第5步：执行更新
用户给出编号后，按编号顺序逐项执行对应的更新命令。每项更新完成后报告结果（成功/失败）。
注意事项：
- openclaw 更新后需跑维护清单（见下方）
- brew 用
brew reinstall 不用 brew upgrade（国内镜像缓存同步延迟）
- npm 更新后不用
--force
- pip 用
pip3 install --upgrade 或 uv pip install --upgrade
- 插件更新后需重启 Claude Code session
- skills 用
npx skills update -g -y 全量更新（不支持单个更新）
openclaw 更新后维护清单
如果用户更新了 openclaw，提醒执行：
~/.openclaw/scripts/patch-health-timeout.sh
DEPS_DIR=$(ls -td ~/.openclaw/plugin-runtime-deps/openclaw-*/ | head -1)
cd "$DEPS_DIR" && npm install node-llama-cpp@3.18.1 sqlite-vec
launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway
sleep 60 && openclaw status
工具清单维护
references/tools.json 记录所有工具的元数据。新增工具时往 JSON 里加一条即可。
脚本
scripts/check.sh — 自动化版本检查脚本，输出 JSON 格式结果供 skill 解析生成报告。
