Orbit 编排与浏览器插件KasenRi/dsh-orbit-browser-plugins

DSH Orbit + 浏览器插件

DeepSeek Harness（DSH）的社区插件。
与 DeepSeek 无关联，亦未获其背书。

本 monorepo 发布两个独立的 Cordis 插件：

| 包 | 作用 |
|---|---|
| @kasenri/dsh-orbit | 确定性工程编排（orbit_controller 工具 + OrbitService）。 |
| @kasenri/dsh-browser | 受控浏览器自动化（agent_browser 工具 + BrowserAutomationService）。 |

Orbit 是 DeepSeek Harness 的确定性工程编排运行时。
它通过极简的 Commander / Executor / Smart Watchdog 架构，协调规划、执行、评估、有界纠正、运行时
恢复与持久化状态。Orbit 强调的是一个“有界、自我收敛的工程执行轨道”：

PLAN → EXECUTE → EVALUATE → CORRECT / RECOVER → SUCCESS

Orbit 不是定时器循环，不是无限自动继续，不是纯审查器，不是纯
规划器，也不是智能体集群。它是确定性监督器加上 Commander、
Executor、Smart Watchdog、持久化状态与有界恢复。

两个包相互解耦：浏览器插件是一项共享能力，
Orbit 在没有它的情况下也能工作。只有声明了 browser 能力的计划步骤
才需要注册 agent_browser 工具。

DeepSeek Harness
│
├─ 原生基础设施：agents / subagents / tools / sessions
│
├─ @kasenri/dsh-orbit
│    ├─ OrbitService（持久化状态位于 /.cx/state.json）
│    ├─ Deterministic Supervisor
│    ├─ Commander / Executor / Smart Watchdog
│    └─ Recoverable guards
│
└─ @kasenri/dsh-browser
└─ agent_browser → agent-browser CLI → Chromium / Chrome / CDP

要求

| 组件 | 测试版本 |
|---|---|
| @deepseek-ai/dsh | 0.1.5-rc.2 |
| @deepseek-ai/cordis | 4.0.2 |
| agent-browser（浏览器插件） | 0.33.2 |
| Node.js | >= 22.19.0 |

DSH 处于开发者预览阶段；这些插件仅针对上述版本进行测试，
并未针对未来所有 DSH 版本进行测试。

安装

两个包均已发布至 npm Registry。pnpm 必须位于 PATH 中。

仅 Orbit 插件
dsh plugin --profile web add @kasenri/dsh-orbit

仅浏览器插件
dsh plugin --profile web add @kasenri/dsh-browser

两者（Orbit 的浏览器能力步骤随后可使用浏览器插件）
dsh plugin --profile web add @kasenri/dsh-orbit
dsh plugin --profile web add @kasenri/dsh-browser

专用的 Git 分发镜像（github:KasenRi/dsh-orbit 和
github:KasenRi/dsh-browser）跟踪镜像仓库的 HEAD，在偏好 Git 源时
仍然可用；源 monorepo 的带版本
GitHub Release tarball 仍可用于手动或离线安装。

每个包都声明了 dsh.bundle 清单，因此 dsh plugin add 会安装它
并自动将其注册为 profile 层。配置请参阅各包的 README：

- Orbit 配置
- 浏览器配置

快速开始

启动 Orbit 最确定的方式是使用斜杠命令：

/agent-orbit 修复当前项目的 TypeScript 错误并运行测试

Orbit 支持三种激活方式：

1. /agent-orbit  — 确定性的斜杠命令激活（Web GUI 斜杠菜单，或在无头/CLI 界面上的真实用户消息手势）。
2. orbit模式 — 推荐的自然语言激活方式。
3. cx模式 — 旧版兼容；仍会解析为 Orbit。

在 Web GUI 中，Orbit 模型控件紧邻原生模型席位左侧：Commander/Watchdog 会持久化到 DSH 设置中，而 Executor 通过同一个共享模型目录跟随当前会话模型。每次新运行都会对三条生效路由进行快照；恢复运行时保留其冻结的路由。

Orbit（类型化工具，与斜杠命令激活的入口相同）
orbit_controller { "action": "run", "goal": "…", "approved_loop_count": 4 }
orbit_controller { "action": "status" }

Browser
agent_browser { "args": ["open", "https://example.com"] }
agent_browser { "args": ["snapshot", "-i"] }
agent_browser { "args": ["click", "@e2"] }
agent_browser { "args": ["snapshot", "-i"] }

安全

- Orbit：Commander 和 Watchdog 使用只读允许列表，Executor 使用写入允许列表，浏览器工具仅对声明了该能力的步骤开放，单一变更所有者隔离，有界修正与循环预算，以及可恢复的守卫拒绝——仅停止单次工具调用而非整个运行。
- Browser：页面作用域引用与过期引用阻断，标签页漂移检测及单次确定性恢复，产物验证，受保护的浏览器状态阻断，凭据脱敏，严格的 allowedDomains 限制，且不绕过 CAPTCHA/OTP/2FA。

从 CX 迁移

参见 packages/orbit/README.md。
简而言之：dsh-cx → dsh-orbit，cx_controller → orbit_controller，
CX 模式 → Orbit 模式，ctx.cx → ctx.orbit。.cx/state.json 保持不变，旧版 cx模式 仍受支持，现有的持久化运行无需迁移。

开发

npm install
npm run typecheck
npm test            # 单元测试
npm run test:e2e    # 真实 Cordis 主机端到端测试
npm run test:smoke  # 真实 Chromium / CDP / Orbit 浏览器冒烟测试
npm run build       # 为两个包生成 lib/

测试套件涵盖单元、运行器集成、真实 Cordis 主机端到端以及真实 Chromium 冒烟测试级别。DeepSeek Orbit 冒烟测试（npm run smoke:deepseek）需要真实模型凭据，不属于默认测试套件。

分发镜像

本仓库是规范的源 monorepo。npm Registry 承载主要发布版本；可安装的 Git 源是生成的发布镜像 KasenRi/dsh-orbit 和 KasenRi/dsh-browser。请勿开发
镜像中的功能。在发布测试和 npm run build 通过后，使用以下命令同步一个明确的稳定版本：

npm run sync:distribution -- 0.5.6 --push

该脚本仅复制每个包的 package.json、cordis.patch.yml、README.md、LICENSE 以及预构建的 lib/。它会更新镜像的 main 分支，并创建一个缺失的包版本标签；普通的开发提交永远不会自动发布到镜像。本仓库 GitHub Releases 中的带版本号的 tarball 仍可用于手动或离线回退。

许可证

MIT