DeepSeek Harness (DSH) 的核心设计是将能力通过插件扩展到不同渠道。对于开发者或用户而言,直接在微信中与 AI 交互是常见的诉求。dsh-wechat 插件通过将微信联系人桥接到 DSH 会话,实现了在微信中调用 DeepSeek 服务的功能。
这是一个由 dAI-aigc 维护的插件,使用 MIT 许可证。它利用腾讯官方的 iLink 通道,将微信联系人映射为独立的 DSH 会话,允许特定的微信 ID 驱动 DeepSeek Harness 进行回复。
核心功能¶
- 独立会话管理:每个微信联系人拥有独立的 DSH 会话(命名格式为
wechat-<contactId>),确保对话上下文与该联系人绑定。 - 多格式传输:支持文本、图片和文件的传输,图片会从 CDN 获取并挂载到会话,文件会直接读取。
- 原生打字指示器:支持微信原生的打字状态显示,通过获取票据、发送状态并定时刷新来实现。
- 白名单机制:通过
allowFrom配置项控制允许驱动代理的微信 ID 列表。默认情况下,仅允许扫码登录的账号,配置为空数组时即为“仅允许登录账号”。 - 本地运行:登录流程在本地机器的包目录中运行,微信端仅需扫码确认。
安装与启用¶
- 安装插件:
在 Web profile 下安装该插件:
dsh plugin --profile web add github:dAI-aigc/dsh-wechat
- 本地登录:
进入插件目录并安装依赖、启动登录:
cd <package dir>
pnpm install
pnpm login
登录脚本会在本地 8899 端口提供二维码页面,扫描并确认后,凭据将存储在 `$DSH_HOME/data/dsh-wechat/weixin/` 目录下。
- 重启服务:
重启dsh web以便插件读取存储的凭据。
典型用法¶
- 配置白名单:在 DSH 的配置中设置
dsh-wechat.allowFrom。例如,将特定的微信号加入列表以允许其发送消息。 - 交互:从白名单中的微信 ID 发送消息,DeepSeek Harness 将在对应的独立会话中处理并回复。
- 回复分块:回复内容会被自动分块,每块 1800 个字符。
- 查看账号:在插件目录运行
pnpm accounts可以列出存储在本地机器上的账号列表。
适用场景与注意事项¶
- 权限与安全:插件以当前 dsh 进程的权限运行,请确保对源码和许可证(MIT)有了解后再安装。
- 并发限制:一次只能有一个进程进行长轮询 (
getupdates)。如果手动运行pnpm listen,插件将无法正常工作。 - 功能限制:语音、视频和转发卡片会被跳过,且不会显示警告信息。
- 会话维护:如果遇到错误代码
-14,表示会话过期,需要重新执行pnpm login进行登录。
该插件适合需要将微信作为 DeepSeek Harness 交互入口的场景。插件仓库:GitHub。