IM 审批遥控桥PerryLink/dsh-reach

dsh-reach

License
DSH plugin
dsh-doctor
Gitee
CI
Version
npm version
npm downloads

面向 DeepSeek Harness（DSH）的多通道决策与远程控制桥接：将任意工作区的审批/提问卡片推送到 IM 通道（微信 iLink、Telegram、飞书——外加 QQ/钉钉/企业微信 v2 即插即用基础），并可从聊天中作答，具备会话控制台、按通道安全机制和开放推送服务。

状态：第 1–3 阶段已完成（微信 + Telegram + 飞书通道，v0.1.8）；v2 通道基础（QQ/钉钉/企业微信）基于开放的 reachChannels 注册表。
设计方案、竞品调研、官方契约验证以及
分阶段路线图见
docs/design/03-rebuild-direction-and-plan.md。
发布（GitHub 仓库 + npm 发布）将在专门会话中进行。

兼容性

| 层面 | 状态 |
|---|---|
| Harness | DeepSeek Harness dsh-v0.1.5-rc.2（GitHub tag）。npm 依赖线：@deepseek-ai/dsh 0.1.5-rc.2（peer 为 >=0.1.2-rc.1 =0.1.5-alpha.1 =24.0.0 |

功能（第 1 阶段）

- 跨会话决策推送：来自任意工作区的审批/提问卡片
会以稳定的 #token id 和 P{n}
编号镜像到微信（iLink/ClawBot）；回复 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 重新排队；静默模式；后台完成通知。
- 设置标签页：设置 → 插件 → IM Bridge（状态、开关、
重新扫描/登出）。
- 开放频道注册表：第三方插件通过
ctx.get('reachChannels').registerChannel({ id, adapter, priority,
ownsChatId, startMonitor }) 注册频道；路由、出站和监控生命周期
全部由 bridge 拥有（QQ/钉钉/企业微信走同一条路径）。

安装

npm 频道（已发布的版本）
dsh plugin --profile web add dsh-reach

git 频道（最新 main）
dsh plugin --profile web add "github:PerryLink/dsh-reach#main"

备选方式
npx @deepseek-ai/dsh plugin --profile web add dsh-reach
dsh1024 plugin --profile web add dsh-reach

安装后重启 DSH（bundle 补丁在启动时应用）。

配置

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、机器人类型 |
| allowFrom | [] | 发送者允许列表（空 = 失败关闭；第一个发送者 = 所有者） |
| queueMode | queue | 忙碌时投递：queue 或 steer |
| maxQueue / sendBudget / windowSec | 50 / 10 / 60 | 队列上限、每窗口发送预算、窗口秒数 |
| denyUnauthorized | false | 静默忽略（true）或通知（false）未知发送者 |
| authCode | '' | IM 侧在接受消息前必须提供的共享密钥 |
| digestSec | 300 | 摘要窗口，以秒为单位（0 禁用摘要） |
| pushToken | '' | 开放推送服务（reach_send HTTP 接口）的令牌 |
| telegramToken | '' | Telegram 频道的 Telegram 机器人令牌 |

开发

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 Market 安装

所有 PerryLink 插件均可在内置的 DSH Desktop Market 中浏览：Market → Sources → add source → 粘贴 https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → 选择它。安装仍会经过 Market 的 npm 身份验证和你的确认。

PerryLink DSH 插件家族
本项目是由 PerryLink 维护的 40 个 DeepSeek Harness 插件之一。如果这个插件对你有帮助，其他的很可能也会：

