前言¶
DeepSeek Harness（DSH）用户在使用智能体时，常需要通过微信进行交互。传统的接入方式通常需要搭建额外的代理服务或手动管理令牌。dsh-weixin 插件旨在解决这一问题，它允许用户通过微信扫码直接将机器人接入 DSH，并在 Host 进程内处理消息流转。
是什么¶
这是一个由 xmanrui 维护的工作流插件，用于将腾讯微信机器人接入 DeepSeek Harness。插件运行在 dsh web 的 Host 进程内：浏览器端仅负责显示一次性二维码和脱敏状态；扫码后得到的 bot_token 会直接写入 Harness 的凭据服务，随后由 Host 通过腾讯 iLink Bot API 进行长轮询，实现消息的收发。
安装与绑定¶
在安装前，请确保满足以下前提：
* DeepSeek Harness 版本为 0.1.0-rc.6，运行环境 Node.js >=22.19；
* 手机微信账号已开通微信机器人功能（该功能由腾讯分批开放，插件代码无法绕过）；
* 运行 Harness 的设备能够访问 *.weixin.qq.com。
执行以下命令进行安装：
npx -y github:xmanrui/dsh-weixin install
安装完成后重启 dsh web，然后按以下步骤绑定：
- 打开「设置 → 插件 → 微信」；
- 点击「扫码绑定微信」；
- 使用手机微信扫描页面上的二维码，并在手机上确认；
- 如果手机显示配对数字，在 Harness 页面输入该数字；
- 页面显示“运行正常”后，即可在微信中向已绑定的机器人发送消息。
功能与消息行为¶
- 多账号隔离：支持重复扫码添加多个微信账号。每个账号拥有独立的凭据引用、长轮询、同步游标、消息去重记录和 Harness 会话映射。
- 消息支持：支持文字消息，以及微信已附带文字识别结果的语音消息。当前不处理图片、文件、视频或无转写语音。
- 会话映射：每个微信用户映射到一个持久 Harness 会话，支持连续对话。
- 命令：在微信中发送
/new可清除当前会话映射，/status用于检查连接状态，/help显示帮助信息。
注意事项¶
- 项目状态：项目已不维护，作者建议迁移至功能更全的
dsh-im插件。 - 安全设计：
bot_token不会发送给浏览器，仅保存在 Host 进程的凭据服务中。删除账号会同时停止该账号的长轮询、清理凭据、配置和会话映射。 - 网络依赖：Host 进程必须能够访问
*.weixin.qq.com。 - 权限限制：仅接受扫码确认用户发来的私聊消息，其他用户默认拒绝。
总结¶
dsh-weixin 提供了一种将微信集成到 DeepSeek Harness 中的原生方式，核心优势在于 token 的安全存储和 Host 进程内的消息处理。对于需要通过微信进行简单文本交互的用户，该插件提供了直接的解决方案。
