這是一個分兩幕的故事
本專案紀錄了如何在缺乏官方API說明書的情況下，透過「AI協作」與「證據驅動（解析真實封包）」的方法，替老舊的ASP.NET WebForms ERP系統（以原廠編號建檔為例）打造一個通用型的PHP批次處理橋樑。
故事分成兩幕。第一幕（V1.0～V15）是這座橋樑從無到有的起點：解決編碼亂碼、做出批次功能、對付老系統的防護機制，是一段「AI幫忙把不可能變成可能」的成功故事。
第二幕（V16～V20）則是故事的轉折——當AI自己在協作過程中悄悄把已驗證能動的程式碼改壞，又在後續維護中讓說明文件本身脫離現實，我們才真正體會到「AI輔助開發」不是一次性的魔法，而是一場需要持續用證據校正的長期工程。
建議依下列版本演進順序閱讀，會像看一部完整的紀錄片一樣，看到這個專案如何長大、如何跌倒，又如何靠證據站起來。
第一幕・V1.0 ～ V15 起點：從零到能動
這一部分的三份文件,記錄的是專案最初的樣貌——一個沒有官方API文件的老系統,如何在AI協助下,從一個簡陋的登入腳本,逐步長成一套具備批次處理與除錯能力的完整框架。故事在這裡還很單純:遇到問題、貼證據給AI、AI給方案、問題解決。
STEP 1. 故事起點 (非技術人員首選)
非技術友善
AI協作故事
商業價值
將艱澀的開發過程轉化為「數位偵探辦案」的故事。以非工程師也能理解的語彙（數位橋樑、翻譯機、踩煞車機制），解釋如何解決「編碼亂碼」、「批次處理」與「系統防護被鎖」三大關卡。
適合對象：IT部門主管、專案發起人、一般使用者。
閱讀收穫：快速了解專案的「為什麼要做」、「遇到什麼困難」以及「AI幫了什麼忙」，建立對整個自動化改造的高階認知,是整個故事最好的入口。
閱讀文件 ➔
STEP 2. 效益驗證 (流程圖解)
視覺化圖解
效率分析
流程差異
以精確的SVG流程圖，直觀對比「傳統人工逐筆操作10次」與「新系統貼上後一鍵批次處理」的動線差異。文內附有具體的效率提升估算表。
適合對象：系統使用者、流程優化評估者。
閱讀收穫：看懂系統導入前後的具體「操作步驟減少了多少」與「時間節省了多少」（約提升4.3倍效率），以量化數據佐證第一幕的開發成果。
閱讀文件 ➔
STEP 3. 技術傳承 (開發者實戰指南)
開發者必讀
逆向工程
架構設計
這是一份去識別化後的標準技術文件，記錄了從V1.0到V3.0整合版的詳細架構演進。文中剖析了如何透過「抓取F12真實封包給AI分析」來突破盲點，並詳細說明三段式驗證、統一驗證規則、除錯落地存檔等底層設計。
適合對象：接手維護的工程師、MIS人員、嘗試逆向對接其他舊系統的開發者。
閱讀收穫：取得可複用的「AI協作提問策略表」，掌握如何實作「無API系統的橋接器」——但這只是故事的前半段,第一幕結束時,這套框架看起來已經很完整、很穩定了。
閱讀文件 ➔
第二幕・V16 ～ V20 轉折：當AI自己捅出洞
如果故事到第一幕就結束,這會是一篇典型的「AI神救援」宣傳文。但專案沒有停在這裡——當團隊為了排查一個沒頭沒尾的.NET錯誤訊息,才發現問題根源竟然是AI在被要求新增小功能時,把自己寫過、已驗證能動的核心程式碼悄悄改壞。這兩份新文件記錄的,正是這段最誠實、也最有價值的續集:AI不是萬能的,而發現這件事的過程,本身就是一堂寶貴的實務課。
STEP 4. 續集技術篇 (真相與教訓)
重寫退化
對照實驗
diff驗證紀律
承接第一幕的技術骨架,補上V16～V20最關鍵的插曲:多版本並行對照測試框架的誕生、一個只回傳54 bytes .NET例外訊息的故障案例、五輪假設推翻的完整排查記錄,以及最終揪出「AI重寫時順手改壞不相關函式」的根因全過程。文末更誠實記錄了同一類退化在後續維護中又發生了一次,以及AI維護的架構文件本身也曾落後於實際程式碼。
適合對象：正在或即將大量使用AI協作開發的工程師、技術主管。
閱讀收穫：理解「重寫退化」(regression by rewrite)這個AI協作特有的風險模式,並取得可直接套用的防禦手段——控制變因的對照實驗、強制diff核對、文件與程式碼同步校對。
閱讀文件 ➔
STEP 5. 續集故事篇 (寫給所有人的誠實反思)
非技術友善
AI真實限制
誠實反思
用白話文重述第二幕的轉折:把那個NullReferenceException的排查過程,比喻成「兩個版本的偵探對照實驗」;把AI悄悄改壞不相關程式碼的事故,比喻成「水電工修燈時順手接壞了客廳插座」。故事最後點出一個所有使用AI的人都該知道的真相——規則寫在文件裡不會自動生效,必須靠人持續拿證據驗證。
適合對象：所有正在評估或已經導入AI輔助開發的團隊與主管,不限技術背景。
閱讀收穫：用最平易近人的方式,理解「AI很強,但AI不是萬能」這句話背後具體發生過什麼事,以及為什麼「用證據驗證AI成果」值得變成團隊的日常習慣。
閱讀文件 ➔
讀完整套文件後你會發現:第一幕證明了AI能讓一個人在幾天內做出過去可能要花數週才能完成的系統;第二幕則證明了,這份效率背後如果少了「持續驗證」這道防線,AI也可能在你沒注意的時候埋下風險。兩幕合在一起,才是完整、誠實的AI協作開發故事。