PerryLink/dsh-reach

English | 简体中文 | Español | Português | हिन्दी

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

面向 DeepSeek Harness（DSH）的多渠道决策与远程控制桥：把任意工作区的审批/提问卡推送到 IM 通道（微信 iLink、Telegram、飞书——另含 QQ/钉钉/企微 v2 drop-in 基座），并可在聊天中直接答复；附带会话控制台、每通道安全策略与开放推送服务。

状态：Phase 1–3 完成（微信 + Telegram + 飞书通道，v0.1.22）；v2 通道基座（QQ/钉钉/企微）基于开放 reachChannels 注册表落地。 设计计划、竞品调研、官方契约核实与分阶段路线见 docs/design/03-rebuild-direction-and-plan.md。

📖 生态实测知识库（实测数据，不是营销）：插件开发指南 · 选型实测数据 · 维护取舍判据。

Install

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

npx @deepseek-ai/dsh plugin --profile web add dsh-reach
dsh1024 plugin --profile web add dsh-reach

安装后需重启 DSH（bundle 补丁在启动时生效）。

What is dsh-reach?

完整证据（含宿主版本兼容矩阵）见 dsh-plugin-supersession-review-20261005.md；英文版见 README.md 的 Maintenance status: 🧊 FROZEN 一节。

工作流概览：安装 → 打开面板 → 操作。下面的示例使用实际命令面。

同一次运行，动图版。

维护状态：🧊 已冻结

2026-10-05 起冻结，不再新增功能。 本包仍可正常使用，没有退役——但不再投入功能开发，只有真实故障才会修复。

维护者判定该能力面已出现采用度更高、更值得推荐的替代方案，因此把精力移到了别处。

	包	周下载量
本包	dsh-reach	600
更值得推荐的替代品	@xmanrui/dsh-im	17,384

为什么替代品更强。 @xmanrui/dsh-im 覆盖十个通道——微信、飞书、企微、钉钉、QQ、Telegram、WhatsApp、Slack、Discord、Matrix。

本包仍然独有的能力。 this package's differentiator was that the same bridge carried approvals and questions back into chat; the rival is far broader in channel coverage

👉 新工作请优先使用 @xmanrui/dsh-im。 已安装的照常可用，没有任何东西被移除。

完整证据（含宿主版本兼容矩阵）见 dsh-plugin-supersession-review-20261005.md；英文版见 README.md 的 Maintenance status: 🧊 FROZEN 一节。

⭐ 如果它帮到了你

这个插件是 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.

兼容性

方面	状态
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 量 checkout 面）。已于 2026-09-24 跑完整门禁链核验；裸装 + scratch profile + keyless 冒烟由 Compat 工作流在每个 PR 上执行。
Node	^22.19.0 || >=24.0.0

Features (Phase 1)

• 跨会话决策推送：任意工作区的审批/提问卡镜像到微信（iLink/ClawBot），带稳定 #token 卡号与 P{n} 编号；回复 1/2、P1=1 P2=2、P1=Q1=2 或 /rp /rq——经原生 pending 瀑布应答（与 GUI 谁先回复谁生效）。
• 安全默认 fail-closed：首位发送者成为 owner；白名单为空拒绝所有人；陌生发送者只审计不回复。
• 会话控制台：/reach /help /status /silent /notify /tasks /enter /workspace /session /preset /model /perm /history /stop /next + DSH 原生命令透传。
• 主动推送：reach_send 工具（出站文件围栏）、限流预算 + FIFO 补发、静默模式、后台完成通知。
• 设置页：设置 → 插件 → IM 桥接（状态、开关、重新扫码/退出登录）。
• 开放通道注册表：第三方插件通过 ctx.get('reachChannels').registerChannel({ id, adapter, priority, ownsChatId, startMonitor }) 挂载通道；路由、出站与监视器生命周期全部由桥接层托管（QQ/钉钉/企微走同一路径）。

示例

以下为插件真实入口；安装后调用一个即可。

详细示例

命令

/rp

输出

已拒绝 2 张权限卡。

来源 tests/bridge.spec.ts:167-174; src/bridge.ts:594-598

失败分支

输入

/rp while 2 approval cards are pending

输出

已拒绝 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

Configuration

profile 行支持以下键（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 / bot 类型
allowFrom	[]	发送者白名单（空 = 全部拒绝；首位发送者 = owner）
queueMode	queue	繁忙投递：queue 排队 / steer 插话
maxQueue / sendBudget / windowSec	50 / 10 / 60	排队上限、窗口发送预算、窗口秒数
denyUnauthorized	false	未授权发送者：静默忽略（true）或友好提示（false）
authCode	''	Shared secret the IM side must present before a message is accepted
digestSec	300	Digest window in seconds (0 disables the digest)
pushToken	''	Token for the open push service (reach_send HTTP surface)
telegramToken	''	Telegram bot token for the Telegram channel

Development

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

从 DSH Desktop 市场安装

所有 PerryLink 插件均可在 DSH Desktop 内置市场中浏览：市场 → 来源 → 添加来源 → 粘贴 https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → 选中。安装仍需通过市场的 npm 身份校验与你的确认。

Interoperability with other DSH plugins

已对照 DSH 0.2.0-rc.2（本 README 面向的运行时）与 2026-10-05 实测的高星插件集验证。

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

• 无工具名冲突。 所有工具都带命名空间，不占用任何已被内置工具或其他插件持有的裸名。
• 无服务键冲突。 只提供 reach, reachChannels, reachPush；该键既不是内置 seam，也没有被任何已调研的高星插件提供。
• 无 slot 冲突。 不注册客户端 slot key，因此不参与 shadows-shipped-ui 座位争抢。
• 无 HTTP 路由冲突。 不注册任何 webServer 前缀。
• 无 patch 层冲突。 组合包 patch 只 insert 自己那一行，从不覆写内置行的 config。
• 无全局改写。 不改原型、不改写 process.env、不替换全局 fetch dispatcher。

共享事件监听器在构造上就不互相干扰。 它用 ctx.on() 监听顺序敏感事件 approval/request, user-questions/request —— Cordis 的广播语义：每个监听器都会运行，任何一个都无法饿死其他监听器。此处每个监听器都通过 next() 委托，因此链条绝不会被短路；改写作用在 next() 产出的值上，而不是用它顶替返回：

静态证据：dsh-plugin-doctor 的 K10–K13 在本仓全部为 pass。

PerryLink DSH Plugin Family

本项目是 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

License

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