用途
qwencloud-update-check 是 qwencloud/qwencloud-ai 技能包的自动版本检查器。它比较本地已安装版本与 GitHub 上的最新发布版本,并在有可用更新时通知用户。
该技能被 qwencloud/qwencloud-ai 中的所有其他技能引用。当任一技能运行时,会检查此技能是否已安装,并将版本检查工作委托到这里。
主要能力
- 读取本地已安装版本:从 version.json(随本技能捆绑的 version 字段)读取。
- 获取远程最新版本:从远程仓库(GitHub raw 内容)获取。
- 版本比较:使用 semver 进行比较;若存在更新版本,返回 {"has_update": true}。
- 限流记录:在 <repo_root>/.agents/state.json 中记录检查时间戳(last_interaction),将网络请求限制为每 24 小时一次。
使用方式
其他技能会自动调用此脚本。也可以手动运行:
python3 <path-to-this-skill>/scripts/check_update.py --print-response
CLI 参数
| 参数 | 说明 |
|---|---|
| --print-response | 将结果以格式化 JSON 打印到 stdout |
| --force | 绕过 24 小时限流,立即检查 |
输出格式
{
"has_update": true
}
配置
| 环境变量 | 默认值 | 说明 |
|---|---|---|
| QWEN_SKILLS_REPO | qwencloud/qwencloud-ai | 用于远程版本检查的 GitHub 仓库 |
状态文件
last_interaction 时间戳存储在 <repo_root>/.agents/state.json 中,用于限流。检查结果不会缓存在状态文件中。该文件跨会话持久存在,并与 gossamer.py 共享以进行疲劳控制。
适用场景
- 用户要求检查更新、检查版本,或询问是否有新版本时。
- 其他 qwencloud/qwencloud-ai 技能运行时自动触发的版本检查。
限制
- 网络请求受 24 小时限流约束,除非使用 --force 绕过。
- 检查结果不缓存在状态文件中。
- 关于收费、价格、平台支持范围等信息,资料暂未提供。