clawdbot-release-check

🔄 GitHub 版本更新智能管家

基于 GitHub API 检查 clawdbot 新版本,智能推送通知避免重复打扰,助开发者及时掌握版本动态与更新亮点。

收藏
6.3k
安装
2.3k
版本
2026.1.5
CLS 安全性认证2026-05-14
点击查看完整报告 >

使用说明

Clawdbot Release Check 是一款专为 clawdbot 用户设计的轻量级版本更新监控工具,通过自动化检查 GitHub Releases 并提供智能通知机制,帮助开发者及时掌握软件动态。

该技能的核心用法围绕版本监控与通知展开。用户可通过 clawdhub install 快速安装,并利用内置的 setup.sh 脚本配置定时任务(cron),支持自定义检查时间(如每日上午 9 点)和 Telegram 通知渠道。手动模式下,check.sh 脚本提供丰富的命令选项:常规检查仅在发现新版本且未通知过时触发提醒,--status 查看当前版本状态,--force 强制推送通知,--all-highlights 展示所有错过的更新亮点,而 --reset 可清除通知状态以便重新提醒。工具通过对比本地 package.json 版本与 GitHub API 获取的最新 release 信息,提取关键更新内容并生成格式化的通知消息。

显著优点体现在智能化与用户体验设计上。采用"只通知一次"机制避免重复打扰,通过本地状态文件记录已通知版本,确保用户不会收到冗余提醒。24 小时缓存策略有效减少 GitHub API 调用次数,既节省网络资源又避免触发 API 限流。输出格式清晰美观,使用 emoji 和 markdown 样式展示版本差异、更新亮点及升级命令,大幅降低版本迁移的认知成本。此外,纯 Shell 脚本实现保证了极低的资源占用和跨平台兼容性。

潜在局限性主要集中在适用范围和外部依赖。作为专项工具,其设计仅针对 clawdbot 项目,无法直接用于监控其他 GitHub 仓库的更新。功能依赖 GitHub API 的可用性,在网络受限或无法访问 GitHub 的环境中将无法正常工作。作为 T3 来源的社区维护项目,长期维护稳定性相对官方产品存在不确定性。此外,Telegram 通知功能需要用户自行配置 bot 和 chat ID,对非技术用户存在一定门槛。

适合的目标群体包括:活跃的 clawdbot 开发者与运维人员,需要及时跟进框架新特性和安全补丁;部署 clawdbot 的生产环境管理员,希望通过自动化监控降低版本滞后风险;以及偏好轻量级命令行工具、习惯使用 Telegram 作为通知渠道的技术用户。

使用该技能可能存在的风险包括:网络层面,定期调用 GitHub API 可能受限于企业防火墙或地区网络策略;存储层面,工具在本地保存版本状态和缓存数据,虽无敏感信息但仍需注意文件权限设置;权限层面,脚本需要执行系统命令(curl、jq)和读写用户目录,在严格受限的沙箱环境中可能运行失败;功能层面,若 GitHub API 变更或项目迁移,可能导致检查逻辑失效,需关注上游更新。

安全解读

核心用法

该 Skill 为 clawdbot 用户提供轻量级版本更新检查服务,通过 GitHub API 获取最新 release 信息,与本地安装版本比对后智能推送通知。

安装与初始化

clawdhub install clawdbot-release-check

快速配置(推荐)
使用内置脚本一键配置定时任务,支持自定义时间和 Telegram 推送:

{baseDir}/scripts/setup.sh --telegram YOUR_TELEGRAM_ID --hour 9

日常操作

  • 静默检查:check.sh(已通知或已最新则无输出)
  • 强制提醒:check.sh --force
  • 批量回顾:check.sh --all-highlights(显示所有错过的版本亮点)
  • 重置状态:check.sh --reset(下次检查将重新触发通知)

---

显著优点

1. 智能去重机制:通过本地状态文件记录 lastNotifiedVersion,确保每个新版本仅提醒一次,彻底解决重复通知困扰
2. 24小时缓存策略:release 数据和提取的 highlights 均缓存,减少 API 调用和 token 消耗

3. 自动环境检测:智能识别 clawdbot 安装路径(支持 ~/dev/clawdis~/clawdbot 或 npm 全局安装)

4. 轻量无依赖:仅需系统标准工具 curljq,零第三方 npm 包依赖

5. 信息丰富:输出版本差距数、关键特性摘要及直接更新命令

---

潜在缺点与局限性

  • GitHub API 依赖:网络受限环境或 API 速率限制可能影响功能
  • 手动更新:仅提供通知,不执行自动更新(需用户手动 git pull && pnpm install
  • 无原生 macOS 通知:默认通过 Telegram 推送,如需系统通知需自行配置
  • 状态文件非加密~/.clawdbot/ 下的 JSON 状态文件以明文存储

---

适合人群

  • 长期运行 clawdbot 的生产环境运维人员
  • 希望及时跟进新特性但不想被频繁打扰的开发者
  • 使用 cron 管理自动化任务的高级用户

---

常规风险

| 风险项 | 级别 | 说明 |
|--------|------|------|
| 外部网络请求 | 低 | 仅访问 GitHub 公开 API,无敏感数据传输 |
| 本地文件写入 | 低 | 限定用户目录 `~/.clawdbot/`,无系统路径访问 |
| curl 挂起风险 | 低 | 未设置超时参数,极端网络环境下可能阻塞 |

安全认证:通过 CLS-Certify v2.1.0 完整扫描,评分 85/S 级,无危险函数调用、无敏感信息硬编码。

clawdbot-release-check 内容

scripts文件夹
手动下载zip · 5.9 kB
check.shtext/x-shellscript
请选择文件