Bilig WorkPaper

要解决什么问题

Agent 在后端或本地工作流里处理「类 Excel」逻辑时，常见路径是浏览器自动化、截图识别或直接操作 Excel UI。这些方式对布局变化、弹窗和渲染时序敏感，很难在写入后证明输出单元格真的按公式更新了。若还要审计、回滚或多轮对话续跑，缺少一份可版本化的工作簿状态会更痛苦。

技能如何工作

Bilig WorkPaper 把电子表格抽象成可持久化的 WorkPaper JSON：通过 API 或 MCP 工具完成典型闭环，而不是驱动界面。

• 读写模型：列出工作表，读取/设置单元格或区域内容。
• 公式与重算：写入或校验公式后触发重算，再从模型中读回显示值（而非只相信写入成功）。
• 持久化与导出：重要变更后导出文档，便于缺陷报告、验证 Agent 改动或恢复流程。

文件型 MCP 会话通常暴露：列出工作表、读区域、设单元格、校验公式、导出文档，以及重算后读取显示值。TypeScript 服务侧也可直接调用包内 API，在进程内维护同一份 WorkPaper 状态。

适用边界与注意点

• 适合「无 UI、可脚本化」的公式与输入/输出验证；若任务本质依赖 Excel 专有功能或复杂 UI 交互，仍需评估是否覆盖。
• 每次变更后应验证：写入输入格与依赖的输出格，并在需要证明时保留导出的 JSON。
• Agent 生成公式时，应先校验再写入；在显示值读回确认输出变化之前，不要视为任务已完成。
• 多轮状态：以可写模式挂载 --workpaper 文件，并在关键步骤导出，避免会话间状态丢失。