微信遥控桥 YTXY-0708/weixin-DSH-bot

weixin-dsh-bridge ｜ 微信操控桥

用微信远程操控 DeepSeek Harness（dsh）干活

微信里下任务 → AI 在指定工作区执行 → 结果、截图、文件自动回传微信。它是「操控台」，不是聊天机器人。

这是什么？ 把微信变成 DeepSeek Harness（dsh）的远程遥控器：出门在外发条微信，电脑上的 AI 就开始干活——写代码、跑任务、截屏、发文件，做完把结果回传到你手机上。每个微信用户绑定一个固定的 dsh 会话，你的 AI 工作区随身带。

你（微信） ⇄ iLink 协议 ⇄ [weixin-dsh-bridge 常驻服务] ⇄ HTTP/WebSocket ⇄ dsh web (127.0.0.1:13080)

flowchart LR
U["📱 你 · 微信"] <==>|"iLink 协议"| B["⚙️ weixin-dsh-bridge常驻服务"]
B <==>|"HTTP / WebSocket127.0.0.1:13080"| D["🤖 dsh webDeepSeek Harness"]
D <==>|"工具调用"| A["🛠️ AI Agent工作区"]
B -. "截图 / 文件 / 提问回传" .-> U

✨ 功能特性

| 特性 | 说明 |
| 🔐 备用微信号做 bot | 独立扫码登录，token 持久化到 ~/.wechat-acp-dsh/，不影响日常账号 |
| 🧵 一人一会话 | 微信用户 ↔ dsh 会话映射本地持久化，重启自动恢复；/open 可接管 dsh 已有会话 |
| 🗂️ 多工作区 | /work 列出/切换工作区，默认工作区可配置，多个项目各干各的 |
| 📋 提问双向 | AI 中途调用 ask_user_question → 自动转发到微信 → 你回复序号/选项 → AI 继续执行（60 秒超时自动取消） |
| 📸 截图回传 | 发 /shot，AI 截下电脑屏幕存成 PNG，图片直接发回微信 |
| 📎 文件收发 | /send <路径> 把本机文件发微信；微信发来的图片/文件自动存收件箱给 AI 读 |
| 🧠 模型切换 | /model 查看/切换模型与 reasoning effort，随时换脑子 |
| 🛠️ Windows 服务化 | NSSM 注册为 WeixinDshBridge 服务：开机自启、崩溃自动重启、日志轮转 |
| 🚫 陌生人忽略 | 可选白名单，名单外的微信用户消息直接忽略 |
| 🌐 中文友好 | 全命令中文别名（/取消、/截图、裸词 取消），语音输入也能用 |
| 📡 稳定传输 | 分片发送（4000 字/段防乱序）、typing 指示、失败重试、消息去重、断线自动重连补事件 |
| 🕵️ 无遥测 | 原仓库的 Application Insights 遥测已整体删除，不采集任何数据 |

📸 真实效果

端到端实测截图（2026-08-24，备用微信 + Windows 服务模式）：

| 命令操控（/help） | 文件收发（/send） |
| 截图回传（/shot） | 状态监控（/status） |

🚀 快速开始

环境要求：Windows（服务化脚本为 PowerShell）、Node.js ≥ 20（验证于 v24）、本机运行中的 dsh web（http://127.0.0.1:13080，loopback 免认证）、一个备用微信号。

1. 安装依赖并构建
npm install
npm run build

2. 扫码登录（终端显示二维码，用备用微信扫码确认） .\login.ps1

3. 前台运行 .\start.ps1 -Workspace "E:\你的工作区"

微信里给 bot 发 /help 查看命令；发任意消息即进入当前工作区的 dsh agent。

💬 微信命令一览

| 命令 | 说明 | 示例 |
| /work | 列出工作区 | /work |
| /work <序号> | 切换工作区（下条消息在新会话执行） | /work 2 |
| /open | 列出最近的 dsh 会话 | /open |
| /open <序号> | 接管某个 dsh 已有会话 | /open 1 |
| /new | 新建会话 | /new |
| /status | 查看工作区/会话/模型/待答提问 | /status |
| /cancel | 中断当前任务（或取消待回答的提问） | /cancel |
| /shot | 让 agent 截屏并回传图片 | /shot |
| /send <路径> | 把本机文件发到微信 | /send E:\报告\a.pdf |
| /model | 列出模型与 effort | /model |
| /model <id或序号> [effort] | 切换模型/effort | /model deepseek-v4-pro max |
| /help | 帮助 | /help |
| /reset | 重置绑定（下条消息创建全新会话） | /reset |

默认别名：/工作区 /会话 /新会话 /状态 /取消 /截图 /发文件 /模型 /帮助 /重置，另有裸词别名 取消、帮助、重置（整条消息匹配，方便语音输入）。普通消息（含图片、文件、语音转文字）都会作为 prompt 进入当前绑定会话的 agent 循环。

