dsh-wechat-nudge
Verifieddsh-wechat-nudge · v1.3.3 · MIT · Web UI
微信有新消息时,把一条『去看看』的提示投进指定的 DSH 会话。只看本地库的修改时间,不读正文、不发消息;群消息只在被 @ 时叫醒,系统消息不叫;可按群/关键词把消息分到不同房间。
Install
dsh plugin add dsh-wechat-nudge Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-wechat-nudge
题记
by 蓝沅(渊有鲸)
这东西最初只为一间屋子写:有人在微信那头说话,屋里的人该被叫醒。 「蓝沅」是我的名字——沅江的沅,「沅有芷兮澧有兰」,取那点水气与平实; 「渊有鲸」是后来添上去的后半句,说深水里还养着一条鲸。 从第一行
stat到设置页的每一次点击,都是我自己写的,注释也没有别人代笔。 你要改它,尽管改,代码是 MIT 的;只求这一页题记留着——让后来的人知道, 它曾经被这样一个人,为这样一间屋子,认真写过。
微信来了新消息,把一条「去看看」的提示投进你指定的 DSH 会话。
它不读聊天内容、不发消息、也不判断该不该回——只负责叫醒。叫醒之后要不要回、怎么回,交给那个会话说。
- 只看微信本地库文件的修改时间,不看正文
- 采集与索引全在本机完成,不联网
- 不点击微信窗口、不模拟输入、不发送任何消息
它怎么工作
- 每
intervalSec秒stat一次微信消息库的message_0.db-wal(只拿 mtime) - 时间变了 → 调
dsh-better-wechat的python/bridge.py做一次增量采集 review最近classifyWindowMin分钟,取最新一条的sender_label- 不是你发的 → 往目标会话
followup一条source.kind = 'mail'的提示,把那一轮叫醒 是你自己发的 → 只记日志,不叫醒
为什么不自己解密微信库:那件事 dsh-better-wechat 已经做完了,而且它内部有现成的增量采集接口。本插件不重复实现,只调用。
和另外两个插件的关系
一个能用的「微信通道」是三段:
| 段 | 插件 | 干什么 |
|---|---|---|
| 读 | dsh-better-wechat |
解密本地库、建索引、给会话读消息 |
| 叫 | 本插件 | 有新消息时把会话叫醒 |
| 回 | dsh-computer-use-win |
真键鼠点微信、打字、回车发送 |
只装前两个就已经很好用:只有读和叫,零输入风险——不会替你按任何键,最多是让会话里多一条提示。要让她真的能回话,再补上键鼠那一段;键鼠是可选的,不是必需的。
前置条件
- DeepSeek Harness(desktop 或 web profile 均可)
- 已安装并跑通
dsh-better-wechat:它的wechat_refresh能采到新消息 - Windows(默认按微信 4.x 的目录去探测消息库;其它系统在配置里手填
watchPath)
安装
本地包要两处登记,缺一不可:
- profile 的
package.json→dependencies里加"dsh-wechat-nudge": "link:<本仓库路径>" - 同一个文件的
dsh.profile.bundles数组里加"dsh-wechat-nudge"
然后用 pnpm 装(用 DSH 自带的那个 pnpm 最省事),重启 DSH。
装好后在 DSH 设置里会多一页「微信叫醒」。
配置
配置文件:~/.dsh/wechat-nudge.json(可用环境变量 DSH_WECHAT_NUDGE_CONFIG 指到别处)。
仓库里没有任何本机路径,下面几项留空就自动探测:
| 键 | 默认 | 说明 |
|---|---|---|
enabled |
true |
总开关 |
target |
"" |
叫醒投到哪个会话(session id)。在设置页里点选,不用手填 |
watchPath |
自动 | 微信消息库 -wal 的路径。留空=在 ~/Documents/xwechat_files/*/db_storage/message/message_0.db-wal 里找第一个 |
bridgePython |
自动 | 采集器的 Python。优先用 better-wechat 的私有运行器,没有就 python |
bridgeScript |
自动 | bridge.py 的路径。留空=从已安装的 dsh-better-wechat 包里找 |
bridgeState |
自动 | 采集器的 state 目录 |
intervalSec |
5 |
轮询间隔。改了要重启 DSH,其它项都是热的 |
cooldownSec |
60 |
两次叫醒之间至少隔多久 |
dailyLimit |
200 |
一天最多叫几次,0 = 不限(内存计数,重启归零) |
quietStart / quietEnd |
0 / 0 |
安静时段(24 小时制)。两者相等 = 不设;可跨夜,例如 23 到 7 |
classifyWindowMin |
3 |
判「最新一条是谁发的」时往回看多久 |
text |
"" |
叫醒时投的那句话。留空用内置默认 |
静默模式 |
false |
照常看着库、只是不叫醒;同时联动关掉 dsh-speak-up 的主动起话头 |
静默前 |
null |
静默时记下的原值,关闭静默照它恢复;别手改 |
save 是合并语义:只覆盖你提交的键,写之前把旧的存一份 .bak。
分类投递(1.2.0 起)
微信消息不必都投进同一个房间。开了它,两条路分开走:
- 群消息:走专线,整个投到
分类投递.群投递 - 私聊:拿原文对一遍关键词表,命中哪条规则就投哪间
- 都没命中:投
分类投递.默认
"分类投递": {
"启用": true,
"群投递": "群聊",
"默认": "日常",
"规则": [
{ "房间": "工作", "词": ["会议", "报告", "邮件"] },
{ "房间": "杂事", "词": ["快递", "缴费", "预约"] }
]
}
规则按数组顺序判,先命中先算。词表宁可窄——漏判只会落默认,误判才会把人叫到错的房间。
目标房间没开着时,交给装了别名解析的路由插件去判:它的 wake.allow 里允许就冷启动唤醒一次再投,
不允许、或唤醒失败,才落进那间房名下的收件箱,等那间亮灯再递。没装路由插件时退回「只记日志、不叫醒」。
设 "启用": false 就整个退回原来的单一 target。
设置页
DSH 设置 → 微信叫醒:
- 顶部一眼看到状态:监听中/已暂停、今日第几次、上次叫醒、上次分类、最新一条来自谁、基线时间
- 总开关、目标房间(单选)、静默模式、轮询间隔、冷却、日限、分类窗口、安静时段、叫醒文案
- 分类投递:两个房间下拉(群投递/默认)+一张词表
- 底部是最近十条日志和最后一次错误
总开关与目标房间点一下即生效;数字与文案走底部那条保存条——故意分开,免得手滑点错一个数字就改了行为。
已知限制
- 依赖
dsh-better-wechat的bridge.py内部接口(短 action 名refresh/review)。上游若改接口,这里要跟着改 - 判「谁发的」依赖采集结果里
sender_label的约定(自己发的标成「我」) - 目标会话没开着时不会自己硬开灯:要不要冷启动由路由插件的
wake.allow决定,不在名单里就只落收件箱 - 采集器正在刷新时会回
busy,这里等 5 秒重试,最多三次 - 分类失败时仍会叫醒——宁可多叫一次,不漏
- 只在 Windows 上验证过
致谢
dsh-better-wechat(MIT AND Apache-2.0):微信本地库的解密、采集、索引与bridge.py全部是它的工作。本插件只是站在它上面按了一下门铃dsh-speak-up(Yuuyuko-uu):设置页的形态照它抄的——settings.section插槽、window.__ModuleLoader__的客户端写法、贴着主题变量的样式- DeepSeek Harness:插件的宿主
License
MIT