跳到正文

pan17/dsh-wechat

30最近提交 2026年8月15日

dsh-wechat DSH 插件

dsh-wechat 通过腾讯 iLink bot 协议将微信集成到 DSH。你可以直接在微信中与 DSH agent 聊天，发送文字、图片、文件、语音消息。插件还提供完整的 slash 命令用于管理工作区、会话、预设、模型和权限，并具备双端审批卡同步功能，在微信和 GUI 之间保持一致。

remote-executionui-productivity

如何安装 dsh-wechat DSH 插件

dsh plugin --profile <profile> add dsh-wechat

来源命令需要人工核对。复制不会执行命令。

dsh-wechat DSH 插件数据来源

dsh-wechat DSH 插件快照日期：2026年8月16日

discovered

dsh-wechat DSH 插件能做什么

  • 在微信和 DSH agent 之间收发文字、图片、文件、语音消息，媒体自动解密并注入本地路径。
  • 通过微信 slash 命令执行 /workspace、/session、/preset、/model、/perm、/silent、/stop、/next、/rp、/rq 等操作。
  • 将 DSH GUI 的审批卡和提问卡镜像到微信，原生防双决机制确保只有第一个回复生效。
  • 通过 DSH 设置页或 http://127.0.0.1:3080/wechat/qr 扫码登录，支持状态查看、重连、退出登录。
  • 静默模式（/silent on）隐藏 agent 中间输出，每轮仅发送最终回复，避免刷屏。
  • 根据消息来源（微信/GUI）动态注入或移除微信渠道提示词，让 agent 调整回复格式。
  • 断点续传：会话映射和 sync-buf 持久化，重启 DSH 后自动恢复微信会话。

dsh-wechat DSH 插件适合哪些场景

  • 将微信作为手机端的 DSH 控制界面，随时随地与 agent 交互。
  • 通过 slash 命令管理工作区、会话、切换模型和预设，无需打开浏览器 GUI。
  • 在微信中接收 agent 通知并审批权限请求，审批卡与 GUI 双端同卡，谁先回复谁生效。
  • 团队成员通过微信与 DSH 交互，利用权限预设控制不同用户的访问范围。
  • 快速中断当前任务，或在微信限流后继续发送被缓存的消息。

dsh-wechat DSH 插件适合谁

  • 希望在手机上获得 DSH 移动端界面的用户。
  • 需要远程管理 DSH 环境、执行管理任务的开发者和高级用户。
  • 通过微信协作使用 DSH agent 的团队，需要审批流程在聊天工具中可用。

dsh-wechat DSH 插件的限制

  • 微信审批卡有 30 分钟软超时（本地移除，不发送 respond），GUI 卡无超时且可继续处理。
  • iLink 协议是腾讯官方 bot 协议，可能随官方调整，需跟随上游 wechat-opencode 修复。
  • send_wechat 工具对所有 agent 可见，但非微信绑定会话调用会返回错误提示。
  • /preset switch 仅对空白会话立即生效；已有内容的会话会将预设应用于下一个新会话。
  • 需要运行中的 DSH 实例以及具备 iLink bot 访问权限的微信账号，插件本身不是独立服务。

dsh-wechat DSH 插件的仓库 README 摘录

以下文字摘自 dsh-wechat DSH 插件的上游仓库 pan17/dsh-wechat 的 README，版权归原作者，仅作引用。

让微信成为 DeepSeek Harness (DSH) 的第二客户端：通过腾讯 iLink bot 协议把 微信私聊桥接到 DSH agent——文本/图片/文件/语音消息双向收发、微信内 slash 命令管理会话/工作区/Preset/模型/权限、审批与提问卡与 GUI 双端同卡同决策、 DSH 设置页内扫码登录与连接配置。以静态 Cordis 插件交付，零运行时 `@deepseek-ai` 依赖，直接调用 DSH 进程内服务。 <img src="./resources/发送.jpg" alt="发送" width="32%" /> <img src="./resources/接收.jpg" alt="接收" width="32%" /> <img src="./resources/设置页.png" alt="设置页" width="32%" /> ## 功能 - **发送** — 微信文本/图片/文件/语音消息 → DSH agent（媒体自动下载解密到 `~/.dsh-wechat/tempfile/`，本地路径作为附件注入） - **接收** — agent 回复文本回微信；`send_wechat` 工具可主动推送文本/文件到微信 - **微信 slash 命令** — `/workspace`、`/session`、`/preset`、`/model`、 `/perm`、`/silent`、`/next`、`/status`、`/stop`、`/rp`、`/rq` 等 由 bridge 直接处理（见下方命令表） - **审批/提问卡（双端同卡）** — 微信与 GUI 弹一致的原生审批/提问卡， 谁先回复谁生效（原生防双决） - **微信渠道提示词（动态注入）** — 微信消息进入会话时，agent 的系统提示 自动注入"你正在通过微信(WeChat)与用户聊天"（runtime context，微信会话 才知道要调整回复格式）；从 GUI 发消息时该提示词自动消失——按消息来源 动态切换，新旧会话（GUI/微信创建）一视同仁 - **静默模式** — `/silent on` 后每轮只发送最终回复 - **二维码登录** — `http://127.0.0.1:3080/wechat/qr` 扫码登录，设置页内嵌 - **设置页 UI** — DSH 设置 → **WeChat**：扫码、状态、重连、退出登录、 连接配置（保存即生效，存储于 `~/.dsh-wechat/config.json`） - **断点续传** — `sync-buf` 与微信会话映射持久化，重启 DSH 后自动恢复会话 ## 安装（部署到 DSH profile） DSH 自带插件管理命令 `dsh plugin`（在

阅读完整 README仓库许可: MIT

dsh-wechat DSH 插件常见问题

如何安装 dsh-wechat？

在终端中运行 `dsh plugin --profile <profile> add dsh-wechat`。该命令会自动添加依赖并注册 bundle 层。安装完成后，必须重启 DSH 才能生效。你可以通过 `dsh --profile <profile> --dump-config` 验证配置，确认输出中包含 `- id: dsh-wechat` 这一行。

如何扫码登录微信？

安装并重启 DSH 后，打开浏览器进入 DSH 设置页，找到「WeChat」部分，你会看到二维码。用微信扫描即可登录。也可以直接访问 `http://127.0.0.1:3080/wechat/qr` 获取二维码。扫码后插件会自动连接，显示你的 Bot ID 和在线状态。

我能在微信中切换工作区和会话吗？

可以。使用 slash 命令 `/workspace`（或 `/ws`）和 `/session`（或 `/s`）来管理工作区和会话。例如 `/workspace list` 显示所有工作区及其会话数，`/workspace switch <编号或路径>` 切换到指定工作区。同样，`/session list` 列出最近会话，`/session switch <编号>` 切换会话。所有命令在 README 中有详细说明。

什么是静默模式？如何开启？

静默模式会隐藏 agent 的中间输出（如工具调用、思考过程），只在每轮结束时发送最终回复，避免在微信中刷屏。在微信中发送 `/silent on`（或 `/sl on`）即可开启，发送 `/silent off` 关闭。该设置重启后依然保持。

微信中的审批卡是如何工作的？

当 DSH 需要你审批（例如权限请求或提问）时，会向微信发送与 GUI 完全相同的卡片。你可以在微信中直接回复「批准」或「拒绝」（或选择选项）。微信和 GUI 之间谁先回复谁生效；如果另一端已经处理过，你会看到「已在其他端处理」的提示。微信卡片有 30 分钟软超时，超时后本地移除，不会发送响应。