安装 DSH Agent Teams 0.1.28 并核对配置与权限

在 DeepSeek Harness(DSH)0.2.1-rc.5 使用 DSH Agent Teams 0.1.28,了解固定安装、旧配置迁移、持久化、权限与失败回退;仅静态审阅,未运行验证。

社区整理已复核原始来源
DSH
0.2.1-rc.5
系统
Windows / macOS / Linux
风险
high
本页目录(13)
对应插件dsh-agent-teams

先查看功能、兼容性、权限和同类选择,再按本文操作。

查看插件详情 →

当前默认 DSH 0.2.2-rc.1 提醒(2026-11-06)

npm 默认版本已改为 DSH 0.2.2-rc.1。本页固定的 Agent Teams 0.1.28 通过它的版本声明检查(engines.dsh 为 >=0.1.2-alpha.2),但下方命令仍固定 DSH 0.2.1-rc.5,本站没有在 0.2.2-rc.1 上复核源码或运行。0.2.2-rc.1 调整了多项插件接口,并要求 Node.js ≥24.9.0;通过声明检查只说明不会被安装门禁拦截,不代表能加载。2026-11-06 未发现需要替换的新版本。升级宿主前先看0.2.2-rc.1 升级检查。

B1 固定版本维护记录(2026-11-01)

本页从 0.1.22 升级至 0.1.28,安装目标与 DSH 命令已同步更新。此前 11-01 的候选暂缓记录保存在批次审核历史中;本轮补齐发行包绑定与配置/权限静态审阅后,转为带风险说明的 source_reviewed,不提升为运行验证。

重新取得 npm 精确版,SHA-512 与元数据一致;registry 的两条 ECDSA 签名验证通过。发行 tag 解引用与本页 40 位提交一致。provenance 声明的摘要与工作流提交已比对,但未验证完整 Sigstore 信任链,未独立重建产物。发行包不附带 src,静态 bundle 与源代码不能据此宣称可复现构建。

以上不是安全认证,也没有执行安装、登录、模型请求、迁移、终端、远程或更新流程。使用前按下文迁移与退出路径逐项核对。

依据:固定证据 1(外部链接,在新标签页打开)、固定证据 2(外部链接,在新标签页打开)。

Agent Teams 0.1.28 提供待审团队计划、持久子 Agent、任务依赖与成员邮箱,新增成员工具策略和更严格的状态恢复;固定命令使用 DSH 0.2.1-rc.5。

如果你的目标是配置待审团队计划、成员工具策略、持久状态和失败恢复,本教程会说明如何在 DeepSeek Harness(DSH)中准备、安装、配置、验证和回退 dsh-agent-teams。本文锁定作者仓库提交 3331b903f0e9;已复核固定提交的原始资料,未进行运行实测。

对应插件:查看 dsh-agent-teams 的功能、权限与兼容性说明。先确认它适合你的工作流,再执行安装。

0.1.22 → 0.1.28 的使用变化

本页已更新到固定 0.1.28 + DSH 0.2.1-rc.5,继续保持 source_reviewed。成员运行后端 memberProvider: spawn 与模型路由 memberLlmProvider 是两个不同概念;不指定 memberModel 时沿用队长路由。指定其他模型时应同时核对其 Provider,避免沿用旧示例的 deepseek-v4 名称而触发 UNKNOWN_MODEL。

先确认是否适合你

  • 分类:Agent 与工作流
  • 风险等级:high
  • 核验证据:source_reviewed
  • 兼容性边界: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 为 * 不代表所有旧宿主可运行;仅完成静态源码审阅。
  • 主要权限关注:成员默认可调用宿主普通编码工具;memberMaxDepth=0 限制继续委派,maxMembers 默认 8 仅限制团队成员数,不是全局并发或费用上限。toolPolicies 由部署者声明,成员按 ID 选择,属于工具可见性与调用限制,不是 OS 沙箱。Web 路由调用宿主 Connection.requestRejection,认证服务缺失时返回 503。

如果你准备在重要工作区使用,先阅读插件详情页的权限和数据流说明;“源码已审阅”或“资料已整理”都不等于安全认证。

安装前准备

