IM 审批遥控桥 PerryLink/dsh-reach

dsh-reach

dsh plugin --profile <name> add dsh-reach

多通道决策与远程控制桥，服务于 DeepSeek Harness（DSH）：把任意工作区的审批卡、提问卡推送到 IM 通道（微信 iLink、Telegram、飞书，另有 QQ/DingTalk/WeCom v2 即插即用的底座），在聊天里直接作答，附带会话控制台、按通道隔离的安全机制和开放的推送服务。

dsh-doctor
DSH Market

dshfind

状态：Phase 1–3 已完成（微信 + Telegram + 飞书通道，v0.1.24）；v2 通道底座（QQ/DingTalk/WeCom）已接入开放的 reachChannels 注册表。
设计方案、竞品调研、官方契约核验和分阶段路线图都在 docs/design/03-rebuild-direction-and-plan.md。
发布（GitHub 仓库 + npm 发布）另开一个会话完成。

📖 生态知识库 —— 实测数据，不是营销话术：插件开发指南 · 插件选型数据 · 维护标准。

安装

dsh plugin --profile web add github:PerryLink/dsh-reach

npm channel (published releases)
dsh plugin --profile web add dsh-reach

git channel (latest main)
dsh plugin --profile web add github:PerryLink/dsh-reach

alternates
npx @deepseek-ai/dsh plugin --profile web add dsh-reach
dsh1024 plugin --profile web add dsh-reach
安装完成后重启 DSH（打包的补丁在启动时生效）。

⭐ 如果它帮到了你

这个插件是 DSH 插件家族的一员（95 个，全部 Apache-2.0）。如果你在用，给个 star —— 它不会解锁任何功能，但会让下一个人在搜索里更容易找到它。

English: part of a 95 plugin family for DeepSeek Harness. If it is useful, a star helps the next person find it — nothing is gated behind it.

dsh-reach 是什么？

完整证据，包括宿主版本兼容矩阵：dsh-plugin-supersession-review-20261005.md。

dsh-reach 的工作流示意图：安装 → 打开面板 → 操作。

工作流概览：安装 → 打开面板 → 操作。下面的示例用的是真实命令接口。

维护状态：🧊 已冻结

2026-10-05 冻结。不再加新功能。 这个包仍然可用，也没有退役 —— 但不再投入功能开发。只有真正的故障才会修。

维护者认为，这项能力在生态里已经收敛到另一个采用更广的实现，所以精力已经转到别处。下面的对比测于 2026-10-05，记录下来，省得别人再测一遍。

| | 包 | 每周下载量 |
| 本包 | dsh-reach | 600 |
| 采用更广的实现 | @xmanrui/dsh-im | 17,384 |

为什么它是主流选择。 @xmanrui/dsh-im 提供十个渠道 —— 微信、飞书、企业微信、钉钉、QQ、Telegram、WhatsApp、Slack、Discord 和 Matrix。

兼容性。 没有声明任何 dsh peer，所以兼容性守卫从不会拦它。

本包还有哪些替代品没有的能力。 本包的差异点在于：同一座桥把审批和提问带回聊天；对手的渠道覆盖更广。

👉 新项目请选 @xmanrui/dsh-im，它是主流选择。 已安装的照常工作，什么都不删。

完整证据，包括宿主版本兼容矩阵：dsh-plugin-supersession-review-20261005.md。

兼容性

| 层面 | 状态 |
| Harness | DeepSeek Harness dsh-v0.2.1-alpha.1（GitHub tag）。Peer 范围 >=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0 \|\| >=0.1.6-0 <0.2.0 \|\| >=0.1.7-0 <0.2.0；dev/test 的固定版本刻意留在已发布的 0.1.7-rc.2 线上，typecheck:ci 标尺量的就是这一面（普通 typecheck 标尺通过 tsconfig.json 的 paths 量检出目录）。2026-09-24 用完整门禁链验证过；每个 PR 都会在 Compat 工作流里跑 bare-import + scratch-profile + keyless 冒烟测试。 |
| Node | ^22.19.0 \|\| >=24.0.0 |

功能（第一阶段）

