Wechat Notify — AI skill for Claude Code

wechat-notify 📱

**AI 助手任务完成 / 卡住 / 需要你确认时，自动推送一条消息到你的微信（或企微 / 钉钉 / 飞书）。**

挂在你正在用的 AI 编程助手（WorkBuddy / Claude Code）的 hook 上，让"跑完了通知我"、"卡住了叫我"变成一件可靠的小事：你去干别的，手机会震。

纯 Python 标准库实现，**零第三方依赖**，Windows / macOS / Linux 均可。

---

它解决什么问题

用 AI 助手跑长任务时最常见的两种煎熬：

• 任务跑完了，你不知道，回来发现早就结束，白等半小时；
• 任务卡在等你点"允许 / 确认"，你没注意，它就一直停在那儿。

本项目把这两件事变成**手机上的系统级推送**：

事件	含义	你会收到
Stop	对话回合结束 = 干完活了	✅ 任务完成：<会话名> + 📝 <本轮概要>
Notification(idle)	空闲等你回复	⏸️ 等你回复：<会话名>
Notification(permission) / PermissionRequest	要你点确认（默认只推高危操作）	🔐 需确认：<会话名>
其他通知	其他提醒	👀 需要你看一眼：<会话名>

特性

• 🎯 事件驱动：由 AI 助手自己的 hook 主动上报"我停了 / 我在等你"，比在外面猜进程状态准得多
• 📱 9 种推送通道任意组合，多通道同时发，任一成功即算送达
• 🚦 分组节流防刷屏：任务完成组只挡 10 秒内的瞬时重复，绝不吞掉真正的完成通知；等待/确认组 60 秒防骚扰
• 🧪 测试消息与真实通知完全隔离：手动测试不污染节流状态（踩过坑后专门修的）
• 📝 会话名自动跟随 UI 重命名：直接读 WorkBuddy 数据库的 custom_title，你改了名通知就跟着变
• 🛡 高危才打扰：rm -rf /、写系统目录才推送；AI 日常清理临时目录不会吵你
• ⏱ watchdog：盯任意长命令 / 已在跑的进程，超时没动静就提醒
• 🧵 硬超时保护：hook 永远在几秒内返回，绝不拖慢 AI 助手；任何异常静默吞掉

快速开始（WorkBuddy 用户）

# 1) 把整个目录复制到技能目录
cp -r wechat-notify ~/.workbuddy/skills/wechat-notify

# 2) 生成配置：复制模板，填一个你有的通道
cd ~/.workbuddy/skills/wechat-notify
cp config.example.json config.json   # 然后编辑，见下文"推送通道"

# 3) 安装 hook（自动写入 ~/.workbuddy/settings.json，会先备份）
python install_hooks.py

# 4) 发一条真实的测试消息，手机收到即成功
python hook.py --test-stop

卸载：`python install_hooks.py --uninstall`（只删自己加的条目，不动其他 hook）。

快速开始（Claude Code 用户）

把目录克隆到任意位置，然后在 Claude Code 的 hooks 配置里加上：

{
  "hooks": {
    "Stop": [
      { "hooks": [ { "type": "command", "command": "python /path/to/wechat-notify/hook.py --hook Stop" } ] }
    ],
    "Notification": [
      { "hooks": [ { "type": "command", "command": "python /path/to/wechat-notify/hook.py --hook Notification" } ] }
    ],
    "PermissionRequest": [
      { "hooks": [ { "type": "command", "command": "python /path/to/wechat-notify/hook.py --hook PermissionRequest" } ] }
    ],
    "UserPrompt