Skip to content

dsh-wechat-nudge

Verified

dsh-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 会话。

它不读聊天内容、不发消息、也不判断该不该回——只负责叫醒。叫醒之后要不要回、怎么回,交给那个会话说。

  • 只看微信本地库文件的修改时间,不看正文
  • 采集与索引全在本机完成,不联网
  • 不点击微信窗口、不模拟输入、不发送任何消息

它怎么工作

  1. 每 intervalSec 秒 stat 一次微信消息库的 message_0.db-wal(只拿 mtime)
  2. 时间变了 → 调 dsh-better-wechat 的 python/bridge.py 做一次增量采集
  3. review 最近 classifyWindowMin 分钟,取最新一条的 sender_label
  4. 不是你发的 → 往目标会话 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)

安装

本地包要两处登记,缺一不可:

  1. profile 的 package.json → dependencies 里加 "dsh-wechat-nudge": "link:<本仓库路径>"
  2. 同一个文件的 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