本页 DSH 命令版本: 0.2.1-rc.5。B1 已复核 0.1.28 固定发行包、声明与源码,本文命令固定 DSH 0.2.1-rc.5;只代表静态审阅,不是插件运行通过。旧组合 0.1.22 + 0.2.0-rc.2 仅用于识别备份,不与新版交叉混装。

  • 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、可丢弃工作区和受限系统账号,升级前保存依赖、锁文件、补丁和插件状态。
  1. 安装 Node.js 22.19、Node.js 24 或项目当前声明支持的更高版本,并确认 pnpm 可用。
  2. 使用独立的 web Profile 和可丢弃测试工作区,不直接连接生产目录。
  3. 备份当前 Profile 配置,并记录安装前的 --dump-config 输出。
  4. 核对固定来源中的外部服务、账号、运行时和平台限制。
  5. 本页没有列出插件专属环境变量;仍需核对宿主和外部服务的凭据要求。

安装 dsh-agent-teams

52DSH 使用目录中记录的精确安装目标,避免直接跟随可能变化的默认分支:

npx --yes @deepseek-ai/[email protected] plugin --profile web add @nanmicoder/[email protected]

GitHub 源码插件如果被 pnpm 拦截构建脚本,先检查终端提示的具体包和脚本。只在 web Profile 中放行确实需要的构建项,不要全局放行未知依赖。

插件专属配置

配置目标

  • $DSH_HOME/profiles/web/cordis.patch.yml:用户覆盖层;与依赖清单、锁文件和 pnpm-workspace.yaml 一同备份。

小团队起步配置(不强行指定模型)

证据:固定来源(外部链接,在新标签页打开)。按上方配置目标使用本段内容;如有占位符,替换为测试值。

- id: agent-teams
  config:
    stateDir: .agent-teams
    memberProvider: spawn
    memberMaxDepth: 0
    maxMembers: 2

安装后设置

  1. 以下为可自行执行的隔离验证步骤;52DSH 本轮未安装或启动插件。
  2. 停止旧进程后用固定版本安装命令更新,同一 Profile 不混用全局启动器与不同 DSH 版本。
  3. 保持 memberMaxDepth=0、maxMembers=2;需要其他模型时明确区分 memberProvider 与 memberLlmProvider。
  4. 先在备份副本核对旧团队;同一 .agent-teams 不由多个 DSH 进程并发写入。

旧团队与配置迁移

升级前让成员停止并确认没有运行中的任务,备份整个工作区 .agent-teams、DSH 会话存储及 Profile 依赖/锁文件/补丁;同一状态目录只由一个 DSH 进程写入。锁是进程内队列,不能宣传多进程并发安全。

新版仍读取 <workspace>/<stateDir>/<teamId>/team.json 与 inbox JSONL。读取时将旧字符串 profile 转为快照,清理部分空可选任务字段和无效行号;其他损坏状态会给出字段错误并拒绝读取,不是任意旧状态自动修复。先在副本检查旧团队,升级后写出的新字段不保证可被 0.1.22 无损读回;回退应恢复升级前整套状态和会话备份。

可在部署配置里定义 toolPolicies,让成员通过 tool_policy 选择已审策略;队长不能提交任意 allow/deny 清单。协调工具保留、队长工具仍禁用;策略选择不替代工作目录权限与宿主审批。

配置验证与成功结果

先导出配置,再启动同一版本的 DSH Web:

npx --yes @deepseek-ai/[email protected] --profile web --dump-config
npx --yes @deepseek-ai/[email protected] web
  1. 核对精确宿主、包版本和唯一挂载行;导出配置成功不算运行验证。

    npx --yes @deepseek-ai/[email protected] --profile web --dump-config
    

    期望结果:配置引用 @nanmicoder/[email protected] 对应包,未出现重复挂载;继续验证前先核对权限。

  2. 在空工作区创建两成员只读计划,先不批准;再由测试负责人批准最小任务。

    期望结果:待审阶段不派工;批准后成员与任务持久化,错误有明确反馈。52DSH 未执行此任务。

第一次使用

  • /agent-teams 让两名成员分别只读审阅测试 README 与测试目录,先给出计划等待批准。

人数、恢复与失败处理

