laohan-gengxin

工具版本检查与更新

扫描所有常用工具的版本状态，生成编号报告，等待选择后逐项更新。

核心理念

只检查不自动更新——报告给用户看，确认后才动。因为盲目更新可能破坏环境（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，提醒执行：

# 1. 健康检查超时补丁
~/.openclaw/scripts/patch-health-timeout.sh

# 2. 补装 memory 依赖
DEPS_DIR=$(ls -td ~/.openclaw/plugin-runtime-deps/openclaw-*/ | head -1)
cd "$DEPS_DIR" && npm install [email protected] sqlite-vec

# 3. 重启 gateway
launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway

# 4. 等60秒冷启动后验证
sleep 60 && openclaw status

工具清单维护

references/tools.json 记录所有工具的元数据。新增工具时往 JSON 里加一条即可。

脚本

scripts/check.sh — 自动化版本检查脚本，输出 JSON 格式结果供 skill 解析生成报告。