hashline

基于 @oh-my-pi/hashline 的 hashline 编辑语言扩展，覆盖 pi 内置 edit 工具。

功能

• 覆盖 edit 工具：内置 edit 替换为 hashline 语法解析 + 应用
• read hook：读取文件后自动注入 [PATH#TAG] header，为后续编辑提供锚点
• 快照验证：编辑时验证 #TAG 与文件内容一致，防止并发修改冲突
• seen-lines 追踪：记录 agent 实际看到的行号，Patcher 拒绝编辑未显示的行
• noop 循环守卫：连续 3 次 byte-identical noop 抛 [E_NOOP_LOOP]（patches.ts EditGuard）
• 重复编辑检测：成功编辑后重发相同 payload 且文件未变 → 抛 [E_DUPLICATE_EDIT]
• 方言归一化：吸收 CRLF/代码块包裹/多余空行等模型输出偏差
• diff 回显：每次 update 附带 compact diff preview，实际增删行当场可见（含行号，可直接作下次编辑锚点）

使用说明

pi install npm:@piex-dev/hashline

安装后即生效：hashline 覆盖 pi 内置 edit 工具，并 hook read 结果。无需额外开关，无需配置文件。

冒烟测试（改动后必跑）：

pi -e ./extensions/hashline/src/hashline.ts -p "what is 1+1" --no-session

依赖

• @oh-my-pi/hashline ^17.1.3（运行时）
• @earendil-works/pi-coding-agent（peer）
• typebox（peer）
• patch-package ^8.0.1（运行时，安装时自动应用 patches/ 下的补丁）

Patches

patches/ 目录包含两个上游补丁，通过 postinstall 脚本 + patch-package 自动应用：

• @oh-my-pi+hashline+17.1.3.patch — 修复 findDuplicateSuffix/findDuplicatePrefix 在较大重写 payload 中误判边界回显的问题
• @oh-my-pi+pi-natives+17.1.3.patch — 用 fileURLToPath 替代 Node 21.2+ 才支持的 import.meta.dir

补丁针对 @oh-my-pi/hashline@17.1.3 的精确文件内容生成。升级 @oh-my-pi/hashline 版本时需重新生成补丁，postinstall 应用失败即为版本不兼容的明确信号。

延伸阅读

• https://piex.dev/zh/packages/hashline/