pi：極簡可擴展 AI Agent 工具包
架構總覽
| 套件 | 用途 |
|---|---|
| pi-ai | 統一多 provider LLM API（OpenAI、Anthropic、Google、xAI…） |
| pi-agent-core | Agent runtime：tool calling、狀態管理、權限控制 |
| pi-coding-agent | 互動式 CLI coding agent，可讀寫檔案、執行 shell、改自己的原始碼 |
| pi-tui | Terminal UI 函式庫，差異化渲染（differential rendering） |
與其他 Coding Agent 的核心差異
極簡核心 + 全系統權限 Extension
pi 刻意不內建 MCP、sub-agent、plan mode、permission popup、to-do 等功能。全部靠 extension 實作。Extension 以 TypeScript 模組載入，擁有完整系統權限——可註冊自訂工具、指令、快捷鍵、UI 元件，甚至替換內建工具。這和 Claude Code（開箱即用、內建一切）走相反路線。pi 的哲學是「給開發者最大的自由度，不做預設」。
Agent Skills 標準 + Pi Packages 生態
pi 實作 Agent Skills 標準（/skill:name），技能包、prompt template、theme 可打包成 Pi Package 透過 npm 或 git 分享。這建立了社群驅動的生態系——不是廠商決定功能，而是社群貢獻各種 extension。
Session 持久化 + 分支
pi 以 JSONL 儲存 session 歷史，支援 /tree（瀏覽對話分支）和 /fork（建立分支）。開發者可從過去的對話點分叉出新的探索路徑，不破壞原始 session。
自修改能力
pi 的 coding agent 可直接修改 pi 自己的原始碼——開發 pi 的人用 pi 開發 pi。這是 dogfooding 的極致。
SDK 和 RPC 模式
除了 CLI，提供 SDK 嵌入其他應用、RPC 模式整合非 Node.js 環境。pi 不只是終端機工具，可作為其他系統的 agent 後端。
供應鏈安全
pi 的依賴管理是業界最嚴格之一：所有外部依賴鎖定精確版本、npmrc 強制 save-exact + min-release-age=2、lockfile 為唯一真相來源、pre-commit 阻擋未授權變更、所有安裝指令強制 --ignore-scripts、CI 排程 npm audit。
對 DKY 技術棧的適用性評估
| 評估維度 | 適用度 | 說明 |
|---|---|---|
| 取代 Claude Code / Codex CLI | 低 | TypeScript 原生，我們 Python 為主；遷移成本高 |
| 作為額外 coding agent | 低 | 多一個 agent 多一份維運成本，無明顯優勢 |
| pi-ai LLM 抽象層 | 不需要 | Hermes + LiteLLM 已覆蓋 |
| Extension 架構借鑒 | 中 | 極簡核心 + extension 設計哲學可參考 |
| 供應鏈安全實踐 | 高 | 可直接搬到 dky-tools CI/CD |
| AGENTS.md 規範 | 高 | 可為 repo 建立 agent 協作文件 |
結論
pi 設計精良，哲學清晰（Unix 式極簡 + 可擴展），社群活躍。但它解決的問題我們已用 Hermes + Claude Code/Codex CLI 覆蓋。最大價值不在採用，而在借鑒其供應鏈安全做法和 AGENTS.md 規範。
如果未來有大規模 TypeScript 專案需要 coding agent，或是 Agent Skills 標準成為跨工具通用格式，pi 會是第一選擇。