用途:通过企业微信群机器人 webhook 发送清晰、无歧义的技术状态通知,适用于备份、同步、cron 任务或服务状态告警。
主要能力:一次性配置(保存 webhook URL、测试连通性、创建可复用发送脚本);发送消息时区分状态与增量、定义每个数字含义;内置 scripts/send_wecom.py 负责实际 HTTP 调用;收件人身份需显式配置,self 可自动发送,others 需人工确认,缺失身份则快速失败。支持接入阿里云 SLS 通知管道或周期性摘要。
使用方式:先检查 ~/.config/setup-notifications-via-wecom/config.json,若含 webhook_url 则跳过配置。webhook 形如 https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY,需私密存储并 chmod 600。用 uv run --no-project python scripts/set_recipient.py --scope self --label "My private self channel" 绑定发送方;测试发送:uv run --no-project python scripts/send_wecom.py --message "WeCom webhook test ✅"。多行消息可用 --file。也可用 curl 直接 POST。
消息规范:首行说明发生了什么;区分状态与增量;每个计数注明统计对象;使用平实位置名称;省略提交哈希、文件路径等噪音;包含验证指标;结尾给出下一步动作。提供备份同步完成、告警、状态更新三类模板。
限制:不创建或管理企业微信群机器人;不推断 webhook 触达对象;仅支持纯文本,不支持 markdown 卡片、图文、图片等富媒体;不修改主机代理配置或自动切换路由。手动发送对瞬时错误最多重试 3 次,自动 outbox 仅一次 HTTP 尝试。HTTP 200 且 errcode 非零仍为失败,errcode=0 仅表示 API 接受,不代表收件人已收到。