# @hy-sde-org/dsh-tool-debug 中文文档

规范地址：https://npmcn.com/package/%40hy-sde-org/dsh-tool-debug/

版本：0\.2\.1-rc\.5
npm 元数据更新时间：2026-11-01T04:24:04.163Z
中文译文更新时间：2026-11-01T09:27:36.070Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：132 kB，22 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：2 个
- peer 依赖：@deepseek-ai/cordis ~4\.0\.5，@deepseek-ai/dsh-tools ^0\.2\.1-rc\.5，@deepseek-ai/dsh-timeout ^0\.2\.1-rc\.5，@deepseek-ai/dsh-system-prompt ^0\.2\.1-rc\.5
- 首次发布：2026-08-22T02:33:18.863Z
- 最新版本发布：2026-11-01T04:24:04.005Z
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

面向模型的调试适配器协议调试工具，在独立的DAP接缝上具有28个操作（启动/附加，断点，步进，线程/堆栈/作用域/变量/求值，拆卸，内存，终止）-无需更改线轴。

## 安装

```sh
npm install @hy-sde-org/dsh-tool-debug
```

也可以使用：`pnpm add @hy-sde-org/dsh-tool-debug`、`yarn add @hy-sde-org/dsh-tool-debug`、`bun add @hy-sde-org/dsh-tool-debug`

## README

# @hy-sde-org dsh-tool-debug

这个 `debug` 工具插件DeepSeek线束，建立在独立的DAP 从同级包中 [`@hy-sde-org/dsh-dap`](https://npmcn.com/package/%40hy-sde-org/dap/)1个工具，28个 操作-启动/附加，源/函数/指令/数据断点， / /暂停/继续步骤中,线程加/范围/变量/评估、 拆卸，内存访问，模块，加载源，自定义请求， 捕获的输出和终止。

```bash
dsh plugin --profile web add @hy-sde-org/dsh-tool-debug
```

npm包安装了一个零效果的bundle补丁(在官方的 挽具与 `debug` 名字，所以没有什么可以禁用或 影子);工具本身是通过添加所提供的 [座席预设行](https://npmcn.com/package/%40hy-sde-org/dsh-tool-debug/examples/agent-preset) 转到用户预设。安装 单独捆捆不会折断靴子。挂载预设后，座席将获得 `debug` 工具，可以启动/附加真正的调试器(debugpy, lldb-dap, gdb， dll, js-debug，…)通过挂载的DAP提供程序。

## 工具表面

-   `name`： `tool-debug`， `inject`： `['tools', 'dap', 'systemPrompt']`
-   配置: `maxResultChars` (16000), `requestTimeoutSec` (30), `timeoutMs` (12万，由 `dsh-tool-call-timeout-policy`）。
-   需要一个会话工作区cwd (`exec.agent.session.header.cwd`)和 不并发安全：调试会话是排他性的。

## 行为笔记

-   一个活动会话：一个活动会话必须被终止（或已被终止） 在另一次发射/附加前终止（退出）。
-   路径解析会话工作区； `cwd` 覆盖每个调用。
-   每个请求超时通过组合 `AbortSignal` （call + timeout）。
-   适配器选择错误命名丢失的适配器和安装命令 （`pip install debugpy`， `apt install gdb`,……)。
-   断点突变在每个会话中序列化，并传播到每个会话 当适配器报告会话树时的活动会话。

## 预设的例子

`examples/agent-preset/` 包含“准备复制”用户预设 （`agent.cordis.yml` + `preset.yml`)，它挂载调试组( `dap` 服务在其自己的隔离域中，因此每个代理拥有其适配器进程) 加上 `tool-debug` 在它旁边划船。将目录复制到 `~/.dsh/.agent-presets/<id>/`，在Web UI预设选择器中选择该预设 (或 `dsh agent` CLI)，该预设中的座席可以调用 `debug`.

## 测试

`pnpm --filter @hy-sde-org/dsh-tool-debug test` （vitest）包含论证 解析、呈现和端到端的启动/断点/步骤/求值流 通过脚本化的DAP适配器。

## 常见问题

### @hy-sde-org/dsh-tool-debug 是什么？

面向模型的调试适配器协议调试工具，在独立的DAP接缝上具有28个操作（启动/附加，断点，步进，线程/堆栈/作用域/变量/求值，拆卸，内存，终止）-无需更改线轴。

### 如何安装 @hy-sde-org/dsh-tool-debug？

在项目目录运行 npm install @hy-sde-org/dsh-tool-debug，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/cordis（~4\.0\.5）、@deepseek-ai/dsh-tools（^0\.2\.1-rc\.5）、@deepseek-ai/dsh-timeout（^0\.2\.1-rc\.5）、@deepseek-ai/dsh-system-prompt（^0\.2\.1-rc\.5）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @hy-sde-org/dsh-tool-debug 支持 TypeScript 吗？

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

### @hy-sde-org/dsh-tool-debug 支持 ESM 还是 CommonJS？

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

### @hy-sde-org/dsh-tool-debug 需要什么版本的 Node\.js？

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

### @hy-sde-org/dsh-tool-debug 可以商用吗？

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

### @hy-sde-org/dsh-tool-debug 还在维护吗？

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