微信定时唤醒 epsilonH-eps/dsh-wechat-wake

dsh-wechat-wake —— 微信里的定时唤醒

给微信里的智能体一组自己的定时工具：到点它自己醒过来说话，说的话直接落进当前微信聊天。

写给微信里的陪聊 / 人格会话用的。DSH 自带的 schedule 那套在这类会话里走不通：

| 现成的 | 卡在哪 |
| @deepseek-ai/dsh-tool-schedule | 社交模式下被 bridge 的 controlTool 前缀挡掉，工具根本不给看 |
| bridge 的「到点把结果发回微信」（adoptScheduledTurn） | 只在 workMode === 'assistant' 时执行 |

所以本插件用不撞前缀的工具名（remind_）绕开第一道闸，用自己的 followup + 投递跑完整条链。

安装

让 dsh 自己把包挂进 profile（会读包里的 dsh.bundle.patch）
dsh plugin --profile web add github:heyikai060215-jpg/dsh-wechat-wake

手动安装（和本机其它 dsh-mod 插件一样）：

1. 把本仓库放到例如 D:/dsh-mod/dsh-wechat-wake
2. profiles/<profile>/package.json 的 dependencies 加 "dsh-wechat-wake": "link:D:/dsh-mod/dsh-wechat-wake"，dsh.profile.bundles 加 "dsh-wechat-wake"
3. profiles/<profile>/node_modules/dsh-wechat-wake 链到该目录（符号链接或 junction）
4. 重启 DSH，或改动 profile 的 package.json 触发一次热加载
5. 到 WeChatAgent 里给目标聊天勾上三个 remind_ 工具

装完先跑只读自检（不发消息，只查通道通不通）：

node tools/selftest.mjs wechat:private:<聊天号>
也可以直接给会话 id，脚本自己反查聊天键
node tools/selftest.mjs social-xxxxxxxx

通道都在的时候会打印 reader / hook / chat / target / mode 并返回 0；缺哪一项返回 1。

工具

| 工具 | 作用 |
| remind_later(note, delay_seconds \| at, mode?) | 定一条一次性唤醒。mode=wake（默认）到点开一轮；mode=text 原样发 note、不花模型 |
| remind_list() | 看这个会话还压着哪些没触发的、最近错过什么 |
| remind_cancel(id) | 取消一条 |

到点流程：复查聊天还在微信白名单 → wake 走 agent.followup() 叫醒会话 → 抓这一轮的正文（去掉 RESPOND: 前缀）→ 发到微信；没抓到正文 / 这一轮报错 / 超时 120 秒 → 退化成发 ⏰ note，保证「到点一定有动静」。

sequenceDiagram
participant U as 微信里的你 participant A as agent（社交模式会话） participant P as dsh-wechat-wake participant H as 微信 hook U->>A: 三分钟后提醒我喝水 A->>P: remind_later(note, delay_seconds) P->>P: 挂定时器 + 写 $DSH_HOME/wechat-wake.json Note over P: 三分钟后 P->>A: agent.followup(到点唤醒) A->>A: 现查 / 现想（wake 模式）
A-->>P: assistant/message → turn/end
P->>H: POST /SendTextMsg
H-->>U: 这条消息是它自己发的
P->>P: 标记 delivered / confirmed

实测记录

真机（微信私聊、社交模式、人格式会话）跑通的一条，状态文件里的原文：

{
"id": "rw-47b31757",
"sessionId": "social-8b23659d…", "chat": "wechat:private:<聊天号>", "note": "本鲸来催了——喝水！快端起来灌两口，别让本鲸催第二遍哦 (￣^￣)", "mode": "text", "dueAt": 1793122435446, "state": "delivered", "firedAt": 1793122435479, "deliveredAt": 1793122436042, "confirmed": true }

