npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

dsh-apply-patch

v0.2.0

Published

DSH plugin: a codex-style apply_patch tool (*** Begin Patch / *** Update File / *** Add File / *** Delete File) injected into the model toolset through DSH's built-in sandbox, enabled on install, with switches in the Plugins center to hide the built-in ed

Readme

dsh-apply-patch

English

为 DSH 提供 Codex 风格的 apply_patch 工具,支持新增、修改、删除和移动文件。 补丁解析与应用行为参照 Codex,所有文件变更都经 DSH 的沙盒能力完成。

安装

dsh plugin --profile web add github:miaobuao/dsh-apply-patch

使用

安装后 apply_patch 立即注册,无需额外配置。插件页面位于 设置 → 插件 → dsh-apply-patch(与网页搜索等官方插件同一槽位 plugins.bundle.config)。页面上有 三个开关:

  • 隐藏内置 edit 工具(disableEdit,默认开启):定点文本编辑由 Update File 承担。
  • 隐藏内置 write 工具(disableWrite,默认开启):整文件写入由 Add File / Update File 承担。
  • 允许覆盖未读取的文件(allowUnobservedOverwrite,默认开启):见下。

工具调用卡片

对话里的 apply_patch 调用使用专用卡片(tool.call.toolview 槽位的 apply_patch 键),不再显示通用工具卡片的原始参数文本:

  • 折叠行的标题直接由补丁动作与文件名生成:单文件是「更新 src/a.ts」「新增 src/b.ts」「删除 old.txt」「移动 a.ts → b.ts」,多文件按动作聚合为「更新 3 个 文件 · src/a.ts、src/b.ts、src/c.ts」(文件名按补丁顺序全部列出,超出一行时 自动省略号截断)或混合时「修改 3 个文件 · …」,并显示总 +A -R 行数;
  • 展开行按补丁顺序列出每个文件操作(A 新增 / M 更新 / D 删除 / M → 移动), 路径可点击在侧栏打开,并附带该操作的 diff 与行数;长 diff 默认折叠中间,首尾 各保留 3 行变化行(外侧再带 1 行上下文),点击「展开 N 行」看完整 diff (虚拟化渲染,只有可视行进入 DOM),展开后可再「收起」;折叠态只做计数扫描, 不保留行文本,流式阶段仍有 200 行预览上限、调用结束后解除;
  • 运行中随 patch 参数流式列出已经出现的操作;结束后按结果标注「已应用 / 未执行」,失败时显示错误原文与「已应用 x/y」。
  • 替换行在红绿行底色内,以更强的底色标出改动。对每个 @@ 块,把上下文和删除行重建 为旧文本、上下文和新增行重建为新文本,用 diff-match-patch 对整块做一次字符级 diff 和 diff_cleanupSemantic,再按换行把编辑脚本投影回行。这样拆行、合行、前插行、 中间插行都按内容对齐;多出来的整行就是新增或删除,不会被硬配给某条旧行。带位置 或标签的 @@ 显示 hunk header;行号取自 @@ -a,b +c,d @@,裸 @@ 不显示 header 和行号,因为 patch 本身没有绝对位置;后续裸块之间用细分隔线分开。 改动段使用更强的主题底色并铺满行高,长行自动换行;超过 800 行的 diff 仍使用固定 行高虚拟化和横向滚动,避免展开大 patch 时一次性铺满 DOM。精确保留空白和源文本, 高亮边界不会拆开 emoji 或组合字符。块过大或缺少 grapheme segmenter 时保留行级底色。

卡片只从会话日志记录的调用参数与结果推导,历史会话回放同样生效。客户端半边不导入 其它 Harness Client 包(只看槽位的公开契约),样式只使用 --dsw-alias-* 主题 token,随宿主明暗主题切换。

隐藏内置工具