默认 maxMembers: 8、memberMaxDepth: 0;示例先设人数为 2。人数上限不是模型请求并发预算,仍须在宿主/Provider 控制费用与速率。先创建待审计划,批准后才派工;只读任务也需要核对成员工具策略。

冷恢复调度会对已持久化、当前进程未观察到的活动任务尝试恢复投递,使用 attempt_id 防止旧执行更新新任务;不能保证对外副作用恰好执行一次。成员报错、429 或重指派时,通过面板/队长工具处理并核对实际产物,不手工编辑 team.json。归档会保留旧团队目录;退役成员索引用于阻止旧子会话继续作为有效成员。

数据、权限与凭据

数据流: 团队、任务、成员工具过滤快照和邮箱写入工作区 .agent-teams;删除团队归档,retired-members.json 记录退役成员;子会话另由 DSH 保存。成员输入和工具结果会进入配置的模型服务;恢复可重新投递持久任务,不能把进程重启视为任务已完成或无重复外部影响。

权限关注: 成员默认可调用宿主普通编码工具;memberMaxDepth=0 限制继续委派,maxMembers 默认 8 仅限制团队成员数,不是全局并发或费用上限。toolPolicies 由部署者声明,成员按 ID 选择,属于工具可见性与调用限制,不是 OS 沙箱。Web 路由调用宿主 Connection.requestRejection,认证服务缺失时返回 503。

数据存储: <workspace>/.agent-teams/<teamId>/team.json、inbox/*.jsonl;archive 保留已归档团队,retired-members.json 保存退役成员索引。成员子会话另由 DSH 保存。

真实 Token、API Key、Cookie 和账号 ID 不应写进 Git 仓库、网页截图或公开 Issue。测试结束后撤销临时凭据。

卸载、回退与清理

停止 DSH 后,从同一个 Profile 移除包:

npx --yes @deepseek-ai/[email protected] plugin --profile web remove @nanmicoder/dsh-agent-teams
  1. 停止同一 Profile 的 DSH,再运行 npx --yes @deepseek-ai/[email protected] plugin --profile web remove @nanmicoder/dsh-agent-teams;导出配置确认已移除。
  2. 恢复升级前整套 Profile 和插件状态备份,不混用新旧状态;卸载不会撤销文件修改、子会话或外部授权。

升级失败时先保护状态

遇到 invalid AgentTeams state,保存原始文件的离线备份和脱敏错误,按具体团队/任务字段排查,不删除整个目录重建。旧版本恢复须同时还原 Profile、工作区状态和 DSH 子会话;卸载包不会停止已脱离管理的外部进程,也不会撤销外部模型授权。本轮没有创建团队、触发模型请求或实测旧状态迁移。

常见问题

UNKNOWN_MODEL 或成员无法启动

移除旧 memberModel 覆盖以沿用队长路由,或配置 memberLlmProvider 与 memberModel 的明确配对;保存实际模型目录与错误。

429、旧状态损坏或恢复后重复任务

降低人数与请求并发,保留原状态备份,按 task/attempt_id 核对结果;使用队长工具恢复,不直接编辑 team.json。

安装成功但页面或命令没有出现

先运行 --dump-config 确认 Bundle 已进入 web Profile,再重启 DSH Web 并硬刷新浏览器。不要通过反复扩大权限来解决加载问题。

插件运行后没有得到预期结果

把问题缩小到本页的最小验证任务,检查作者文档要求的变量、外部服务和平台限制。保存终端错误原文,并核对当前安装目标是否仍对应本页固定提交。

作者固定资料中未识别到独立故障章节。遇到插件特有错误时,应先停止 DSH、保留日志并回退插件。

固定来源证据

以下资料是本文配置结论的依据:

继续查看:返回 dsh-agent-teams 插件详情页,重新核对兼容性、权限、同类插件和来源状态。

来源与维护信息

本文根据以下原始资料整理。版本变化后,请以官方资料和页面标注的验证日期为准。

完成当前任务后

按结果继续,不要停在文章末尾

已成功

继续完成配置、验证或下一阶段任务。

继续下一步 →
仍未解决

保留现象和错误原文,再进入对应排障路径。

DSH 安装 Git 插件被 allowBuilds 阻止怎么办 →安装和管理 DeepSeek Harness(DSH)插件 →