dsh-apply-patch
DSH 插件：为模型注入 codex 风格的 apply_patch 工具。
GPT 系列模型在训练时大量使用 OpenAI Codex 的 apply_patch 工具，因此在 DSH 里使用 GPT 模型时，模型会本能地调用 apply_patch —— 但 DSH 默认不提供该工具，导致报错。本插件通过 DSH 强大的插件系统补上这个工具，并且完全走 DSH 自带的沙盒系统，绝不绕过沙盒直接修改文件。
功能
apply_patch 工具：与 OpenAI Codex 完全一致的补丁格式（*** Begin Patch / *** Update File: / *** Add File: / *** Delete File: / *** Move to: / *** End of File / *** End Patch），并支持 gpt-4.1 风格 heredoc（<<'EOF' ... EOF）的宽松解析。- 沙盒写入：所有文件写入都通过
ctx.fs（DSH 沙盒文件系统）执行，删除通过沙盒 bash 执行 —— 沙盒拒绝时返回 [sandbox: ...] 错误，绝不绕过。
- 按模型条件注入：设置里的配置卡片只有一个下拉选择：
- 关闭：完全不注入
apply_patch
- 仅GPT模型（默认）：只对模型 id 以
gpt- 开头的模型注入
- 所有模型：对所有模型注入
- 设置卡片：设置 → 插件 → 插件配置 → Apply Patch，实时生效（live）。
安装
通过 dsh plugin 命令安装到目标 profile（默认 web）：
从 npm 安装
dsh plugin --profile web add @fonlan/dsh-apply-patch
从 GitHub 安装
# 默认分支（仓库带 prepare 构建脚本，pnpm 会自动构建）
dsh plugin --profile web add github:fonlan/dsh-apply-patch
# 指定 release tag
dsh plugin --profile web add github:fonlan/dsh-apply-patch#v0.1.0
本地源码链接安装（开发）
pnpm build
dsh plugin --profile web add .
安装后插件通过 cordis.patch.yml 自动挂载：服务端注册 apply_patch 工具与 dsh-apply-patch 设置命名空间，web 端注册 settings.plugin.item 设置卡片（设置 → 插件 → 插件配置 → Apply Patch）。安装后需要重启 dsh web 进程生效。
删除插件
dsh plugin --profile web remove @fonlan/dsh-apply-patch
升级
dsh plugin --profile web update @fonlan/dsh-apply-patch
使用
模型（尤其是 GPT 系列）会像在 Codex 中一样直接调用 apply_patch，例如：
*** Begin Patch
*** Update File: hello.py
@@
-print("hello")
+print("hello, world")
*** Add File: new.py
+x = 1
*** Delete File: old.py
*** End Patch
工具返回 codex 风格的摘要：
Success. Updated the following files:
M /path/to/hello.py
A /path/to/new.py
D /path/to/old.py
沙盒说明
所有变更都通过 DSH 内置沙盒：
| 操作 | 沙盒路径 |
|---|
| Add / Update / Move 写入 | ctx.fs.writeText（沙盒文件系统，遵守会话 sandbox mode 与 workspace root） |
| Delete / Move 删除原文件 | ctx.shell（沙盒 bash rm，遵守同一策略） |
read-only 模式下任何写入都会被沙盒拒绝，返回 [sandbox: file access denied under read-only mode]。workspace-write 模式下只允许写入 workspace root（以及沙盒策略允许的 /tmp）。- 观察策略（fs-observation-policy）要求先读后写，工具内部自动完成 stat/read/observe/write 流程。
工作原理
- 通过
ctx.settings.register 注册 dsh-apply-patch 命名空间（单字段 mode）。
- 通过
ctx.tools.register 注册 apply_patch 工具（defineTool）。
- 挂钩
system-prompt/assemble 瀑布：组装工具列表时，按 mode + 当前会话模型决定是否保留 apply_patch。
- 模型判定优先读取组装变量中的
variables.model（模型选择层注入的权威值，切换模型零延迟），回退到 agent/request 捕获的已解析路由、会话请求头、agentDefaultModel 默认值。
开发
pnpm install
pnpm build # 构建 host + client
pnpm typecheck # 类型检查
pnpm test # 单元测试（解析器/应用器）+ 集成测试（真实 cordis + 沙盒 fs）
License
MIT
