limuyang2/agent-team

用于 DeepSeek Harness 的 Agent Team

Agent Team — 独立 Agent，共享工作区

npm version
license

当前版本：0.1.4

在 DeepSeek Harness 中构建由独立 AI Agent 组成的团队。混合使用不同模型和提供商，指定一名 Leader，让每个成员在各自的对话中工作，同时共享同一个工作区。

Agent Team 不会将成员变成子 Agent。每个成员都是一个独立的根 Agent，拥有自己的模型、会话、上下文、权限、推理模式和工具活动。团队任务、消息和共享工作区提供了协作层。

Agent Team 工作台

为什么要使用独立 Agent，而不是一个过载的 Agent？

Agent Team 围绕一个简单的理念设计：将专门的工作交给专门的 Agent。

常见的父/子 Agent 工作流会复用或继承父级运行时配置的许多部分。这很方便，但可能让每项任务都携带同样昂贵的模型、宽泛的工具目录和不断增长的上下文。例如，一个小的提交信息任务，可能仍然要通过用于架构和实现的同一个高能力模型来运行。

Agent Team 让每个成员都能拥有明确、专注的配置：

| 关注点 | 常见的父/子 Agent 设置 | Agent Team |
| --- | --- | --- |
| 模型 | 通常复用父模型或一个共享的模型策略 | 为每个成员选择不同的提供商和模型 |
| 技能和 MCP | 宽泛的目录可能被继承或在各处暴露 | 只给每个角色它需要的技能和 MCP 服务器 |
| 上下文 | 规划、执行、工具输出和结果会累积在一起 | 每个成员都有隔离的会话和上下文窗口 |
| 成本 | 简单工作可能仍然消耗昂贵的通用模型 | 将常规工作路由到更小或专门的模型 |
| 权限 | 一个宽泛的权限策略可能扩散到整个工作流 | 为每个成员设置最小权限默认值和运行时权限 |

这种分离让 Leader 专注于规划和验证，让专家专注于执行，减少无关的工具选择，并防止一个 Agent 的上下文随着整个团队产生的每个细节而增长。成员通过显式发送任务、进度和结果来协作，而不是共享一个不断扩大的对话。

子 Agent 的行为因框架而异。上述比较描述的是常见的父级继承模式；Agent Team 的优势在于，模型、工具、权限和上下文隔离都是每个成员在产品层面上的明确选择。

示例：为每项工作使用合适的模型

考虑一个由三名专业成员组成的软件开发团队：

| 角色 | 模型 | 专注的配置 |
| --- | --- | --- |
| 架构负责人 | GPT | 理解需求、设计解决方案、拆分工作、协调成员并验证结果 |
| 编码智能体 | GLM | 加载编码技能和开发 MCP 工具、修改工作区并运行测试 |
| 提交助手 | DeepSeek Flash | 读取 Git 状态和差异，然后以只读权限生成 Conventional Commit 消息 |

GPT 负责人将上下文用于决策和验证，而不是每个实现细节。GLM 接收代码库上下文和执行所需的工具。DeepSeek Flash 快速处理范围狭窄的提交任务，无需为负责人的更高能力模型付费，也无需加载编码智能体庞大的工具目录。

协作流程是明确的：

用户目标 → GPT 负责人规划并分配工作
→ GLM 编码智能体实现并报告测试结果
→ GPT 负责人验证结果
→ DeepSeek Flash 提交助手总结 Git 差异

你可以做什么

- 为规划、编码、测试、审查、文档或任何其他角色创建可复用的助手。
- 在一个团队中混合使用不同提供商和模型——例如，一个 Codex 负责人搭配 GLM 编码成员。
- 手动创建助手，或向内置的团队智能体助手描述一个角色。
- 多次添加同一个助手；每次选择都会成为一个独立的团队成员。
- 并排查看所有成员，支持流式输出、Markdown、思考块和工具调用。
- 让负责人创建任务、分配成员、跟踪进度并收集结果。
- 直接向负责人发送消息，或在启用时向普通成员发送消息。
- 为当前会话更改成员的权限预设和推理模式。
- 查看已加载的技能、上下文使用情况、token 统计信息和缓存命中率。
- 浏览共享工作区文件并预览 Git 变更和差异。
- 添加或移除成员、更换负责人、重置所有上下文或解散团队。

