# @dippingorange/dsh-conductor-ui 中文文档

规范地址：https://npmcn.com/package/%40dippingorange/dsh-conductor-ui/

版本：2\.3\.1
npm 元数据更新时间：2026-11-11T02:52:03.711Z
中文译文更新时间：2026-11-12T12:36:17.947Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：96.9 kB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-10-21T05:31:19.234Z
- 最新版本发布：2026-11-11T02:52:03.502Z
- 近 30 天下载量：2601（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 14 个）

## 中文简介

指挥者网络任务板:现场任务状态,报告,取消,以及后续.

## 安装

```sh
npm install @dippingorange/dsh-conductor-ui
```

也可以使用：`pnpm add @dippingorange/dsh-conductor-ui`、`yarn add @dippingorange/dsh-conductor-ui`、`bun add @dippingorange/dsh-conductor-ui`

## README

# Conductor Task Board（Web UI）

这是 `@dippingorange/dsh-conductor` 的可视化面板，独立成一个 Client bundle，便于单独启停。

## 入口

### 1\. 输入框工具栏 → 右侧栏 tab（日常使用）

输入框卡片底部工具栏最左侧的 `▦` 图标（`conversation.input.left`）。点击后：

-   在**右侧栏**打开「任务板」tab，聊天与看板并排；
-   当前会话的任务以紧凑单列显示；
-   支持取消（两次确认）、追加指令、完整报告弹窗；
-   顶部可切换「执行者与发布者」；
-   关掉右侧栏后任务继续运行，点 `▦` 随时再打开。

不再向 `conversation.composer.dock` 注入大卡片，因此不会和 activity/usage 参数行挤在一起。

### 2\. 整页任务板

左侧栏的 **任务板** 面板图标（`sidebar.panellist`，和 Plugins / Schedule 同级）， 对应 `main` slot 里的整页视图（`conductor-tasks`）：

-   三列看板：**进行中 / 已完成 / 失败·取消**；
-   汇总所有会话的任务，顶部按会话名称筛选；
-   卡片显示任务号、角色、执行路由、会话标记、耗时、报告预览；
-   同样支持取消、追加指令、完整报告；
-   顶部「返回对话」回到当前会话。

两个界面都每 2 秒轮询；操作后立即刷新。

### 3\. 执行者与发布者

两种看板里都有「执行者与发布者」标签：

-   **任务发布者（旗舰）**：选 provider/model，应用为 DSH 默认模型；新建会话使用它；
-   **执行者（次旗舰）**：固定角色列表，每个角色绑定 provider/model，可改名、说明、增删；
-   每个执行者显示最近一次任务的**上下文占用百分比**和**上次压缩后的对话轮数**；
-   **压缩阈值**：每个执行者可单独设置，默认 40%（DeepSeek 在 40% 后质量下降的观察值）；
-   压缩成功后，左侧 **任务板** 图标和 **执行者与发布者** 标签出现绿点；打开后清除；
-   **路由策略**：默认只允许使用执行者角色，旗舰不能自行指定 provider/model；
-   保存后写入 `$DSH_HOME/conductor/roles.json`，立即生效。

## 数据来源

由 `@dippingorange/dsh-conductor` 的 Host 半注册的同源接口：

| 方法 | 路径 | 作用 |
| --- | --- | --- |
| GET | `/conductor/board?session=<id>` | 当前会话的任务列表 |
| GET | `/conductor/boards` | 所有会话的任务（整页看板用） |
| GET | `/conductor/result?session=<id>&task=<T1>` | 单个任务的完整报告 |
| GET | `/conductor/export` | 导出终态任务、完整报告、上下文统计 |
| POST | `/conductor/import` | 插件重载后恢复终态任务（running/queued 跳过） |
| POST | `/conductor/action` | `{session, task, action: "cancel" | "followup", message?}` |
| GET | `/conductor/roles` | 发布者、执行者角色、路由策略、上下文统计 |
| GET | `/conductor/roles/audit` | 角色修改审计（最近 N 条） |
| GET | `/conductor/notifications` | 压缩未读绿点状态 |
| POST | `/conductor/notifications/read` | `{target: "board" | "roles"}` 清除绿点 |
| POST | `/conductor/roles` | 保存完整的角色配置 |
| GET | `/conductor/routes` | 所有 provider 及其模型（下拉框数据） |
| POST | `/conductor/lead/apply` | 把发布者写回 DSH 默认模型 |

API 与 Web GUI 同源，沿用 GUI 的访问边界，不要把 GUI 端口暴露到不可信网络。

## 文件

-   `client.js` —— 浏览器半：slot 注册、紧凑条、整页看板、弹窗、轮询
-   `index.js` —— Host 半（空插件，只为挂载 bundle 行）
-   `cordis.patch.yml` —— 插件行
-   `locale/en.json`、`locale/zh.json` —— Plugin Manager 显示名
-   `icon.svg` —— 插件图标

## 开发注意

-   不使用 Harness Client 包，只从浏览器模块表取 `react`；
-   颜色/边框全部使用 `--dsw-alias-*` 主题 token；
-   不读取宿主 DOM，不向 `document.body` 追加节点；
-   修改 `client.js` 后在 Plugin Manager 里关开一次该插件（或刷新页面）即可加载新版本。

## 常见问题

### @dippingorange/dsh-conductor-ui 是什么？

指挥者网络任务板:现场任务状态,报告,取消,以及后续\.

### 如何安装 @dippingorange/dsh-conductor-ui？

在项目目录运行 npm install @dippingorange/dsh-conductor-ui，或使用 pnpm add / yarn add / bun add。

### @dippingorange/dsh-conductor-ui 支持 TypeScript 吗？

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

### @dippingorange/dsh-conductor-ui 支持 ESM 还是 CommonJS？

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

### @dippingorange/dsh-conductor-ui 可以商用吗？

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

### @dippingorange/dsh-conductor-ui 的下载量有多少？

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

### @dippingorange/dsh-conductor-ui 还在维护吗？

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