Potpie

工具簡介

Potpie 是 Momenta Softwares Inc. 所推出的用於處理代碼上下文圖譜及進行 AI 開發的平臺，目前被視為用於大型代碼庫的規格驅動式開發工具。它能將代碼結構、依賴關係、版本歷史、專案文件以及工程任務整理成可查詢的上下文圖譜，如此一來，代理就能在理解專案內容之後，進行回答、規劃、修改和除錯等工作。

主要功能

代碼上下文圖譜

Potpie會對倉庫、分支以及相關的專案資料進行索引，並建立檔案、函數、類別、呼叫關係以及語意資訊之間的連結。使用者可以透過關鍵字、節點或自然語言來查詢這個圖譜，接著再透過實際的程式碼來回答跨檔案的問題。

• 適合追蹤功能入口、依賴鏈、實現位置和架構決策。
• 可比較分支或提交之間的變化，並分析受影響的代碼元素。
• 首次索引和大型倉庫更新需要計算時間，結果品質取決於索引是否完整且足夠新。

Ask、Build 與 Debug 工作流

Ask用於解釋程式碼與架構，Build會先研究現有的模式再進行修改，Debug則從故障表現出發追蹤可能的根本原因並提出相應的解決方案。對於複雜的任務，可由主管將其分解給專門的子代理來處理，但最終的成果仍需經過程式碼審查與測試。

• 代碼問答可返回相關檔案和代碼位置，便於開發者繼續核對。
• 代碼生成代理能準備變更，並在用戶明確要求後透過 GitHub 建立拉取請求。
• 規格代理可從需求或現有代碼生成技術規格，調試代理用於分析錯誤路徑和修復點。

工程系統集成

Potpie 可以與 GitHub、Linear、Jira 和 Confluence 連接，從而將代碼、議題、專案及文件整合在相同的環境中。產品文件中也列出了 Slack、Sentry 和 VS Code，不過不同部署版本所支援的整合功能可能有所差異。

• GitHub 整合可讀取倉庫、議題和拉取請求，並在授權範圍內管理分支與變更。
• Jira、Linear 和 Confluence 這些工具可以用來查詢或更新專案資料，而具體的操作權限則由管理員所決定。
• VS Code 擴充功能將程式碼庫的聊天與修改流程引入編輯器，並透過本機隧道連接到雲端代理。

CLI、API 與自訂代理

目前的開源架構以 CLI 為優先，可為 Claude Code、Codex、Cursor 和 OpenCode 安裝對應的指令或技能。API 可用於解析儲存庫、檢查索引狀態、建立會話、傳送訊息、列出專案與代理，並執行語意化碼碼搜索。

使用教學

1. 先決定使用託管企業服務還是自託管開源版，並根據組織安全要求準備獨立測試倉庫。
2. CLI 使用者在安裝 Potpie 後，運行設定向導，選擇本機倉庫、編碼助手以及需要連接的專案系統。
3. 託管使用者安裝 GitHub 應用程式，並僅授權目標倉庫的存取權，接著選擇倉庫、分支，以及 Ask、Build 或 Debug 代理。
4. 等待索引狀態完成，先詢問架構或關鍵流程，檢查回答是否引用了正確文件與實現。
5. 進行代碼修改時寫清需求、約束和驗收標準，在隔離分支查看差異並運行項目測試。
6. 需要自動化時創建 API 金鑰，為請求設定最低權限，並在金鑰庫中保存且定期輪換。

版本與使用方式

適合哪些用戶

• 需要理解大型、遺留或跨多個服務代碼庫的軟體工程團隊。
• 希望縮短新人熟悉架構、定位實現與分析依賴時間的技術負責人。
• 需要將程式碼變更與 Jira、Linear、Confluence 等工程資料關聯的企業組織。
• 適合那些希望使用自托管代碼智能體、擴展代理工具，或透過 API 建構內部開發流程的團隊。

價格與方案

目前，企業的定價頁面並未公開固定單價，費用是由用戶許可證費用以及根據支援人數計算出的平台費用所構成，而現有的技術架構本身則不另收費用。條款中提到可能存在免費與付費方案，以及 Pro 方案，但公開的購買頁面並未列出這些方案的統一價格或額度。

產品優勢

• 上下文圖譜同時連接代碼結構、歷史與工程資料，比單次檔案檢索更適合跨組件推理。
• 問答、規格、構建和調試共用項目上下文，減少不同代理之間的資訊割裂。
• 核心倉庫採用寬鬆的 Apache 2.0 授權證，可審查代碼並自行部署。
• 同時提供 CLI、網頁、編輯器擴充及 API，便於接入不同的開發流程。

使用限制與注意事項

• 索引過期、缺乏私有依賴或工程文件不完整，會讓回答和影響分析遺漏關鍵上下文。
• 代理生成的代碼可能引入安全、性能或相容性問題，不能代替測試、審查和發布批准。
• 連接 GitHub 與任務系統會授予讀取或寫入權限，應使用最小作用域並隔離生產憑證。
• 開源版免費不代表運行免費，自託管仍需承擔模型調用、計算、儲存、認證和維護成本。
• 文件同時涵蓋新舊架構，CLI 優先版本與網頁代理版本的設定和功能可能不完全一致。

隱私、安全與退款

託管服務會處理代碼、提示詞、生成結果、授權令牌及使用日誌，並可能運用去識別過的輸入與結果來優化內部模型。Pro 數據的訓練功能目前暫未開放，敏感代碼的使用者應先以書面方式確認相關設定，或選擇符合組織要求的本地及專有部署方式。

隱私政策規定，為了滿足歷史記錄、分析及訓練之需求，輸入的資料、日誌以及回饋可能需被長期甚至無限期地保存。使用者可申請刪除這些資料，但由於備份、審計及法律上的要求，這些資料仍可能被保留下來。該平台不適合用來處理受監管的敏感資料，而自托管環境中的存取控制、網路安全及修補工作則由部署該平台的組織負責。

付款後通常不予退還；若出現技術故障、重複扣款、不可抗力，或有可證明的取消理由，可在交易完成後 7 天內以書面方式申請，由公司自行決定是否退還。若獲准退款，大概需要 7 至 14 個工作日，具體仍以訂單合約為準。

API、SDK 與開源情況

Potpie 提供帶有 API 金鑰認證的介面，能夠完成倉庫解析、狀態查詢、會話管理、訊息傳輸、專案處理、代理功能以及語意搜尋等操作。目前還沒有獨立的 SDK 名稱，開發者可依照介面文件直接進行整合。

核心 Potpie 倉庫與獨立網頁介面倉庫皆採用 Apache 2.0 授權條款，但完整產品的商標、託管服務、企業功能以及第三方整合功能並不因此而自動開放。在自行託管時，還必須遵守模型、資料庫、認證以及外部平台的相關授權條款與規定。

常見問題

Potpie是完全免費的嗎？

開源代碼可依 Apache 2.0 讓許可證使用，但部署、模型與維護會產生各自的成本。企業託管服務則是根據使用者數量與平台規模來定價，並非有公開的固定價格的免費產品。

能讓 Potpie 直接修改代碼嗎？

Build或代碼生成代理可以進行修改準備，並在收到明確要求後建立拉取請求。使用者應先在隔離分支中檢查差異、執行測試，並完成團隊的審核。

私有代碼會用於訓練嗎？

隱私政策允許使用去識別後的輸入資料，並以此建議改進內部系統，且稱 Pro 版本在訓練階段暫時不會被推出。當涉及專有代碼時，應在上傳前確認合約、資料使用規範、保留期限以及部署範圍。