一個 Day1 先放著沒展開的問題

Day1 提過一句話：這系列選 Pi Coding Agent 當作實作載體，原因是它開源、而且刻意做得很極簡。當時說「這件事先講到這裡就好」，把技術上「極簡為什麼等於可歸因」留到今天。現在地圖也畫完了（Day3），是時候把這件事講清楚。

極簡到什麼程度：一層一層疊上去，不是一整包黑盒子

Pi 的架構是分層的：最底層是統一處理跟各家模型溝通的部分，上一層是迴圈本身（也就是 Day2 講的那個「看現況、想下一步、動手做、看結果」），再上一層才是完整的 coding agent，把內建工具、對話存檔這些東西包進去，最外面才是你會直接打交道的終端機介面。

每一層只多加一點點能力，你要用到哪一層就用哪一層，不需要囫圇吞下一整包才能開始。這跟很多商業工具「安裝下去就是一整個完整產品，內部怎麼運作看不到」的做法很不一樣。

有人寫過一篇教學，示範怎麼用 Pi 的這幾層自己組出一個功能完整、能持久保存對話的 coding assistant，整個組裝起來大概一百二十行程式碼就搞定。這個數字不是說 Pi「功能很少」，而是說明：把這些層疊起來理解、疊起來用，門檻沒有想像中高——因為沒有一大堆藏在底下、你看不到也改不動的邏輯。

極簡的另一面：不假裝自己很安全

有意思的是，Pi 官方文件自己講得很白：它沒有內建的沙盒隔離，也沒有內建的權限系統去限制檔案、網路、憑證這些存取。文件甚至直接提醒，一個做半套的內建沙盒反而容易被誤會成「有安全保障」，結果讓人掉以輕心。

乍看之下這像是缺點，但換個角度看，這其實是同一種「不藏東西」的態度延伸到安全設計上：它沒有用一層看起來安全、其實靠不住的東西把風險包起來讓你安心，而是老實告訴你「這裡沒有保護，你要自己決定要不要加隔離環境」。你清楚知道自己現在站在哪個邊界上，而不是誤以為有人幫你擋好了。

為什麼極簡等於「可歸因」

這才是今天真正想講的重點。極簡帶來的最大好處，不是省資源、不是門檻低，而是出問題的時候，你有辦法查出問題到底出在哪一層。

如果一個 coding agent 的系統提示是藏起來的、重試邏輯看不到、context 是怎麼組出來的完全是黑盒子——那麼當它表現異常時，你只能憑猜的：到底是模型本身不夠聰明、是提示詞沒寫好、是 harness 設計有問題，還是單純環境出了狀況（比如 Day1 提過的那種網路雜訊）？猜錯方向，時間就白花了。

Pi 因為每一層都攤在外面，出狀況時可以一層一層排查：先看 context 有沒有餵對東西、再看工具有沒有正常執行、再看模型的回應合不合理。這正是 Day1 承諾的那套「歸因方法論」能夠成立的前提——沒有一個可以攤開來檢查的迴圈，「這是模型的問題還是 harness 的問題」這種問題根本無從回答起。

這件事不是紙上談兵，已經先驗證過一次

在正式開始這系列的實驗之前，我先拿一個小任務跑過一次 Pi，確認環境沒問題。結果很直接：整個任務跑完只花了幾千分之一美元，過程中沒有任何一步出錯，而且每一步——讀了哪些檔案、改了什麼、跑了什麼指令——全部都留在一份完整的記錄裡，逐行攤開來看。

這份記錄有多完整、長什麼樣子，Day6〈打開黑箱〉會直接秀給大家看。這裡先想強調一件事：這種「事後能逐行回放」的能力，不是每個 coding agent 工具都做得到，而它剛好是 Pi 極簡設計換來的直接好處。

明天

地圖畫好了、也講清楚為什麼選 Pi 了，接下來就是真的動手了。Day5 會走一次完整的安裝流程，在 Windows 環境下把 Pi 裝起來、跑出第一個 session。