雜湊錨定編輯協定 (Hash-Anchored Edit Protocol) · Oh My OpenAgent

AI 程式碼修改的經典痛點

在使用 AI 助手（如 GPT-4 或 Claude）修改程式碼時，開發者經常遇到一個極其頭痛的問題：行號偏移與程式碼混亂 (Offset & Drift Errors)。

為什麼會發生行號偏移？

當 AI 助手生成修改建議時，它通常會指定「修改第 12 行到第 15 行的代碼」。然而：

如果在這之前，你手動在檔案頂部插入了 3 行註釋。
或者另一個背景代理同時修改了第 5 行。此時，檔案的實際行號已經發生了偏移。AI 助手指定的「第 12 行」在實體檔案中已經變成了「第 15 行」。這會導致 AI 的 Patch 應用到錯誤的位置，破壞代碼結構，甚至引發無法編譯的語意崩潰。

為了解決這一問題，Oh My OpenAgent (OMO) 獨創了 雜湊錨定編輯協定 (Hash-Anchored Edit Protocol)。

雜湊錨定編輯協定的運作原理

與依賴脆弱的「絕對行號」不同，雜湊錨定協定採用了**語意內容雜湊比對（Semantic Content Hashing）**與前後文錨定技術。

 絕對行號修改 (脆弱)              雜湊錨定修改 (強健)
 
 ┌──────────────────┐            ┌──────────────────────────────────┐
 │ 修改第 12-15 行  │            │ Anchor Content:                  │
 └────────┬─────────┘            │   "private void Connect()"       │
          │                      │ Context Hash: 7a8f9c2d           │
          ▼ (行號偏移 3 行)       └────────────────┬─────────────────┘
 ┌──────────────────┐                             │ 
 │  修改了錯誤位置   │                             ▼ (自動模糊匹配上下文)
 │  (代碼結構損壞)  │            ┌──────────────────────────────────┐
 └──────────────────┘            │  精確定位到真正的 Connect 方法，  │
                                 │  安全應用修改 Patch              │
                                 └──────────────────────────────────┘

1. 生成內容雜湊錨點 (Context Hash Anchor)

當 OMO 準備修改某段程式碼時，它會將目標代碼塊（Target Block）的前後 3 行代碼，以及目標代碼本體，通過輕量級的哈希算法生成一個唯獨的語意指紋（Context Hash Anchor）。

2. 搜尋與語意匹配 (Fuzzy Anchor Matching)

在應用 Patch 前，OMO 的修改工具不會盲目尋找絕對行號，而是在目標檔案中進行語意錨點搜尋。即使檔案行號發生了大幅度移動，只要該代碼段的特徵指紋和上下文一致，OMO 就能 100% 精確地將其定位。

3. 三方安全合併 (Three-way Safe Merge)

定位完成後，修改工具會自動執行類似 Git 的三路合併（3-way Merge），將 AI 生成的修改安全地織入到目標位置，並在完成後立即進行增量編譯校驗，確保沒有破壞周圍的代碼結構。

藉由雜湊錨定編輯協定，OMO 成功解決了並行開發下的寫衝突與行號偏移問題，使多個代理人同時修改同一個檔案成為了可能。