隐藏通过 ctx.tools.restrict({ deny }) 完成,限制挂在每个 agent 自己的 context 上:

  • agent/created 时按当前开关建立限制;开关翻转由 settings/document-updated 触发重新 求值,下一步生效,不需要重启插件或重建 agent。
  • 这是官方对「让某个 agent 看不到工具」的规定机制:schema 展示、名字查询与执行三者 保持一致,不会出现「工具还列着、调用却被拒」的中间态。
  • 限制是 agent.ctx 的 effect:卸载插件或销毁 agent 时自动解除,edit / write 自己回来。不会留下任何持久改动,不需要用户手动恢复。
  • 预设挂载的工具同样覆盖得到:preset registry 为每个 revision 生成一个 generation scope,并把 agent 的 scope key 绑成它的子作用域,因此 tools.view(agent) 把预设 注册读成继承工具,正是 restrict 过滤的对象。
  • 若组合里根本没有挂载某个工具,点名它会抛错,所以安装处会捕获并只记录警告,绝不 因此中断 agent 创建。

覆盖未读取的文件

默认开启,与 Codex 一致:Add File / Move to 可以覆盖已存在但模型没读过的文件, Delete File 也可以直接删除。关闭后,这三类操作要求模型先读取目标,否则返回读后写 策略的错误。Update File 不受影响(补丁上下文匹配本身即证明模型读过文件)。

行为与保证

  • 多文件补丁严格按补丁顺序执行,不并行、不预取。
  • 失败不回滚:已生效的改动保留。应用阶段的失败以结构化 ApplyFailure 抛出,字段包含 stage(失败步骤:resolve / add / delete / read / derive(纯文本派生, 上下文匹配失败出现在这里)/ verify(写入前再取版本)/ update / move-write / move-remove)、applied(已生效的 A/M/D 条目)、affected(按新增 / 修改 / 删除分组)、code、landedAt、removal。已有改动生效时,面向模型的错误消息末尾 带 “Applied before the failure:” 列表;补丁文本解析失败仍抛 PatchParseError。
  • *** Move to: 指向源文件自身时按原地更新处理,不会先写后删。
  • Update File 在读取之后、写入之前再取一次版本;期间文件被外部改动时以 FS_STALE_VERSION 失败,并且不为该文件记录读取观察。
  • Delete File 与 Move to 的删除步骤经 DSH 沙盒 shell 执行(rm -- <path>),需要 宿主挂载 sandboxed shell。缺少 shell 时,删除与移动都在改动任何文件之前失败 (Move to 在写目标之前)。
  • 删除是“检查后删除”,不是原子操作:沙盒能力层没有带版本条件的删除原语。执行 rm 前会再取一次版本:Delete File 只在严格模式(关闭“允许覆盖未读取的文件”)下校验; Move to 在两种模式下都校验源文件版本(目标内容正是基于该版本派生)。这缩小但不消除 竞态窗口。
  • Move to 实现为“先写目标、再删源”,不保留源文件权限位(上游 FileSystem 没有 remove / rename 能力)。若目标已写入而源删除未获确认:确定为“未启动删除”时,消息说明 目标已写入、源文件仍在原处;已请求删除但无法确认时,消息说明源删除未确认、要求在重试 前检查两个路径,并在结果未知时另附 “Removal outcome is unknown for …”。
  • 每次删除单独启动一次沙盒 shell,以保留逐文件的失败归因与顺序语义。

环境选择

补丁中可出现 *** Environment ID: <id>:解析器只校验它最多出现一次、且不能为空,然后 丢弃该行,不据此切换环境。hunk 路径始终按会话工作目录解析。

兼容性

  • peerDependencies 声明:@deepseek-ai/dsh-* 为 ^0.2.2-alpha.2, @deepseek-ai/cordis 为 ~4.0.6-alpha.1。
  • 支持 0.2.2-alpha.2 起的宿主。0.2.1 及更早不受支持:0.2.2 才把工具声明从 system-prompt/assemble 载荷中移出(旧版本启用本插件会导致每轮装配抛错), settings/document-updated 与当前 tools.restrict 语义也以该版本为准。
  • 本仓库的开发与验证基线:@deepseek-ai/* 0.2.2-alpha.2(devDependencies 固定), typecheck、build 与 test 在该基线上通过。基线必须跟着宿主升级,否则宿主的 契约变化不会被 tsc 发现。

许可与来源

本项目基于 fonlan/dsh-apply-patch, 由 miaobuao 修改,整体按 GPL-3.0-or-later 分发。 原作者版权及 MIT 许可保留于 LICENSES/MIT.txt。 Codex 相关改编和测试数据的 Apache-2.0 许可见 LICENSES/Apache-2.0.txt,完整来源及修改说明见 NOTICE。