Excel 高度依赖手动操作导致效率瓶颈
在企业日常报表、数据清洗以及预算编制等工作中，用户往往需要在 Excel 中频繁切换工作表、手动编写公式或复制粘贴外部数据。这类手动交互导致以下痛点：
- 操作延迟：每一次人工输入都可能成为整个工作流的瓶颈。
- 错误率升高：重复性的键入与复制粘贴极易产生漏填或格式错位。
- 知识沉淀不足：经验公式、业务规则难以在团队内部统一复用。
传统的 VBA 脚本虽能实现部分自动化，但缺乏现代 大语言模型 的语义理解与多模态能力，无法满足快速迭代的业务需求。
基于 Office.js 与 Pi 多模型的侧边栏代理架构
Pi for Excel 通过 Office.js 在 Excel 中注入一个 Task Pane（侧边栏），将前端 UI 与后端 Pi 大模型服务解耦，实现 多模型（文本、代码、表格）即时交互。
关键组件
| 组件 |
作用 |
| manifest.xml |
声明 Excel 加载项的入口 URL、权限以及任务窗格位置。 |
| taskpane.html / taskpane.js |
前端 UI，负责收集用户指令、展示模型回复、渲染代码高亮。 |
| Pi Proxy Service |
位于 Azure Functions 或自托管环境，负责转发 Office.js 发出的 REST 请求到 Pi 多模型后端，并处理鉴权、速率限制。 |
| Office.js Runtime |
提供 Excel 与 Web 前端的桥接 API（如 Office.context.workbook），实现单元格读取、写入及公式计算。 |
示例：manifest 简要片段
<?xml version="1.0" encoding="UTF-8"?>
<OfficeApp xmlns="http://schemas.microsoft.com/office/appforoffice/1.1"
xsi:type="TaskPaneApp">
<Id>YOUR-ADDIN-ID</Id>
<Version>1.0.0.0</Version>
<ProviderName>tmustier</ProviderName>
<DefaultLocale>en-US</DefaultLocale>
<DisplayName DefaultValue="Pi for Excel"/>
<Description DefaultValue="AI 侧边栏助理"/>
<AppDomains>
<AppDomain>https://your-proxy.example.com</AppDomain>
</AppDomains>
<Hosts>
<Host Name="Workbook"/>
</Hosts>
<DefaultSettings>
<SourceLocation DefaultValue="https://your-proxy.example.com/taskpane.html"/>
</DefaultSettings>
<Permissions>ReadWriteDocument</Permissions>
</OfficeApp>
前端交互流程（简化版）
// taskpane.js
Office.onReady(() => {
document.getElementById('sendBtn').onclick = async () => {
const prompt = document.getElementById('prompt').value;
// 调用 Pi 代理
const response = await fetch('https://your-proxy.example.com/api/pi', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ model: 'gpt-4o', prompt })
});
const { answer } = await response.json();
// 将答案写回选中的单元格
const range = Office.context.workbook.getSelectedRange();
range.values = [[answer]];
};
});
- 核心术语：fetch、JSON、Office.context.workbook
- 通过
fetch 将用户输入的自然语言 Prompt 发送至 Pi Proxy Service，后者使用 Pi 多模型 API（如 gpt-4o、claude-3）生成答案。 - 返回的文本直接写入用户当前选中的单元格，实现 “对话式公式生成” 与 “即时数据清洗” 两大场景。
多模型切换与提示工程
Pi 支持 文本、代码、表格 三类模型。前端 UI 提供下拉框切换 model 参数，后端在收到请求后依据 model 字段调用对应模型的端点。此设计让同一侧边栏即可满足：
- 公式生成（文本 → Excel 公式）
- VBA 脚本产出（代码模型）
- 图表建议（多模态模型返回 JSON 配置）
架构示意图
响应时延与本地资源消耗的权衡
使用 Pi 多模型 能显著提升交互智能度，但也引入 网络往返时延 与 云端计费 的成本。若在局域网内部署 自托管代理，可通过缓存最近请求降低时延；但缓存会占用 额外内存，并带来一致性管理负担。团队需要根据业务对 实时性 与 成本 的容忍度，选择云端直连或本地代理两种部署策略。
生产部署关键要点
- 最小权限：在 manifest 中仅声明
ReadWriteDocument，避免不必要的文件访问。 - 安全令牌：使用 Azure AD 或 OAuth2 对 Pi Proxy 进行身份校验，防止滥用。
- 错误回退：在 taskpane.js 中捕获网络异常，提供“离线模式”提示，防止用户操作中断。
- 监控与日志：在代理层记录请求体积、响应时长，以便后续容量规划。
通过上述实现，Excel 变身为 AI 增强的交互式工作台，让业务人员在熟悉的表格环境中直接获取模型驱动的洞察与自动化脚本。
项目地址: https://github.com/tmustier/pi-for-excel
