前言¶
DeepSeek Harness 的插件生态把 Tool、Skill、Plugin 交给 Agent 使用；但在实际任务中，执行动作不等于结果可靠。dsh-omni-router 针对这一层做补充：它定位为 “Omni - an Agent Reliability Kernel for DeepSeek Harness”，把任务处理分成 Decide、Prepare、Verify 三步。
DSH 继续负责执行，Omni 负责可靠性。下面介绍它的定位、已核实功能、安装命令和典型用法。
这是什么¶
qwe225380/dsh-omni-router 由 qwe225380 维护，package name 为 dsh-omni-router，当前 package.json 版本为 3.0.0-rc.27，许可证为 MIT。
它的一句话定位是：
Omni - an Agent Reliability Kernel for DeepSeek Harness. Decide. Prepare. Verify: DSH owns execution, Omni owns reliability.
也就是说，它不替代 DSH，而是在 DSH 已有执行能力之上增加任务级判断、上下文准备、能力审计、证据验证和失败恢复。
核心功能¶
任务介入¶
简单任务真正 NOOP，复杂任务才进入 Assist / Guard。这样避免所有任务都走复杂流程。
任务契约与上下文¶
它使用 Task Contract + 精准 Context + Capability Sufficiency。任务先形成验收与能力边界，再进入执行。
证据与恢复¶
它关注 Evidence / Freshness / Acceptance coverage / Recovery，把验收、证据新鲜度、验收覆盖和失败恢复作为任务完成前后的检查点。
能力复用¶
设计原则是优先复用 DSH 已有 Tool / Skill / Plugin，不重复造轮子；只在确实阻塞任务时补齐能力缺口。
失败处理¶
当 retry 不奏效时，策略会转向 repair、expand context 或 change hypothesis，而不是重复同一种尝试。
能力缺口安装¶
默认 recommend 模式：识别缺口、搜索、推荐，用户/Host 审批后安装；显式开启 auto-trusted 才自动安装。
与 Router Standard 组合¶
检测到 Router Standard 时，它会自动生成组合预设，并委托 persona/reasoning routing。
基准测试¶
它提供 OmniBench 多臂基准测试与 release gates，用于对比和发布门槛检查。
安装与启用¶
安装命令如下：
dsh plugin --profile web add dsh-omni-router
这条命令在当前 DSH 的 web profile 中添加 dsh-omni-router。
使用前注意：
- 当前 package.json 版本为
3.0.0-rc.27，属于 RC 状态。 - 许可证为 MIT。
- 插件以当前 dsh 进程权限运行；安装前应检查源码、配置项与许可证，再决定是否在重要环境启用。
典型用法¶
以下示例来自插件资料，可按任务类型理解。
修复并发刷新问题¶
场景：修复 refreshSession 偶发并发刷新三次。
流程：
1、生成 Task Contract，包含 C1-C3。
2、整理 Relevant Context。
3、DSH 执行。
4、给出证据：concurrency test 28/28、full auth suite 143/143。
5、输出 Proof: 3/3。
该示例展示了 Task Contract、执行证据和 Proof 的组合。
前端 UI 修复¶
流程：
1、判断这是前端任务。
2、检查当前 DSH 能力。
3、复用 Browser 与 UI/Verification Skill。
4、生成 UI acceptance criteria。
5、DSH 执行。
6、收集 screenshot/tool/test evidence。
7、Verify。
已有 Browser 和 UI/Verification Skill 时，不重复安装同类能力。
复杂重构¶
已有能力全部复用，缺失能力只补 gap。
与 dsh-router-standard 组合¶
Router Standard 继续负责 DeepSeek persona/attention/workflow routing；Omni 负责 capability、context、evidence 和 reliability。
运行 OmniBench¶
npm run omnibench:v2:generate -- benchmark/omnibench-v2/manifest.local.example.json
node benchmark/omnibench-v2/run.mjs benchmark/omnibench-v2/manifest.local.example.json --exec
node benchmark/omnibench-v2/matrix.mjs <results.json>
node benchmark/omnibench-v2/gates.mjs <results.json>
这些命令分别用于生成 manifest、执行 benchmark、生成 matrix 和检查 gates。
适用场景与注意¶
适合需要在 DSH 上执行任务，并希望同时关注任务契约、能力复用、证据和失败恢复的场景。尤其是任务涉及验收条件、工具证据或跨步骤恢复时。
需要注意：
- 默认 recommend 模式安装缺口能力需用户/Host 审批；显式开启 auto-trusted 才自动安装，并记录
.omni/capability-audit.json。 - 如果 DSH 当前没有可靠事件 hook，Omni 会输出 Verified、Partially Verified 或 Unverified。
- 3.0 RC benchmark validation is in progress；达到 Gate 前不宣称 frontier parity。
- 当前版本
3.0.0-rc.27是 RC 版本，正式环境建议先检查行为与权限。
结尾¶
dsh-omni-router 的价值在于把“执行”和“可靠”分开：DSH 提供执行与插件能力，Omni 补充 Decide、Prepare、Verify 的任务层约束。它不追求替代 DSH，而是尽量复用已有 Tool、Skill、Plugin，并在证据不足时给出明确状态。
GitHub：https://github.com/qwe225380/dsh-omni-router
目录页（插件线索提供，未见于已抓取资料，使用前请自行确认）：https://www.skillhub.cn/plugins/qwe225380/dsh-omni-router