截图

通过对话创建助手

描述你需要的角色。内置助手会收集缺失的设置、准备长期指令，并仅在你确认后创建助手。

通过对话创建助手

可复用助手库

在设置 → 智能体团队下管理助手。每个助手可以使用不同的提供商、模型、预设、默认权限、推理模式、技能、MCP 服务器和角色指令。

技能和 MCP 范围： 智能体团队使用通过标准 DeepSeek Harness 接口暴露的技能和 MCP 服务器。此插件不提供技能或 MCP 服务器的安装、更新或生命周期管理。请先安装相应的 Harness 插件来管理这些资源；智能体团队仅允许助手选择并使用当前配置文件中已可用的资源。

助手库

组建团队
选择成员，指定恰好一名 Leader，选择一个 Workspace，并决定是否允许与普通成员直接通信。

组建团队

浮动团队启动器

一个紧凑的浮动按钮可打开全屏 Team 工作台，而不会与其他 Harness 客户端的侧边栏扩展产生冲突。将鼠标悬停在其上或拖动它以显示标签。将其拖放到屏幕任一边缘即可向该边缘收起；最后的位置会在本地被记住。从工作台导航器中创建团队并在它们之间切换。

浮动团队启动器

要求

- Node.js 22.19.0+ 或 24.0.0+
- DeepSeek Harness 0.1.1-rc.2
- pnpm 在 PATH 中可用（Harness 使用它来管理 Profile 插件）

如有必要，安装 pnpm：

npm install -g pnpm

安装

DeepSeek Harness Web

将 Agent Team 安装到 Harness 的 web Profile 中：

npx @deepseek-ai/dsh plugin --profile web add @limuyang2/dsh-agent-team

启动 Harness：

npx @deepseek-ai/dsh web

打开 Harness 打印的 URL，通常为 。安装或替换插件后请重启 Harness。

DeepSeek Harness Desktop

将确切的 Agent Team 版本安装到由 DeepSeek Harness Desktop 管理的 Profile 中：

dsh plugin add --save-exact @limuyang2/dsh-agent-team@0.1.4

命令完成后，退出并重新打开 DeepSeek Harness Desktop。--save-exact 会将 Desktop Profile 固定到经过测试的插件版本，而不是自动迁移到更新的版本。

卸载

使用 Ctrl+C 停止 Harness，然后从 web Profile 中移除 Agent Team：

npx @deepseek-ai/dsh plugin --profile web remove @limuyang2/dsh-agent-team

命令完成后重启 Harness。移除插件不会修改 DeepSeek Harness 源代码，也不会从你的团队 Workspace 中删除文件。

快速开始

1. 在 Harness 中配置模型

首先在 Harness 中配置你想使用的提供商、模型和凭据。Agent Team 从当前活动的 Profile 读取模型目录，并且从不存储提供商 API 密钥。

提示：为 GLM-5.3 启用 Thinking Mode

将以下配置添加到 ~/.dsh/settings.yaml。它会公开 GLM-5.3 可用的推理级别，并将 high 设置为 Provider 默认值：

llm-pi-ai:
providers:
zai-coding-cn:
reasoning: high
modelOverrides:
glm-5.3:
reasoningEfforts:
off:
minimal: minimal
low: low
medium: medium
high: high
xhigh: xhigh
max: max
compat:
thinkingFormat: zai
supportsReasoningEffort: true

将此块合并到现有的 llm-pi-ai 部分，而不是再添加一个。如果你的 ZAI Provider 使用不同的 ID，请替换 zai-coding-cn。重启 Harness，然后从助手对话工具栏中选择所需的 Thinking Mode；该运行时选择会覆盖该对话的 Provider 默认值。

2. 创建助手

打开 Settings → Agent Team，然后选择以下之一：

- Start Conversation，通过聊天设计一个助手。
- Create Manually，直接配置所有字段。

一个实用的初始团队通常包含：

- 一个 Leader，负责理解目标、规划工作、委派任务并验证结果。
- 一个或多个 成员，专注于实现、测试、审查或文档。

3. 创建团队

点击浮动的 Team 按钮，然后在工作台导航器中点击 +：

