智能体团队 limuyang2/agent-team

DeepSeek Harness 智能体团队

Agent Team — Independent Agents, Shared Workspace

当前版本：0.1.4

在 DeepSeek Harness 里组建独立 AI 智能体团队。混用不同模型和服务商，指定一名 Leader，每个成员都在自己的会话里干活，同时共用同一个 Workspace。

Agent Team 并不会把成员变成子代理。每个成员都是独立的根智能体，有自己的模型、会话、上下文、权限、推理模式和工具活动。团队任务、消息和共享 Workspace 构成协作层。

Agent Team workbench

为什么要用独立智能体，而不是一个过载的智能体？

Agent Team 围绕一个简单的想法设计：把专门的工作交给专门的智能体。

常见的父/子代理工作流会复用或继承父级运行时的大部分配置。这很方便，但会让每个任务都背上同样昂贵的模型、宽泛的工具目录和不断膨胀的上下文。比如一个写 commit message 的小任务，可能还是走那套用于架构和实现的高能力模型。

Agent Team 让每个成员都有明确、聚焦的配置：

| 关注点 | 常见的父/子代理方案 | Agent Team |
| 模型 | 往往复用父级模型，或共用一套模型策略 | 每个成员都能选不同的服务商和模型 |
| 技能与 MCP | 宽泛的目录可能被继承，或在各处暴露 | 每个角色只拿到自己需要的技能和 MCP 服务器 |
| 上下文 | 规划、执行、工具输出和结果堆在一起 | 每个成员都有独立的会话和上下文窗口 |
| 成本 | 简单工作也可能消耗昂贵的通用模型 | 把日常事务交给更小或更专门的模型 |
| 权限 | 一套宽泛的权限策略会扩散到整个工作流 | 按成员设置最小权限默认值和运行时权限 |

这样分工，Leader 能专注规划和验证，专家专注执行，无关的工具选项更少，也不会因为整个团队产出的每个细节而让某个智能体的上下文不断膨胀。成员之间显式发送任务、进度和结果，而不是共享一段越滚越大的对话。

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

示例：给每项工作配对的模型

设想一个软件开发团队，有三名专门的成员：

| 角色 | 模型 | 聚焦配置 |
| Architecture Leader | GPT | 理解需求、设计方案、拆分工作、协调成员、验证结果 |
| Coding Agent | GLM | 加载编码技能和开发 MCP 工具、修改工作区、运行测试 |
| Commit Assistant | DeepSeek Flash | 读取 Git 状态和 diff，生成 Conventional Commit 消息，只有只读权限 |

GPT Leader 把上下文花在决策和验证上，而不是每个实现细节。GLM 拿到代码库上下文和执行所需的工具。DeepSeek Flash 快速处理范围很窄的提交任务，不必为 Leader 那更强能力的模型付费，也不用加载编码智能体庞大的工具目录。

协作流程很明确：

User goal → GPT Leader plans and assigns work
→ GLM Coding Agent implements and reports test results
→ GPT Leader verifies the result
→ DeepSeek Flash Commit Assistant summarizes the Git diff

你能做什么

- 创建可复用的助手，用于规划、编码、测试、评审、文档，或任何其他角色。
- 在一个团队里混用服务商和模型——比如 Codex Leader 搭配 GLM 编码成员。
- 手动创建助手，或者向内置的 Team Agent Assistant 描述一个角色。
- 同一个助手可以添加多次；每次选择都会成为一个独立的团队成员。
- 并排查看所有成员，支持流式输出、Markdown、Think 块和工具调用。
- 让 Leader 创建任务、分配成员、跟踪进度、收集结果。
- 直接给 Leader 发消息，启用后也可以给普通成员发。
- 为当前会话修改成员的权限预设和推理模式。
- 查看已加载的技能、上下文用量、token 统计和缓存命中率。
- 浏览共享工作区文件，预览 Git 变更和 diff。
- 添加或移除成员、更换 Leader、重置所有上下文，或解散团队。

截图

通过对话创建助手

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

Create an assistant by conversation

可复用的助手库

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

技能和 MCP 范围： Agent Team 使用通过标准 DeepSeek Harness 接口暴露的技能和 MCP 服务器。本插件不提供技能或 MCP 服务器的安装、更新或生命周期管理。请先安装相应的 Harness 插件来管理这些资源；Agent Team 只让助手选择并使用当前配置档中已有的资源。

Assistant library

组建团队

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

组建团队

悬浮团队启动器

一个紧凑的悬浮按钮，点开即可进入全屏 Team 工作台，不会和其他 Harness 客户端的侧边栏扩展抢位置。悬停或拖动它可显示标签。把它拖到屏幕任意一侧边缘，就会收拢到该侧；最后的位置会保存在本地。在工作台导航器中可以创建团队并在团队之间切换。

悬浮团队启动器

环境要求

- Node.js 22.19.0+ 或 24.0.0+
- DeepSeek Harness 0.1.1-rc.2
- PATH 中可用 pnpm（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，通常是 <http://127.0.0.1:3080/>。安装或替换插件后请重启 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 标签页上，可以移除该成员。
- 会话标题栏： 显示角色、服务商、模型、推理模式和实时状态。双击可放大对话。
- 输入区： 发送消息；输入 / 调用允许的技能；输入 @ 搜索并提及 Workspace 文件；附加本地文件、停止生成、修改运行时设置。
- Permission： 作用于所选成员的当前会话。助手模板只提供初始默认值。
- Reasoning mode： 从下一轮开始生效，只显示所选模型支持的选项。
- Info： 显示该成员已加载的技能。
- 上下文环： 显示上下文用量、输入/输出 token 和缓存命中率。
- Workspace： 浏览文件、手动刷新、监听文件变化、预览 Git 差异。

团队协作

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