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

快速上手

dsh-agent-team-gui

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add --allow-build=dsh-agent-team-gui github:toolclub/dsh-agent-team-gui

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

— 源: plugins.install

关键要点

• 始终：每条有效的顶层用户消息都运行所选小队。
• 智能：有界规划器可以跳过不适合或太简单的任务。
• 手动：普通消息保持单人；可以只给下一条消息使用小队，或者让模型调用工具。
• 全部成员：每个已配置成员恰好获得一次任务。
• 自适应：智能规划选择最小但非空的合适成员子集。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后需要重启 DSH Web 进程吗？

需要。README 明确写到"安装或更新后必须重启进程"，否则新的 agent-team-gui Host 行不会生效。

必须使用 Web profile 吗？headless 能装吗？

必须使用 Web profile。插件只能向 Web profile 的 storage/Connection RPC/browser module 注册 UI；如果其他进程内插件注入了必需的 service，导出的 Host service 仍可被消费，但官方 Settings UI 不存在。

安装前需要哪些前置条件？

DSH >=0.1.0-rc.5 <0.2.0、Node.js >=22.19.0 <23 或 >=24.0.0（Node 23 不支持）、pnpm，并且 DSH 内至少需要一条已配置好的 provider/model 路由，否则小队没有可调用的模型。

卸载插件会一起清掉小队数据吗？

不会。README 写明"删除包不会自动删除 DSH 存储后端中的持久插件表"，小队、成员、版本、运行历史都留在 DSH 存储里，需要手动清理。

安装时 pnpm 弹出 allowBuilds 提示怎么办？

只把 dsh-agent-team-gui 这一个包加入 pnpm 提示的 Web profile 工作区文件（默认 ~/.dsh/profiles/web/pnpm-workspace.yaml）的 allowBuilds，然后重复同一条固定版本命令；README 警告过其他包的 allowBuilds 都不要授权。

旧 v0.4 数据还能用吗？

可以。agentRecordReadSchema 和 squadRecordReadSchema 仍接受老记录；但旧数据不能再以 v2 上限写入，编辑会按 v2 新写规则校验。另外没有存原始计划的旧运行会被显式拒绝重试。

模型工具调用一定能触发小队吗？

不一定。README 把 model-tool 触发模式标注为 best-effort，因为 DSH 尚未暴露 toolChoice 控制；需要稳定自动触发时请用 "guaranteed" 触发模式，它由 Host 驱动并按持久消息幂等。

可以远程 URL 拉取配方吗？

不可以。snapshotSchema.capabilities.remoteRecipeFetch 显式为 false，v0.5 故意禁掉了远程 URL 配方以避免暴露未做 SSRF 加固的 Host 网络请求面；请导入本地 JSON 配方。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.5+ （CI 实际验证 rc.6，需 <0.2.0）
• Node: ^22.19.0 || >=24.0.0 （Node 23 不支持）

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则