pi 架構拆解自頂向下讀原始碼

一個中文學習站,逐層拆解 badlogic/pi-mono 的整體設計;每一步都直連 GitHub 對應原始碼行,版本釘在 v0.73.1。

自頂向下

從 pi-ai 統一 LLM API → pi-agent-core 迴圈 → pi-coding-agent CLI → pi-tui 終端 UI → pi-web-ui 網頁元件,一層層往下展開。

每個關鍵檔案都帶 SrcLink,點開就是 GitHub 上對應的那幾行;版本釘在 v0.73.1,升版本只改一處。

不只是給指標——關鍵函式的 5-15 行真實 TypeScript 原始碼直接貼在頁面裡,前後用中文點出在做什麼。

每頁除了職責,還講為什麼這麼設計,以及邊界情況和失敗模式怎麼處理。

pi-mono 是 monorepo:pi-ai(基礎)→ pi-agent-core(通用 agent)→ pi-coding-agent(編碼 CLI)+ pi-tui(終端)+ pi-web-ui(網頁),包之間如何拼裝。

本站聚焦架構拆解與原始碼定位,安裝使用看官方 README,不重複造使用文件。