dsh-ptc-parse-frame
DSH PTC run_code 插件：附加解析错误的行号和代码框，使语法错误清晰可见。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:yi-Xu-0100/dsh-ptc-parse-frame#7945bea4aa4b25c2e41b124a3a25c4055c883035Ptc Parse Frame 以 dsh-ptc-parse-frame 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
给 DSH 的 PTC（Programmatic Tool Calling）补上「解析失败时的行号 + 代码框」。
在 DSH 里，run_code 的程序在执行前会先经过 TypeScript 类型剥离
（stripTypeScriptTypes）。语法出错时，DSH 只把 error.message 转发给模型，
丢掉了错误栈里的行号和 ^^^ 代码框。于是漏一个逗号只会得到：
code run failed (exception): Expected ',', got 'string literal'
模型不知道是哪一行、哪个字符串列表漏了，只能整段重吐重试。
本仓库提供一个 Host 插件，把这段位置信息补回去（真实结果还会带运行时自己的
File sandbox: 行，插件把代码框插在解析消息之后、这些后缀之前）：
Error: code run failed (exception): Expected ',', got 'string literal'
run_code.ts:1
const a = ["x" "y"];
^^^
File sandbox: workspace-write.
0.2.0 已实现并安装。 这是一个 Host-only 的 profile bundle：
tools/post-execute，只在 run_code 的解析失败上改写结果；plugin_manager install_bundle 安装到 desktop profile；仓库目录本身就是 bundle 根目录（package.json 声明了
dsh.bundle.patch）。首选官方入口：
plugin_manager action: install_bundle target: <本仓库绝对路径>
安装会：
link: 依赖加入 profile；dsh-ptc-parse-frame 加入 dsh.profile.bundles；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 | 行号前缀，也是「已经带位置」检测用的名字。 |
插件只在以下条件同时成立时改写结果：
run_code；isError: true；code；code run failed (exception): <parser message> 开头；code 仍然失败，且解析器消息与第 4 步一致；run_code.ts:<数字> 形式的位置。任一条件不满足就原样返回。运行时异常（例如 throw new Error("boom")）的程序
能正常解析，因此不会被误判；其它工具的结果完全不经过改写。
插件自身抛错时返回下游 listener 的原始 decision，绝不改变失败原因。
| 版本 | 形态 | 本仓库是否适用 |
|---|---|---|
| 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 插件 | 本插件 |
无运行时依赖，测试直接使用 Node 24 的 node:module.stripTypeScriptTypes：
npm test
等价于：
node test/plugin.test.mjs
node --test 在 DSH 沙箱里会因为测试运行器需要 spawn 子进程而报 EPERM，
所以脚本直接运行测试文件（node:test 在单文件模式下进程内执行）。
| 文档 | 内容 |
|---|---|
| docs/overview.md | 问题、目标、非目标 |
| docs/background.md | 根因与证据 |
| docs/compatibility.md | 两版本差异与旧方案为何失效 |
| docs/design.md | 插件设计 |
| docs/implementation-plan.md | 实施计划与验收标准 |
| docs/verification.md | 验证矩阵与记录 |
| docs/publishing.md | 发布到 GitHub 的步骤 |
| docs/upstream.md | 上游 issue/discussion 现状与评论草稿 |
| docs/research-notes.md | 复现、源码取证与 API 确认 |
| docs/upstream-comment.md | 可直接粘贴到 #7618 的评论草稿 |
MIT，见 LICENSE。