前言¶
DeepSeek Harness (DSH) 採用插件化架構。在處理長任務或複雜流程時，直接使用模型往往缺乏確定性，難以追蹤狀態且容易失控。Orbit 作爲一個面向 DSH 的確定性長任務編排器，通過引入明確的角色分工和流程控制，將“規劃、執行、審覈、糾錯、恢復、最終驗收”拆解爲可管理的步驟。它不與 DeepSeek 官方相關，屬於社區插件。
核心功能¶
Orbit 將任務執行拆解爲若干角色與機制：
- Commander：負責計劃、步驟審覈、最終審覈和策略調整，持續會話。
- Executor：單步執行、工具調用與驗證，會話複用。
- Heartbeat Watchdog：異常即時介入與週期巡檢，主動監控運行健康度。
- Durable State：持久化 Run 狀態到
.cx/sessions/，支持冷恢復。 - Bounded Loop：Plan、Correction、Watchdog、Append 都有明確的上限。
- Route Freeze：創建後凍結角色模型與 Reasoning，中途改 UI 隻影響下一次 Run。
- Persistent Role Sessions：會話身份、輪次、Token 寫入 State，正常交接不重新創建角色。
- Mutation Fence：多 Session 共存時的串行執行防衝突。
- 可選 MoA：多候選競爭執行（需額外安裝）。
- 可選 Browser：配合
@kasenri/dsh-browser進行真實網頁操作。
安裝與啓用¶
安裝命令如下：
dsh plugin --profile web add github:KasenRi/dsh-orbit
激活 Orbit 的方式有三種：
- 使用
/agent-orbit <goal>命令。 - 在對話中輸入
orbit模式（如“用 orbit模式完成這個項目”）。 - 使用
cx模式。
典型用法¶
Orbit 通過 orbit_controller 工具驅動運行。支持的操作包括：
- 啓動/運行：調用
orbit_controller，action設爲run或start。 - 恢復運行：調用
orbit_controller，action設爲resume。 - 檢查狀態：調用
orbit_controller，action設爲status。 - 關閉運行：調用
orbit_controller，action設爲stop。 - 環境檢查：調用
orbit_controller，action設爲doctor。
示例配置：
{
"action": "run",
"goal": "…",
"approved_loop_count": 4,
"user_hard_constraints": ["only touch src/"]
}
適用場景與注意¶
- 環境要求：依賴 DSH 基礎服務（agents, subagents, tools, sessions），要求 Node.js >= 22.19.0。
- MoA 依賴：MoA（多候選競爭執行）是可選功能。如需使用，需自行另外安裝
@goodandready/dsh-moa。MoA 只負責提供候選，Orbit 決定流程，Judge 只做相對選優。 - 非官方性質：Orbit 是非官方社區插件，不與 DeepSeek 官方相關。
- 權限與安全：插件以當前 DSH 進程權限運行，建議安裝前檢查源碼與許可證。
總結¶
Orbit 通過結構化的角色與狀態管理，讓 AI 能夠按照確定的工程流程完成任務，而非僅僅是“連續回答”。對於需要長鏈路、可恢復且可審覈的複雜任務，Orbit 提供了可控的執行路徑。更多詳情可查閱 GitHub 倉庫：https://github.com/KasenRi/dsh-orbit。
