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

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

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

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

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

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

- 包体积（解压后）：934 kB，101 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：@deepseek-ai/cordis ~4\.0\.4，@deepseek-ai/dsh-fs ^0\.2\.0-rc\.2，@deepseek-ai/dsh-tools ^0\.2\.0-rc\.2，@deepseek-ai/schemastery ~3\.18\.4，@deepseek-ai/dsh-subprocess ^0\.2\.0-rc\.2，@deepseek-ai/dsh-util-values ^0\.2\.0-rc\.2，@deepseek-ai/dsh-storage-domain ^0\.2\.0-rc\.2，@deepseek-ai/dsh-typert-protocol ^0\.2\.0-rc\.2，@deepseek-ai/dsh-api-workspace-files ^0\.2\.0-rc\.2
- 首次发布：2026-10-08T06:50:38.630Z
- 最新版本发布：2026-11-03T00:23:26.091Z
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

dsh-devtools 的启动管理组件：启动项扫描 + 运行日志工作台 + run\_\* 工具

## 安装

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

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

## README

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

# @zhangzhian / dsh-devtools-runs

中文：DSH **启动管理组件**：扫描工作区里可启动的东西、托管启动、看日志和端口， 代理人 `run_*` 工具。

![启动管理：可启动项、运行中的服务](https://cdn.jsdelivr.net/npm/@zhangzhian/dsh-devtools@0.3.1/images/runs-panel.png)

## 安装

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

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

## 提供什么

-   **宿主半**：代理 `run_scan`、`run_start`、`run_stop`、`run_list`、`run_logs`、 `run_ports`、`run_plan_get`、`run_plan_set`。
-   **客户端半**：面板 —— 按类型分组的可启动项、按工作区持久化的启动列表、带排队和并发 “run”，“run”，“run”，“run”。

## 要求

-   近年来 `>= 0.2.0-rc.2`。
-   不需要额外装依赖：`@deepseek-ai/*` 齐刷刷，刷刷刷，刷刷刷，刷刷刷，刷刷刷。

* * *

## 英语

# @zhangzhian / dsh-devtools-runs

这个 **启动管理组件** DSH devtools：扫描工作空间中可运行的 在管理下启动它，监视日志和端口，以及一组 `run_*` 代理工具。

![Start management: candidates, running services](https://cdn.jsdelivr.net/npm/@zhangzhian/dsh-devtools@0.3.1/images/runs-panel.png)

## 安装

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

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

## 它提供了什么

-   **主机一半**：代理工具 `run_scan`， `run_start`， `run_stop`， `run_list`， `run_logs`， `run_ports`， `run_plan_get`， `run_plan_set`.
-   **客户端一半**：面板-按类型分组的可运行候选人，工作空间持久 启动列表、带队列和并发上限的托管运行、日志跟踪和端口 跟踪进程返回到拥有它们的运行的快照。

## 要求

-   近年来 `>= 0.2.0-rc.2`.
-   没有额外的依赖： `@deepseek-ai/*` 是由DSH安装本身提供的 （声明为对等依赖项，因此不会第二次安装）。

## 常见问题

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

dsh-devtools 的启动管理组件：启动项扫描 \+ 运行日志工作台 \+ run\_\* 工具

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

在项目目录运行 npm install @zhangzhian/dsh-devtools-runs，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/cordis（~4\.0\.4）、@deepseek-ai/dsh-fs（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-tools（^0\.2\.0-rc\.2）、@deepseek-ai/schemastery（~3\.18\.4）、@deepseek-ai/dsh-subprocess（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-util-values（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-storage-domain（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-typert-protocol（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-api-workspace-files（^0\.2\.0-rc\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

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

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

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

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

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

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

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

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