- 跨会话决策推送：来自任意工作区的审批/提问卡片都会镜像到微信（iLink/ClawBot），带稳定的 #token id 和 P{n} 编号；回复 1/2、P1=1 P2=2、P1=Q1=2，或 /rp /rq —— 通过原生 pending waterfall 作答（先回复的赢过 GUI）。
- 故障关闭式安全：第一个发送者成为所有者；允许列表为空时拒绝所有人；未知发送者会被审计，且永不回复。
- 会话控制台：/status /silent /notify /tasks /enter /history /stop /next /help，外加原生 DSH 命令透传。
- 主动推送：reach_send 工具，带出站文件围栏；速率预算 + FIFO 重新入队；静默模式；后台完成通知。
- 设置标签页：Settings → Plugins → IM Bridge（状态、开关、重新扫描/登出）。
- 开放通道注册表：第三方插件通过 ctx.get('reachChannels').registerChannel({ id, adapter, priority, ownsChatId, startMonitor }) 注册通道；路由、出站、监控生命周期全部由 bridge 掌管（QQ/钉钉/企业微信走同一条路径）。

示例

这些是插件的真实入口；安装一次，然后调用其中一个。

详细示例

命令

~~~sh
/rp

输出

~~~text
已拒绝 2 张权限卡。

观察自 tests/bridge.spec.ts:167-174; src/bridge.ts:594-598

失败分支

输入

~~~text
/rp while 2 approval cards are pending

输出

~~~text
已拒绝 2 张权限卡。

观察自 plugins/dsh-reach/tests/bridge.spec.ts:167-174; plugins/dsh-reach/src/bridge.ts:594-598; plugins/dsh-reach/README.md:121-136

简要示例

- /rq

配置

配置档行接受以下键（经 Schemastery 校验；非法值会让加载大声失败）：

| 键 | 默认值 | 描述 |
| crossSessionNotify | true | 从任意工作区/会话推送决策卡（总开关） |
| notifyTaskEvents | false | 后台任务完成/出错通知 |
| cardTimeoutSec | 1800 | 决策卡软超时，单位秒（0 = 永久等待） |
| approvalOnTimeout | delegate | 超时卡片策略：delegate（GUI 链）/ reject / wait |
| textChunkLimit | 4000 | 每条消息的长回复分块上限，单位字符 |
| silent | false | 只发最终回复，不逐步流式输出 |
| cwd | '' | 新 IM 会话的默认工作目录（'' = 宿主 cwd） |
| baseUrl / cdnBaseUrl / botType | iLink 默认值 | 微信网关、媒体 CDN、机器人类型 |
| allowFrom | [] | 发送者允许列表（空 = 故障关闭；第一个发送者 = 所有者） |
| queueMode | queue | 忙碌投递：queue 或 steer |
| maxQueue / sendBudget / windowSec | 50 / 10 / 60 | 队列上限、每窗口发送预算、窗口秒数 |
| denyUnauthorized | false | 静默忽略（true）或通知（false）未知发送者 |
| authCode | '' | IM 侧在接受消息前必须出示的共享密钥 |
| digestSec | 300 | 摘要窗口，单位秒（0 关闭摘要） |
| pushToken | '' | 开放推送服务（reach_send HTTP 接口）的 token |
| telegramToken | '' | Telegram 通道的 Telegram 机器人 token |

开发

pnpm install
pnpm run typecheck && pnpm run typecheck:ci && pnpm testbash
pnpm run build && pnpm run verify:self-contained && pnpm run verify:artifacts
pnpm run check:readmes && pnpm pack

从 DSH Desktop Market 安装

在 DSH Desktop Market 里可以浏览所有 PerryLink 插件：Market → Sources → add source → 粘贴 https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → 选中它。安装仍要经过 Market 的 npm 身份校验，并由你确认。

与其他 DSH 插件的互操作性

已针对 DSH 0.2.0-rc.2（本 README 面向的运行时）以及 2026-10-05 调研的高星插件集做过验证。

本插件不会干扰其他插件，包括广泛安装的高星插件：

- 无工具名冲突。 每个工具都带命名空间；没有注册任何裸名称，既不属于已发布工具，也不属于其他插件。
- 无服务键冲突。 它提供 reach、reachChannels、reachPush；这些键不是内置接缝，调研过的高星插件也都不提供。
- 无槽位冲突。 它不注册任何客户端槽位键，因此不会争抢 shadows-shipped-ui 的席位。
- 无 HTTP 路由冲突。 它不注册任何 webServer 前缀。
- 无补丁层冲突。 包补丁只 insert 自己那一行，从不覆盖内置行的 config。
- 无全局改动。 它不改原型、不改写 process.env，也不替换全局 fetch 调度器。

