安装前先看这几项
- 配置资料
- 配置资料完整
- 配置难度
- 较高
- 适合新手
- 建议具备相关经验
- 兼容状态
- 声明兼容,尚未实测
- 验证状态
- 源码已审阅,未标记运行实测
本页目录(9)
按照固定来源完成安装、配置与验证
教程包含独立 Profile、精确安装目标、配置证据、最小验证任务、回退和数据清理。
这个插件能做什么
Agent Teams 0.1.28 提供待审团队计划、持久子 Agent、任务依赖与成员邮箱,新增成员工具策略和更严格的状态恢复;固定命令使用 DSH 0.2.1-rc.5。
需要多 Agent、工作流、编排能力的用户。
该插件涉及较高配置难度或敏感权限,不建议在生产工作区直接试装。
安装前准备
- DSH 0.2.1-rc.5(必需):0.1.28 以 engines.dsh >=0.1.2-alpha.2 为宿主判断依据,按官方 engines 优先规则接受 0.2.1-rc.5;Node.js 为 ^22.19.0 || >=24。Web 界面与子 Agent 仍依赖实际宿主服务,范围宽或 peer 为 * 不代表所有旧宿主可运行;仅完成静态源码审阅。
- 独立环境与备份(必需):使用独立 web Profile、可丢弃工作区和受限系统账号,升级前保存依赖、锁文件、补丁和插件状态。
如何安装 dsh-agent-teams
本页命令固定使用 DSH 0.2.1-rc.5,与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录;新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。
下面的命令使用本站核验的 DSH 基线,并锁定插件版本或 Git commit,避免默认分支变化导致安装内容漂移。本站已核对安装目标,但尚未在你的系统和 Profile 中实际执行。
- 安装到
webProfile- DSH 基线
0.2.1-rc.5- 安装来源
- npm 预构建包(锁定版本)
- 固定目标
@nanmicoder/[email protected]
B1 已复核 0.1.28 固定发行包、声明与源码,本文命令固定 DSH 0.2.1-rc.5;只代表静态审阅,不是插件运行通过。旧组合 0.1.22 + 0.2.0-rc.2 仅用于识别备份,不与新版交叉混装。
- 01检查 Node.js 与 pnpm
DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上,并且
pnpm必须已在 PATH 中。先运行:环境检查node --version && pnpm --version - 02安装到 Web Profile
这条命令会把插件加入
webProfile,并在插件声明 DSH Bundle 时自动加入配置层。npm 预构建包(锁定版本)npx --yes @deepseek-ai/[email protected] plugin --profile web add @nanmicoder/[email protected] - 03确认 Bundle 已进入配置
安装成功后先导出组合配置,不启动 Agent。输出中应能找到包名 @nanmicoder/dsh-agent-teams或对应 Bundle 层。
检查配置npx --yes @deepseek-ai/[email protected] --profile web --dump-config - 04启动并完成最小验证
启动 Web Profile 后,只测试一个与插件功能直接相关的最小任务,并检查日志、文件、网络和凭据访问是否符合预期。
启动 DSH Webnpx --yes @deepseek-ai/[email protected] web
测试不通过时先停止 DSH,再从同一 Profile 移除插件。移除后重新运行配置检查,确认对应 Bundle 层已经消失;插件自己创建的数据和外部账号配置可能需要另行清理。
npx --yes @deepseek-ai/[email protected] plugin --profile web remove @nanmicoder/dsh-agent-teams插件专属配置
$DSH_HOME/profiles/web/cordis.patch.yml- 用户覆盖层;与依赖清单、锁文件和 pnpm-workspace.yaml 一同备份。
小团队起步配置(不强行指定模型) · yaml。示例中的账号、路径和凭据占位符必须替换,不要提交真实密钥。
- id: agent-teams
config:
stateDir: .agent-teams
memberProvider: spawn
memberMaxDepth: 0
maxMembers: 2- 以下为可自行执行的隔离验证步骤;52DSH 本轮未安装或启动插件。
- 停止旧进程后用固定版本安装命令更新,同一 Profile 不混用全局启动器与不同 DSH 版本。
- 保持 memberMaxDepth=0、maxMembers=2;需要其他模型时明确区分 memberProvider 与 memberLlmProvider。
- 先在备份副本核对旧团队;同一 .agent-teams 不由多个 DSH 进程并发写入。
配置检查与成功结果
- 01核对精确宿主、包版本和唯一挂载行;导出配置成功不算运行验证。复制验证命令
npx --yes @deepseek-ai/[email protected] --profile web --dump-config期望结果:配置引用 @nanmicoder/[email protected] 对应包,未出现重复挂载;继续验证前先核对权限。
- 02在空工作区创建两成员只读计划,先不批准;再由测试负责人批准最小任务。
期望结果:待审阶段不派工;批准后成员与任务持久化,错误有明确反馈。52DSH 未执行此任务。
第一次使用建议这样验证
- /agent-teams 让两名成员分别只读审阅测试 README 与测试目录,先给出计划等待批准。
它可能接触哪些数据和能力
成员默认可调用宿主普通编码工具;memberMaxDepth=0 限制继续委派,maxMembers 默认 8 仅限制团队成员数,不是全局并发或费用上限。toolPolicies 由部署者声明,成员按 ID 选择,属于工具可见性与调用限制,不是 OS 沙箱。Web 路由调用宿主 Connection.requestRejection,认证服务缺失时返回 503。
数据存储:<workspace>/.agent-teams/<teamId>/team.json、inbox/*.jsonl;archive 保留已归档团队,retired-members.json 保存退役成员索引。成员子会话另由 DSH 保存。
请注意:“源码已审阅”说明本站检查到的证据范围,不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。
故障排查与数据清理
- UNKNOWN_MODEL 或成员无法启动
- 移除旧 memberModel 覆盖以沿用队长路由,或配置 memberLlmProvider 与 memberModel 的明确配对;保存实际模型目录与错误。
- 429、旧状态损坏或恢复后重复任务
- 降低人数与请求并发,保留原状态备份,按 task/attempt_id 核对结果;使用队长工具恢复,不直接编辑 team.json。
- 停止同一 Profile 的 DSH,再运行 npx --yes @deepseek-ai/[email protected] plugin --profile web remove @nanmicoder/dsh-agent-teams;导出配置确认已移除。
- 恢复升级前整套 Profile 和插件状态备份,不混用新旧状态;卸载不会撤销文件修改、子会话或外部授权。
深入审计:兼容性、数据流与来源
兼容性与审阅记录
兼容性说明
0.1.28 以 engines.dsh >=0.1.2-alpha.2 为宿主判断依据,按官方 engines 优先规则接受 0.2.1-rc.5;Node.js 为 ^22.19.0 || >=24。Web 界面与子 Agent 仍依赖实际宿主服务,范围宽或 peer 为 * 不代表所有旧宿主可运行;仅完成静态源码审阅。
数据流
团队、任务、成员工具过滤快照和邮箱写入工作区 .agent-teams;删除团队归档,retired-members.json 记录退役成员;子会话另由 DSH 保存。成员输入和工具结果会进入配置的模型服务;恢复可重新投递持久任务,不能把进程重启视为任务已完成或无重复外部影响。
源码审阅结论
2026-11-01 B1:重新取得 npm 0.1.28,SHA-512 与 npm integrity 一致,两个 registry ECDSA 签名验证通过,发行 tag 解引用至固定提交。provenance 声明的摘要与工作流提交匹配,但未完成 Sigstore 信任链验证;未独立重建发行产物。已按固定源码复核配置、授权、持久化与恢复边界,批准带风险说明的 source_reviewed;未安装或执行插件、未用真实凭据。
来源与维护信息
本页根据固定提交的仓库、包清单和本站审阅资料生成。版本变化后,请重新核对作者说明。
- 来源快照
08f3df46cca1- 固定提交
3331b903f0e9- 许可证
- MIT
- 主要语言
- TypeScript
- 中文资料
- 有完整中文配置资料