dsh-ptc-plus

PTC Plus 给 DSH 的 PTC 模式一个会话绑定的持久 TypeScript REPL。 每次 run_code 都在同一个会话里继续。上一次 run_code 的变量、导入和结果，下一次还能直接用。

[!NOTE] 社区插件，与 DeepSeek 或 DSH 无隶属、无背书。

[!IMPORTANT] 面向 danger-full-access 设计：可直接访问 Node.js 与操作系统，不另加沙箱。仅在可接受此权限的环境使用。

设置卡片展示即时配置和 enabled 开关。

默认 PTC 模式的问题

DSH 的 PTC 模式让每次 run_code 都从新环境开始。模型算过的东西，下一次还要重发。写错一行，整段代码重发。这个插件把 run_code 接到一个会话级环境里，后面的调用直接复用之前的东西。

三个最直接的场景

状态跨调用

第一个 run_code 算完：

import { readFile } from 'node:fs/promises'
const manifest = JSON.parse(await readFile('package.json', 'utf8'))
const deps = Object.keys(manifest.dependencies ?? {})
return deps.length

第二个直接接着用：

return deps.map(dep => dep + '@' + manifest.dependencies[dep])

deps 和 manifest 还在。setup 代码只发一次。

修错不重发

默认情况下，结果不对或执行失败，模型只能把整个代码块再发一遍。

PTC Plus 下它只发这一行：

edit_run_code({ edits: [{ old_string: 'deps.length', new_string: 'deps' }] })

模型只发改动，完整源码留在对话之外。精确文本替换和正则替换都有限制，坏的正则不会卡住。

当被拒 cell 的末尾可唯一验证为缺少一个闭合符时，诊断会直接给出应用该修正并重运行所需的完整 edit_run_code(...) 调用。生成的调用带有 expected_target_call_seq 前置条件；如果另一个 cell 已先成为 edit 目标，它会拒绝且不执行。PTC Plus 不会自动应用这项建议；有歧义或没有持久目标身份的修复仍需提交修正后的源码。

模块语法

DSH 的 PTC 模式把每个 run_code 当作 async function body 执行，静态 import 和 export 声明在这个函数体里无效。PTC Plus 会在执行前用 AST 分析适配这些形式。

模型照常写：

import { readFile } from 'node:fs/promises'

依赖从项目解析，具名和默认导入保持 live 且只读。模型不需要知道 run_code 其实是一个函数体。

一次配对实测

一次身份盲化的配对实验使用了 opencode-go/deepseek-v4-flash。两个 arm 使用同一版本夹具、任务 prompt、权限，每个任务重复两次，每个 arm 共 18 个 session。

模块语法任务的区分最清楚：PTC Plus 两次都只用一次 run_code 完成；未启用 PTC Plus 的 DSH PTC 模式两次都未满足静态 import 要求，尝试过程合计用了 8 次工具调用。

这是一次有随机性的配对观测，不是性能保证。预设机器预算在 PTC Plus 的 18 个 session 中有 2 个超限，未启用 PTC Plus 的 18 个 session 中有 5 个超限，因此整组矩阵没有通过 machine acceptance。Token 流量包含 input、cache-read、cache-write 和 output token。夹具、配对规则、指标与盲评流程见评测说明。

真实会话：长代码与真实的 edit_run_code 修复调用；修复从未重发源码。

设置

打开 设置 → 插件配置 使用上面的设置卡片。卡片跟随 DSH 界面语言：界面设为 English 时显示英文，设为中文时显示中文。enabled 是即时生效的总开关：关闭后只保留卡片和这个开关，开启后恢复 session runtime 以及 run_code/edit_run_code。

设置按常用与兼容性、可选能力、高级行为和资源限制分区；需要主动决策的选项位于前面，资源限制位于后面。

“使用 PTC Plus 增强工具卡片”默认开启，提供可展开的源码、结果、执行状态和功能标记。关闭后，run_code 与 edit_run_code 使用 DSH 原生工具卡片；这个开关只影响显示。

