papi

Paperpipe 是一款專為開發者、研究人員及 AI 代理設計的學術研究轉程式實作工具。它透過維護一個結構化的本地資料庫，彌補了靜態 PDF 論文與實際程式碼實作之間的落差。此工具協助使用者透過提取的公式、LaTeX 原始檔案及針對程式碼撰寫優化的摘要來驗證實作細節，避免 AI 產生幻覺。它是交叉比對數學定義、理解架構圖以及追蹤實作筆記的核心工具。

• 透過 CLI 高效管理本地論文資料庫，支援 arXiv ID、URL 及本地檔案匯入。

• 自動提取並組織關鍵技術素材，包括數學公式、LaTeX 原始碼以及用於實作的高階摘要。

• 混合式搜尋功能，結合快速的 ripgrep (rg) 字面匹配、BM25 排序搜尋，以及透過 PaperQA2 或 LEANN 後端進行的語意檢索 (RAG)。

• 與 AI 程式代理 (如 Claude Code 或 Gemini) 無縫整合，允許代理人在編寫程式碼時獲取引用、頁面特定內容及驗證後的數學細節。

• 具備論文間的綜合分析能力，可比較不同的研究方法、參數規模及研究方法論，協助進行複雜的實作決策。

• 透過中繼資料 (Metadata) 追蹤與標籤系統，有效管理大量實作導向的文獻收藏。

• 優先使用 papi CLI 進行直接查詢以降低延遲；僅在需要語意綜合或跨論文推理時才調用 RAG 工具 (如 papi ask、leann_search 或 retrieve_chunks)。

• 資料庫目錄 ~/.paperpipe/ 包含重要的檔案如 equations.md、source.tex 及 figures/，在偵錯邏輯或模型架構時應優先參閱。

• 使用 papi export 指令將特定論文內容匯出至專案資料庫中，以便在 AI 代理會話中作為背景知識使用。

• 主要輸入為論文 ID 或搜尋關鍵字；主要輸出為精確的技術規格、可引用的章節或針對程式實作問題的綜合解答。

• 請確保安裝了適當的後端依賴 (如 [all] 以支援完整 RAG 及圖表提取)，以發揮此助理的最佳效能。