pan17/dsh-wechat 预览 preview

pan17/dsh-wechat

让微信成为 DeepSeek Harness (DSH) 的第二客户端:通过腾讯 iLink bot 协议把 微信私聊桥接到 DSH agent——文本/图片/文件/语音消息双向收发、微信内 slash 命令管理会话/工作区/Preset/模型/权限、审批与提问卡与 GUI 双端同卡同决策、 DSH 设置页内扫码登录与连接配置。以静态 Cordis 插件交付,零运行时 @deepseek-ai 依赖,直接调用 DSH 进程内服务。

catalog descriptioncatalog 简介 / catalog description:DSH插件,将微信私聊消息桥接到DSH,支持文本、图片、文件、音视频的双向传输。目标是在微信端还原DSH的原生体验

Project Overview项目介绍

This is a native plugin built specifically for DeepSeek Harness (DSH) that bridges WeChat private chats to the DSH agent via Tencent's iLink bot protocol, turning WeChat into a second client for DSH. It supports two-way transmission of text, images, files, and voice messages, and lets users manage DSH workspaces, sessions, presets, models, and permissions directly via slash commands inside WeChat. It ships as a static Cordis plugin for DSH, has no extra @deepseek-ai runtime dependencies, and can be installed directly from npm via DSH's built-in plugin CLI command. After installation, you must restart DSH before accessing its configuration UI from the DSH settings menu.

Once installed and restarted, users can scan a QR code directly from DSH's WeChat settings page to log in and connect the WeChat bot. All approval and question cards from DSH are mirrored to WeChat, and whichever client responds first is the one that takes effect, preventing duplicate decisions. Any changes made on WeChat, including switching sessions or changing the default preset, are immediately synced to DSH's GUI, and any changes in the GUI are also synced back to WeChat automatically. It is ideal for users who want to access and control DSH on the go, without needing to open the DSH GUI to manage sessions or review agent responses.

dsh-wechat is released under the permissive MIT license, and is free to use and modify. Configuration and state data is stored locally on the user's machine in the ~/.dsh-wechat directory, so it persists across DSH updates and restarts. It currently only supports a single connected WeChat user, and all of its core functionality relies on Tencent's official iLink bot protocol. Any changes to the iLink protocol from Tencent may require upstream fixes from the plugin's maintainer to keep working. This is an unofficial community project, not affiliated with DeepSeek Harness or Tencent WeChat, and users assume all risk when using it.

这是一个专为DeepSeek Harness(DSH)开发的原生插件,通过腾讯iLink bot协议将微信私聊桥接到DSH agent,让微信成为DSH的第二客户端,支持文本、图片、文件、语音消息双向收发。它支持微信内slash命令管理会话、工作区、预设、模型和权限,审批与提问卡可实现双端同卡同决策,在DSH设置页内置了扫码登录和连接配置,以静态Cordis插件形式交付,无额外运行时依赖。

用户需要先通过DSH内置的插件管理命令完成安装,之后重启DSH,在DSH设置的WeChat页面扫码登录微信即可使用。适合需要随时随地通过微信访问DSH,不用打开DSH图形界面就能管理会话、接收Agent回复推送和跨会话审批请求的用户,可实现微信端操作和GUI端操作完全同步,任意一端操作都会同步到另一端。

本插件采用MIT许可证开放源代码,免费供用户使用,配置和状态默认存储在本地的~/.dsh-wechat/目录下,DSH重启后可自动恢复原有会话。插件仅支持绑定单个微信用户,功能依赖腾讯官方iLink bot协议,官方接口调整需配合上游修复,本项目是非官方项目,不隶属于DSH或腾讯微信,用户使用需自行承担风险。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 10 stars - an early-stage project星标 10,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile desktop add dsh-wechat

把 pan17/dsh-wechat 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-wechat

npm npm downloads License

让微信成为 DeepSeek Harness (DSH) 的第二客户端:通过腾讯 iLink bot 协议把 微信私聊桥接到 DSH agent——文本/图片/文件/语音消息双向收发、微信内 slash 命令管理会话/工作区/Preset/模型/权限、审批与提问卡与 GUI 双端同卡同决策、 DSH 设置页内扫码登录与连接配置。以静态 Cordis 插件交付,零运行时 @deepseek-ai 依赖,直接调用 DSH 进程内服务。

发送 接收 设置页

功能

  • 发送 — 微信文本/图片/文件/语音消息 → DSH agent(媒体自动下载解密到 ~/.dsh-wechat/tempfile/,本地路径作为附件注入)
  • 接收 — agent 回复文本回微信;send_wechat 工具可主动推送文本/文件到微信
  • 微信 slash 命令 — /workspace、/session、/preset、/model、 /perm、/silent、/notify、/next、/status、/stop、/rq 等 由 bridge 直接处理(见下方命令表)
  • 审批/提问卡(双端同卡) — 微信与 GUI 弹一致的原生审批/提问卡, 谁先回复谁生效(原生防双决)
  • 微信渠道提示词(动态注入) — 微信消息注入可配置提示词;GUI 消息时自动消失。设置页可开关/编辑正文,微信 /surface on|off 切换
  • 静默模式 — /silent on 后每轮只发送最终回复,设置页可切换(全局配置,重新扫码后仍保留)
  • 繁忙时投递(与 DSH 同源) — 按 busyEnter 排队/插话;微信 /enter 同步
  • 跨会话决策推送 — /notify on 后,任意会话的权限/提问卡整卡推送到微信。当前会话可直接回;其它会话必须 P{n}=…(P1=/rq 关闭该卡)。默认关。后台任务完成/报错走 /notify tasks on|off
  • 二维码登录 — http://127.0.0.1:3080/wechat/qr 扫码登录,设置页内嵌
  • 设置页 UI — DSH 设置 → WeChat:单卡展示状态、扫码、退出登录、连接配置与通知/静默开关(保存即生效,存储于 ~/.dsh-wechat/config.json 与 state.json)
  • 断点续传 — sync-buf 与微信会话映射持久化,重启 DSH 后自动恢复会话
  • 单用户 — 只服务第一个微信用户;bot token 缺失/失效时不向微信推送,日志会写明原因(需重新扫码或等会话恢复)

安装(部署到 DSH profile)

方式一:设置页内直接安装(推荐)

打开 设置 → 插件 → 添加插件,在输入框填包名:

dsh-wechat

点「安装」即可。插件声明了 dsh.bundle,安装时会被自动注册成 bundle 层, 不需要再手动改 profile 配置。国内网络下载慢时,把「安装源」切到 中国大陆镜像源。

安装完成后若提示「已安装,下次启动后加载」,重启 DSH 即可;若出现 「立即启用」按钮,也可以直接点它免重启。

然后浏览器打开 设置 → WeChat:扫码登录、查看状态、改配置,或直接访问 http://127.0.0.1:3080/wechat/qr 扫码。

方式二:命令行

DSH 自带插件管理命令 dsh plugin(在 profile 目录转发 pnpm,并自动把 声明了 dsh.bundle 的依赖加入 bundle 层):

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev omd-dsh 下一个 Next dsh-multi-folder →