pan17/dsh-wechat
30Last commit Aug 15, 2026
dsh-wechat DSH plugin
dsh-wechat integrates WeChat into DSH using the Tencent iLink bot protocol. It allows you to chat with DSH agents directly from WeChat, sending text, images, files, and voice messages. The plugin also provides a full set of slash commands for managing workspaces, sessions, presets, models, and permissions, and features a dual-end approval card system that synchronizes between WeChat and the DSH GUI.
How to install the dsh-wechat DSH plugin
dsh plugin --profile <profile> add dsh-wechatThis source command needs manual review. Copying does not run it.
dsh-wechat DSH plugin data source
dsh-wechat DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-wechat DSH plugin can do
- Send and receive text, images, files, and voice messages between WeChat and DSH agents with automatic media decryption.
- Execute slash commands like /workspace, /session, /preset, /model, /perm, /silent, /stop, /next, /rp, /rq directly from WeChat.
- Mirror approval and question cards from DSH GUI to WeChat; native conflict resolution ensures only the first response takes effect.
- QR code login via the DSH settings page (or http://127.0.0.1:3080/wechat/qr) and persistent connection management.
- Silent mode (/silent on) that suppresses intermediate agent outputs and sends only the final reply each turn.
- Auto-inject a WeChat channel system prompt into the agent's context when messages come from WeChat, restoring original prompts when messages come from the GUI.
- Persistent session mapping and sync-buffer that survive DSH restarts, automatically resuming previous WeChat sessions.
Where the dsh-wechat DSH plugin fits
- Use WeChat as a mobile interface to control your DSH agents and workflows on the go.
- Manage multiple workspaces and sessions, switch models and presets via slash commands without opening the GUI.
- Receive agent notifications and approve permission requests directly from WeChat, with the same decision card as the GUI.
- Enable team members to interact with DSH through WeChat, leveraging permission presets to control access.
- Quickly cancel ongoing tasks or continue sending cached messages after hitting WeChat's rate limits.
Who the dsh-wechat DSH plugin is for
- DSH users who want a mobile-friendly, always-available interface via WeChat.
- Developers and power users who need to manage DSH environments remotely and perform administrative tasks from their phone.
- Teams that collaborate on DSH agents and require approval workflows accessible from the chat app.
dsh-wechat DSH plugin limitations
- WeChat approval cards have a 30-minute soft timeout (locally removed without sending respond), while GUI cards have no timeout and can still be processed.
- The iLink protocol is Tencent's official bot protocol and may change; the plugin follows the upstream wechat-opencode fixes.
- The `send_wechat` tool is visible to all agents but returns an error when called from a non-WeChat bound session.
- /preset switch only applies immediately to empty sessions; sessions with existing content will apply the preset to the next new session.
- Requires a running DSH instance and a WeChat account with iLink bot access; the plugin is not a standalone service.
dsh-wechat DSH plugin: from the repository README
Quoted from the pan17/dsh-wechat README, the upstream source of the dsh-wechat DSH plugin. Copyright remains with the original authors.
让微信成为 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`（在
Read the full READMERepository license: MIT
dsh-wechat DSH plugin questions
How do I install dsh-wechat?
Run `dsh plugin --profile <profile> add dsh-wechat` in your terminal. This command automatically adds the dependency and registers the bundle layer. After installation, restart DSH for the plugin to take effect. You can verify the configuration by running `dsh --profile <profile> --dump-config` and looking for a line with `- id: dsh-wechat`.
How do I log in to WeChat?
After installing and restarting DSH, open your browser and go to the DSH settings page, then navigate to the 'WeChat' section. You will see a QR code. Scan it with your WeChat app to log in. Alternatively, you can directly open `http://127.0.0.1:3080/wechat/qr` in your browser to get the QR code. Once scanned, the plugin will automatically connect and show your bot ID and online status.
Can I switch workspaces and sessions from WeChat?
Yes. Use the slash commands `/workspace` (or `/ws`) and `/session` (or `/s`) to manage workspaces and sessions. For example, `/workspace list` shows all workspaces and their session counts, and `/workspace switch <number or path>` switches to a specific workspace. Similarly, `/session list` shows recent sessions and `/session switch <number>` switches to that session. All commands are documented in the plugin's README.
What is silent mode and how do I enable it?
Silent mode suppresses intermediate agent outputs (such as tool calls, thinking steps) and only sends the final reply at the end of each turn. This prevents message flooding in WeChat. To enable it, send `/silent on` (or `/sl on`) from WeChat. To disable, send `/silent off`. The setting persists across restarts.
How do approval cards work in WeChat?
When DSH needs your approval (e.g., for a permission request or a question), a card is sent to your WeChat with the same content as the GUI card. You can reply 'approve' or 'deny' (or choose options) directly in WeChat. The first response between WeChat and the GUI wins; if the other end already responded, you will see a 'already processed elsewhere' message. WeChat cards have a 30-minute soft timeout, after which they are removed locally without sending a response.