xbzbing/dsh-im-wechat ↗★ 0

dsh-im-wechat

把微信(WeChat iLink)接入 DeepSeek Harness 的 IM 桥插件

包名
dsh-im-wechat
兼容性
待验证
Harness 依赖范围
>=0.2.2-rc.1 <0.3.0
Cordis 依赖范围
^4.0.1
版本
0.4.0
许可证
MIT
最近更新
2026年11月15日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:xbzbing/dsh-im-wechat

使用

接入我的超级助理

  • 主人在微信里发消息 → 插件交给核心,命令解析、主人判定都由核心做;核心受理后到首段交付送达前显示「正在输入」。
  • 核心的交付 → 插件按 Markdown 透传发到微信,超过 1500 字节分条。
  • 主人太久没开口时 context_token 会过期(窗口声明为 24 小时,实测 18 小时龄仍可发送),交付先挂起、等主人下次发消息再送达;桥已向核心声明这个窗口,核心会跳过硬发(ADR-0013,数值由 ADR-0015 修订为 24 小时)。
  • 没有交互卡:核心的问题与选项由插件写成文字,主人回复序号或文字即可作答。
  • 主人在微信里发的图片会作为附件交给核心(需要核心声明 owner-images 且判明是主人,否则按纯文本)。
  • 面板上的两个开关:接入微信(收消息) 控制插件是否工作;接入我的超级助理 决定消息与提醒归谁——打开时由核心处理,关闭后插件自己发问题提醒(与 Web 竞答)和长任务提醒。打开后,只属于独立模式的设置(问题与审批提醒开关、提醒前等待、提醒阈值)在面板上锁住并标出原因:这些值只在没接核心时生效,改它们不会影响核心发不发提醒。

独立模式

  • 面板「独立模式」里选工作区:默认是 $DSH_HOME/dsh-im-wechat 下自动创建的「微信会话」,也可以换成宿主里已有的工作区。首条微信消息在所选工作区的目录里新建一个会话,之后一直用它。
  • 这个工作区目录与会话的 cwd 是同一个位置,里面没有任何凭据:登录态与面板设置放在另一个目录 $DSH_HOME/.dsh-im-wechat(ADR-0021)。
  • 之后主人发的文字、图片与文件直接提交给该会话,回答发回微信;「当前会话」里能看到绑定的会话与运行状态。模型 present 的本地图片会自动发到微信,不用它知道 CLI。
  • 会话用哪个模型与推理等级在「默认模型」里选:先选来源(provider),再选模型,最后选推理等级;候选来自宿主的模型目录,provider 的第一项是「跟随 DSH 默认」,推理等级留空就用模型自己的默认。改完立刻换到已绑定的会话;清空整条选择只影响以后新建的会话——已绑定的会话仍用它记下的模型,要回到默认请先「重置绑定」;只清空推理等级会把已绑定会话切回模型默认(ADR-0025、ADR-0026)。
  • 图片(png / jpeg / webp / gif,单张 ≤ 10 MiB,一次最多 9 张)作为附件交给会话;只有图没有字时补一句「请看这张图」,下载失败的图当这条没有图(ADR-0017)。
  • 文件(PDF、Office、压缩包等不限类型,单条 ≤ 32 MiB、最多 3 个)下载解密后交给宿主的附件暂存,模型拿到只读副本路径自己打开;只有文件没有字时补一句「请看这个文件」,没接上的文件会回一句原因(ADR-0028)。
  • 绑定会话的模型需要支持图片输入;不支持时图片会被拒收、文字照常送达,并回一句「图片没有发出去」。
  • 「回合内插话」默认打开:回合正在跑也会把新消息插进去(尽力而为,宿主窗口已关时退化成排队);关掉才排队等这一轮结束。
  • 换工作区或想开新会话:点「重置绑定」,或在微信里发 /new。
  • 微信里可以发这几条命令(只认扫码登录的主人):/help 看命令说明;/new(或 /reset)开新会话;/sessions [页码](或 /list)列最近会话;/send 往指定会话发消息,回答回推给你;/trace [分钟] 跟踪一个会话,/trace 看列表、/trace stop [序号或会话 id] 停止(序号按 /sessions 快照);/stop 停当前回合;/status 看连接、当前会话、模型、待答与跟踪。命令不进模型、不建会话,接入核心后整段交给核心(ADR-0027)。

配置

profile 的 cordis.patch.yml 里按 loader id 叠加配置:

- id: dsh-im-wechat
  config:
    enabled: true                     # 静态默认「接入微信(收消息)」,面板值优先
    superagent: true                  # 静态默认「接入我的超级助理」,面板值优先
    longTaskThresholdMinutes: 45      # 长任务提醒阈值(分钟),默认 30,范围 1–1440
    questionReminders: true           # 问题与审批提醒,默认开
    questionDelayMinutes: 5           # 提醒前等待(分钟),默认 5,范围 0–120(0 = 立即)
    maxText: 1500                     # 单条消息上限,按 UTF-8 字节计,默认 1500
    typingIndicator: true             # 「正在输入」状态,默认开(ADR-0007)
    verifyPin: false                  # 取码时强制服务端出 PIN,仅用于提前验证(ADR-0014)
    directModel:                      # 独立模式微信会话的模型与推理等级;整段省略 / 留空 = 跟随 DSH 默认(ADR-0025、ADR-0026)
      provider: deepseek-account
      model: deepseek-reasoner
      reasoningEffort: high           # 可选:适配器声明的推理等级 id;省略 = 模型默认

其余键(dataDir、baseUrl、cdnBaseUrl、botAgent、directWorkspaceId、directBusyMode)见 src/host/config.ts。

面板上改的设置(接入微信、接入我的超级助理、长任务阈值、提醒开关与等待时间、独立模式的工作区、提交方式、模型与推理等级)落在 $DSH_HOME/.dsh-im-wechat/config.json(0600);独立模式的会话绑定在 direct.json(同目录)。两者都优先于 profile 配置,卸载重装后沿用。