limuyang2/agent-team

DeepSeek Harness Agent Team

English | 简体中文

当前版本：0.1.4

在 DeepSeek Harness 中组建由多个独立 AI Agent 构成的团队。你可以混用不同模型和 Provider，指定唯一 Leader，让每位成员拥有独立对话和上下文，同时在同一个 Workspace 中协作。

Agent Team 不是 Subagent 方案。每位成员都是独立的根级 Agent，拥有自己的模型、Session、上下文、权限、思考模式和工具调用；团队任务、消息和共享 Workspace 构成协作层。

为什么选择独立 Agent 团队

Agent Team 的核心理念是：专业的事情交给专业的 Agent 做。

常见的父 Agent / Subagent 工作流会复用或继承较多父级运行配置。这样虽然方便，却容易让每个任务都携带同一套高成本模型、庞大工具目录和不断增长的上下文。例如，只是生成一条提交信息，也可能继续使用负责架构规划和复杂编码的高等级模型，造成不必要的成本。

Agent Team 允许为每位成员设置明确、专注的配置：

这种隔离让 Leader 专注规划和验收，让专业成员专注执行；既减少无关工具选择和提示词负担，也避免整个团队的细节全部挤入单个 Agent，缓解上下文爆炸。成员之间只显式传递任务、进度和结果，不共享一份无限膨胀的对话历史。

不同框架的 Subagent 行为并不完全相同。上面的对比针对常见的父级配置继承模式；Agent Team 的优势是把每位成员的模型、工具、权限和上下文隔离做成明确的产品能力。

示例：让合适的模型负责合适的任务

例如，可以组建一个包含三位专业成员的软件开发团队：

GPT Leader 的上下文只保留关键决策、任务状态和验收结果，不必塞入所有编码细节；GLM 获取代码执行所需的仓库上下文和工具；DeepSeek Flash 快速处理范围明确的 Commit 任务，无需继续消耗 Leader 的高等级模型，也不必加载编码 Agent 的庞大工具目录。

完整协作链路是显式的：

用户目标 → GPT Leader 规划并分派任务
        → GLM 编码 Agent 实现并回报测试结果
        → GPT Leader 验收产出
        → DeepSeek Flash Commit 助手根据 Git Diff 生成提交信息

你可以做什么

• 创建用于规划、编码、测试、评审、文档等职责的可复用助手。
• 在一个团队中混用不同 Provider 和模型，例如 Codex Leader 配合 GLM 编码成员。
• 手动创建助手，或向内置的“团队 Agent 小助手”描述角色，由它协助生成配置。
• 多次添加同一个助手，每次都会成为独立的团队成员实例。
• 并排查看所有成员的流式输出、Markdown、Think 和工具调用。
• 让 Leader 创建任务、分派成员、跟踪进度并收集结果。
• 与 Leader 直接沟通；启用对应策略后，也可直接与普通成员沟通。
• 在运行时调整单个成员当前 Session 的权限和思考模式。
• 查看已加载 Skills、上下文占用、Token 统计和缓存命中率。
• 浏览共享 Workspace，并预览 Git 文件变更和 Diff。
• 动态添加或移出成员、更换 Leader、清空全部上下文或解散团队。

界面预览

通过对话创建助手

描述你需要的角色。内置小助手会补充询问必要配置、整理长期指令，并在你确认后创建助手。

可复用助手库

在 设置 → Agent 团队 中管理助手。每个助手可独立配置 Provider、模型、Agent Preset、默认权限、思考模式、Skills、MCP Servers 和角色规则。

Skills 与 MCP 能力边界： Agent Team 使用 DeepSeek Harness 标准接口提供的 Skills 和 MCP Servers。本插件不提供 Skills 或 MCP Servers 的安装、更新及生命周期管理能力。请先安装相应的 Harness 插件来管理这些资源；Agent Team 只负责让助手选择并使用当前 Profile 中已经可用的资源。

组建团队

选择成员、指定唯一 Leader、选择 Workspace，并决定是否允许用户直接与普通成员通信。

悬浮团队入口

紧凑的悬浮按钮用于打开全屏团队工作台，不会与其他 Harness 客户端的侧边栏扩展争抢位置。鼠标悬停或拖动时会展开文字；拖到屏幕左右边缘并松开后，按钮会朝对应边缘收起，并在本地记住最后位置。团队创建和切换统一在工作台导航栏中完成。

环境要求

• Node.js 22.19.0+ 或 24.0.0+
• DeepSeek Harness 0.1.1-rc.2
• 终端中可以使用 pnpm（Harness 使用它管理 Profile 插件）

如果尚未安装 pnpm：

npm install -g pnpm

安装

DeepSeek Harness Web

将插件安装到 Harness 的 web Profile：

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

启动 Harness：

npx @deepseek-ai/dsh web

打开终端输出的地址，通常是 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 固定到经过验证的插件版本，避免自动升级到后续版本。

卸载

先在运行 Harness 的终端按 Ctrl+C 停止服务，再从 web Profile 中移除 Agent Team：

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

命令完成后重新启动 Harness。卸载插件不会修改 DeepSeek Harness 源码，也不会删除团队 Workspace 中的文件。

快速开始

