本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-agent-teams

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @nanmicoder/dsh-agent-teams

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• id: agent-teams
• One captain leads one active team at a time.
• Idle members are automatically reused for ready work; messages that cannot be delivered live remain durable and are retried at a later status boundary.
• State is file-backed and serialized within one DSH process; concurrent processes editing the same team are not coordinated.
• The activity panel reports persisted state as-is. Models may occasionally finish work without performing the expected task-state update.

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后需要额外配置吗？

默认参数即可工作，团队状态自动写到工作区的 .agent-teams 目录。如需调整成员数量上限、子代理后端或团队规模等参数，在 profile 的 cordis.patch.yml 覆盖 config 即可。

一个会话能同时带几个团队？

只能带一个。agent_teams_create 在检测到当前会话已是某团队队长时会直接报错，需要先 agent_teams_delete 结束或归档旧团队。

成员之间如何沟通？

走持久化邮箱。任意成员或队长可调用 agent_teams_send_message 直接投递到对方，发送时还会唤醒对方进入下一轮次，不需要队长转发。

团队结束后数据还在吗？

在。agent_teams_delete 把整个团队目录归档到 <stateRoot>/archive/<teamId>/，成员、任务、依赖图和邮箱完整保留。Web 面板上仍可继续翻看历史快照。

进程崩溃后未完成的任务会怎样？

调度器是事件驱动的，没有轮询线程。重启后队长恢复或调用 agent_teams_status 会触发共享任务池：空闲成员若仍持有未完成任务，旧 attempt 会被撤销并生成新 attempt，原成员重新被唤醒执行。

多人同时改一个团队会冲突吗？

同一 DSH 进程内对每个团队按 id 串行化了读写，修改不会交错。但插件明确声明：多个进程同时改同一团队不保证一致，建议单进程使用。

需要选哪个 LLM 才能用？

没有强制要求。成员默认沿用队长当前的 provider 和 model 并快照其思考强度；只有用户明确指定某个角色走别的模型时，才需要为该成员传入可选的 provider + model。

能在不装 DSH 的情况下跑这个插件吗？

不能。README 与 cordis.patch.yml 都把它定位为宿主侧插件，依赖 cordis 的 services、ctx.subagents、ctx.agents、ctx.systemPrompt.section 等接缝；脱离 DSH 没有可注册的目标。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+
• Node: ^22.19.0 || >=24

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则