1. 从列表中添加助手。你可以多次添加同一个助手。
2. 选择恰好一名成员作为 Leader。
3. 输入团队名称并选择一个 Workspace。
4. 选择用户是否可以直接与普通成员聊天。
5. 点击 Create and Start。

团队会自动启动，并在全屏工作台中打开。

4. 给 Leader 一个目标

将完整目标发送给 Leader。Leader 可以将其拆分为任务、分配成员、接收进度更新并验证最终输出。当团队策略允许时，你也可以直接与单个成员交谈。

工作台指南

每个可见列都是一个真实、独立的 Harness 会话。

- 成员标签页： 显示或隐藏对话。将鼠标悬停在非 Leader 标签页上可移除该成员。
- 对话标题栏： 显示角色、provider、model、reasoning mode 和实时状态。双击可放大对话。
- Composer： 发送消息；输入 / 调用允许的 Skill；输入 @ 搜索并提及 Workspace 文件；附加本地文件、停止生成并更改运行时设置。
- Permission： 应用于所选成员的当前会话。助手模板仅提供初始默认值。
- Reasoning mode： 从下一轮开始应用，并且仅显示所选模型支持的选项。
- Info： 显示为该成员加载的 Skills。
- Context ring： 显示上下文使用量、输入/输出 token 和缓存命中率。
- Workspace： 浏览文件、手动刷新、监视文件更改并预览 Git diff。

团队协作

Leader 和成员通过明确的团队工具和消息进行沟通：

- Leader 创建任务并将其分配给成员实例。
- 被分配的成员在自己的会话中接收任务。
- 成员报告运行中、已完成或失败状态及结果。
- 状态和结果更新会自动送达 Leader。
- 当需要澄清时，成员可以发送直接的团队消息。
- 成员变更会以稳定的成员 ID 送达 Leader。
成员共享一个 Workspace，但不共享对话历史。这样可以让角色和模型上下文保持隔离，同时允许他们处理相同的文件。

团队管理

- 添加成员： 从助手快照启动一个新的独立成员，并通知 Leader。
- 移除成员： 停止并归档该成员的会话，将其从团队中移除，并通知 Leader。
- 更换 Leader： 更改角色，但不替换成员当前的会话。
- 清除任务和上下文： 停止所有成员，清除团队任务和排队消息，并为每个剩余成员分配一个新会话。团队设置和 Workspace 文件保持不变。
- 解散团队： 永久移除团队、其任务和团队消息。助手模板和 Workspace 文件不会被删除。

当成员加入团队时，助手设置会被快照保存。之后编辑助手不会热更新现有成员；请先移除该成员再重新添加，以应用新配置。

重要行为

- 助手的权限设置只是成员的初始默认值。
- 推理选项来自 Harness 模型能力；插件不会凭空创造不受支持的选项。
- MCP 凭据保留在 Harness Profile 中。助手模板只存储允许的服务器名称。
- 从 Workspace 外部选择的文件会被复制到 .agent-team/uploads/，以便智能体可靠地访问它们。
- Changes 视图需要 Git Workspace。普通文件夹仍支持文件浏览。
- Harness 目前没有用于物理删除单个会话日志的公开 API。已重置或已解散的会话不再由 Agent Team 恢复或使用，但旧日志可能仍保留在 Harness 存储中。

故障排除

pnpm not found on PATH

运行 npm install -g pnpm，验证 pnpm --version，然后重新安装插件。

端口 3080 已被占用

另一个 Harness 进程已在运行。使用 Ctrl+C 停止旧进程，然后再次运行 npx @deepseek-ai/dsh web。

缺少某个模型或推理选项

刷新助手目录，并在 Harness 中验证模型配置。只有当提供商报告该能力时，推理模式才会出现。

无法删除某个助手

该助手仍被某个团队成员引用。请先移除这些成员或解散相关团队。

未显示任何 Git 更改

确认所选 Workspace 本身就是一个 Git 仓库。嵌套在非 Git Workspace 内的仓库不会被视为该 Workspace 的仓库。

用户文档

详细的用户指南提供中文版本：

- 文档索引
- 安装与启动
- 助手库
- 创建团队
- 工作台与协作
- Workspace 与 Git 更改
- 团队管理
- 故障排除
链接

- npm 包
- GitHub 仓库
- 问题追踪

许可证

MIT