1. 在 Harness 中准备模型

先配置需要使用的 Provider、模型和凭据。Agent Team 读取当前 Profile 的模型目录，不保存 Provider API Key。

Tips：为 GLM-5.3 开启思考模式

将下面的配置加入 ~/.dsh/settings.yaml。它会为 GLM-5.3 声明可选的思考档位，并把 Provider 默认档位设为 high：

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，请替换为实际 ID。重启 Harness 后，可在助手对话工具栏的 思考模式 中选择档位；对话中的选择会覆盖 Provider 默认值。

2. 创建助手

进入 设置 → Agent 团队，选择：

• 开始对话：通过聊天设计助手。
• 手动新建：直接填写完整配置。

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

• 一个 Leader：理解目标、规划工作、分派成员并验收结果。
• 一个或多个 成员：分别负责编码、测试、评审或文档。

3. 组建团队

点击页面左侧的悬浮 团队 按钮，再点击工作台导航栏中的 +：

1. 从助手列表添加成员；同一助手可以添加多次。
2. 指定且仅指定一个 Leader。
3. 输入团队名称并选择 Workspace。
4. 选择是否允许用户直接与普通成员通信。
5. 点击 创建并启动。

创建成功后，团队会自动启动并进入全屏工作台。

4. 向 Leader 描述目标

把完整目标发送给 Leader。Leader 可以拆分任务、分派成员、接收进度并验收最终产出。团队策略允许时，你也可以直接与某个普通成员沟通。

工作台说明

每一列都是一个真实、独立的 Harness Session。

• 成员标签：控制对话列的显示与隐藏；鼠标悬停在非 Leader 标签上可以移出成员。
• 对话标题：展示角色、Provider、模型、思考模式和实时状态；双击可以放大该成员对话。
• 输入框：发送消息；输入 / 调用当前成员允许的 Skill；输入 @ 搜索并引用 Workspace 文件；也可上传本地文件、停止输出和修改运行配置。
• 权限：只影响当前成员的当前 Session；助手模板仅提供初始默认值。
• 思考模式：从下一轮开始生效，只展示当前模型支持的档位。
• Info：查看成员当前加载的 Skills。
• 上下文圆环：查看上下文占用、输入/输出 Token 和缓存命中率。
• Workspace：浏览文件、手动刷新、自动跟踪文件变化并预览 Git Diff。

Agent 如何协作

Leader 和成员通过明确的团队工具与消息通信：

• Leader 创建任务并分派给具体成员实例。
• 成员在自己的 Session 中收到任务。
• 成员回报执行中、已完成或失败状态，并附带结果。
• 进度和结果会自动通知 Leader。
• 需要澄清时，成员可以发送团队消息。
• 成员加入或移出会携带稳定成员 ID 通知 Leader。

成员共享 Workspace，但不共享聊天上下文。这样既能在同一份文件上工作，又能保持角色和模型上下文相互隔离。

团队管理

• 添加成员：基于助手快照启动新的独立成员，并通知 Leader。
• 移出成员：停止并归档该成员 Session，从团队中移除并通知 Leader。
• 更换 Leader：只变更团队角色，不替换成员当前 Session。
• 清空任务与上下文：停止所有成员，清空任务和排队消息，为所有保留成员换用全新 Session；团队配置和 Workspace 文件不变。
• 解散团队：永久删除团队、任务和团队消息，但不会删除助手模板或 Workspace 文件。

助手加入团队时会生成配置快照。之后编辑助手不会热更新已经运行的成员；要应用新配置，需要移出旧成员并重新添加。

重要行为

• 助手模板中的权限只是成员首次启动的默认权限。
• 思考模式来源于 Harness 返回的模型能力，插件不会伪造模型不支持的参数。
• MCP 凭据保留在 Harness Profile 中，助手模板只保存允许使用的 Server 名称。
• 从 Workspace 外选择的文件会复制到 .agent-team/uploads/，确保 Agent 可以稳定读取。
• “变更”页签要求 Workspace 本身是 Git 仓库，普通目录仍可浏览文件。
• Harness 当前没有物理删除单个 Session 日志的公开 API。清空或解散后的旧 Session 不再由 Agent Team 恢复或使用，但日志可能继续保留在 Harness 存储中。

常见问题

提示 pnpm not found on PATH

执行 npm install -g pnpm，确认 pnpm --version 能正常输出后，重新安装插件。

端口 3080 已被占用

已有 Harness 进程正在运行。在旧终端按 Ctrl+C 停止，然后重新执行 npx @deepseek-ai/dsh web。

找不到模型或思考模式

刷新助手目录并检查 Harness 模型配置。只有 Provider 声明对应能力时，插件才会展示思考模式档位。

助手无法删除

该助手仍被团队成员引用。先移出对应成员或解散相关团队。

没有显示 Git 变更

确认所选 Workspace 本身就是 Git 仓库。位于普通 Workspace 子目录中的仓库不会被当作 Workspace 仓库。

用户文档

• 文档首页
• 安装与启动
• 助手库
• 创建团队
• 工作台与协作
• Workspace 与 Git 变更
• 团队管理
• 故障排查

相关链接

• npm 包
• GitHub 仓库
• 问题反馈

License

MIT