tmustier/pi-for-excel

Pi for Excel – AI 驅動的電子試算表助手

是什麼 – 一個開源的 Office 增益工具，將對話式 AI 代理直接嵌入 Microsoft Excel。您可以設定任意 LLM（Anthropic、OpenAI、Google Gemini、GitHub Copilot 或自訂 OpenAI 相容端點），讓代理讀取、寫入、格式化和分析工作簿。

主要功能

• 16 個內建電子試算表工具 – 例如 read_range、write_cells、fill_formula、search_workbook、explain_formula、conditional_format，以及用於追蹤公式相依性的工具。
• 多模型支援 – 透過斜線指令（/model）即時切換提供者或模型。
• 會話管理 – 每個工作簿支援多個聊天標籤頁，自動儲存、歷史記錄，以及 /resume 指令。
• 自動上下文注入 – AI 會自動取得工作簿藍圖、目前選取範圍和最近變更，無需手動描述工作表。
• 一鍵回滾 – 每次變更操作都會建立檢查點；側邊欄可立即恢復變更。
• 格式規範 – 一次定義公司風格規則（貨幣符號、負數樣式、小數位數），代理將自動遵循。
• 斜線指令與擴充功能 – /settings、/tools、/extensions 等指令，以及可安裝由 AI 產生的沙箱擴充（迷你應用）。
• 外部整合 – 可選的網路搜尋（Jina、Serper、Tavily、Brave）和用於自訂工具的 MCP 網關。

如何取得

1. 從倉庫下載 manifest.prod.xml（或使用 Vercel 托管的 URL）。
2. 將清單新增至 Excel（macOS、Windows 或 Excel 網頁版 – 請參閱連結的安裝指南）。
3. 從功能區開啟 Pi 面板，使用 API 金鑰或 OAuth 連接提供者，開始聊天（例如：「我有哪些工作表？」）。

開發者快速入門

• 需要 Node ≥ 22.19（或 ≥ 24）和 mkcert 用於本地 HTTPS。
• 克隆後執行 npm install，產生本地憑證，然後執行 npm run dev（Vite 在 https://localhost:3141 提供插件）。
• 按照倉庫的側載說明將開發用清單載入 Excel 中。
• 可選工具：npx pi-for-excel-proxy（OAuth 用 CORS 代理）、npx pi-for-excel-python-bridge、npx pi-for-excel-tmux-bridge（用於本地 Python/LibreOffice 或 tmux 橋接）。

架構概覽

• 前端 – 使用 Lit Web Components 建構的 Vite 打包單頁任務窗格。
• 代理核心 – @earendil-works/pi-agent-core 負責工具迴圈、串流傳輸和狀態管理。
• LLM 抽象層 – @earendil-works/pi-ai 為 Anthropic、OpenAI、Gemini、Copilot 或自訂端點提供統一 API。
• Office.js – 用於讀取/寫入工作簿和管理 UI 集成。
• 工具註冊表 – 所有 16 個核心工具的中央定義；UI、提示和執行時皆由此註冊表衍生。
• 擴充沙箱 – 不可信的擴充在權限強制的 iframe 中執行。
• 儲存 – IndexedDB 儲存會話資料、檢查點和使用者層級規則。

為何重要 Pi for Excel 展示了如何將功能完整的 LLM 驅動代理嵌入傳統生產力應用中，將靜態電子試算表轉變為互動式、AI 增強的工作空間。它展示了可重複使用的實用模式——工具註冊表、自動上下文注入、基於檢查點的回滾和沙箱擴充，適用於其他 Office 增益工具或桌面應用的 AI 集成。

授權 – MIT（© Thomas Mustier）