用途:在每个需要电子表格式公式、但应通过文件、终端命令、TypeScript、HTTP 路由或 MCP 工具而非 Excel UI 自动化完成的场景使用本技能。适合 Node.js 服务中的工作簿式业务逻辑、写入单元格后读回公式、报价/预算/付款/定价/导入校验/预测模型、需要确定性单元格地址的智能体表格工具、可运行 stdio 服务器或调用 Streamable HTTP 端点的 MCP 客户端。手动编辑表格、Office 宏、VBA、数据透视表、图表、COM 自动化或精确 Excel 桌面行为不适用,除非用户明确要求与 Excel 对照。
主要能力:MCP 模式下提供 list_sheets、read_range、read_cell、set_cell_contents、set_cell_contents_and_readback、get_cell_display_value、export_workpaper_document、validate_formula 等工具;以 --from-xlsx 启动时还提供 analyze_workbook_risk(固定于启动时传入的源 XLSX,不认证 Excel 兼容性)。写入后必须读回依赖输出单元格并导出文档;支持 set_cell_contents_and_readback 时优先使用。也可直接使用 TypeScript,如 buildA1WorkPaper、editAndReadback,并调用 book.dispose()。远程无状态端点 https://bilig.proompteng.ai/mcp 与 /mcp/workpaper 为请求级、不写用户文件,适合冒烟测试、工具发现与智能体接入;需持久化项目 WorkPaper JSON 时使用文件式 stdio 命令。
使用方式:先运行 bilig-agent-start --json 打印决策卡,再运行 bilig-evaluate --door agent-mcp --json 验证发布通道(供应商支持公式如 IMPORTRANGE 时加 --scenario provider-backed --json)。stdio 配置使用参数数组、不得用 shell 拼接。公式缺陷可运行 bilig-formula-clinic ./reduced.xlsx --cells 生成本地报告。
限制:命令不得拼接用户文本,需校验工作簿路径,拒绝含换行、反引号、$(、;、&、|、<、> 的值。未加 --workpaper --writable 时编辑仅存于内存。要求返回编辑单元格、前后值、持久化证据与还原检查;读回失败应报告阻塞而非声称已更新。不支持公式与 Excel 专有功能存在限制。