Why I switched to Pi...
三句話摘要
Pi Agent：一個開源編碼代理框架，通過靈活的擴展系統讓硬件完全適應用戶需求。 Pi Agent 通過開放的擴展系統實現了對代理硬件的完全控制，相比閉源代理提供了真正的定制自由，是構建複雜代理系統的最靈活選擇。 相比閉源代理的本質差異：Claude Code 和 Codex 等主流編碼代理是閉源的，用戶無法修改內部邏輯，只能通過有限的 Hook 系統進行定制。Pi Agent 打破這一限制，採用開放式扩展系統，允許用戶完全控制代理硬件的行為。
重點整理
重點- 1
相比閉源代理的本質差異：Claude Code 和 Codex 等主流編碼代理是閉源的，用戶無法修改內部邏輯，只能通過有限的 Hook 系統進行定制。Pi Agent 打破這一限制，採用開放式扩展系統，允許用戶完全控制代理硬件的行為。
- 2
扩展系統是核心優勢：用戶可在項目中的 `.py/extensions/` 文件夾編寫 Python 擴展，修改代理上下文（如注入 Git 信息）、添加新工具、定制 UI，甚至代理自身也可生成需要的擴展。這使得之前無法實現的功能優化（如清理 PR 評論減少 80-90% token 成本）成為可能。
- 3
模組化生態設計：Pi 生態包含 Coding Agent（編碼代理）、AI Package（LLM 接口）、OS Package（任務調度）等專用模組，用戶可按需組合，避免承載不必要的功能。
- 4
權限控制與安全機制：通過編寫擴展實現輕量級權限檢查，使用小模型驗證操作合法性。檢測到敏感操作時可立即停止會話，這種細粒度控制在閉源代理中難以實現。
實用技巧與重點
乾貨- 核心工具與概念：
- Pi Agent 基礎配置：4 個關鍵工具，無預設子代理、代理團隊或 MCP
- 擴展編寫方法：`py.on_before_agent_start()` 修改啟動前邏輯；`py.register_tool()` 註冊新工具
- 生態包組成：
- Py Coding Agent：編碼代理主體
- Py Core：會話管理、窗口管理等基礎功能
- Py AI Package：支援連接多種大語言模型
- Py OS Package：任務調度與代理間協作（實驗階段）
- 部署方式：
- 本地代理：完全訪問文件系統，支援自定義編輯器 UI、會話分享（二維碼/URL）
- Web 部署：沙盒隔離、多租戶支援、資源加載器、權限級別定制
- 優化成果：
- PR 評論清理擴展：減少 token 消耗 80-90%
- 權限檢查扩展：用輕量化模型驗證操作合法性
- 相關資源：
- CloudCode Playbook（HubSpot 贊助的免費資源）：涵蓋提示模式、CLAUDE.md 設置、Hook 配置、任務管理等
結論
結論“Pi Agent 通過開放的擴展系統實現了對代理硬件的完全控制，相比閉源代理提供了真正的定制自由，是構建複雜代理系統的最靈活選擇。”
完整解析
詳細Pi Agent 是一個開源編碼代理框架，其設計理念與 Claude Code、Codex 等主流編碼代理有根本區別。雖然這些工具在基本編碼能力上已趨近相同，但 Pi Agent 被 OpenClawed 選中作為基礎框架的關鍵在於其開放的架構。
傳統編碼代理採用閉源設計，用戶只能通過公開的 SDK 和 CLI 構建新系統，但無法修改代理的內部邏輯。即使它們提供 Hook 系統允許在特定事件（如代理啟動、工具調用前）定義行為，這種定制仍受到本質限制——用戶無法真正改變硬件的工作方式。相比之下，Pi Agent 的設計哲學是讓硬件適應用戶。為了實現這一點，Pi Agent 採用最小化基礎設計（只包含 4 個關鍵工具），但提供了極其靈活的擴展系統。用戶可以編寫 Python 擴展來修改代理上下文、添加新工具、定制 UI，甚至代理本身可以自動生成所需的擴展——用戶只需說「我需要一個天氣小部件」，代理就會自動生成相應的擴展。
擴展系統的威力體現在實際應用中。開發者可以在代理啟動前注入最新的 Git 信息，使代理始終感知項目狀態；可以讀取剪貼板內容；可以實現權限控制——通過輕量化模型驗證請求的安全性，在檢測到危險操作時立即停止。最令人印象深刻的是成本優化案例：通過編寫一個清理 PR 評論的擴展，開發者成功將 token 消耗降低了 80-90%，因為擴展只展示關鍵信息。這種級別的優化在 Claude Code 或 Codex 中幾乎無法實現。
Pi 生態由多個模組組成。Py Coding Agent 是核心編碼代理，Py Core 提供會話管理和基礎功能，Py AI Package 提供大語言模型接口（支援多種 LLM），Py OS Package 提供任務調度和代理間協作（仍在實驗階段）。這種模組化設計允許用戶按需組合，避免加載不需要的功能。
從部署角度，Pi Agent 支援兩種方式。本地代理運行在用戶電腦上，完全訪問文件系統，可自定義 UI、發佈會話供他人訪問。Web 部署的代理運行在共享基礎設施上，需要對文件操作進行沙盒隔離，以確保多租戶安全。在 Web 部署中，系統可通過資源加載器定制每個代理會話的工具集和訪問權限。OpenClawed 利用 Pi Agent 的這些特性構建了 Postia——一個專門用於啟動和運營企業的代理系統，展示了 Pi Agent 遠超單純編碼代理功能的潛力。
關鍵時刻
Pipeline v2帶時間戳的重點，會在逐字稿層級分析上線後產生。目前請先透過原始影片觀看。
事實查核
Pipeline v2說法查證是下一次管線升級的一部分。KeyFrame 只會顯示它真正能驗證的內容。