共享事件监听器在设计上互不干扰。 它用 ctx.on() 观察对顺序敏感的事件 approval/request、user-questions/request——这是 Cordis 的广播注册方式，每个监听器都会执行，谁也无法饿死别人。这里的每个监听器都通过 next() 委托，所以调用链永远不会被短路；改动施加在 next() 产出的值上，而不是顶替它返回：

静态证据：dsh-plugin-doctor 的 K10–K13 对本仓库的每项检查都报告 pass。

PerryLink DSH 插件家族

本项目属于 PerryLink 的 DeepSeek Harness 插件家族。下面这份名单默认折叠，好让每个 README 的首屏都保持简短；展开即可看到每一行及其状态。

展开全部插件

| 插件 | 状态 |
| dsh-aqua-input-check | |
| dsh-archive-check | |
| dsh-auto-review | |
| dsh-autotier | |
| dsh-bid-ca-precheck | |
| dsh-bid-qual-check | |
| dsh-cert-mcp | |
| dsh-checkpoint-rewind | |
| dsh-click | |
| dsh-composer-history | |
| dsh-contract-stance | |
| dsh-customs-doc-check | |
| dsh-data-quality | |
| dsh-demurrage-ledger | |
| dsh-doublecheck | |
| dsh-drill-script-check | |
| dsh-eia-guide-check | |
| dsh-emergency-plan | |
| dsh-essay-rubric-check | |
| dsh-evidence-check | |
| dsh-export-ctl-check | |
| dsh-fast | |
| dsh-fmea-table-check | |
| dsh-forecast-penalty | |
| dsh-fund-research | |
| dsh-github | |
| dsh-gongwen-flow-check | |
| dsh-gongwen-word-check | |
| dsh-guard-plan-qc | |
| dsh-hazchem-check | |
| dsh-hazplan-check | |
| dsh-hidden-risk-map | |
| dsh-hs-classify | |
| dsh-icd-rule-check | |
| dsh-industry-research | |
| dsh-lawcite-adapter | |
| dsh-laya | |
| dsh-lc-doc-check | |
| dsh-learning-gap-check | |
| dsh-library | |
| dsh-local-ai | |
| dsh-lsp-actions | |
| dsh-mask | |
| dsh-mcp-panel | |
| dsh-medrec-qc | |
| dsh-memento | |
| dsh-nsfc-form-check | |
| dsh-nurse-record-check | |
| dsh-observe | |
| dsh-origin-rvc-check | |
| dsh-ota-review-check | |
| dsh-output-styles | |
| dsh-paper-doc-adapter | |
| dsh-permission-rules | |
| dsh-permit-report-check | |
| dsh-pipeline-check | |
| dsh-pleading-draft | |
| dsh-plugin-doctor | |
| dsh-plugin-guide | |
| dsh-plugin-kit | |
| dsh-plugin-upgrade | |
| dsh-policy-brief-draft | |
| dsh-power-loss-split | |
| dsh-power-ticket-check | |
| dsh-ppap-check | |
| dsh-protest-deadline | |
| dsh-railway-window | |
| dsh-repair-order-qc | |
| dsh-research-report | |
| dsh-review-reply-check | |
| dsh-rulefile-check | |
| dsh-safety-brief-check | |
| dsh-score | |
| dsh-session-sync | |
| dsh-site-log-check | |
| dsh-skill-pack-security | |
| dsh-soe-decision-check | |
| dsh-soilwater-check | |
| dsh-sop-sync-check | |
| dsh-spc-gbt-adapter | |
| dsh-talk | |
| dsh-tender-extract | |
| dsh-tender-matrix | |
| dsh-test-drive | |
| dsh-ticktick | |
| dsh-translate | |
| dsh-warranty-calc | |
| dsh-budget | 🧊 已冻结 — 见仓库 README |
| dsh-claude-move | 🧊 已冻结 — 见仓库 README |
| dsh-defend | 🧊 已冻结 — 见仓库 README |
| dsh-draw | 🧊 已冻结 — 见仓库 README |
| dsh-reach | 🧊 已冻结 — 见仓库 README |
| dsh-background-agents | 🚫 已退役 — 见仓库 README |
| dsh-session-pin | 🚫 已退役 — 见仓库 README |
| dsh-team-rooms | 🚫 已退役 — 见仓库 README |

许可证

Apache-2.0。第三方声明见 THIRD_PARTY_NOTICES.md。