前言¶

DeepSeek Harness（DSH）采用插件化架构。若需要在微信中与本地运行的 DSH 进程交互，或通过微信控制本地智能体，需要一个专门的连接层。dsh-wechat-bridge 插件提供了这一能力，它将微信 iLink 通道接入 DSH 生态。

插件简介¶

这是一个独立社区集成项目，将本地 DSH 进程连接到微信 iLink 机器人通道。它不包含桌面微信自动化脚本，也不依赖任何第三方运行时环境。项目采用 MIT 许可证。

该插件定位为面向终端和自动化工作流的微信远程桥接，而非通用多 IM 聚合器。它不提供图形化设置面板，而是通过独立 CLI 和 SSE 控制接口实现操作。

核心功能¶

插件提供以下核心能力：

• 消息接入：接入微信 iLink 文本消息及语音转写消息。
• 会话管理：支持继续、创建、列出和切换 DSH 会话。
• 双向同步：微信与 DSH 的用户确认问题双向同步。电脑端和微信端谁先回答，该端的问题状态即生效。
• 摘要同步：DSH 生成的回复摘要会主动同步回微信。
• 控制与监控：提供 SSE 事件流、消息 relay、待发队列管理以及状态/日志查询 API。
• 文件传输：支持受目录白名单约束的流式加密文件上传。
• 独立 CLI：提供 dsh-wechat 命令行工具，避免占用易冲突的 wx 名称。

安装与启用¶

安装前请确保本地环境已安装 Node.js 20+，且 DeepSeek Harness 版本兼容 0.1.5-rc.1。由于 GitHub 存在同名项目，请务必核对完整仓库名 LZG3530606141/dsh-wechat-bridge。

通过 DSH 插件管理器安装指定版本的插件：

dsh plugin --profile <你的-profile> add "github:LZG3530606141/dsh-wechat-bridge#v0.1.0"

安装后需重启对应的 DSH profile 以使 bundle 生效。

使用方式¶

安装完成后，可以使用 dsh-wechat 命令进行操作。默认情况下，插件在 127.0.0.1:8848 启动控制接口。

常用命令如下：

• 状态与诊断：

    dsh-wechat status
    dsh-wechat doctor

• 登录与重连：

    dsh-wechat qr
    dsh-wechat relogin

• 消息处理：

    dsh-wechat listen [--json] [--filter <regex>]
    dsh-wechat send <text...>
    dsh-wechat send-file <absolute-path>
    dsh-wechat outbox [flush|clear]
    dsh-wechat chat <text...>
    dsh-wechat repl

• 会话操作：

    dsh-wechat sessions
    dsh-wechat switch <n|sessionId>
    dsh-wechat new [--bind]

• 功能开关：

    dsh-wechat relay [session|cli|off]
    dsh-wechat log [--tail N] [-f]

CLI 支持环境变量配置：
* DSH_WECHAT_BRIDGE：控制面 URL，默认 http://127.0.0.1:8848。
* DSH_WECHAT_PORT：覆盖默认端口。
* DSH_WECHAT_TOKEN：远程控制令牌。

安全与注意事项¶

插件在安全设计上遵循“默认拒绝”原则：

• 默认监听：HTTP/控制面默认绑定 host: 127.0.0.1。
• 远程控制：默认拒绝无令牌的远程控制（controlAllowRemote: false）。
• 依赖：零第三方运行时依赖。
• 数据隐私：本仓库不包含桌面微信自动化逻辑，也不会打包任何令牌、二维码链接、日志、会话标识或运行状态数据。

若需配置文件发送功能，建议收窄 fileSendRoots 目录白名单，避免将整个磁盘暴露给文件发送接口。

务必不要提交 $DSH_HOME/wechat-bridge 目录下的数据，该目录包含敏感的授权凭证、上下文、待发队列和日志。

生态背景¶

DSH 的核心理念是“一切皆插件”。DeepSeek Harness 插件市场是一个独立的社区目录，与 DeepSeek 或幻方 AI 无官方从属关系。本文档仅基于社区核实的事实编写，旨在为开发者提供工具选择参考。