🐞 Lecture 11.5: 名偵探與急診室病例文檔：收集三大金牌線索、解剖 F12 隱形病灶與 Agent Self-Healing 自我修復歷程

歡迎來到 Bug 特種偵探事務所兼 Agent 急診室會診現場！我是你的首席偵探兼主治醫師。

在上一堂黑客松實戰中，我們體驗了指揮 AI 大副開發網頁的快感。然而，在真實的軟體工程領域中，有一項客觀規律是絕對無法迴避的——那就是 Bug（程式漏洞與運行異常）！

當你點擊網頁上的按鈕卻一片死寂，或者黑色命令列視窗突然噴出一整頁紅色的英文報錯時，零程式基礎的學員常會陷入兩種極端的處置誤區：

• 誤區一：恐懼與自責：「完蛋了！螢幕跳出滿屏紅字，我是不是按錯鍵把電腦顯示卡或硬碟給弄壞了？」
• 誤區二：無效的吼叫：對著大副大喊：「大副！程式壞掉了！網站打不開！你快點幫我修好！」

請跟著主治醫師一起在急診室裡大喊：遇到 Bug 絕對不要慌張！Bug 是軟體開發中再正常不過的物理日常！

大副是一個具備 Self-Healing（自我修復） 能力的高級 Agent。但如果你只對它喊「壞掉了」，它的自注意力機制因為缺乏客觀的事實線索（Observation），只能憑空猜測幻覺，甚至越修越爛。

今天，我們就要學習如何像一名頂尖的名偵探與急診室醫師一樣，精準收集 Bug 的三大金牌病況線索，讓大副在一秒內定位病灶並完成 Self-Healing 自我修復！

---

🩺 急診室第一會診：醫生看診三大金牌病況線索 (Expected / Actual / Error Traceback)

想像你去醫院看診。如果你只是坐在醫生面前大哭喊：「醫生，我生病了，你快救我！」卻不肯說哪裡痛、發燒幾度、吃了什麼食物，醫生即便有神醫之術也無能為力。

當程式出錯時，請為大副提供這三大金牌病況線索：

📌 線索一：你原本『期待』發生什麼事？（Expected Behavior）

告訴大副你的初始設計目標與預期功能。 * ❌ 無效描述：「按鈕壞了。」 * ✅ 絕佳診斷：「我原本期待點擊『翻譯點字』按鈕時，下方文字框會顯示翻譯好的中文國字。」

📌 線索二：實際上『發生了』什麼事？（Actual Behavior）

精準描述客觀觀察到的現象，絕不夾帶個人猜測。 * ❌ 無效描述：「我覺得是網頁死掉了。」 * ✅ 絕佳診斷：「但是當我點擊按鈕後，下方文字框一片空白，沒有顯示任何文字，也沒有跳出任何警告視窗。」

📌 線索三：最關鍵的『現場屍體』：複製完美的錯誤日誌（Error Traceback）

這是診斷過程中最具決定性的實體線索！不管是命令列裡的紅色英文 Traceback，還是瀏覽器 Console 裡的錯誤訊息，原封不動選取並複製貼給大副！ * ❌ 無效描述：「終端機顯示好像找不到檔案。」 * ✅ 絕佳診断：「命令列跳出了以下這段紅字報錯：[貼上完整 Traceback，例如 FileNotFoundError: [Errno 2] No such file or directory: 'brl.dic']。」

當你將這三大金牌線索整整齊齊貼給大副時，大副的神經網路會立刻完成自注意力配對，它不需要憑空猜測，能直接精準定位到出錯的程式碼行數與變數，並觸發工具自動修復！

---

🔍 視障無障礙特種搜查隊：用 NVDA 與 F12 主控台捕捉『隱形 Bug 殘留物』

對於使用 NVDA 螢幕閱讀器的視障同學來說，瀏覽器網頁點了沒反應時，畫面上可能不會跳出任何顯眼的警告視窗。我們要去哪裡抓取這個「隱形 Bug 病灶」呢？

請掌握以下兩大無障礙除錯通道：

