DeepSeek Harness 微信接入插件 (dsh-wechat-suite)

DeepSeek Harness (DSH) 是一个基于插件架构的智能体开发与运行框架。开发者通常需要在微信端与智能体进行对话、监控运行状态或进行人工审批。dsh-wechat-suite 插件通过腾讯的 iLink 协议，将 DSH 的 Profile 连接到微信个人账号，实现无需公网 IP 和端口转发的双向通信。

是什么¶

这是一个将 DSH Profile 连接到微信个人账号的插件包。它利用腾讯的 ilinkai.weixin.qq.com 网关实现通信。插件包含两个核心组件：
* wechat-gateway：处理 iLink 服务，包括二维码登录、认证长轮询、重连/退避、发送重试与限流熔断、输入指示器、加密 CDN 媒体传输及入站消息去重。
* wechat-conversation-node：微信与 DSH 的桥接层，负责会话定向、命令执行、上下文轮换以及多模态媒体处理。

核心功能¶

消息与媒体支持：支持双向文本、图片、语音、文件、视频传输。集成 OCR（文字识别）、STT（语音转写）、TTS（文本转语音）、图片生成及视频处理能力。
连接与可靠性：提供二维码登录、认证长轮询。具备自动重连/退避机制、发送重试、限流熔断、输入指示器。媒体下载/上传通过加密 CDN 进行，支持入站消息去重。
会话与控制：支持会话定向、命令执行、上下文轮换。提供智能体审批、提醒、早间天气、摘要导出及灯光控制功能。
多平台与运维：支持微信与 QQ 双平台，统一管理。提供独立的管理控制台，支持前端编辑即时生效。YAML 配置保存后不会破坏 Profile。

安装与启用¶

环境准备：确保安装了 Node.js >= 22、pnpm，并拥有一个 DSH Profile 和一个专用的微信账号。
安装插件：

    dsh plugin --profile <your-profile> add github:PRTS168/dsh-wechat-suite

账号绑定：

    pnpm login

扫描生成的二维码以登录微信账号，系统将存储 `WEIXIN_BOT_TOKEN`、`WEIXIN_ACCOUNT_ID` 等凭据。

配置：

    pnpm setup

填充 `allowFrom` 允许列表条目及其他必要凭据。

典型用法¶

安装并配置完成后，重启 dsh web，向微信发送消息即可与智能体交互。若需管理控制台，运行：

node admin/server.ts

控制台将运行在 http://127.0.0.1:8790/（Token 将生成在 admin/.admin-token）。

注意事项¶

单实例限制：iLink 协议对每个账号只允许一个认证轮询器。在同一微信账号上运行第二个实例会导致 HTTP 403 并丢失消息。
账号风险：建议使用专用微信账号，将其视为一次性账号，腾讯可能会随时限制该账号。
必要配置：必须配置 allowFrom 允许列表条目，以及 WEIXIN_BOT_TOKEN、WEIXIN_ACCOUNT_ID、WEIXIN_BASE_URL 凭据。缺少这些配置插件将保持空闲。
预设文件：插件不包含 Persona 预设，需将 agentPreset 指向自己目录下的预设（如 $DSH_HOME/.agent-presets/<name>/）。

结语¶

该插件通过封装 iLink 协议，为 DSH 提供了在微信端的完整交互能力。对于需要在移动端或微信生态内部署和管理智能体的开发者，这是一个可行的解决方案。更多细节可参考 GitHub 仓库。