- DSH
- 0.2.1-rc.5
- 系统
- Windows / macOS / Linux
- 风险
- high
本页目录(13)
先查看功能、兼容性、权限和同类选择,再按本文操作。
当前默认 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、可丢弃工作区和受限系统账号,升级前保存依赖、锁文件、补丁和插件状态。
- 安装 Node.js 22.19、Node.js 24 或项目当前声明支持的更高版本,并确认
pnpm可用。 - 使用独立的
webProfile 和可丢弃测试工作区,不直接连接生产目录。 - 备份当前 Profile 配置,并记录安装前的
--dump-config输出。 - 核对固定来源中的外部服务、账号、运行时和平台限制。
- 本页没有列出插件专属环境变量;仍需核对宿主和外部服务的凭据要求。
安装 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
安装后设置
- 以下为可自行执行的隔离验证步骤;52DSH 本轮未安装或启动插件。
- 停止旧进程后用固定版本安装命令更新,同一 Profile 不混用全局启动器与不同 DSH 版本。
- 保持 memberMaxDepth=0、maxMembers=2;需要其他模型时明确区分 memberProvider 与 memberLlmProvider。
- 先在备份副本核对旧团队;同一 .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
-
核对精确宿主、包版本和唯一挂载行;导出配置成功不算运行验证。
npx --yes @deepseek-ai/[email protected] --profile web --dump-config期望结果:配置引用 @nanmicoder/[email protected] 对应包,未出现重复挂载;继续验证前先核对权限。
-
在空工作区创建两成员只读计划,先不批准;再由测试负责人批准最小任务。
期望结果:待审阶段不派工;批准后成员与任务持久化,错误有明确反馈。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
- 停止同一 Profile 的 DSH,再运行 npx --yes @deepseek-ai/[email protected] plugin --profile web remove @nanmicoder/dsh-agent-teams;导出配置确认已移除。
- 恢复升级前整套 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、保留日志并回退插件。
固定来源证据
以下资料是本文配置结论的依据:
- README.md(外部链接,在新标签页打开)
- docs/usage.md(外部链接,在新标签页打开)
- docs/harness-0.2.1-rc.2/README.md(外部链接,在新标签页打开)
- docs/maintenance-2026-09-06/release/README.md(外部链接,在新标签页打开)
- skills/README.md(外部链接,在新标签页打开)
- docs/verification-guide.md(外部链接,在新标签页打开)
继续查看:返回 dsh-agent-teams 插件详情页,重新核对兼容性、权限、同类插件和来源状态。
来源与维护信息
本文根据以下原始资料整理。版本变化后,请以官方资料和页面标注的验证日期为准。
- GitHub:NanmiCoder/dsh-agent-teams(外部链接,在新标签页打开)
- GitHub:NanmiCoder/dsh-agent-teams 固定提交 package.json(外部链接,在新标签页打开)
- GitHub:NanmiCoder/dsh-agent-teams 固定提交 LICENSE(外部链接,在新标签页打开)
- GitHub:NanmiCoder/dsh-agent-teams 固定提交 cordis.patch.yml(外部链接,在新标签页打开)
- GitHub:NanmiCoder/dsh-agent-teams 固定提交 README.md(外部链接,在新标签页打开)
- GitHub:NanmiCoder/dsh-agent-teams 固定提交 usage.md(外部链接,在新标签页打开)
- GitHub:NanmiCoder/dsh-agent-teams 固定提交 index.ts(外部链接,在新标签页打开)
- GitHub:NanmiCoder/dsh-agent-teams 固定提交 state.ts(外部链接,在新标签页打开)
- GitHub:NanmiCoder/dsh-agent-teams 固定提交 scheduler.ts(外部链接,在新标签页打开)
- GitHub:NanmiCoder/dsh-agent-teams 固定提交 web-routes.ts(外部链接,在新标签页打开)
- GitHub:NanmiCoder/dsh-agent-teams 固定提交 tool-policies.ts(外部链接,在新标签页打开)
- GitHub:NanmiCoder/dsh-agent-teams 固定提交 harness-compat.ts(外部链接,在新标签页打开)
- GitHub:deepseek-ai/deepseek-harness 固定提交 plugin-compatibility.ts(外部链接,在新标签页打开)
- GitHub:NanmiCoder/dsh-agent-teams 固定提交 README.md(外部链接,在新标签页打开)
- GitHub:NanmiCoder/dsh-agent-teams 固定提交 README.md(外部链接,在新标签页打开)