這個項目解決什么問題Coding Agent 賽道越來越卷——Claude Code、Codex、pi、oh-my-pi……但大部分人的使用方式停留在會用并不理解背后的數據流。SaladDay 的pi-from-scratch用 600 行 TypeScript 從零實現了一個完整可用的 Coding Agentnano-pi把 pi 的核心思想剝離出來讓你親手寫一遍。核心亮點教學網站的互動設計。右側編輯器跟著閱讀進度逐步補全代碼看完文章的時候nano-pi 的完整源碼也自動出現在編輯器里。同時提供了 Trace 跟蹤工具可以打斷點逐行看代碼執行流。架構清晰沒有工程噪聲。刪除了 pi 的所有工程細節插件系統、文件系統緩存、權限管理……只保留讀文件→理解→改代碼→執行這一條主數據流。適合用來理解 Coding Agent 的本質。純 TypeScript零框架依賴。600 行代碼Node.js 22一個 OpenAI 兼容 API key 就能跑。沒有 React、沒有 Vite、沒有任何構建步驟。Trace 調試面板。可以逐行觀察 agent 的決策過程哪一行讀了什么文件、調用了什么 API、做了哪些判斷。這是理解 agent 行為最有價值的設計。快速上手# 克隆gitclone https://github.com/SaladDay/pi-from-scratch.gitcdpi-from-scratch# 安裝依賴npminstall# 設置 API KeyexportNANOPI_API_KEYyour-api-keyexportNANOPI_MODELgpt-4o# 可選exportNANOPI_BASE_URLhttps://api.openai.com/v1# 可選# 運行 nano-pinpmrun dev教學網站本地運行cdwebnpminstallnpmrun dev我的評價最大的價值并非代碼本身而在于其“刪減哲學”。大多數開源項目容易陷入“功能堆砌”的陷阱。原版 pi 包含了插件系統、文件系統抽象、權限層、多模型適配等復雜模塊但對于只想理解 Coding Agent 核心原理的開發者而言這些反而成了干擾學習的“噪聲”。SaladDay 做了一件更具挑戰性的事——精準判斷哪些部分可以刪除同時不損失對核心流程的理解。最終呈現的成果是一個僅 600 行、可直接運行、并支持 Trace 調試的完整 Agent 實現。與同類項目的對比對比 pi-bookpi-book 更像架構說明書闡述“應該怎么做”而 pi-from-scratch 則提供了可運行的代碼與 Trace 工具直觀展示“實際上是怎么跑的”。對比 pi 原版pi 是一個功能完備的產品但理解門檻較高nano-pi 則是其精煉出的“教學切片”聚焦核心數據流。適合人群適合對 Coding Agent 已有初步了解并希望深入理解其內部數據流與決策過程的開發者。不建議零基礎新手直接上手——如果你尚未接觸過 Prompt Engineering建議先體驗一次 Claude Code 等成熟產品。一點小吐槽README 中包含了三個贊助商鏈接OpenModel、Cubence、pi-book篇幅略顯冗長。不過代碼庫本身保持整潔并不影響核心的學習與使用體驗。