LZG3530606141/dsh-wechat-bridge

dsh-wechat-bridge

CI
Release
License: MIT

中文 · English

一个独立的 DeepSeek Harness bundle，用于将本地 DSH 进程连接到微信 iLink 机器人通道。它包含文本和转写语音输入、DSH 对话/会话集成、用户提问与回复同步、SSE 控制 API、加密文件上传，以及 dsh-wechat CLI。

独立的社区集成。不隶属于腾讯或微信，也未获得其认可。

中文

功能

- 微信 iLink 文本及语音转写消息接入
- 继续、创建、列出和切换 DSH 会话
- 微信与 DSH 用户确认问题双向同步，电脑和微信先回答者生效
- DSH 回复摘要主动同步到微信
- SSE 事件流、消息 relay、待发队列和状态/日志控制 API
- 受目录白名单约束的流式加密文件上传
- 独立命令 dsh-wechat，不占用容易冲突的 wx 名称

本仓库不包含桌面微信自动化，也不会打包任何令牌、二维码链接、日志、会话标识或运行状态。

适用场景与特点

这是面向终端和自动化工作流的微信远程桥接，而不是带 Web 设置面板的通用 IM 聚合器。它适合希望从微信继续控制本机 DSH，同时通过脚本或 CLI 观察状态、切换会话和处理待发消息的用户。

相较于仅提供聊天转发的实现，本插件重点提供以下组合：

- 独立 dsh-wechat CLI 与 SSE 控制 API，可用于监听、诊断和脚本集成
- DSH 用户问题与回复摘要同步，电脑端和微信端可以协同处理
- relay/outbox 模式，在微信上下文暂不可用时保留待发消息
- 受目录、大小和可信 CDN 限制的 AES 加密文件发送
- 仅回环监听、默认拒绝无令牌远程控制等安全默认值
- 零第三方运行时依赖，并在 Node.js 20、22、24 上持续测试

如果需要图片/音视频双向收发、微信内完整斜杠命令或图形化设置面板，请在 DSH 插件市场比较其他微信插件后按需求选择。本项目不声称是腾讯或微信官方插件。

安装与启用

需要 Node.js 20+ 与兼容 0.1.5-rc.1 的 DeepSeek Harness。由于 GitHub 上存在多个同名项目，请使用完整仓库名 LZG3530606141/dsh-wechat-bridge 核对作者；在插件市场中可搜索 LZG3530606141、dsh-wechat-bridge、WeChat iLink 或 微信 iLink。

推荐从 GitHub Release 标签安装到指定 DSH profile：

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

如需锁定已经验证的源码提交，可使用：

dsh plugin --profile  add "github:LZG3530606141/dsh-wechat-bridge#b16e63a"

Release 页面同时提供 lzg3530606141-dsh-wechat-bridge-0.1.0.tgz.sha256，可在下载 tarball 后校验文件完整性。安装后启动同一 profile。包通过 package.json 的 dsh.bundle.patch 声明 cordis.patch.yml，DSH 会启用其 bundle patch。示例 patch 会插入：

- insert:
- id: dsh-wechat-bridge
name: '@lzg3530606141/dsh-wechat-bridge'
inject: [agents, userQuestions]
config:
host: 127.0.0.1
port: 8848
session: ''
controlToken: ''
controlAllowRemote: false
stateDir: !!js dshHomePath('wechat-bridge')

默认状态目录是 $DSH_HOME/wechat-bridge。它可能包含授权凭证、上下文、待发队列和日志，必须视为敏感数据并做好本机权限控制与备份策略。

常用配置：

| 配置 | 默认值 | 说明 |
| --- | --- | --- |
| host | 127.0.0.1 | HTTP/控制面监听地址；默认仅本机 |
| port | 8848 | bridge 端口 |
| session | '' | 默认会话；留空使用最近活跃根会话 |
| wechat | true | 是否启用 iLink 通道 |
| syncQuestions / syncReplies | true | 问题与回复同步 |
| controlAllowRemote | false | 是否无令牌放开远程控制；不推荐 |
| controlToken | '' | 远程控制令牌；默认空且仅回环可访问 |
| stateDir | $DSH_HOME/wechat-bridge | 敏感运行状态目录 |
| fileSendRoots | 用户主目录 | 可主动发送文件的根目录，建议收窄 |
| fileSendMaxBytes | 100 MiB | 文件大小上限 |
| guiPort | 3080 | 本机 DSH Web GUI RPC 端口 |

扫码登录

1. 启动启用了此 bundle 的 DSH。
2. 运行 dsh-wechat status 或 dsh-wechat qr。
3. 若没有链接，运行 dsh-wechat relogin，稍后再运行 dsh-wechat qr。
4. 仅在自己的手机微信中打开临时授权链接并确认。
5. 用 dsh-wechat doctor 检查通道、DSH GUI 和会话状态。

二维码授权链接和登录状态属于秘密，不要粘贴到 issue、聊天记录或终端共享截图中。重新授权会清理当前 bridge 凭证并申请新二维码。

CLI

dsh-wechat status
dsh-wechat listen [--json] [--filter ]
dsh-wechat send
dsh-wechat send-file
dsh-wechat outbox [flush|clear]
dsh-wechat chat
dsh-wechat repl
dsh-wechat sessions
dsh-wechat switch
dsh-wechat new [--bind]
dsh-wechat relay [session|cli|off]
dsh-wechat log [--tail N] [-f]
dsh-wechat qr
dsh-wechat relogin
dsh-wechat doctor

