# @chenkai114/dsh-team-admin 中文文档

规范地址：https://npmcn.com/package/%40chenkai114/dsh-team-admin/

版本：0\.2\.7
npm 元数据更新时间：2026-11-05T06:32:49.585Z
中文译文更新时间：2026-11-09T12:16:29.594Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40chenkai114/dsh-team-admin
原文对照：https://npmcn.com/package/%40chenkai114/dsh-team-admin/?lang=original
项目主页：https://github.com/chenkai2/dsh-team-admin#readme
源码仓库：https://github.com/chenkai2/dsh-team-admin

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：134 kB，13 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：0 个
- 首次发布：2026-11-04T08:55:53.461Z
- 最新版本发布：2026-11-05T06:32:49.249Z
- 近 30 天下载量：3367（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 19 个）

## 中文简介

DSH 插件：GUI 管理任意会话的智能体团队 —— 查看成员、删除角色并清理其持久会话（进回收站，可恢复）、回收成员名额、过滤已删除成员；新旧两版智能体团队都支持

## 安装

```sh
npm install @chenkai114/dsh-team-admin
```

也可以使用：`pnpm add @chenkai114/dsh-team-admin`、`yarn add @chenkai114/dsh-team-admin`、`bun add @chenkai114/dsh-team-admin`

## README

# dsh-team-admin

给 DeepSeek Harness 的「智能体团队（Agent Teams）」补一个**管理面**：在 GUI 里选任意会话，查看它的团队成员，**删除角色并清理该成员的持久会话**。

## 为什么需要

v0.2.x 的内置 Team roster 是 **append-only**：只能 `spawn_teammate` 加人，没有删除 / 改名 / 名字复用（见 `dsh-experimental-agent-team` 的 Known Limitations）。成员上下文耗尽、任务结束或建错时，只能"停手不理会"，名单和名额永久占着。

本插件补上缺失的那一半：

-   列出任意根会话的团队成员（名字、状态、描述、模型、名下任务数）
-   删除成员：中断运行中的会话 → 成员会话目录**移入回收站** → 写墓碑，管理面标记「已删除」
-   已删除成员集中展示，回收站路径可复制
-   删除后**回收成员名额**：roster 仍是 append-only，插件按团队把有效上限抬到「配置上限 + 该团队墓碑数」，删一个就能再加一个（0.2.2 起按团队生效，不再全局加）
-   已删除成员从顶部「子智能体」选择器与内置「智能体团队」面板里消失（在宿主投影出口按墓碑过滤，不改宿主源码）
-   **新版智能体团队（0.2.2-rc.1+）**：上游移除了成员/角色列表，插件在会话页头补回一个只读「成员 N」面板，数据来自会话日志里的 `team/member` 事件
-   顺带修老格式会话：没有 title / sessionListMetadata 投影的 v1 会话补标题，空白草稿重新按「新会话」规则隐藏

## 安装

```sh
dsh plugin --profile web add @chenkai114/dsh-team-admin
```

重载后左侧栏会出现 **团队管理** 入口（插件市场里本包的配置卡也保留）。

未发布前用本地源码链接安装：

```sh
dsh plugin --profile web add link:/Users/chenkai2/data1/www/htdocs/dsh-team-admin
```

或在 profile 的 `package.json` 里手动加：

```json
{
  "dependencies": { "@chenkai114/dsh-team-admin": "link:/Users/chenkai2/data1/www/htdocs/dsh-team-admin" },
  "dsh": { "profile": { "bundles": ["...", "@chenkai114/dsh-team-admin"] } }
}
```

左侧栏「团队管理」入口（0.1.1 起）：

