前言¶
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
