dsh-plugin-wechat-bridge: Put DeepSeek Harness Agent into WeChat Private Chats

nattocb/dsh-plugin-wechat-bridge

Integrations & ConnectionsVerified
Listed on 2026-08-21
Page last updated 2026-10-26

A DSH plugin bridging WeChat (ilink bot) private chats into DeepSeek Harness agent sessions, streaming replies back as plain text, with media, whitelist, and hot-swap support.

dsh-plugin-wechat-bridge is a WeChat bridge plugin for DeepSeek Harness that lets you chat with the DSH agent directly from WeChat on your phone, with replies streamed back as plain text. It polls the WeChat ilink bot API per configured account, supports media sending/receiving, whitelist control, and session notifications, and uses a one-session-per-peer-per-day isolation design. You can enable or disable it in real time via the Settings tab, /wechat command, or settings.yaml, without restarting the process. Ideal for users who want convenient mobile access to DeepSeek Harness.

How to Install

install
dsh plugin --profile web add github:nattocb/dsh-plugin-wechat-bridge
Category
Integrations & Connections
Platform
DSH Plugin
Author
nattocb
Distribution
Plugin

dsh-plugin-wechat-bridge Key Features

WeChat chats drive agentStream plain-text repliesMedia send/receive & decryptInbound whitelist fail-closedHot-swap enable/disable
Listed on dsh-plugin.org

dsh-plugin-wechat-bridge Repo Summary

What Does It Do?

It is a WeChat bridge plugin for DeepSeek Harness (DSH) that connects WeChat private messages to DSH agent sessions, letting you chat with the agent directly from WeChat. It solves the problem of using DSH on mobile, streaming replies as plain text, and supports media sending/receiving, whitelist control, and session notifications.

Core Features

  • WeChat private messages drive agent sessions: polls the WeChat ilink bot API per configured account, triggers agent responses, and sends replies in chunks (4096 chars × up to 5 segments).
  • Runtime hot-swap: enable/disable in real time via Settings UI tab, /wechat slash command, or settings.yaml, without restarting the process.
  • One session per peer per day: rotates daily based on local timezone, lazily creates a session on the first inbound message, and no file is created if no conversation occurs.
  • Crash-safe design: cross-process polling lock, per-chat serialization, inbound deduplication, and corrupted log isolation with self-healing.
  • One-way session notifications: sends a fixed-template brief to whitelisted WeChat contacts when any top-level session turn ends, with per-workspace mute support.
  • Inbound whitelist (fail-closed): empty allowedPeers rejects everyone; matches robot internal contact IDs.
  • Outbound media: agent calls the wechat_send_file tool to upload images/videos/files to the current peer.
  • Inbound media: automatically downloads and decrypts images/files/videos/voice from WeChat, storing them in a designated directory.

How to Use This Plugin?

After enabling it in DSH, first scan a QR code to bind a WeChat account with ilink bot permission (bot_type=3), then send a private message to the bot. Replies will be streamed back as plain text, just like in the GUI. You can manage accounts, whitelist, notifications, and other settings via the Settings tab or /wechat command.

This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: nattocb/dsh-plugin-wechat-bridge. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.

Install, update, and uninstall this plugin in the Plugin Market of DeepSeek Harness's DSH Plugin Hub

DSH Plugin FAQ