前言¶
DeepSeek Harness (DSH) 是一个基于插件构建的智能体运行环境。本地任务执行通常需要打开终端或管理后台，而手机端的微信是触手可及的交互入口。zhy5/dsh-wx-bridge 插件通过腾讯 iLink 通道将手机微信接入本机 DSH，让微信内的消息直接驱动本地执行任务。
插件介绍¶
- 定位：联网工具类插件，负责打通微信与本地 DSH 之间的指令通路。
- 维护者：zhy5
- 协议：MIT
- 核心价值：把手机微信变成一个控制台，通过审批、推送和指令执行，实现远程或移动端对本地 DSH 的控制。
核心功能¶
- ACP 原生会话集成：不再由插件拼接上下文，而是直接交给 DSH 的 Agent Client Protocol (ACP) 处理。每个微信联系人或档位对应一条独立会话，重启后可恢复，上下文不丢失。
- 审批与推送：支持微信内审批应答（1.1.0 新增），任何需要越权或特殊权限的操作会以审批卡片形式推送到微信，回复即可批准或拒绝。支持主动推送，任何进程可通过命令将消息推送到手机。
- 内核组件：内置零依赖的
bridge.mjs（iLink 长轮询收发 + ACP 会话执行）与keeper.mjs（存活自检 + 脱树重启）。 - 管理与控制：提供实时状态面板与预设管理，支持通过 HTTP 接口控制桥进程与配置。
安装与启用¶
使用官方安装命令添加插件。注意：插件原名 @zmainer/wxbridge，自 1.0.8 起改名为 @zmainer/dsh-wx-bridge（旧包已弃用）。
dsh plugin --profile <profile> add @zmainer/dsh-wx-bridge
安装后，确认 profile 的 package.json 里 dsh.profile.bundles 包含 @zmainer/dsh-wx-bridge（若 pnpm 构建脚本非零退出，可能被跳过，需手工追加）。
典型用法¶
推送消息：
node "<dataDir>/wxpush.mjs" --text "跑完了：1442 条全部落库"
微信内指令：
- /预设 自检：验证当前档位是否按预设组装。
- /审批 询问|自动|拒绝：切换审批策略。
- /sessions：列出并接上 DSH 已有会话。
注意事项¶
- 数据安全：数据经腾讯 iLink 通道传输，不得用于涉密内容。
- 权限保护：状态与凭据文件为明文，仅靠 ACL 保护。
- 默认策略：审批默认 120 秒未回按拒绝；准入默认 strict（未登记不执行）。
- 版本：当前版本 1.1.8。
结语¶
该插件通过原生会话与审批机制，解决了移动端控制本地任务的安全性与上下文连贯性问题。适合需要在移动端远程执行本地任务或利用微信作为控制入口的场景。
