dsh-supervisor

English | 中文

DeepSeek Harness 的社区控制面插件。它提供可替换的 ctx.fleet 服务，用于观察和控制同一个 dsh 进程中的 live Session，而不是再实现一套 Agent runtime。

状态：Service Preview（L0 + L1）。 Fleet 服务已经实现并通过测试，但模型可调用的 fleet_* 工具尚未提供。

这是独立的社区项目，与 DeepSeek AI 不存在隶属或官方背书关系。

设计

DeepSeek Harness 把能力设计成可热替换的插件缝。本项目遵循相同结构：

FleetService                  Service Definition（ctx.fleet）
InProcessFleetProvider        默认 Provider（ctx.agents）
fleet_* tools                 计划中的 Consumer（L2）
supervisor preset / transport 计划中的 Consumer（L3+）

本插件不替换已有的 subagent 或 workflow runtime：

• delegated Session 的继续写入和中断属于 ctx.subagents；
• 编排属于 ctx.workflowEngine；
• Fleet 只补当前进程的 live Session 观察和有限 root 控制。

完整约束见 docs/architecture.md。

当前能力

ctx.fleet 当前提供：

• list() — 列出当前进程的 live Agent；
• inspect() — 返回有限且 JSON-safe 的对话摘要；
• send() — 给 live root Agent 排入 plugin-source follow-up；
• steer() — 转向 live root Agent；
• cancel() — 使用稳定 Fleet 原因取消 live root Agent；
• subscribe() — 观察投影后的 created/status/disposed 事件。

L1 会正确分类 delegated Agent，但不会写入它们。Provider 不会绕过 ctx.subagents 直接调用 child Agent 方法，也会拒绝调用方控制自己。

API、配置和错误码见 docs/reference/fleet.md。

运行要求

• Node.js ^22.19.0 或 >=24.0.0
• 仓库开发使用 pnpm 11.7.0
• @deepseek-ai/dsh@0.1.0-rc.6

第一条发布线不承诺跨 DSH release candidate 兼容。

安装

目前尚未发布 npm 包。请使用本地 checkout，或固定 commit 的 GitHub 源安装。

本地 checkout

git clone https://github.com/Wha1eChai/dsh-supervisor.git
cd dsh-supervisor
pnpm install
pnpm run build

dsh plugin --profile web add /absolute/path/to/dsh-supervisor
dsh --profile web --dump-config
dsh --profile web