❓ 提问交互（ask_user_question）

dsh agent 在任务中途调用 ask_user_question 时：

1. 桥把问题格式化为微信消息发给你（60 秒内回复，超时自动取消该提问）；
2. 你回复序号（如 1）、选项文字（如 方案B）或多选（1 3）；
3. 多问题时按 1:2, 2:内容 格式一次答完；
4. 桥把答案提交给 dsh，agent 继续执行。回复 /cancel 可主动取消。

🖥️ Windows 服务化（NSSM）

.\install-service.ps1 # 注册 WeixinDshBridge 服务（管理员），自动下载 NSSM .\login-service.ps1 # 停服务 → 前台扫码 → 起服务 .\stop-service.ps1 # 停止服务 .\uninstall-service.ps1 # 卸载服务（不删存储与源码）

开机自启、崩溃自动重启（延迟 5s）、stdout/stderr 重定向到 ~/.wechat-acp-dsh/service-.log（10MB 轮转）。

🔧 配置

复制 config.example.json 为 config.json 按需修改（null 表示保持内置默认）。常用字段：

{
"wechat": { "allowedUsers": [] }, // 微信用户 id 白名单；空=不限制
"dsh": {
"baseUrl": "http://127.0.0.1:13080", // dsh web 地址 "defaultWorkspace": "E:\\工作区", // 路径/工作区 id/标题 "questionTimeoutSec": 60, // 提问超时 "showThoughts": false, // 是否转发思考块 💭 "showToolImages": true, // 转发工具结果里的图片 "autoSendImagePaths": true // 自动发送回复里的图片路径 } }

CLI 参数优先于配置文件；--instance <name> 把存储/token/日志隔离，可同时跑多个桥实例（多微信控制多工作区）。

🧪 测试与验证

- ✅ 单元测试 50/50 通过（npm test）：微信发送/收件箱/状态/待发文本 + dsh client 信封与错误路径 + session-map 持久化 + 提问解析矩阵
- ✅ npm run build（tsc 严格模式）零错误
- ✅ 对真实 dsh 的冒烟测试：npx tsx scripts/smoke-dsh.ts（消息往返）、npx tsx scripts/smoke-question.ts（提问往返）
- ✅ 用户端到端实测（2026-08-24）：扫码登录、命令往返、/work /open /new /reset /model 切换、/shot 截图回传、/send 文件、提问双向、服务崩溃自动拉起

📁 目录结构

src/
weixin/ iLink 登录/收发/文件/CDN（复用自 wechat-acp） adapter/ 微信消息 → dsh prompt（文本/图片/文件收件箱） dsh/ dsh 适配器（本项目核心） client.ts unary RPC 客户端（/api/<method>、/api/respond） events.ts events.mux WebSocket 订阅（自动重连） session-map.ts 微信用户 ↔ dsh 会话映射（JSON 持久化） session.ts 会话管理器（绑定/接管/提问/事件路由/历史兜底） answer.ts 提问格式化与微信回复解析 types.ts dsh wire 类型 bridge.ts 主桥（命令集/回复管线/截图监视/注入） config.ts 配置与命令别名 inject/ 本地 CLI → 常驻进程的消息注入队列 storage/ 最后活跃用户状态 bin/wechat-acp-dsh.ts CLI 入口 scripts/smoke-.ts dsh 侧冒烟测试 *.ps1 启动/登录/服务化脚本

🔒 安全与隐私

- dsh API 仅 loopback（127.0.0.1），桥只连本机；
- bot token 与会话映射存于 ~/.wechat-acp-dsh/（用户主目录私有文件）；
- 无任何遥测上报；
- /send 可读本机任意路径——白名单 + bot 私聊是其边界，请自行决定是否把 bot 分享给他人。

❓ FAQ

Q: 消息发出去没反应？ A: 看 service-err.log / 终端日志。常见原因：dsh web 未启动（桥会自动重连）、会话未绑定（先 /status）、token 过期（errno -14 时重新 .\login.ps1）。

Q: 重启后会话还在吗？ A: 在。映射持久化，桥启动时自动恢复绑定；dsh 侧会话历史由 dsh 自己保存。

Q: 想用两个微信控制两个工作区？ A: --instance a / --instance b 跑两个桥实例，各自扫码、各自映射、互不干扰。

Q: 群消息支持吗？ A: 当前版本只处理私聊，群消息直接忽略。

📄 License

查看许可（View-Only License）：本仓库源码公开可见，仅供浏览与学习，保留所有权利——未经作者书面许可，禁止复制、修改、分发或用于任何产品/项目。详见 LICENSE。

本项目 fork 自 formulahendry/wechat-acp（MIT），微信 iLink 客户端代码改编自 @tencent-weixin/openclaw-weixin 与 wechat-acp；上游部分仍按各自原始许可证（MIT）授权。无遥测。