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

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

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

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

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

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

- 包体积（解压后）：44.7 kB，22 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 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/dsh-api-workspace-files ^0\.2\.0-rc\.2
- 首次发布：2026-10-08T06:49:34.724Z
- 最新版本发布：2026-11-03T00:19:53.908Z
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

dsh-devtools 各组件包共用的纯函数与类型（不是插件组件：不插 loader 行，插件页里看不见）

## 安装

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

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

## README

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

# @zhangzhian / dsh-devtools-shared

`dsh-devtools` （files / git / runs / Settings / workbench / tunnel-core） 日志、路径处理、文件系统适配、客户端描述符外壳。

## 安装

不要单独装它。它不是插件、不出现在插件页。装清单包即可。

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

## 提供什么

-   **宿主半**：`log`（`[dsh-devtools]` 出口国),`paths`、`fs-util`、`repo-paths`、 `wake`、`tool-scope`、`log-format`。
-   **客户端半**：`client-kit`严格编解码器，`SCOPE_PARAMETER`、方法包装）， 构建时被内联进消费它的组件包(文件/ git /运行/设置/ tunnel-core)。

## 要求

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

* * *

## 英语

# @zhangzhian / dsh-devtools-shared

由DSH devtools组件包（files / git / runs /）共享的内部帮助程序 Settings / workbench / tunnel-core)：日志记录、路径处理、文件系统适配器和 客户端描述符shell。

## 安装

不要直接安装此软件包。它不是一个插件，永远不会显示在插件上 页面。而是安装bundle包。

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

## 它提供了什么

-   **主机一半**： `log` ( `[dsh-devtools]` 出口国), `paths`， `fs-util`， `repo-paths`， `wake`， `tool-scope`， `log-format`.
-   **客户端一半**： `client-kit` (描述符shell：严格编解码器， `SCOPE_PARAMETER`， 方法包装器)，内联到使用它的组件包中(files / git / 运行/设置/隧道-核心)在构建时。

## 要求

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

## 常见问题

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

dsh-devtools 各组件包共用的纯函数与类型（不是插件组件：不插 loader 行，插件页里看不见）

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

在项目目录运行 npm install @zhangzhian/dsh-devtools-shared，或使用 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/dsh-api-workspace-files（^0\.2\.0-rc\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

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

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

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

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

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

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

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

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