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