| 时刻 | 事件 |
| 01:30:55 | 会话那一轮的工具表里出现 remind_later / remind_list / remind_cancel |
| 01:30:55 | 模型自己调用 remind_later，选了 mode: "text" |
| 01:33:55.479 | 定时器触发（误差 0.5 秒内） |
| 01:33:56.042 | 投递完成，微信数据库回执 confirmed: true |

自检脚本的输出长这样：

{
"chat": true,
"fromSession": "social-8b23659d…", "mode": "social", "reader": true, "hook": true, "target": "昵称 (wxid_…)"
}
mode: "wake"（到点真叫醒再说话）走同一条链路（agent.followup() + 抓 turn/end 正文），还没在「到点必须现查现说」的任务上单独验收——第一次用建议先这么试一次。

怎么授权（关键）

插件不自己判模式，要不要给某个微信聊天用，仍然在 WeChatAgent 里按聊天勾选：

- 界面：聊天 → 设置此聊天 → 能力与权限，勾上 remind_later / remind_list / remind_cancel
- 等价改文件：config/wechatagent.json → wechat.dshAccess.chats["<聊天键>"].tools

社交模式的聊天勾上就能用（这是本插件的目标场景）。助手模式的聊天别勾：那边原生 schedule_create 已经把结果转发得好好的，而且 bridge 对助手模式里任何「非请求的唤醒」都会查发起人，查不到就整轮报错——所以插件在助手模式被调用时会直接回一句「请改用 schedule_create」，不硬闯。

依赖的三条既有通道（不碰微信本体、不改 WeChatAgent 代码）

1. state/accounts/<账号>/dsh-sessions.json 的 conversations：会话 ↔ 聊天
2. state/wechat-io-config.json 的 reader 地址和令牌：查 wxid、查回执
3. state/hook/native-token.txt + POST http://127.0.0.1:30001/SendTextMsg：发消息

和 dsh-tts-bridge-wechatagent-bridge（把朗读桥念的话发成微信语音条）用的是同一套。

状态与边界

- 待触发列表落在 $DSH_HOME/wechat-wake.json；进程重启后重新挂表
- 关着期间到点的：10 分钟内补发，更早的记成 missed（不补发，免得半夜收到一句不合时宜的提醒）
- 每个会话最多 12 条待触发，单条最长 7 天；两次发送至少隔 1.5 秒
- 投递前复查白名单；聊天被移出白名单 → 记 skipped，不发
- 直发 hook 绕过了 WeChatAgent 的发送队列（没有去重编号、没有重试队列），失败只记日志，不重试轰炸
- 只能唤醒还活着的会话；冷会话退化成发静态文本
- 依赖匹配版微信 + WeChatAgent 的 hook；微信升级导致 hook 偏移变化时，发送会失败（插件本身不用改）

安全与免责

- 这个插件会真的往微信发消息，而且用的是你本机的微信 hook。先在没人打扰的聊天里试，别直接挂到工作群。
- 它不读聊天记录、不上传任何数据；待触发列表只写本机 $DSH_HOME。
- 授权是逐聊天的：没在 WeChatAgent 里勾上，任何会话都调不到这三个工具。
- 按 MIT 提供，不附带任何担保；被微信风控、发错人、发错时间的风险请自行评估。

文件

package.json main = lib/host.js，dsh.bundle.patch 指向 cordis.patch.yml cordis.patch.yml insert: { id: wechat-wake, name: 'dsh-wechat-wake' } lib/host.js 三个工具 + 定时器 + 到点流程 + 状态持久化 lib/send.mjs 会话→聊天→wxid→SendTextMsg，外加只读探针 probe() tools/selftest.mjs 命令行只读自检

卸载

1. profiles/<profile>/package.json 里删掉 dsh-wechat-wake 依赖和 bundles 里那一行
2. 删掉 profiles/<profile>/node_modules/dsh-wechat-wake 这个链接
3. 删掉仓库目录，以及 WeChatAgent 里的三个工具勾选
4. 想清干净的话再删 $DSH_HOME/wechat-wake.json

License

MIT