返回目录

dsh-wechat-bridge

精选清单收录维护状态: 活跃

thawline/dsh-wechat-bridge

让 DSH 住进微信:可以接你自己的号,也可以给 AI 单独注册一个小号。后台发消息不抢窗口、断了自动重连、发图以数据库为准。

前往 GitHub
$ dsh plugin --profile desktop add github:thawline/dsh-wechat-bridge

18

星标

9

Fork

JavaScript

语言

MIT

许可证

2026-10-31

创建于

2026-11-05

最近推送

MIT 许可的 Windows 插件,用微信本地数据库加 UI Automation 把个人微信号和 DeepSeek Harness 桥接起来,带主人专属的工具权限、群聊限速和按天日记。

DSH 适配

兼容

作者声明

安全审计

未审计

最后核验

2026-11-14

许可证

MIT

01它能帮你完成什么?

  • 直接在微信里跟自己装在 DeepSeek Harness 上的 agent 说话,不用机器人账号也不用 webhook

    你在微信里发的话进入绑定的 DSH 会话;伙伴说完一整轮后,最后一句回复以及能匹配上的表情包图片回到这个微信聊天里

    本来就泡在微信里、希望手机上也能叫到本机 DeepSeek Harness agent 的 Windows 用户

  • 让别人的微信消息也能进到 agent,但不把机器交出去

    决定谁能触发一轮的入站白名单,以及由外人叫醒时对每一轮挂上、直接拒绝所有工具调用的 `tools.guard`——只放行文字回复

    想让朋友或某个群试一试、但不想暴露自己文件和命令行的人

  • 留一份能翻的群聊记录,同时在群里回话又不刷屏

    `~/.dsh/wechat-diary/<YYYY-MM-DD>/<群名>.md` 下按天写的 markdown 日记,加上可配置的群上下文条数、回复间隔与每小时上限

    希望 agent 在群里存在但被限速、事后还能查文字记录的小团队

02如何接入 DeepSeek Harness?

前置条件

  • Windows —— README 说明 UI Automation 是 Windows 独有的,所以只能在 Windows 上用
  • 同一台机器上登录着的微信 4.x,入站消息就是读它的本地 SQLite 库
  • Python 3.10+ 且装了 `wechatauto-replica`,或者用仓库 Release 里打好的 Windows x64 Python 3.12 运行环境(已含 `wechatauto-replica`、`uiautomation`、`numpy`、`Pillow`、`pywin32`、`comtypes`)
  • 宿主需要提供 `tools.guard` —— README 说本版本 DSH 有;没有的话就只剩嘴上约束

安装步骤

  1. 01

    安装插件:`dsh plugin --profile desktop add github:thawline/dsh-wechat-bridge`,或在 设置 → 插件 → 安装 里填 `github:thawline/dsh-wechat-bridge`

    $ dsh plugin --profile desktop add github:thawline/dsh-wechat-bridge

  2. 02

    重启一次 DSH,打开 设置 → 通到微信

  3. 03

    点「装依赖」:有现成的、装好 `wechatauto-replica` 的 Python 就把「解释器」填成它的路径;没有就让插件用系统 Python 3.10+ 建一个虚拟环境

  4. 04

    不想装 Python:解压 `wechat-bridge-runtime-win64-py312.zip`,把里面的 `python` 文件夹放到 `~/.dsh/wechat-bridge-runtime/python`,也就是让 `C:\Users\<你>\.dsh\wechat-bridge-runtime\python\python.exe` 存在,插件启动时会自己找到

  5. 05

    点「启动」看日志滚起来,然后挑一间「默认会话」、打开「总开关」

  6. 06

    先留着「试运行」,确认日志里记的「该发什么」是对的,再把试运行关掉

验证接入成功

  • 点「启动」后桥接日志里出现「桥接已就绪」
  • 试运行开着时日志会记下「该发什么」;关掉试运行后,在微信里跟文件传输助手说话,伙伴的回复会回到微信

回滚

  • 关掉「总开关」—— 关着的时候一句都不发
  • 自带运行环境是绿色版:README 说整个文件夹搬到哪都能跑,删掉就等于卸载

03DSH 适配与能力边界

DSH 适配兼容

DSH 插件加一份随包的 Python 桥接:宿主半边管会话绑定、权限与队列,Python 半边负责读微信本地 SQLite 库和用 Windows UI Automation 发送,两边通过 `/dsh-wechat-bridge/` 下的本机 HTTP 接口通信。

  • 微信入站 → DSH 会话

    微信私聊或群聊消息,从微信 4.x 的本地 SQLite 库读取(只读,微信须处于登录状态)→消息变成绑定 DSH 会话里的一轮,可带群上下文条数,也可按单个聊天或单个群绑定会话

    收到图片和表情包会先把文件落盘,再由视觉模型写一句中文描述后转进会话语音、视频仍然跳过
  • DSH 回复 → 微信,走 UI Automation 与剪贴板

    一轮结束时伙伴的最后一条回复,以及其中的 `[表情: 描述]` 标记→在真实微信窗口里打出来的文字,以及以图片消息粘贴出去的表情包;`[表情: …]` 那串描述本身不会出现在正文里

    通过 UI Automation 与剪贴板驱动真实的微信窗口发送失败重试时可能把微信拉到前台发图后要回微信库里查到新图片才算成功
  • 两层权限模型

    一份 wxid/昵称的入站白名单,以及「主人」名单→决定谁能起一轮的白名单闸门,以及决定这一轮能不能调工具的 `tools.guard` 闸门

    外人叫醒的那一轮,所有工具调用在执行前就被拒绝主人永远放行,不需要写进白名单
  • 两个工具与一套本机 HTTP 接口

    对话里的自然语言,或对 `/dsh-wechat-bridge/*` 接口的 HTTP 调用→管「不回谁」名单的 `wechat_block`、把某个微信聊天接到某间会话的 `wechat_bind`,以及 receive/outbox/state/save/test-send/install/start/stop 等接口

    配置写在 `~/.dsh/wechat-bridge-config.json`,保存后 30 秒内自动生效,不用重启虚拟环境放在 `~/.dsh/wechat-bridge-venv`

