dsh-wechat-queue
带有持久化串行消息队列的 WeChat (iLink) DeepSeek Harness 渠道
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-wechat-queue@0.2.1Wechat Queue 以 dsh-wechat-queue 发布，当前版本为 0.2.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
在微信里和你的 AI 助手聊天。
发文字、发图、发文件、发视频，它在微信里回你。 一条回完才处理下一条，进程死了重启接着干 —— 你的消息不会丢。
Talk to your AI agent from WeChat. Text, images, files and videos in; one reply per turn out; messages survive a restart.
把微信接入 DeepSeek Harness —— 带一个落盘的串行消息队列。 A WeChat (iLink) channel for DeepSeek Harness with a durable serial message queue.
插件行为没有变化。这次只补了开源清单要的三个仓库文件：SECURITY.md、Dependabot 配置、
package-lock.json。代码没动。
你在微信发消息
↓
立即写盘（JSONL） ← ① 进程此刻被杀，消息还在
↓
排队，严格串行 ← ② 不会两条消息抢着跑、回复交错
↓
跑完这一轮 ← ③ 中途的中间片段不外发，只回最终结果
↓
把完整回复发给你
| 意外 | 会发生什么 |
|---|---|
| 进程崩了 / 你重启了电脑 | 重启后从磁盘恢复，没处理完的消息接着跑 |
| 你连发三条 | 按顺序一条条处理，不会乱序、不会回复串台 |
| 这一轮跑了三分钟 | 中间不刷屏，跑完一次性给你结果 |
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:SteelUnion/dsh-wechat-queue
装完重启 DSH，在插件页点登录、手机扫码，就能在微信里找它说话了。
| 你担心的 | 实际情况 |
|---|---|
| 消息会不会丢 | 不会。 每条消息一进来就写盘，进程被杀也没关系 |
| 会不会回一半停住 | 不会。 攒到这一轮跑完，一次发完整回复 |
| 会不会和别的消息插队 | 不会。 严格串行，一条处理完才拿下一条 |
| 手机能不能收到选项弹窗 | 不能。 微信是回合制通道，所以本插件配合 dsh-confirm-gate 会自动改用文字提问 |
用微信和你的 DSH agent 对话：发文字、发图、发文件、发视频，它在微信里回你。 一条回完才处理下一条，进程死了重启接着干。
A WeChat channel plugin for DeepSeek Harness.
Messages are persisted to disk and processed strictly one at a time — the next message
is only picked up after the previous turn has finished and been replied to.
The agent replies once per turn (at turn/end), shows a native "typing" indicator,
and can receive images, files and videos.
Built to replace dsh-channel-wechat, which had three structural problems:
missed messages (it polled with the oldest stale bot credential),
mid-turn replies (it sent every assistant/message fragment),
and deadlocks (no timeout, silent catch {}).
| 问题 | 老插件 | 本插件 |
|---|---|---|
| 收不到 | listAccounts()[0] 取最旧的僵尸账号 | 登录时清空旧记录，永远只有一个 |
| 中途发 | 每个 assistant/message 都发一段 | 攒到 turn/end，一次发完 |
| 卡死 | runExclusive 无超时 + catch {} 静默 | 三层超时，任何终态都推进队列 |
/compact、/goal 等进队列执行，与普通消息同序deliverables/ 下的文件就会发过去dsh plugin --profile desktop add <解压后的目录>
装完完全退出 DSH 再启动，宿主才能发现插件。
首次使用需要在 GUI 插件页扫码登录，或者用环境变量临时登录：
$env:DSH_WECHAT_QUEUE_TOKEN = "<accountId>:<token>"
- id: wechat-queue
config:
enabled: true
# 会话工作目录。决定微信那边读到的是谁的人格。
cwd: 'C:\path\to\your\workspace'
# 权限：管「能不能碰文件」
permission: 'danger-full-access'
# Agent 预设：管「有没有工具可用」
agentPreset: 'cordis'
deliverTimeoutMs: 600000
turnTimeoutMs: 600000
queueAckText: ''
permission 和 agentPreset 是两件事| 配了什么 | 结果 |
|---|---|
只给 permission | 权限全开，但 agent 一个工具都没有 |
| 两个都给 | 权限全开 + 工具齐全 |
只给 permission 时，agent 会说「我没有工具，请你手动跑这条命令」，而且它说的是实话。
agentPreset 不要留空串 —— 空串会回落到 profile 的默认预设，不一定是你在用的那个。
| 命令 | 作用 |
|---|---|
/stop | 中止当前这一轮（写标记，不会卡住） |
/status | 队列状态 |
/new | 开一段新对话 |
/help | 帮助，含 DSH 原生命令列表 |
其他 /xxx 如果 DSH 认识，会进队列在轮到时执行。
把文件放进 <cwd>/deliverables/，然后在回复里提到它。
<你的工作区>/
└─ deliverables/
└─ 报告.pdf ← 放这里,提到就会发
只有 deliverables/ 下的文件才会被自动发送。
不加这个限制的话，模型说「我读了 SOUL.md、USER.md」就会把那些文件也发出去 ——
列举路径不等于要发文件。
| 内容 | 位置 |
|---|---|
| 队列记录 | <DSH_HOME>/wechat-queue/queue-YYYY-MM-DD.jsonl |
| 运行日志 | <DSH_HOME>/wechat-queue/wechat-queue-YYYY-MM-DD.log |
| 轮询游标 | <DSH_HOME>/wechat-queue/cursor.txt |
| 启动错误 | <DSH_HOME>/wechat-queue/startup-error.txt |
| 账号凭证 | .credentials.yaml 的 wechat-queue/account |
排查先看运行日志。 GUI 启动没有终端，console.error 的输出没人看得见。
received → queued → delivered → running → replied
├→ failed （带 stage + error）
├→ timeout （带 stage）
└→ stopped （被 /stop）
任何终态都会让队列推进到下一条。 这是「永不堵死」的来源。
node test/zz-all.mjs
548 项，18 个套件，0 失败。
覆盖：串行与超时、状态机、JSONL 存储、四种媒体（图片/文件/视频/语音）、 文件发送与上传、预设挂载契约、事件竞态、扫码登录。
node pack.mjs # 输出 dist/dsh-wechat-queue-v<version>.zip
node pack.mjs --list # 只列清单
零运行时依赖。 peerDependencies 只声明 @deepseek-ai/cordis，
DSH 本体版本要求写在 engines.dsh。
为什么不用 ctx.get() 做软探测：它不是软探测，用到的服务必须写进 inject，否则直接抛。
为什么 agentPresets.resolve() 必须 await：它是 async 的。不 await 会拿到一个 Promise，
preset?.id 永远是 undefined，于是预设从未挂载 —— 这就是「权限全开但一个工具都没有」的原因。
为什么媒体要「先下载完再入队」：worker 是独立循环，enqueue 一完成它就可能取走交付。
图片几十毫秒赶得上，视频几秒就赶不上 —— 附件会丢掉，而且队列记录看起来一切正常。
这些坑和更多细节都在 NOTES.md。
协议层（lib/protocol/）搬自 dsh-channel-wechat v0.2.5（MIT）。
lib/protocol/qrcode.js 是 vendored 的 qrcode-generator 2.0.4（MIT）。
队列层、worker、桥接层、命令转发、typing 指示器、媒体处理是本插件自己的实现。
MIT。全文见 LICENSE。