| 插件 | 一句话简介 |
|---|---|
| dsh-auto-review | 审批链上的第二模型自动审查，默认失败即关闭 | |
| dsh-background-agents | 持久化的后台子代理，带 Web UI 侧边栏、消息传递和中断功能 | |
| dsh-budget | DeepSeek Harness 的成本治理：预算、碳排放和延迟集于一个面板。 | |
| dsh-checkpoint-rewind | 等同于 Claude Code /rewind：快照、会话分叉、一次性恢复 | |
| dsh-claude-move | 将 Claude Code 的会话、记忆、技能和 CLAUDE.md 迁移到 DSH | |
| dsh-click | 面向 DeepSeek Harness 的跨平台原生桌面控制——Windows 优先。 | |
| dsh-composer-history | Web 编辑器的终端风格输入历史：方向键、Ctrl+R 搜索 | |
| dsh-data-quality | 数据集质量检查和引用交叉核对（此处消费的可选数值桥接） | |
| dsh-defend | 面向 DeepSeek Harness 的提示注入、越狱和密钥泄露防御。 | |
| dsh-doublecheck | 工程纪律守卫：需求拷问、测试门禁、对手审查 | |
| dsh-draw | 面向 DeepSeek Harness 的统一静态图像生成路由。 | |
| dsh-fast | 面向 DeepSeek Harness 的只读性能诊断。 | |
| dsh-fund-research | 面向中国公募基金的确定性研究报告 | |
| dsh-github | 面向 DSH 的 GitHub PR/issue 集成，每次写入都需审批 | |
| dsh-industry-research | 行业研究编排，通过本插件的 ctx.researchReport.assemble 封存其交付物 | |
| dsh-library | 面向 DeepSeek Harness 的本地文档知识库。 | |
| dsh-local-ai | 面向 DeepSeek Harness 的本地模型（Ollama）集成。 | |
| dsh-lsp-actions | 通过语言服务器提供 LSP 诊断、格式化、补全、代码操作和重命名 | |
| dsh-mask | PII 脱敏中间件：在模型边界处匿名化，在展示层还原 | |
| dsh-mcp-panel | 只读 MCP 运行时面板：/mcp 命令 + 设置选项卡，显示状态、工具和错误 | |
| dsh-memento | 需审批的跨会话记忆：ctx.memory 接缝 + SQLite + memory 工具 | |
| dsh-observe | 面向 DeepSeek Harness 的 OpenTelemetry 和 Langfuse 可观测性导出器。 | |
| dsh-output-styles | 等效于 Claude Code outputStyles 的运行时样式切换 | |
| dsh-permission-rules | Claude Code 风格的声明式 allow/deny/ask 权限规则，带审计功能 | |
| dsh-personal-directive | 带顶栏开关的个人指令注入器（框架版） | |
| dsh-plugin-guide | 作为按需智能体技能提供的插件开发知识库 | |
| dsh-plugin-doctor | 面向 DSH 插件的零依赖静态 + 沙箱冒烟检测器 | |
| dsh-research-report | 可验证的研究报告引擎：内容寻址的证据账本和密封版本 | |
| dsh-score | 面向 DeepSeek Harness 插件的多维度质量评分。 | |
| dsh-session-pin | 在 Web 侧边栏中固定会话，并保持持久排序 | |
| dsh-session-sync | 面向 DeepSeek Harness 的跨设备会话同步——会话存储的专用 git 镜像。 | |
| dsh-skill-pack-security | 安全审计技能包：密钥扫描、依赖项和供应链审查 | |
| dsh-talk | 面向 DeepSeek Harness 的语音优先会话循环：对它说话，听它回答。 | |
| dsh-test-drive | 面向 DeepSeek Harness 插件的隔离安装与冒烟测试驱动。 | |
| dsh-translate | 面向 DeepSeek Harness 的供应商参数转换和确定性 JSON 修复。 | |
| dsh-ticktick | TickTick/滴答清单任务桥接：会话头部面板 + 11 个工具 | |
| dsh-wechat | 微信 ↔ DSH 桥接（腾讯 iLink 机器人）：文本/图片/文件/语音，在聊天中审批 | |
| dsh-autotier | 自动强/廉价模型层级路由，带确定性风险防护和 /tier 命令 | |
| dsh-catalog | PerryLink 系列的 DSH Desktop Market 标准目录源 | |
| dsh-cert-mcp | 只读 MCP 服务器，暴露认证注册表：等级、快照和五维证据 | |
| dsh-kit | 一键安装核心系列的入门包 | |
| dsh-plugin-certification | 社区认证注册表，包含可复现检查的等级和徽章 | |
| dsh-plugin-kit | PerryLink DSH 插件共享的零运行时依赖工具包 | |
| dsh-plugin-portal | 零依赖静态门户，将整个插件系列渲染为单个页面 | |
| dsh-plugin-upgrade-015 | 合并的 0.1.3-alpha.1 → 0.1.5-rc.1 升级通道卡片，外加零依赖接缝扫描器 | |
| dsh-team-rooms | 跨会话团队房间：共享消息总线、任务板和时线 | |

从 DSH Desktop Market 安装

所有 PerryLink 插件均可在内置的 DSH Desktop Market 中浏览：Market → Sources → add source → paste https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → select it。安装仍需经过 Market 的 npm 身份验证和你的确认。

许可证

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