Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Agent Teams spin up a reviewer teammate to check the README for typos, then report back"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
把「Lead + 多个 teammate」的协作方式带进 ZCode：Lead 在会话里创建队友、共享任务板、收发消息，并用 MCP Apps 面板实时看到团队状态。
适用：需要并行拆活、希望把实现/审查/测试分给不同成员，或想把一段多步工作交给可复用的成员协作。
角色：Lead = 当前会话（你正在对话的 agent）；teammate = 插件创建的独立子会话，与 Lead 共享同一工作目录。
载体：桌面 = 「智能体团队」MCP Apps 面板（实时）；CLI = /team 文本摘要 + team-ctl 工具（可生成静态卡片）。
宿主基线：本插件在 ZCode Desktop 3.16.2 / CLI 0.17.0 上完成终验（实测基线，非推测）；发布演练另在 Desktop 3.16.3 / CLI 0.17.0 复测通过。更低版本未验证，不在支持范围内。
打开 插件市场 / Plugin Marketplace。
点 添加 / Add → 添加插件市场 / Add Plugin Marketplace。
粘贴或选择市场根目录（含 marketplace.json 的那一层，不是插件子目录），点 添加。
切到 个人 / Personal，找到「智能体团队 / Agent Teams」，点 安装。
安装后可在 设置 → 插件 / Settings → Plugins 中确认与启用。
zcode plugins marketplace add /path/to/market-root # 市场根目录（含 marketplace.json）
zcode plugins install agent-team@agent-team-release # 换成你的市场名
zcode plugins enable agent-team@agent-team-releaseRelated MCP server: multi-agents
安装后默认启用；在 设置 → 插件 里可查看开关与配置。
插件声明的 SessionStart / Stop / UserPromptSubmit hooks 随启用直接生效，不需要信任授予或 hooks 开关（已在干净环境实测）。
桌面默认权限模式下，agent-team 的 MCP 工具首次调用会弹「需要权限」确认；选择「允许（仅本次）」或「始终允许本项目」即可。这是宿主的工具权限，与 hook 无关。
装好、启用后不需要任何专门命令：团队协作策略已由 SessionStart hook 自动注入会话上下文（D10），在新任务里直接对话即可。共有三个调用面，按需取用：
调用面 | 怎么触发 | 干什么 |
自然语言对话（主通道） | 直接说目标 / 下指令 | 创建队友、分派任务、收发消息等全部操作；策略已自动注入，模型自己知道该用哪些团队工具 |
| 会话里输入 | 输出团队状态文本摘要 + 面板/命令入口（只读，不创建/修改任何数据） |
| 输入 | 手动（重新）加载团队协作策略 skill；长会话策略丢失后恢复用 |
新建一个任务（必须是新任务——旧任务不会刷新插件能力），直接描述目标即可。默认 leadMode: orchestrator 下 Lead 会自主拆活、组队、分派并独立验收，不需要逐条指挥：
帮我并行推进两件事：一边给 src/utils 补单元测试，一边审查 README 与 CHANGELOG 的措辞，完成后汇总。Lead 的动作链：创建队友 → 在共享任务板建任务并指定 owner → 等待各成员完成 → 独立复核（读 diff、跑测试）→ 验收通过后汇总给你（D26/D27）。
把 leadMode 配置为 collaborator 后 Lead 等你指示再建队；任何时候想精确控制，也直接下指令：
创建一个叫 reviewer 的队友，让它检查 README 前三段的错别字，然后汇总它的结论。给 reviewer 发个消息：重点看中英文标点混用。列一下现在的成员和任务状态。模型会把这些话术映射到对应工具（spawn_teammate / send_message / list_agents / team_task_list …），你不需要记工具名。
/team 看状态会话里随时输入 /team：首行输出「成员 N · 共享任务 T」，随后逐行列出成员与任务（与面板词典同源同文案），并按运行环境附上面板/命令入口。刷新语义：桌面 MCP Apps 面板自动实时（订阅推送，无需手动刷新）；CLI 每次重跑 /team 即最新。
/team-coordination 重载策略策略的主通道是 hook 自动注入，通常无需手动加载。两种情况会用到这个 skill：
超长会话中注入的策略可能被上下文压缩掉（D24）：输入 /team-coordination（或让模型「重新加载团队策略 skill」）即可恢复；
想确认当前会话按团队纪律工作时，也可以点名加载。
以「创建 reviewer 检查 README 错别字」为例：
会话里出现「智能体团队」面板（spawn_teammate 的结果携带面板打开提示，桌面上会定向打开），成员区显示 lead（当前会话）与 reviewer；
reviewer 创建并开始工作，面板/任务板出现任务与状态变化；
reviewer 完成后向 Lead 汇报，Lead（orchestrator 下先独立复核）汇总给你；
reviewer 的会话是隐藏子会话，不会和 Lead 平级出现在左侧任务栏。
interrupt:false 时 8 个）工具 | 谁用 | 作用 |
| Lead | 创建一个有名字的持久队友（ |
| 全体 | 给另一个成员发消息：运行中在最近回合边界送达；空闲则拉起/恢复一轮 |
| 全体 | 列出 Lead 与全部队友的 target 与可用状态（ |
| Lead | 中断一个队友当前回合，保留其待处理收件箱（配置关闭时此工具不注册 → 8 个） |
| Lead | 等待下一次成员/消息/任务变化（不会唤醒空闲成员；超时返回 noProgress） |
| 全体 | 在共享任务板创建一条未分配任务（可带 |
| 全体 | 列出任务：状态、owner、revision、阻塞、写作用域告警（可分页/过滤） |
| 全体 | 读取单条任务的最新完整内容（改动前必读） |
| 全体 | 用 |
另有一个 app 专用回环工具 team_panel_call（面板心跳/刷新/详情，模型不可见）；诊断探针 team_ping 仅在 TEAM_DEBUG_TOOLS=1 时暴露。
在 设置 → 插件 → 智能体团队 中修改，改完对新任务生效（进行中的会话沿用启动时配置）。
配置 | 默认 | 说明 |
| 8 | 团队内 teammate 数量上限（不含 Lead，含 failed） |
| 256 | 任务板任务数量上限 |
| 65536 | 成员间单条消息的最大字节数 |
| 5000 | 团队处置（结算与回收）的超时时间 |
| true | 关闭后模型只拿到 8 个工具（ |
| orchestrator |
|
# /team 命令：输出团队状态文本摘要（桌面/CLI 均可用）
/team
# 直接读盘重放（与 /team 同源）
node <插件目录>/dist/team-ctl.mjs state <teamDir> # 文本摘要
node <插件目录>/dist/team-ctl.mjs state <teamDir> --json # 机器可读
node <插件目录>/dist/team-ctl.mjs transcript <teamDir> <member> # 成员会话查看流
node <插件目录>/dist/team-ctl.mjs widget <teamDir> --standalone --out /tmp/team.html --theme dark --lang zh
node <插件目录>/dist/team-ctl.mjs tail <teamDir> # 跟随事件日志<teamDir> = $ZCODE_PLUGIN_DATA/teams/<session_id>（CLI 下通常是 ~/.zcode/cli/plugins/data/agent-team@<market>/teams/…）。
daemon、hooks 与 team-ctl 都由 Node 运行，要求 Node ≥ 22。安装前自检：
node -v输出应为 v22.x 或更高。低于 v22 时 daemon 启动自检会给出警告，面板与工具可能不可用；插件会把实际版本写进 $ZCODE_PLUGIN_DATA/logs/daemon-lifecycle.jsonl（字段 node、nodeWarn）。
先备份，再卸载。默认卸载会删除团队数据且不可撤销。
# 1) 找到插件数据目录（安装时的 dataPath；也可从 plugins list --json 读取）
DATA="$HOME/.zcode/cli/plugins/data/agent-team@<market>"
# 2) 备份（保留任务板、成员、消息、事件日志）
tar -czf ~/agent-team-backup-$(date +%Y%m%d).tar.gz -C "$(dirname "$DATA")" "$(basename "$DATA")"实测行为（2026-10-24 干净环境演练）：
入口 | 默认卸载 | 可否保留数据 |
CLI |
| 可： |
桌面 | 设置 → 插件 → 更多操作 → 卸载，确认框明确提示删除缓存、数据目录与配置；实测删除数据目录内容（空目录保留），当前版本缓存删除 | 无 UI 等价选项 |
注意：卸载时仍打开的相关任务窗口，后续活动会在原路径重建一个空的数据骨架（events.jsonl 为 0 字节），原团队数据不会恢复；不要因为目录又出现而误判为“数据还在”。卸载后建议关闭相关任务窗口。
zcode plugins list | grep agent-team
zcode plugins list --json # 看 version / rootPath / dataPath / diagnostics桌面：设置 → 插件 中确认「智能体团队」开关为启用；设置 → 钩子 可看到它声明的三条 hook。
文件 | 内容 |
| 每次 SessionStart / Stop / UserPromptSubmit 的完整 env overlay 与输入摘要——判断 hook 有没有跑就看这里 |
| daemon 启动/回收：pid、node 版本、数据目录、 |
| teammate 轮次与投递细节（排障用） |
| 工具调用与面板回环记录 |
| daemon 落盘的有效配置（hook 读取同一份） |
| 团队事件日志（append-only； |
| 协调者锁获取/释放/接任审计 |
确认插件已启用（禁用状态下 hook 不会运行）；
打开一个新会话，然后看 logs/hooks.jsonl 是否新增 sessionstart 记录；
没有记录 → 看 设置 → 钩子 是否列出三条 agent-team hook（SessionStart / Stop / UserPromptSubmit），以及插件是否因版本/清单问题带 diagnostics；
有记录但模型没按团队策略行动 → 看该条记录的 env_overlay.ZCODE_PLUGIN_ROOT 是否指向当前安装目录；升级后旧会话仍用旧版本，需新开会话。
现象 | 原因与处理 |
安装后 | 已知告警：manifest 的 hooks 声明与宿主自动发现同路径文件重复，宿主显式忽略；三条 hook 仍正常执行，不影响使用。计划在后续版本清理清单 |
队友一直 | 看 |
桌面工具调用挂起或 | 已知宿主限制（D11）：桌面 callTool 在 daemon 空闲回收后不重建连接。新开一个任务、立刻发起调用可命中存活 daemon；面板心跳已尽量保活 |
面板数字不动 | 面板靠订阅+心跳刷新； |
升级后行为没变 | 宿主按会话固定插件运行时：升级后请新开任务；CLI 更新提示 “Restart zcode to apply” 同理 |
旧团队会话出现在左侧任务栏 | 旧数据遗留： |
团队持久记录损坏 | 报 |
确认不再需要历史团队后，可整体删除 $ZCODE_PLUGIN_DATA（等价于默认卸载的数据处置）。删除前先备份；删除后无法恢复任务板与消息。
本插件是 ZCode 上对 DSH Agent Teams 的复刻。以下差异均为已登记、已验收的适配项，来自《04-能力映射与差距分析》D1–D27（编号以该台账为准）。
编号 | 你会看到什么 |
D1 | 团队事件写在插件自己的数据目录（JSONL），不写进 Lead 会话日志；会话导出/回滚不包含团队事件 |
D2 | “运行中插话”只能在下一次回合边界送达（宿主没有 steer 原语）；目标运行中时消息排队，不会被丢弃或重复 |
D3 |
|
D4 | 主 UI 是会话内 MCP Apps 面板；没有原版的头部 hover 按钮/弹层/pin； |
D5 | 成员会话默认不进行左侧任务栏；面板内提供成员会话查看视图（只读）。旧版遗留的可见行可用 |
D6 | Lead 仍能看见宿主内置 Task 工具（无法禁用）；teammate 侧已禁用 Task，团队工具优先由策略引导 |
D7 | 策略文本中“文件版本冲突”一句替换为 ZCode 文件工具的等价语义；其余逐字 |
D8 | 协调者是“瞬时”的：daemon 空闲会被宿主回收，任一实例可接任；协调者交替的瞬间可能出现 |
D9 | 没有 SessionEnd hook：处置靠 daemon 退出时尽力执行 + 下次启动对账；极短宽限下可能只留下可对账的状态 |
D10 | 策略通过 SessionStart hook 注入到消息上下文，而非系统提示；注入文本不落 transcript；被禁用 hook 时会有 fail-loud 警告 |
D11 | 桌面 callTool 在 daemon 被回收后可能挂起/ |
D13 | 工具条目不声明 |
D14 | 身份缺失时错误消息里用 |
D15 | 参数类型错误返回 |
D16 | 同一团队由两个 daemon 服务时（代理模式）： |
D17 | daemon 空闲回收默认不终止队友轮次（keep 休眠态）；如需要彻底回收可设 |
D18 | 给 Lead 的“已送达”以 hook 注入回执为准（宿主无直达注入原语，注入不落 transcript）；对外仍是 |
D19 | hook 读取 daemon 落盘的配置；首次 daemon 启动前 hook 使用默认值（如 |
D20 | 空闲 Lead 的唤醒是灰度功能：默认不拉起新回合，消息持久待命； |
D21 | 静态卡片无活性探测：成员状态按 phase 保守映射（active→inactive、lead 恒 inactive）；实时面板/伴生面板才显示 running |
D22 | 诊断工具 |
D23 | 历史事件名/旧 checkpoint 自动兼容：旧 |
D24 | 策略文本在 SessionStart（startup/resume）注入；Lead 极长会话中途可能因上下文压缩丢失，可重新加载 skill 或开新任务 |
D25 | 插件只写宿主任务索引的两个白名单点（会话隔离 anchor 墓碑、 |
D26 | Lead 默认 |
D27 | 任务 |
This server cannot be deployed
Agent-native collaboration network: orchestrate a team of long-running agents from any MCP client.
Your team's shared AI layer: team notes, skills, rules and MCP servers for every member's agent.
Shared pads, chat and tasks for your team and their agents. Any agent can join.
The team layer for AI coding agents: shared contracts, collision alerts, E2EE sessions.