![侧栏入口](https://npmcn.com/package/%40chenkai114/dsh-team-admin/docs/images/sidebar-entry.png)

打开后是完整管理面板，可直接对真实会话操作：

![团队管理面板](https://npmcn.com/package/%40chenkai114/dsh-team-admin/docs/images/team-panel-real.png)

## 用法

1.  搜索并选中一个会话（只列根会话）
2.  面板显示该会话的团队成员
3.  点某个成员的「删除」→ 行内二次确认 → 确认
4.  成员会话进回收站，管理面把它移到「已删除」区

## 删除到底做了什么

| 步骤 | 行为 |
| --- | --- |
| 停止 | 运行中的成员会被中断，最多等 15s 变 inactive；超时则报错不动数据 |
| 清理会话 | 成员会话目录 `~/.dsh/sessions/.../<memberId>/` 移到 `~/.dsh/team-admin/trash/<leadSessionId>/<memberId>-<ms>/`（**移动，不是删除**，可手工恢复） |
| 墓碑 | 写入 `~/.dsh/team-admin/state.json`，管理面据此显示「已删除」 |

## 适用版本

| DSH 版本 | 智能体团队实现 | 插件行为 |
| --- | --- | --- |
| `0.2.2-alpha.1` / `alpha.2` | `packages/experimental/agent-team`（旧） | 删除 / 名额回收 / 投影过滤全量生效；成员面板用宿主自带的 |
| `0.2.2-rc.1` 起 | `packages/team/agent-team`（新） | roster / `maxMembers` 已移除：名额回收自动跳过；删除与投影过滤继续生效；页头补回只读成员面板 |

插件通过运行时能力探测区分两版（新增 `agentTeams.roster`、`health.maxMembers`），不写死版本号；`package.json` 声明 `dsh.requires.dsh = ">=0.2.2-alpha.1 <0.3.0"`。

## 边界（重要）

-   **记录本身不会消失**：宿主 roster 是 append-only，本插件不（也无法）从 Lead 会话日志里抹掉 `team/member` 记录；它只是被墓碑标记，并从投影里过滤掉。管理面与页头成员面板才是"已删除"的真源。
-   **名额会回收（旧版团队）**：插件按团队把有效上限抬到「配置上限 + 该团队墓碑数」，所以删一个就能再加一个；`0.2.2-rc.1` 起上游移除了 `maxMembers`，这套机制自动跳过。
-   **已删除成员不可调度**：新版智能体团队的成员权威已交给 subagent runtime，历史成员只能看、不能派活 —— 这是上游设计，不是本插件限制。
-   **只删成员，不删 Lead**：`lead` 与任意根会话都不受影响。
-   **仅本机**：所有接口只接受回环地址；删除动作不会暴露到网络。
-   **不做的事**：不改内置团队工具的语义、不写 Lead 会话日志、不碰任务板（成员名下的任务仍留在任务板上，需要时用 `team_task_update` reassign）。

## 配置

| 变量 / 字段 | 默认 | 说明 |
| --- | --- | --- |
| `DSH_TEAM_ADMIN_DATA_DIR` | `~/.dsh/team-admin` | 墓碑与回收站根目录 |

## 开发

```sh
npm test          # node:test，纯本地，不依赖运行中的 dsh
```

模块划分与 HTTP 契约见 [docs/CONTRACT.md](https://npmcn.com/package/%40chenkai114/dsh-team-admin/docs/CONTRACT.md)。

## 发布

仓库走 GitHub Actions + npm Trusted Publishing（OIDC），与 dsh-daemon 同构：

1.  npm 包页面 → Settings → Trusted Publisher → GitHub Actions，填 `chenkai2` / `dsh-team-admin` / `publish.yml` / `npm-publish`
2.  升 `package.json` 版本（同时改 `src/index.js` 的 `PLUGIN_VERSION`）→ 打 tag `vX.Y.Z` → 发 GitHub Release
3.  Actions 自动校验 tag/版本、跑测试、`npm publish --provenance --access public`

## License

MIT

## 常见问题

### @chenkai114/dsh-team-admin 是什么？

DSH 插件：GUI 管理任意会话的智能体团队 —— 查看成员、删除角色并清理其持久会话（进回收站，可恢复）、回收成员名额、过滤已删除成员；新旧两版智能体团队都支持

### 如何安装 @chenkai114/dsh-team-admin？

在项目目录运行 npm install @chenkai114/dsh-team-admin，或使用 pnpm add / yarn add / bun add。

### @chenkai114/dsh-team-admin 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/chenkai114\_\_dsh-team-admin 是否存在。

### @chenkai114/dsh-team-admin 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @chenkai114/dsh-team-admin 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @chenkai114/dsh-team-admin 可以商用吗？

@chenkai114/dsh-team-admin 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @chenkai114/dsh-team-admin 的下载量有多少？

根据 npm 官方下载统计，@chenkai114/dsh-team-admin 在 2026/10/10 – 2026/11/08 这 30 天内被下载 3,367 次，日均约 112 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @chenkai114/dsh-team-admin 还在维护吗？

最新版本 0\.2\.7 发布于 2026/11/05（4 天前）；至今共发布 19 个版本，其中过去 12 个月发布了 19 个；首次发布于 2026/11/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。