ntfy-notify 用于通过 ntfy.sh 发送推送通知,采用轻量级 shell 工作流,适合在告警、任务状态更新、提醒或自动化结果发布时使用。核心脚本为 scripts/ntfy_send.sh,主打确定性和低开销。
使用前需要准备默认主题,通过环境变量 NTFY_DEFAULT_TOPIC 设置,例如 export NTFY_DEFAULT_TOPIC="my-topic"。可选认证使用 NTFY_ACCESS_TOKEN(脚本也兼容旧版 NTFY_TOKEN)。可选自定义服务器通过 NTFY_SERVER 设置,默认是 https://ntfy.sh。脚本会从 ntfy-notify/.env-path 自动读取 ~/.config/stu-skills/ntfy-notify/.env 作为密钥与默认值文件,推荐将配置写入该文件,避免在命令中内联密钥。若未设置 NTFY_DEFAULT_TOPIC 且未传 --topic,脚本会退出并提示代理向用户索取主题。
发送方式:基本用法为 scripts/ntfy_send.sh "Build finished";显式指定主题为 scripts/ntfy_send.sh --topic ops-alerts "Backup completed";可附加标题、优先级与标签,例如 scripts/ntfy_send.sh --title "Deploy" --priority 4 --tags rocket,white_check_mark "Release shipped"。
注意事项:优先使用环境变量保存密钥和默认值;--dry-run 会在打印的 curl 输出中隐藏 bearer token 值,并可在不发起网络请求的情况下验证负载与请求头行为;建议保持消息简短且可操作。