# @zhangzhian/dsh-devtools-workbench 中文文档

规范地址：https://npmcn.com/package/%40zhangzhian/dsh-devtools-workbench/

版本：0\.3\.1
npm 元数据更新时间：2026-11-03T00:21:05.114Z
中文译文更新时间：2026-11-03T00:38:57.654Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40zhangzhian/dsh-devtools-workbench
原文对照：https://npmcn.com/package/%40zhangzhian/dsh-devtools-workbench/?lang=original
源码仓库：https://codeup.aliyun.com/67617ae720a07de19c7c1633/dsh-plugins

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

- 包体积（解压后）：720 kB，15 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：@deepseek-ai/cordis ~4\.0\.4，@deepseek-ai/dsh-session ^0\.2\.0-rc\.2，@deepseek-ai/schemastery ~3\.18\.4，@deepseek-ai/dsh-api-gateway ^0\.2\.0-rc\.2，@deepseek-ai/dsh-host-webserver ^0\.2\.0-rc\.2，@deepseek-ai/dsh-client-ui-slots ^0\.2\.0-rc\.2，@deepseek-ai/dsh-client-ui-primitives ^0\.2\.0-rc\.2，@deepseek-ai/dsh-client-ui-conversation ^0\.2\.0-rc\.2，@deepseek-ai/dsh-client-ui-sidebar-right ^0\.2\.0-rc\.2
- 首次发布：2026-10-20T03:13:46.249Z
- 最新版本发布：2026-11-03T00:21:04.868Z
- 已发布版本数：6（近 12 个月 6 个）

## 中文简介

DSH 开发工具：底部工作台（终端 + 输出）

## 安装

```sh
npm install @zhangzhian/dsh-devtools-workbench
```

也可以使用：`pnpm add @zhangzhian/dsh-devtools-workbench`、`yarn add @zhangzhian/dsh-devtools-workbench`、`bun add @zhangzhian/dsh-devtools-workbench`

## README

[英语](https://npmcn.com/package/%40zhangzhian/dsh-devtools-workbench/#readme-english) | 简体中文

# @zhangzhian / dsh-devtools-workbench

中文：DSH**底部工作台组件**：贴在窗口底部、可拖动、可收起的一块面板， 里面跑真正的终端，另有一个输出页签显示插件自己的运行轨迹。

## 安装

不要单独装它。装清单包 —— 它会作为依赖自动拉下来，并在插件页上给你一个可开关的组件行。

```bash
dsh plugin --profile web add @zhangzhian/dsh-devtools
```

## 提供什么

-   **宿主半**：一条路由 `GET /devtools-workbench/bundle/chunk-terminal.js`，把懒加载的 英文释义终端本身用的是**宿主**的企业(`ctx.webTerminals`），所以宿主的 并发上限、空闲回收、崩溃恢复三套机制照常生效 —— 本插件从不自己起进程。
-   **客户端半**：`body` 层的固定宿主 + 面板本体，开关在会话标题栏右侧的终端图标上。
-   **终端页签**： 真的回收进程的关闭动作。右侧的**终端实例列表**默认收起（只有一个终端时它只写 一行「终端 1」，白占宽度），页签条右边有一颗图标切换，状态跟着会话记住； 新建终端会自动展开它。
-   **输出页签**：插件自己的运行轨迹 —— 终端阶段迁移、几何测量降级、持久化失败。 "终端打不开"的时候看这里。
-   **只挤高度，绝不写宽度**：面板只在 `<html>` 上写一个 `--devtools-workbench-height` 变量，会话列用 `margin-bottom` 消费它。写宽度就得 自己接管左右两侧的开合与动画。
-   **缺依赖会降级**：宿主没有终端服务时，终端页签显示一句提示，其余功能照常。

## 要求

-   近年来 `0.2.0-rc.2` 【中文译文 `package.json` 里）。
-   浏览器侧运行时：`dsh.client.platform` 是 `web`。
-   宿主的终端服务（`@deepseek-ai/dsh-api-terminal-controller`）是**可选**的 —— `dsh web` 默认带它，但没有它面板也能干净降级。
-   `@xterm/xterm` 与 `@xterm/addon-fit` 【翻译】【翻译】

* * *

## 英语

# @zhangzhian / dsh-devtools-workbench

这个 **底部工作台** DSH devtools组件：一个可调整大小，可折叠的面板 到窗口底部，通过主机的终端服务运行一个真正的PTY， 加上一个Output选项卡，显示插件自己的诊断信息。

## 安装

不要直接安装此软件包。安装bundle包——它把它作为一个 依赖项，并在插件页面上提供一个可切换的组件行。

```bash
dsh plugin --profile web add @zhangzhian/dsh-devtools
```

## 它提供了什么

-   **主机一半**：一条路线； `GET /devtools-workbench/bundle/chunk-terminal.js`，哪艘船 惰性加载的xterm包。终端本身使用 **主机的** 企业 （`ctx.webTerminals`)，因此主机的并发上限、空闲回收和崩溃恢复 所有这些仍然适用-这个插件永远不会生成自己的进程。
-   **客户端一半**:一个 `body`\-水平固定层加上面板，从终端图标打开 在会话头中。
-   **终端选项卡**：一个真正的PTY，几个选项卡，每个选项卡的shell选择器，重新连接/重试，和一个 接近的行动实际上收获了这个过程。
-   **输出选项卡**：插件自己的跟踪-终端相变，几何回退， 持久性的失败。当“终端无法打开”时，您可以在这里查看。
-   **挤高度，不要挤宽度**：面板写单 `--devtools-workbench-height` CSS变量on `<html>`;对话列消耗 它通过 `margin-bottom`.书写宽度意味着要占用两侧栏的布局和 动画。
-   **优雅降级**：没有主机终端服务，终端选项卡显示提示 其他的都在工作。

## 要求

-   近年来 `0.2.0-rc.2` 或稍后(对等体范围声明在 `package.json`）。
-   浏览器端运行时： `dsh.client.platform` 是 `web`.
-   主机终端服务(`@deepseek-ai/dsh-api-terminal-controller`)是 **可选** - - - - - - 它随附 `dsh web` 默认情况下，但没有它，面板会干净地降级。
-   这个 `@xterm/xterm` 和 `@xterm/addon-fit` 依赖被捆绑；平台没有 为第三方插件提供xterm。

## 常见问题

### @zhangzhian/dsh-devtools-workbench 是什么？

DSH 开发工具：底部工作台（终端 \+ 输出）

### 如何安装 @zhangzhian/dsh-devtools-workbench？

在项目目录运行 npm install @zhangzhian/dsh-devtools-workbench，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/cordis（~4\.0\.4）、@deepseek-ai/dsh-session（^0\.2\.0-rc\.2）、@deepseek-ai/schemastery（~3\.18\.4）、@deepseek-ai/dsh-api-gateway（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-host-webserver（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-client-ui-slots（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-client-ui-primitives（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-client-ui-conversation（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-client-ui-sidebar-right（^0\.2\.0-rc\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @zhangzhian/dsh-devtools-workbench 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @zhangzhian/dsh-devtools-workbench 支持 ESM 还是 CommonJS？

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

### @zhangzhian/dsh-devtools-workbench 可以商用吗？

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

### @zhangzhian/dsh-devtools-workbench 还在维护吗？

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