前言¶
在 DeepSeek Harness（DSH）中，run_code 的程序在执行前会先经过 TypeScript 类型剥离（stripTypeScriptTypes）。一旦语法出错，DSH 只把 error.message 转发给模型，错误栈里的行号和 ^^^ 代码框被丢弃。漏一个逗号只会得到类似下面的结果：
code run failed (exception): Expected ',', got 'string literal'
模型无法知道是哪一行、哪个字符串列表漏了，只能整段重吐重试。dsh-ptc-parse-frame 旨在补上这段位置信息，把解析失败时的行号与代码框放回给模型。
这是什么¶
dsh-ptc-parse-frame 是一个 Host 插件（profile bundle），给 DSH 的 PTC（Programmatic Tool Calling）run_code 补上「解析失败时的行号 + 代码框」。
- 维护者：yi-Xu-0100
- 分类：客户端
- GitHub：https://github.com/yi-Xu-0100/dsh-ptc-parse-frame
- 核心价值：在语法错误时把位置信息还给模型，减少无意义的重试。
核心功能¶
- 监听
tools/post-execute，只在run_code的解析失败上改写结果。 - 在错误消息中插入行号前缀与代码框（
run_code.ts:<数字>），代码框包含出错行及其上下文。 - 支持配置代码框的最大行数、是否启用以及行号前缀名称。
- 自带 23 个单元测试，覆盖行号、代码框、运行时异常、幂等、配置与回退。
- 插件自身抛错时返回下游 listener 的原始 decision，不改变失败原因。
安装与启用¶
本仓库本身就是 bundle 根目录（package.json 声明了 dsh.bundle.patch）。推荐使用官方入口：
plugin_manager action: install_bundle target: <本仓库绝对路径>
安装会：
- 把本目录作为
link:依赖加入 profile； - 把
dsh-ptc-parse-frame加入dsh.profile.bundles； - 立即应用 bundle patch（
patchReload: live）。
如需卸载：
plugin_manager action: remove_bundle target: dsh-ptc-parse-frame
修改 index.js 之后，需要让 Host 做一次 profile recomposition（例如开关一次 bundle）或重启 DSH NEXT，运行中的进程才会加载新的模块版本。
配置¶
默认配置（cordis.patch.yml）：
- insert:
- id: ptc-parse-frame
name: dsh-ptc-parse-frame
config:
enabled: true
maxFrameLines: 10
sourceName: run_code.ts
| 配置 | 默认值 | 说明 |
|---|---|---|
enabled |
true |
设为 false 时插件完全 no-op（但保持已安装）。 |
maxFrameLines |
10 |
代码框正文的最大行数（1–40），优先保留 caret 附近的行。 |
sourceName |
run_code.ts |
行号前缀，也是「已经带位置」检测用的名字。 |
兼容性¶
| 版本 | 形态 | 本仓库是否适用 |
|---|---|---|
| DSH Desktop 2.0.17（PTC 0.2.0-rc.2） | resources/app 解包 | 旧方案：文件补丁（legacy，见 docs/compatibility.md） |
| DSH NEXT 2.0.19-next（PTC 0.2.1-rc.2） | resources/app.asar + profile 插件 | 本插件 |
典型用法¶
当 run_code 因语法错误失败时，插件会将解析错误消息改写为类似下面的形式：
Error: code run failed (exception): Expected ',', got 'string literal'
run_code.ts:1
const a = ["x" "y"];
^^^
File sandbox: workspace-write.
模型可以看到具体的行号与代码片段，从而直接修正错误，而不需要重新生成整段代码。
适用场景与注意¶
- 适合在 DSH NEXT（PTC 0.2.1-rc.2）中使用，以 profile bundle 方式安装。
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证（MIT）。
- 插件只在特定条件同时成立时改写结果：工具名是
run_code、结果isError: true、工具参数里有原始code、错误消息以code run failed (exception): <parser message>开头、用与运行时相同的包装重新解析原始code仍然失败且解析器消息一致、结果文本里还没有run_code.ts:<数字>形式的位置。
短结尾¶
该插件将解析失败时的位置信息还给模型，降低无意义重试。目录页：https://www.skillhub.cn/plugins/yi-Xu-0100/dsh-ptc-parse-frame；GitHub：https://github.com/yi-Xu-0100/dsh-ptc-parse-frame。