🌐 第一通道：瀏覽器開發者工具 (F12 Console 報讀)

• 第一步：開啟診斷室：在 Chrome 或 Edge 瀏覽器中，按下鍵盤上的 F12（或 Ctrl + Shift + J），開啟開發者工具。
• 第二步：切換主控台：按下 Ctrl + 數字鍵 2（或用 Tab 鍵移動）切換到 Console（主控台） 分頁。
• 第三步：捕捉隱形病灶： Console 記錄了網頁執行時所有的隱形 JavaScript 錯誤！使用 NVDA 審閱游標（小鍵盤 7 / 9 或 NVDA + Shift + 上下鍵）朗讀最後幾行紅色的英文報錯。
• 第四步：選取並複製：使用 NVDA + F9 標記報錯起點，移動到結尾按 NVDA + F10 選取並複製這段報錯，貼給大副！

💻 第二通道：命令列終端機 (PowerShell / CMD 全選複製)

如果是在 PowerShell 執行 Python 腳本時噴出紅字 Traceback： * 按下 Ctrl + A（全選當前命令列文字）或使用 NVDA 審閱游標選取報錯區塊。 * 按下 Ctrl + C 複製。 * 直接貼給大副說：「大副，請幫我分析這段 Traceback 報錯並自動修復程式碼。」

---

🔬 手術室現場直播：大副 Self-Healing 自我修復五步曲機制大解剖

當你把三大金牌線索交給大副後，大副在背景是如何幫你把 Bug 默默修好的呢？

我們來解剖大副在背景執行的 Self-Healing 自動修復五步曲 完整生命週期：

• 第一步：解析日誌 (Parse Error Log)： 大副讀取你提供的 Traceback 錯誤日誌，解析出錯誤類型為 FileNotFoundError，且發生的檔案為 main.py 的第 12 行。
• 第二步：定位原始碼 (Locate Source Code)： 大副自動呼叫 view_file 工具，查看 main.py 第 12 行的實體程式碼，發現程式試圖執行 open('brl.dic', 'r')。
• 第三步：診斷根因 (Diagnose Root Cause)： 大副結合實體環境狀態，意識到 brl.dic 檔案並不存在於當前目錄下，或者網頁因為 CORS 跨域安全性原則無法讀取硬碟檔案。
• 第四步：動手修復 (Apply Automated Fix)： 大副呼叫 replace_file_content 或 write_to_file 工具，自動修改 main.py 或將字典數據內嵌寫死到 index.html 代碼內部。
• 第五步：重新驗證 (Re-validate Test)： 大副呼叫終端機指令或測試腳本重新跑一遍，確認 Exit Code 為 0（無任何報錯），然後開心地向你回報：「總裁/船長！Bug 已經徹底修復完畢，請重新整理網頁測試！」

---

📋 經典診斷病案會診室與實戰問答

在結束本診所會診前，我們進行三項經典病案會診：

• 病案一：遇到程式跳出滿屏紅色英文 Traceback 時，最正確的心態與做法是什麼？
  • 解答：完全不用慌張！把 Traceback 視為最寶貴的現場屍體線索，複製完整的錯誤日誌（Error Log）原封不動貼給大副即可。
• 病案二：在瀏覽器中，如果點擊網頁按鈕沒有反應，應該按下哪一個按鍵打開 Console 查看隱形報錯？
  • 解答：按下 F12（或 Ctrl + Shift + J）打開開發者工具的 Console 分頁。
• 病案三：大副為什麼能做到 Self-Healing（自我修復）？
  • 解答：因為大副不僅有 LLM 大腦，還能呼叫實體工具（如查看檔案與執行測試），當它獲得真實的客觀報錯日誌（Observation）時，它就能精準修正程式碼直至測試通過！

Bug 不是你的敵人，它是引導你與大副把程式做得更完美的指路明燈！

現在，你已經是一位合格的除錯偵探兼 Agent 急診室醫師了。

👉 下一堂課：Lecture 12 五星級阿基師主廚解密：用五大廚房結構比喻與三大魔法提示詞，解開任何程式碼黑盒子 👉 回課程大綱：學習地圖