git:20260522.ee29bcc to v1

---

name: laohan-gengxin

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，提醒执行：

```bash

# 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 node-llama-cpp@3.18.1 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 解析生成报告。