04适合谁?何时不该用?

适合

  • 本来就泡在微信里、希望手机上也能叫到本机 DeepSeek Harness agent 的 Windows 用户
  • 想让朋友或某个群试一试、但不想暴露自己文件和命令行的人
  • 希望 agent 在群里存在但被限速、事后还能查文字记录的小团队

不适合

  • 微信个人号自动化不是官方接口,有封号风险,README 建议先用小号或测试号。
  • 只能在 Windows 上用(UI Automation 是 Windows 独有的),而且同一个微信号不能同时开两个桥,否则会抢窗口、发送会乱。
  • 微信升级可能让它失效:`wechatauto` 靠一张按版本号硬编码的地址表找控件树,升级后发不出去先看设置页下面的日志。
  • 默认谁都能发进来:任何能给这个微信号发消息的联系人,都能让本机模型跑一轮并花掉你的额度;工具闸门只挡住他们动电脑,想收紧这一层要自己填入站白名单。

05兼容性、维护与安全提示

  • 微信个人号自动化不是官方接口,有封号风险,README 建议先用小号或测试号。
  • 只能在 Windows 上用(UI Automation 是 Windows 独有的),而且同一个微信号不能同时开两个桥,否则会抢窗口、发送会乱。
  • 微信升级可能让它失效:`wechatauto` 靠一张按版本号硬编码的地址表找控件树,升级后发不出去先看设置页下面的日志。
  • 默认谁都能发进来:任何能给这个微信号发消息的联系人,都能让本机模型跑一轮并花掉你的额度;工具闸门只挡住他们动电脑,想收紧这一层要自己填入站白名单。
2026-10-312026-11-05v1.3.4

MIT · 仅 README 证据,最新版本 v1.3.4,未做安全审计;是 Yuuyuko-uu/dsh-wechat-bridge 的修改版

06常见问题

怎么把这个桥接装进 DeepSeek Harness?

执行 `dsh plugin --profile desktop add github:thawline/dsh-wechat-bridge`,或在 设置 → 插件 → 安装 里填 `github:thawline/dsh-wechat-bridge`。重启一次 DSH,进入 设置 → 通到微信,点「装依赖」装好 Python 侧(把「解释器」指向已有 `wechatauto-replica` 的 Python,或用 Python 3.10+ 建虚拟环境),再点「启动」,等日志出现「桥接已就绪」。

我需要自己装 Python 吗?

不需要——仓库的 Release 里有一份打好的 Windows x64 Python 3.12 运行环境,已经装好 `wechatauto-replica`、`uiautomation`、`numpy`、`Pillow`、`pywin32`、`comtypes`。解压 `wechat-bridge-runtime-win64-py312.zip`,把里面的 `python` 文件夹放到 `~/.dsh/wechat-bridge-runtime/python`,插件就会自己找到,不用填「解释器」也不用点「装依赖」。

别人能通过微信动我的电脑吗?

工具层面动不了。外部消息进来时,插件会给那间会话挂一道 `tools.guard`:如果是外人叫醒的,任何工具调用都会在执行前被拒,只放行文字回复,所以「帮我删掉 D 盘」只会被回一句做不了。代价是默认谁都能发进来,任何能给这个微信号发消息的人都能起一轮并花你的额度——想收紧就填入站白名单;另外这道闸要求宿主提供 `tools.guard`。

群聊会不会被 agent 刷屏?

README 的默认值比较保守:同一个群两条回复之间至少隔 30 秒,同一个群一小时最多 6 次,被叫到时往前读 6 条群上下文。三项都可配置,填 0 表示不限。群里默认只有被点名(别名写死在 `bridge/wechat_bridge.py`)或者主人说话才进来。

开之前有哪些风险?

微信个人号自动化不是官方接口,有封号风险,README 建议先用小号或测试号。它只能在 Windows 上用,因为 UI Automation 是 Windows 独有的;微信升级也可能让发送失效,因为 `wechatauto` 靠按版本号硬编码的地址表找控件树。另外同一个微信号不要同时开两个桥。

08数据与来源

  • 作者声明github.comebacf9cce7c4…

    宿主半边管会话绑定、权限、队列;Python 半边管读库、发送、日记。中间走本机 HTTP。

  • 作者声明github.comebacf9cce7c4…

    收消息:读微信 4.x 的本地 SQLite 数据库(只读,要求微信处于登录状态)

  • 作者声明github.comebacf9cce7c4…

    dsh plugin --profile desktop add github:thawline/dsh-wechat-bridge

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-14。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。