dsh-im-wechat
把微信(WeChat iLink)接入 DeepSeek Harness 的 IM 桥插件
安裝
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:xbzbing/dsh-im-wechat說明文件
閱讀完整 README ↗使用
接入我的超级助理
- 主人在微信里发消息 → 插件交给核心,命令解析、主人判定都由核心做;核心受理后到首段交付送达前显示「正在输入」。
- 核心的交付 → 插件按 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 配置,卸载重装后沿用。