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