SuperAPI AI 工具集

health-check

部署与运维

查看项目

更新于 10-16 05:29

技能介绍

health-check 是 terrylica/cc-skills 仓库中面向 po(Pushover)插件的诊断技能,用于自检插件运行状况并查询当月剩余配额。其核心通过 TypeScript 核心(pushover_core.ts)实现。

用途 该技能用于诊断 po Pushover 插件并检查每月剩余配额,运行完整自检,覆盖凭据解析(通过 1Password/Keychain)、/users/validate.json 校验、月度配额、预期的自定义提示音、依赖项以及审计日志大小。

主要能力

  1. doctor:执行完整自检并以 JSON 输出。检查项包括:凭据(op→Keychain)、/users/validate.json、月度配额、预期的自定义提示音(po_fanfare/po_uplift/po_celebrate)、依赖(bun/uv/Chrome)以及审计日志大小。
  2. quota:输出 {limit, remaining, reset},打印剩余消息数,并在低于 quota_warn_remaining(见 pushover_api_limits.json)时发出警告。

使用方式 命令示例(保留原文): env -u HTTPS_PROXY -u HTTP_PROXY bun "$(cc-plugin-root pushover-commander)/skills/_lib/pushover_core.ts" doctor # full self-test (JSON) env -u HTTPS_PROXY -u HTTP_PROXY bun "$(cc-plugin-root pushover-commander)/skills/_lib/pushover_core.ts" quota # {limit, remaining, reset}

可靠性原语(适用于每次发送)

  • 限制唯一来源(Limits SSoT):skills/_lib/pushover_api_limits.json 是所有 Pushover 限制/规则的唯一来源(消息 1024、标题 250、url 512、附件 5 MB、声音 <500 KB/≤30 s、应用名 20、描述 500、html⊕monospace、priority-2 需要 retry+expire)。只在此处编辑,不在别处修改。
  • 预检(Preflight):pushover_core.ts 依据 pushover_api_limits.json 校验每次发送,将 Pushover 的静默失败转为显式输出:拒绝(url>512、附件>5 MB、html+monospace)——可用 --force 覆盖;并警告(消息/标题截断、声音不在账户中)。
  • 审计追踪(Audit trail):每次发送都会向 ~/.local/state/pushover/po-audit.jsonl 追加一行以 UUID 为键的 JSONL(ts、uuid、app、priority、status、request、receipt、remaining、message_len、errors)。可用 grep <uuid> ~/.local/state/pushover/po-audit.jsonl | jq . 检索。
  • 配额守卫(Quota guard):每次发送读取 X-Limit-App-Remaining,并在偏低时警告。
  • 重试/退避(Retry/backoff):瞬时网络错误 / 5xx 会在失败前重试(×3,退避)。

适用场景 适用于需要验证 po Pushover 插件配置是否健康、确认凭据与依赖是否可用、检查当月剩余发送配额,以及排查发送失败原因的场景。

限制与说明 该技能被描述为“自进化技能”:通过使用改进,若指令有误、参数漂移或需要变通方案,应立即修复该文件,不要推迟;仅在真实、可复现的问题上更新。执行后需反思:检查是否暴露了真实失败(凭据、配额、依赖)且没有误报为正常;若损坏的子系统被报告为健康,应修复检查;剩余配额是否被准确报告,陈旧或错误的配额读数需在误导前修复;仅在问题真实且可复现时更新,而非推测。

其他信息(如具体收费、价格、支持平台等)暂未提供。