$ cat ~/map/pi-edit-guard.md

pi-edit-guard

挂在内置 edit 名下的修复与匹配管线：纠正畸形参数，容错空白差异定位文本。

extensions✓ 9月11日

pi install npm:pi-edit-guard

## 速览

一个 pi 扩展：用参数修复加十四轮匹配的管线覆盖内置 edit 工具，让畸形调用与空白不匹配的编辑在失败前被救回，另带一个撤销最近编辑的 undo 工具。

## 要点

• $参数修复在进入校验前救回畸形调用：双重编码的 JSON、来自另一种训练数据形态的字段名（如把 oldText 写成 old_string）、本应展平的嵌套路径对象、被字符串化的编辑数组。
• $十四轮匹配链在空白、缩进、转义或行序不对时仍能定位目标文本；匹配耗时中位数 2 毫秒，p95 低于 650 毫秒。
• $在从真实会话中挖掘的 71 个失败样本上，内置工具失败 65 次；edit-guard 完全解决 57 个，对其余 14 个给出精确诊断，且从不弄坏内置工具本可正确应用的编辑。
• $undo 工具按文件撤销最近一次 edit 工具改动，底层是跨会话存续、FIFO 淘汰的追加式 JSONL 存储。
• $两个工具都有开关设置——editOverrideEnabled 控制 edit 覆盖，undoEnabled 控制 undo。

## 常见问题

## 参考链接

• README ↗

最后更新: 2026年9月11日