Scout — 软件更新顾问

Scout 监控用户关注的工具在 GitHub 上发布的版本，审阅发布说明，评估升级风险，并给出是否升级的建议。它绝不会在未经明确授权的情况下自动安装任何内容。

执行一次检查

python3 scripts/check_updates.py
# 输出结构化 JSON 格式：
python3 scripts/check_updates.py --json

配置从 ~/.config/scout/watchlist.json 读取。首次运行时会自动生成该文件，默认添加 openclaw。

添加一个工具（交互式流程）

当用户希望添加一个工具时，请依次询问以下信息：

1. GitHub 仓库地址（例如：owner/repo）
2. 如何检测已安装版本（支持 command、npm、pip 或 file 方式）

随后执行：

python3 scripts/add_tool.py 
  --name "tool-name" 
  --repo "owner/repo" 
  --detect-type command 
  --detect-cmd "tool --version" 
  --version-prefix "v" 
  --notes "该工具的功能说明"

支持的检测类型及示例详见 references/watchlist.md。

验证一次发布

在推荐任何升级前，请先运行问题检查脚本：

python3 scripts/verify_release.py --repo owner/repo --since YYYY-MM-DD

该命令将报告自指定发布日期以来新建的、带有 bug 标签或包含回归关键词的问题。

跳过某个版本

当用户决定跳过某次更新时：

python3 scripts/skip_release.py --tool toolname --version v1.2.3 --reason "原因说明"
# 查看已跳过版本列表：
python3 scripts/skip_release.py --list
# 取消跳过：
python3 scripts/skip_release.py --clear --tool toolname

被跳过的版本记录保存在 ~/.config/scout/skip_list.json 中，并会在后续的 check_updates.py 输出中被屏蔽。

审核工作流

对每一个发现的更新，必须先生成完整的推荐卡片，再向用户请求批准：

🔔 更新：<工具名称> <当前版本> → <最新版本>
   来源：，作者/组织：
   发布日期：<日期>

风险等级：🟢/🟡/🔴 <等级>

变更内容概述：
- <通俗易懂的摘要>
- <注明是否包含安全修复、破坏性变更、新增权限等>

对我们环境的影响：
- <影响到的配置项或工作流部分>
- <是否需要修改配置或重新认证等>

发布后问题反馈：<未发现 / 列出已知回归问题>

建议操作：<立即升级 / 暂缓 / 跳过>
理由：<一句话说明>

切勿在未提供完整卡片的前提下直接询问“是否要升级 X？”。用户需基于卡片所含上下文独立做出判断，无需预先了解该工具细节。

风险等级定义：

• 🟢 低风险 —— 仅含补丁或修复，不涉及配置变更，不引入新权限
• 🟡 中风险 —— 新增功能、少量可选配置项、或存在可选的破坏性变更
• 🔴 高风险 —— 包含破坏性变更、认证机制调整、数据模式迁移、或关键安全补丁

获得批准后的操作

1. 执行对应工具的安装命令
2. 如适用，验证配置（例如：openclaw config validate）
3. 必要时重启相关服务
4. 确认系统健康状态

技能健康审查

定期依据 OpenClaw 最佳实践，自查所用技能的质量：

python3 scripts/review_skills.py [--skills-dir /path/to/skills]

该脚本逐项检查各技能是否存在结构问题或质量改进点。所有检查结果均以报告形式呈现——任何修改均须经显式授权后方可应用。

周期性使用建议

建议将 Scout 加入心跳监控（heartbeat）或每周定时任务（cron）。推荐执行频率：每周一次（周日）。