dsh-wechat-bridge
WeChat ⇄ DSH 桥接套件：iLink 网关 + 支持动态代理预设路由、会话内图片和 Web 设置面板的对话节点
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Kairos0922/dsh-wechat-bridge#547d89f82ad79c02c376b9104d3e8799e7b06c70Wechat Bridge 以 dsh-wechat-bridge 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →把微信变成 DeepSeek Harness（DSH）的移动遥控器。
人在外面，智能体在电脑上干活——微信发一条消息，DSH 替你查资料、写代码、跑脚本、处理文件，结果直接回微信。走腾讯官方 iLink 通道，扫码即连，无需公网服务器、无需 webhook、无需固定 IP。
/modes 列出你 DSH 里的全部 agent 预设，回复编号直接开会话，不写死任何角色/export 会话导出、长文转文件）与视频（/video），实测正常显示🧮 12.0k / 32.0k），接近上限提示自动压缩并建议 /new；自动压缩发生时主动告知/retry 引导；断线恢复自动通知notifyRejected 提醒）；危险操作经审批，在微信里回复 /yes /no 或编号即可决定前置：本机已安装 DeepSeek Harness（dsh CLI 可用）。
第 1 步：安装（自动注册为 profile 插件层，装完重启 dsh web）：
dsh plugin --profile web add https://github.com/Kairos0922/dsh-wechat-bridge.git
若你的 profile 不叫
web，把--profile web换成你的 profile 名。
第 2 步：扫码配对——打开 DSH Web 界面 → 设置面板 → 插件 → 微信桥 → 点击「扫码配对」，用你的微信扫码确认。
扫码即配对（bootstrap）：信任集为空时，第一个扫码用户的微信 id 自动进入信任集（持久化保存，无需手写配置）；信任集非空后，新用户扫码需在 Web 面板点「确认」才加入，换账号扫码同样需确认后才切换凭据。多用户：每个用户拥有独立会话/上下文/偏好，后来的扫码不会顶替先前用户。
allowFrom仅用于预授权或收紧（见下表）。
然后直接在微信里给机器人发消息即可——没有会话时会自动创建（默认模式），不用手动 /new。常用命令见下节。
| 命令 | 作用 |
|---|---|
/modes | 列出全部模式（中文说明 + 快捷命令），回复编号直接开会话 |
/new [模式] <任务> | 按模式新建会话并开始处理 |
/sessions | 列出你的会话（含上下文用量与最后活动时间） |
/use N | 切换到第 N 个会话 |
/status | 查看会话、偏好、配对人数与出站状态 |
/model | 查看/切换模型（仅影响之后新建的会话；/model default 恢复默认） |
/workspace | 查看/切换工作区（仅影响之后新建的会话；/workspace default 恢复默认） |
/thinking on|off | 思考心跳是否附最近原文（per-user） |
/stop | 停止当前执行中的任务（也可直接回复「停 / 停止 / 算了」） |
/retry | 重试上一次任务 |
/close | 归档当前会话 |
/yes /no | 审批：同意 / 拒绝最近一次权限请求（只回答你自己的；仅一条待确认时也可回复 1/2） |
/video <路径> | 把本机视频文件作为微信视频消息发送（仅限工作区 cwd 与媒体目录下的 .mp4 文件，校验扩展名/真实路径/普通文件，≤10MB） |
/export | 导出当前会话全文为 .md 附件 |
/card | 把最近一条回复渲染成长图（需 cardMode: long + 本机 Chrome） |
/help [命令] | 查看全部命令或单个命令详情 |
//开头 | 转义：原样把 / 开头的文本当普通消息发给 agent |
| 方向 | 类型 | 状态 |
|---|---|---|
| 微信 → bot | 图片 | ✅ 生产可用（CDN 下载 + AES 解密落盘） |
| 微信 → bot | 文件 | ✅ 代码就绪（同管线下载落盘 + mime 表；实现与官方 downloadMediaFromItem 对齐，待生产实测后转 ✅） |
| 微信 → bot | 视频 | ✅ 代码就绪（同上，落盘 .mp4；待生产实测后转 ✅） |
| 微信 → bot | 语音 | ⚠️ 仅取微信转写文本；无转写字段时明确告知（协议支持 SILK 下载转码，未实现） |
| bot → 微信 | 图片 | ✅ 实测正常显示（/card 长图、agent 图片输出） |
| bot → 微信 | 文件附件 | ✅ 实测可用（/export、fileThresholdChars 长文转文件） |
| bot → 微信 | 视频 | ✅ 实测正常播放（/video <路径>；item 类型必须为 ITEM_VIDEO=5） |
| bot → 微信 | 语音气泡 | ❌ 腾讯客户端不渲染 bot 语音（官方参考实现实测同样不可见） |
协议规格见 docs/protocol.md；历史探针矩阵与判定过程见 docs/porting-notes.md。
| 配置 | 默认 | 说明 |
|---|---|---|
allowFrom | [] | 额外白名单（扫码即配对是主信任机制；此项用于预授权未扫码用户或收紧） |
defaultMode | — | /new 不带模式时的默认预设 |
cwd | — | /new 会话默认工作目录 |
markdownMode | passthrough | passthrough / filter / plain 三种 Markdown 策略（渲染行为实测见 docs/verification-records.md） |
minSendIntervalMs | 5000 | 出站最小发送间隔（限流卫生） |
typingHeartbeatSec | 25 | 长任务期间重发「正在输入」的间隔（0=关闭） |
maxMessageChars | 2000 | 单条气泡上限 |
fileThresholdChars | 0 | 长文转文件阈值（>0 时超长回复自动变 .md 附件；0=关闭） |
cardMode | off | 长图卡片模式（off / long，需本机 Chrome） |
progressToolPrefixes | [] | 工具进度卡片前缀（命中工具名的工具在任务中发进度卡片）。注意：当前微信后端对卡片 item 静默丢弃，配置后也暂不显示；后端支持后填前缀（如 ["bash","fs"]）即启用 |
approvalTimeoutSec | 600 | 审批等待超时（超时默认拒绝） |
notifyOnComplete | false | 长任务完成时主动播报（仅私聊） |
notifyRejected | false | 陌生账号尝试联系时通知信任用户 |
thinkingDigestSec | 120 | 执行中「仍在处理」心跳间隔（秒，0=关闭） |
sendBudgetWindowSec / sendBudgetMaxPerWindow | 60 / 4 | 出站滑动窗口预算（每窗口最多条数，超限排队不丢弃） |
sessionWindowSendMax | 10 | 服务器会话窗口出站配额上限（实测约 10 条/用户入站窗口；最终答案/审批等 must 消息豁免；0=关闭会计） |
inboundDebounceMs | 2000 | 同一会话快速连续文本合并为一个 agent turn；媒体立即冲刷；0=关闭 |
完整配置见插件源码 src/node/index.ts 的 Config。
/yes /no 只回答你自己的审批。allowFrom ∪ 面板确认的配对用户 ∪ 凭据 owner（详见下节「安全模型」）。任何拿到二维码的人都能发起配对请求——二维码只在你的 Web 面板显示，请勿对外发布。allowFrom 配置 ∪ Web 设置面板中确认过的配对用户 ∪
凭据 owner（扫码登录的账号本身）。信任集外的消息只记日志、绝不喂给模型。/api/dsh-wechat-bridge/* 带浏览器信任栅栏——Host 回环校验 +
sec-fetch-site 拒绝跨站 + Origin 同源校验；非本机回环 Host 一律 403。<redacted>。/video 路径限制：仅允许工作区（cwd）与媒体目录下的 .mp4 文件，校验扩展名、
真实路径、普通文件与大小上限（10MB）。*.cdn.weixin.qq.com）+ HTTPS + 30s 超时
mediaRetentionDays（默认 30 天，0 关闭）
自动删除——包含用户发来的图片。allowGroups 已就绪待开放。progressToolPrefixes: []），后端支持后填前缀即可启用。ret=-2 的 errmsg 区分限流与窗口配额耗尽，见 docs/protocol.md §5）。
prepare failed，直到你下一条消息重置窗口。桥端对策：心跳/todo/上下文行在窗口见底时自动让位（HEARTBEAT_QUOTA_RESERVE=3），配额留给最终答案；最终答案、审批提示、出错/停止通知为最高优先级（must），不受配额限制。pnpm install && pnpm verify # build → bundle → node --check → 242 项测试
scripts/dry-run.sh --check # 隔离干跑（临时 DSH_HOME，不动生产）
MIT。协议客户端与 Markdown 过滤器移植自 Tencent/openclaw-weixin（MIT）；架构范式参照 Jesse-njx/dsh-chatnode-wechat（MIT）。完整署名见 LICENSE。
⚠️ 本通道经腾讯微信机器人网关，腾讯可能限制账号；建议使用愿意承担风险的微信号。仅使用官方 iLink 通道，不涉及任何非官方协议。
allowGroups | [] | 群聊两级白名单（腾讯暂未向机器人开放群事件，待用） |
botAgent | 包名/版本 | 上报给微信服务器的 bot_agent（UA 语法自动清洗、256B 上限；仅观测用途，不影响鉴权/路由） |