dsh-apply-patch

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 流程。

工作原理

1. 通过 ctx.settings.register 注册 dsh-apply-patch 命名空间（单字段 mode）。
2. 通过 ctx.tools.register 注册 apply_patch 工具（defineTool）。
3. 挂钩 system-prompt/assemble 瀑布：组装工具列表时，按 mode + 当前会话模型决定是否保留 apply_patch。
4. 模型判定优先读取组装变量中的 variables.model（模型选择层注入的权威值，切换模型零延迟），回退到 agent/request 捕获的已解析路由、会话请求头、agentDefaultModel 默认值。

开发

pnpm install
pnpm build        # 构建 host + client
pnpm typecheck    # 类型检查
pnpm test         # 单元测试（解析器/应用器）+ 集成测试（真实 cordis + 沙盒 fs）

License

MIT