智能体协作舰队 CH4ACKO3/dsh-agent-fleet

dsh-agent-fleet

DeepSeek Harness 的智能体开发协作组件。

Core、Message、Resources、Authorization 提供运行时组件。根包还额外加入持久化的 Team 工作流和 trace 检查。UI 在原生 DSH Web 的新建会话视图里加入内嵌的 Team 入口和启动配置界面。

加载 dsh-agent-fleet 即可安装完整的基础运行时。Core、Message、Resources、Authorization 和连接器网关都是内部模块，随主插件一起打包，不需要单独安装。

安装

让智能体帮你安装

整段安装可以交给一条消息完成。把下面这段发给任何能使用终端、能打开浏览器的智能体：

帮我在这台机器上安装 DeepSeek Harness 和 dsh-agent-fleet 插件。请严格按照 https://github.com/CH4ACKO3/dsh-agent-fleet#installation 的当前说明执行，使用 npm 已发布版本，不要从源码安装，并一并安装该章节推荐的 @ch4acko3/dsh-turn-fold 和 dsh-render-engine 公共渲染插件。
不要使用 headless 模式。缺少兼容的 Node.js 时也请一并安装。完成后启动 web profile，在浏览器中确认 WebUI 可以打开，并检查 Fleet patches 和 the-binding-of-dsh/bidirectional-connection 均为 bound。请持续处理到安装成功或遇到需要我决定的明确阻塞，最后告诉我 WebUI 地址、安装的版本和验证结果。

智能体应当实际执行下面的命令，而不是只描述它们。使用管理员权限前它可以先询问，但普通包安装、创建 profile、启动和验证都不需要询问。模型凭据在 WebUI 里单独配置，安装过程中不要索取或打印。

手动安装

使用 Node.js ^22.22.3 或 >=24.11.1。先装 DeepSeek Harness，再装 Harmony，让 Harmony 接管最终的 dsh 启动器，然后把 Fleet 加入 Web profile：

npm install --global @deepseek-ai/dsh@0.1.1-rc.2
npm install --global dsh-harmony@^0.8.8
dsh plugin --profile web add dsh-agent-fleet@latest --allow-build=dsh-harmony
dsh web

dsh web 会留在前台运行，通常会自动打开浏览器。保持它运行，再从另一个终端验证安装：

dsh --version
dsh --profile web --dump-config
dsh harmony status --json --profile web

WebUI 能打开、解析后的 profile 里包含 dsh-agent-fleet、Harmony 报告 Fleet patches 和 the-binding-of-dsh/bidirectional-connection 均为 bound，就说明安装完成。

Fleet 会把兼容的 Harmony 和 The Binding of DSH（TBOD）包装进 profile。仍然需要单独全局安装 Harmony，因为它的补丁必须在 profile 加载之前运行。

想要推荐的 Web 体验，请安装 dsh-turn-fold 和 dsh-render-engine 里的公共服务插件：

dsh plugin --profile web add @ch4acko3/dsh-turn-fold@latest

for package in \
shiki syntax-highlight code-render markdown-render mermaid-render math-render \
structured-render table-render code-frame-render diff-engine diff-render ansi-render
do
dsh plugin --profile web add "@ch4acko3/dsh-${package}@latest"
done

dsh-turn-fold 提供可见的紧凑轮次 UI。dsh-render-engine 是仓库名，不是已发布的根包；上面的命令安装它已发布的渲染服务，让 Web 插件可以共用语法、Markdown、Mermaid、数学公式、结构化数据、表格、诊断、diff 和终端渲染。

只安装配置档用到的可选集成：

dsh plugin --profile web add @ch4acko3/dsh-agent-fleet-git
dsh plugin --profile web add @ch4acko3/dsh-agent-fleet-lark
dsh plugin --profile web add dsh-agent-fleet-patchouli

除了全局 Harmony 命令，也可以先把 Harmony 装进配置档；下次启动 WebUI 时，在 Harmony 的首次运行对话框里选 Install and restart。dsh plugin ... add 会安装 Fleet，并把它的 bundle 追加到配置档。如果你是用原生 npm/pnpm 装的 Fleet，就在 DSH 的插件设置里启用 dsh-agent-fleet。Fleet 会通过 Harmony 自动激活 TBOD，并复用已启用的 TBOD bundle。

--allow-build 选项只放行配置档里 Harmony 必需的安装器。如果旧版 pnpm 仍报 Ignored build scripts: dsh-harmony，先批准它，再重跑 Fleet 的 add 命令，让 DSH 完成 bundle 追加：

dsh plugin --profile web approve-builds dsh-harmony
dsh plugin --profile web add dsh-agent-fleet@latest --allow-build=dsh-harmony

Harmony 的首次运行门禁会报缺少启动器；Fleet 的插件兼容性元数据会报不可用的包和版本不匹配。Fleet 不会切换到备用传输。

组件

- core — 注册、扁平成员生命周期、控制，以及统一授权。
- resources — Team 资源目录文件、文件/二进制引用，以及建议性工作路径。
- message — Fleet 范围内的私信、Channel、Meeting、Vote，以及共享 Channel 状态。
- authorization — 内置分组、操作权限和资源 keycard，走 Core 的单条授权路径。
- ui — DSH Web 内嵌的 Team 入口和启动配置界面。

Team 工作流

根 bundle 增加生命周期、归档和追踪工具：

- fleet_run create 从调用会话当前工作区里的 JSON 初始化文件创建持久 Team。fleet_run start 向空闲 Team 提交一条 Markdown 工作项。finish 记录该工作的结果，并把同一个 Team 恢复为空闲；close 显式退役 Team 并释放其成员 Session。resume 在进程重启后恢复空闲或运行中的 Team。
- fleet_trace 读取持久 Team 协调时间线，或某个成员的原生 DSH Session 事件。
- fleet_archive export 为已暂停或已关闭的 Team 写出完整归档。成员 Session、消息、 traces 和 Team 资源文件始终包含在内；workspace 文件需要主动选择加入。
fleet_archive import 默认创建一个暂停的副本，并生成新的 Team 和 Session id；要用 import_mode: "restore" 保留归档中的身份，用于灾难恢复。两种模式都能通过 fleet_run resume 继续同一份工作。

下游插件可以通过 ctx.fleetArchives.register({ id, save, restore }) 注册一个归档贡献者。Fleet 在归档内为每个贡献者分配独立目录。目标端未安装的插件，其数据保留在 Team 运行目录下，并报告为不可用的扩展，而不是丢弃。恢复期间，贡献者会收到源 Team 和源 Session id 到导入后 Session id 的映射，这样它们自己的引用就能跟随复制后的 Team。

每个 Team 都在 Fleet 管理的 DSH 存储下写入工作流索引、当前/最近的工作记录，以及跨成员协调事件。<projectRoot>/.fleet/<team-id>/ 只存放真正的 Team 资源文件。完整的成员记录仍保存在配置好的 DSH Session 持久化后端中。因此，创建或恢复 Team 需要 sessionPersistence；Core、Message 和 Resources 不依赖它，仍可独立使用。

初始化格式把 Team 身份和成员放在 core 下，然后把设置按模块 id 存放在 modules 下。Fleet 解析自己的 message、resource 和 UI 块；已安装的插件可以为自己负责的块注册解析器，未安装模块的数据则原样保留。Web 客户端使用对应的注册表来提供可选的设置编辑器和贡献的模板。紧凑结构见 examples/team-config.json。