“允许执行缺少摘要的 run_code”默认开启。模型没有提供外层 description 时，代码仍会执行；启用增强工具卡片时，界面显示备用摘要。关闭本设置后按 DSH 原生规则校验。这个开关不改变模型请求或原始调用参数。

插件启用且会话使用 ptc preset 时，会话头部显示绿色 PTC Plus 标识。悬浮、聚焦或点击后可以查看下一 cell 可复用的变量、函数、类和 import，并展开其有界定义源码。卡片只读取已提交的源码，不读取运行时值、不触发 getter，也不执行代码。正文中的 run_code 与 edit_run_code 仍可展开查看源码和结果；只有结果 metadata 能证明某项功能确实生效时，预览才显示对应标记。

真实会话：“REPL 可复用绑定”卡片展示下一 cell 可直接复用的 binding。

所有设置都会实时应用，并保留已有 binding。已提交的 cell 在完整执行期间使用同一份配置；执行期间发生的更新用于随后提交的 cell。更新失败会回滚。Node 在 worker 创建时固定 V8 old-generation 上限，因此活动 session worker 存在时修改这一项会被拒绝，释放 session 后才能修改。启用失败时，运行时会回滚并把设置保持为停用。

cordisToolsEnabled 默认关闭。打开后，DSH 官方 Cordis 工具、owner guidance 与精确的 cordis-plugin-development companion Skill 会作为一个整体加入 PTC agent；同一 shipped preset 目录中的其他 Skill 不会随之暴露。关闭时这三项也会一起移除；它不切换 preset，也不改变 run_code/edit_run_code 的直接调用面。Cordis 能在实时 DSH runtime 中运行模型编写的插件，开启它需要接受 shell 级信任。

如果 Cordis 调用在 cell 已经赋值大段 host 或 client 源码之后才失败，这些顶层 binding 仍会保留。后续只需在短 cell 中重试 Cordis 调用并复用该 binding，无需再次传输源码。

cold recovery 或重新启用 Cordis 后，已记录的 Cordis value 仍是历史数据，但不能证明进程内 Plugin、Run、approval 或先前 Inspect observation 仍然存活。PTC Plus 会提供有界恢复 context，直到一次新的成功 Cordis Inspect 调用验证当前进程。

详见 客户端 UI、ADR 0019 与 ADR 0020。

范围

PTC Plus 提供会话绑定的持久 run_code 层。原生工具的权限、策略、审批、取消、sandbox 和进程治理仍由 DSH 与操作系统负责。

安装

要求 Node.js ^22.19.0 || >=24.0.0，并已安装带 TypeScript PTC 模式的 DSH。把 npm 正式包安装到你实际使用的 profile：

dsh plugin --profile <profile> add dsh-ptc-plus
dsh --profile <profile> --dump-config

安装后重启对应的 DSH profile。固定 npm 版本、GitHub、本地 checkout 和 tarball 安装方式见安装指南。

Windows 开发时可双击 scripts\run-dev-dsh.cmd 启动一个独立的 DSH alpha 最新版并只安装本插件。脚本会缓存 DSH、插件快照和 pnpm 依赖，仅在版本或源码内容变化时更新，并自动清理旧缓存；它会在当前进程内去重 Windows PATH，不会创建盘符映射、目录联接或修改系统环境；如果去重后仍超过 cmd.exe 限制，会在运行 npm/DSH 前直接提示缩短 PATH。Web 未指定端口时会自动选择空闲回环端口，不会因 3080 被占用而失败。缓存默认位于 %LOCALAPPDATA%\dsh-ptc-plus-dev，不会写入本仓库。详细选项见安装指南。

danger-full-access 是首要支持方式。worker 只隔离生命周期，不隔离恶意代码。

文档

安装指南 · 运行时参考 · 架构 · 发布 · 全部文档

使用 MIT License。