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）