让开源，少一点语言距离。
npm包中文文档

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

中文文档
0.2.1-rc.5发布于 2026/11/01MITTypeScriptES Module

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

中文使用文档
中文原文
文档目录4 节
  1. 工具表面
  2. 行为笔记
  3. 预设的例子
  4. 测试

@hy-sde-org dsh-tool-debug

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

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

npm包安装了一个零效果的bundle补丁(在官方的 挽具与 debug 名字，所以没有什么可以禁用或 影子);工具本身是通过添加所提供的 座席预设行 转到用户预设。安装 单独捆捆不会折断靴子。挂载预设后，座席将获得 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 共发布 11 个版本，首次发布于 2026/08/22；过去 12 个月发布了 11 个版本。

版本发布日期距今
0.2.1-rc.5latest2026/11/012 天前
0.2.1-rc.32026/10/259 天前
0.2.1-alpha.42026/10/1618 天前
0.2.1-alpha.22026/10/1321 天前
0.2.0-rc.22026/10/031 个月前
0.1.7-rc.22026/09/291 个月前

关于 @hy-sde-org/dsh-tool-debug 的常见问题

@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 和提交记录判断。