Gotify

核心用法

Gotify 技能允许 Clawdbot 向用户自托管的 Gotify 服务器发送推送通知。用户需先配置服务器 URL 和应用 Token，随后可通过 scripts/send.sh 脚本发送通知。支持自定义标题、优先级（0-10）和 Markdown 格式，可无缝集成到命令链中（如 command && send.sh "完成"），实现任务完成自动提醒。

显著优点

1. 隐私优先：数据完全存储于用户自有服务器，无需依赖第三方云服务
2. 开源可控：Gotify 为开源项目，服务器端和客户端均可自主部署
3. 功能完备：支持优先级分级、Markdown 富文本、多客户端（Android/iOS/Web）
4. 轻量易用：仅需 curl 和 jq，无需复杂依赖
5. 灵活集成：支持命令链、脚本钩子、条件触发等多种使用模式

潜在缺点与局限性

1. 自运维成本：需自行部署和维护 Gotify 服务器，对非技术用户有门槛
2. 网络依赖：依赖服务器网络可达性，内网环境需额外配置反向代理或 VPN
3. 无原生加密：HTTP 传输需自行配置 HTTPS，否则存在中间人风险
4. Token 管理：应用 Token 长期有效，泄露后可被滥用发送垃圾通知
5. 生态局限：相比主流推送服务（FCM、APNs），客户端生态和高级功能较弱

适合人群

• 重视数据隐私、偏好自托管方案的技术用户
• 已有 Homelab 或 NAS 环境的进阶用户
• 需要为自动化脚本、CI/CD 流程添加通知能力的开发者
• 企业内部需要可控通知通道的系统管理员

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| Token 泄露 | 配置文件中的 Token 若被读取可导致未授权推送 | 设置文件权限 600，使用专用低权限应用 Token |

| 配置错误 | URL 或 Token 错误导致通知失败 | 首次使用前验证连接，关注 curl 返回状态 |

| 服务器不可用 | 自托管服务宕机导致通知丢失 | 关键任务建议备用通知渠道 |

| HTTP 明文传输 | 未配置 HTTPS 时数据暴露 | 强制使用 HTTPS，配合证书验证 |

核心用法

Gotify Skill 是一个轻量级的推送通知工具，通过调用用户自建的 Gotify 服务器，将任务完成状态、系统告警等信息推送到手机等移动设备。

基础调用：

bash scripts/send.sh "任务完成"

完整参数：支持自定义标题（-t）、优先级（-p 0-10）和 Markdown 格式（--markdown）。优先级 8-10 会触发设备声音/振动提醒，适合关键告警场景。

典型集成：通过 && 或 ; 将通知命令追加到长任务后，例如 ./deploy.sh && bash scripts/send.sh "部署完成"。

显著优点

1. 隐私可控：Gotify 为用户自建服务，数据不经过第三方云平台，避免敏感信息泄露给商业推送服务商。
2. 零依赖：仅需系统预装的 curl 和 jq，无额外软件包，供应链攻击面极小。
3. 格式丰富：原生支持 Markdown 渲染，可发送结构化报告、状态摘要等富文本内容。
4. 优先级分级：0-10 级优先级适配不同场景，高优先级可突破勿扰模式。

潜在局限

• 需自建基础设施：用户必须自行部署和维护 Gotify 服务器，增加了初期配置成本。
• 网络可达性依赖：通知发送依赖与 Gotify 服务器的网络连通，内网环境需额外配置反向代理或 VPN。
• 无内置重试机制：单次请求失败即返回错误，对关键任务需用户自行包装重试逻辑。
• 输入验证薄弱：当前版本对消息长度、URL 格式等缺乏严格校验，极端输入可能导致异常。

适合人群

• 已部署 Homelab / NAS 的进阶用户
• 对数据隐私敏感、拒绝商业云推送的开发者
• 需要监控 CI/CD 流水线、定时任务、备份脚本执行状态的管理员
• 希望在手机端接收服务器告警的运维人员

常规风险

| 风险项 | 说明 | 缓解建议 |

|--------|------|----------|

| Token 泄露 | 配置文件若权限过宽，可能被本地其他用户读取 | 建议设置文件权限 600，避免全局可读 |

| 配置错误导致 Token 暴露 | 误将 HTTP 或非标准端口配置为 Gotify 地址 | 脚本应验证 URL 必须为 HTTPS 协议 |

| 通知内容敏感信息泄露 | 消息通过用户网络发出，虽加密但仍建议避免包含密码、密钥 | 日志脱敏，使用占位符替代敏感值 |

安全认证结论

该 Skill 通过 CLS-Certify v2.1.0 扫描，获 A 级 / 85 分 认证。无危险函数调用、无硬编码凭证、无 Agent 注入风险。网络通信限定于用户配置的 HTTPS 端点，符合数据最小化原则。两项低风险项（外部网络请求、工具依赖）均属功能必需，已标记为可接受。