SuperAPI AI 工具集

qwencloud-update-check

部署与运维

查看项目

更新于 10-16 08:19

技能介绍

用途

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 绕过。
  • 检查结果不缓存在状态文件中。
  • 关于收费、价格、平台支持范围等信息,资料暂未提供。