---
title: "安装 DSH Agent Teams 0.1.28 并核对配置与权限"
seo_title: "DSH Agent Teams 0.1.28 教程：配置、迁移与权限"
description: "在 DeepSeek Harness（DSH）0.2.1-rc.5 使用 DSH Agent Teams 0.1.28，了解固定安装、旧配置迁移、持久化、权限与失败回退；仅静态审阅，未运行验证。"
canonical: https://52dsh.com/tutorials/nanmicoder-dsh-agent-teams-install-config/
authors: ["52DSH 编辑部"]
audience: []
outcomes: []
prerequisites: ["Node.js 与 pnpm","独立 web Profile","可丢弃测试工作区"]
difficulty: advanced
estimated_action_time: null
next_steps: null
published_at: 2026-08-22
updated_at: 2026-11-06
verified_on: 2026-11-01
maintenance_status: community
verification_level: source_reviewed
risk_level: high
dsh_version: 0.2.1-rc.5
plugin_id: nanmicoder-dsh-agent-teams
tutorial_kind: plugin_configuration
related_plugin_url: https://52dsh.com/plugins/nanmicoder-dsh-agent-teams/
---

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

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

## 当前默认 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 升级检查](/tutorials/dsh-update-uninstall/#022-rc1默认版本升级检查)。

## 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](https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/package.json)、[固定证据 2](https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/LICENSE)。

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

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

> 对应插件：[查看 dsh-agent-teams 的功能、权限与兼容性说明](/plugins/nanmicoder-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 使用目录中记录的精确安装目标，避免直接跟随可能变化的默认分支：

```bash
npx --yes @deepseek-ai/dsh@0.2.1-rc.5 plugin --profile web add @nanmicoder/dsh-agent-teams@0.1.28
```

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



## 插件专属配置

### 配置目标

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

### 小团队起步配置（不强行指定模型）

证据：[固定来源](https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/src/index.ts)。按上方配置目标使用本段内容；如有占位符，替换为测试值。

```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：

```bash
npx --yes @deepseek-ai/dsh@0.2.1-rc.5 --profile web --dump-config
npx --yes @deepseek-ai/dsh@0.2.1-rc.5 web
```

1. **核对精确宿主、包版本和唯一挂载行；导出配置成功不算运行验证。**

   ```bash
   npx --yes @deepseek-ai/dsh@0.2.1-rc.5 --profile web --dump-config
   ```

   期望结果：配置引用 @nanmicoder/dsh-agent-teams@0.1.28 对应包，未出现重复挂载；继续验证前先核对权限。

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 移除包：

```bash
npx --yes @deepseek-ai/dsh@0.2.1-rc.5 plugin --profile web remove @nanmicoder/dsh-agent-teams
```

1. 停止同一 Profile 的 DSH，再运行 npx --yes @deepseek-ai/dsh@0.2.1-rc.5 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、保留日志并回退插件。

## 固定来源证据

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

- [README.md](https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/README.md)
- [docs/usage.md](https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/docs/usage.md)
- [docs/harness-0.2.1-rc.2/README.md](https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/docs/harness-0.2.1-rc.2/README.md)
- [docs/maintenance-2026-09-06/release/README.md](https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/docs/maintenance-2026-09-06/release/README.md)
- [skills/README.md](https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/skills/README.md)
- [docs/verification-guide.md](https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/docs/verification-guide.md)

继续查看：[返回 dsh-agent-teams 插件详情页](/plugins/nanmicoder-dsh-agent-teams/)，重新核对兼容性、权限、同类插件和来源状态。

## 原始来源

- https://github.com/NanmiCoder/dsh-agent-teams
- https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/package.json
- https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/LICENSE
- https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/cordis.patch.yml
- https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/README.md
- https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/docs/usage.md
- https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/src/index.ts
- https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/src/state.ts
- https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/src/scheduler.ts
- https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/src/web-routes.ts
- https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/src/tool-policies.ts
- https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/src/harness-compat.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/b830ec950faba0a46dda564be3e2d854afed94f1/packages/boot/app-boot/src/plugin-compatibility.ts
- https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/docs/harness-0.2.1-rc.2/README.md
- https://github.com/NanmiCoder/dsh-agent-teams/blob/3331b903f0e954d59ac69be1a75fd4fd7e1de20e/docs/maintenance-2026-09-06/release/README.md