CLI 环境变量：

- DSH_WECHAT_BRIDGE：控制面 URL，默认 http://127.0.0.1:8848
- DSH_WECHAT_PORT：只覆盖默认端口
- DSH_WECHAT_TOKEN：远程控制令牌
- NO_COLOR：禁用颜色

为迁移方便，CLI 仍兼容旧的 WX_BRIDGE、WX_PORT、WX_TOKEN，但新部署应使用 DSH_WECHAT_*。

listen --exec 会执行本地 shell 命令。消息正文只通过环境变量传入，但仍应将其视作不可信输入，绝不能拼接到命令字符串。

安全

- 保持 host: 127.0.0.1 与 controlAllowRemote: false。
- 如果必须远程访问，设置强随机 controlToken，并使用可信认证隧道或 TLS 反向代理；不要直接暴露端口。
- 收窄 fileSendRoots，避免把整个磁盘暴露给文件发送接口。
- 不要提交 $DSH_HOME/wechat-bridge、.env、日志、令牌、二维码或会话数据。
- 详见 SECURITY.md。

故障排查

- 控制面不可达：确认 DSH 正在运行、bundle 已启用、端口一致，并使用 127.0.0.1。
- 二维码过期：运行 dsh-wechat relogin，等待数秒后再运行 dsh-wechat qr。
- 主动推送排队：微信上下文窗口可能已过期；在手机微信里给 bot 发任意一句话，队列会尝试补发。
- chat/new 失败：确认本机 DSH Web GUI 在配置的 guiPort 可达；运行 dsh-wechat doctor。
- 文件发送被拒：使用绝对路径，确认文件在 fileSendRoots 内、不是符号链接逃逸、非空且未超过大小上限。
- 远程请求 403：本机使用回环地址；远程访问必须提供与配置一致的 DSH_WECHAT_TOKEN。

English

定位

本插件是一个面向终端和自动化的微信远程桥接，而非带有 Web 设置面板的通用多 IM 网关。其独特组合包括独立的 dsh-wechat CLI、SSE 控制 API、同步的 DSH 问题与回复摘要、relay/outbox 投递、受限的加密文件发送、安全的回环默认配置，以及零第三方运行时依赖。CI 覆盖 Node.js 20、22 和 24。

如果您的主要需求是完整的双向图片/音频/视频处理、全面的微信内斜杠命令界面，或仅通过 GUI 进行设置，请选择其他市场插件。本项目是独立的社区集成，不声称获得腾讯或微信的认可。

安装与配置

GitHub 上存在多个同名短名称的仓库。请核实完整仓库标识 LZG3530606141/dsh-wechat-bridge；市场搜索可能使用 LZG3530606141、dsh-wechat-bridge、WeChat iLink 或 微信 iLink。

将带标签的发布版本安装到您打算运行的 DSH 配置文件中：

text
dsh plugin --profile  add "github:LZG3530606141/dsh-wechat-bridge#v0.1.0"

对于本仓库验证的确切源代码修订版本，请使用 #b16e63a 代替该标签。Release 页面还提供了 lzg3530606141-dsh-wechat-bridge-0.1.0.tgz.sha256 用于 tarball 完整性校验。安装后启动同一个 profile。该包通过 dsh.bundle.patch 声明其 bundle 补丁。随附的补丁绑定 127.0.0.1:8848，将默认会话和控制令牌留空，拒绝未经身份验证的远程控制，并将运行时状态存储在 $DSH_HOME/wechat-bridge 下。

状态目录是敏感的：它可能保存登录凭据、投递上下文、发件箱和日志。切勿提交或发布它。在多用户环境中启用文件投递之前，请缩小 fileSendRoots 的范围。

二维码登录与 CLI

启动 DSH，然后使用：
text
dsh-wechat status
dsh-wechat relogin
dsh-wechat qr
dsh-wechat doctor

仅在你自己的微信客户端中打开临时授权 URL。不要分享该 URL、令牌、账号标识符、日志或会话 ID。

该 CLI 支持实时 SSE 监听、发送文本/文件、发件箱管理、DSH 聊天/会话操作、中继模式、日志、重新授权和诊断。运行 dsh-wechat --help 查看完整命令列表。使用 DSH_WECHAT_BRIDGE、DSH_WECHAT_PORT 和 DSH_WECHAT_TOKEN 进行配置。

安全与故障排除

保持回环默认值。对于有意的远程访问，需要强 controlToken 以及经过身份验证的加密隧道或反向代理。listen --exec 会运行本地 shell 命令；仅使用可信的固定命令，切勿将消息文本插值到命令中。

如果主动投递已排队，请从微信向机器人发送一条消息以刷新上下文。如果 DSH 会话命令失败，请使用 dsh-wechat doctor 验证配置的本地 GUI 端口。有关报告和部署指南，请参阅 SECURITY.md。

开发

该包没有第三方运行时依赖。配置默认值由插件直接应用，因此安装不依赖于从插件目录解析宿主内部包。
text
npm test
npm pack --dry-run

测试涵盖流媒体加密/上传行为、路径和 CDN 限制、bundle 元数据、安全默认值、包允许列表以及基本源状态断言。

许可证

MIT。请参阅 LICENSE。