用途:在 officecli-xlsx 引擎之上构建“仪表盘式”Excel 工作簿,而非普通带图表的表格。核心是组成结构——用户首先落在 Dashboard 工作表,上面放置公式驱动的 KPI 卡片、单元格区域引用的图表、迷你图与语义化条件格式;原始数据与聚合放在上游 Data / Summary 工作表,用户通常无需打开。
主要能力:生成多条公式型 KPI(SUM、AVERAGE、IFERROR 等,引用 Data/Summary 单元格,不硬编码数值);绘制多个图表并使用单元格区域引用(如 series1.values="Sheet1!B2:B13");添加迷你图(sparkline)、条件格式(databar、colorscale、iconset、formulacf);设置打开时激活的 Dashboard 与 calc.fullCalcOnLoad;支持打印就绪交付(Print_Area、fitToPage、横向页面、隐藏非 Dashboard 工作表)。
使用方式:需先安装 officecli(macOS/Linux:curl -fsSL https://d.officecli.ai/install.sh | bash;Windows PowerShell:irm https://d.officecli.ai/install.ps1 | iex),用 officecli --version 验证。属性不确定先查 help,如 officecli help xlsx chart。典型流程分阶段:创建并导入数据、新建 Dashboard 工作表并设置 KPI 公式、添加迷你图与图表、设置 fullCalcOnLoad 与 activeTab(最后),然后 close 与 validate。命令示例中的长图表命令应使用续行符拆分。
适用场景:用户需要“打开即用”的仪表盘、多个 KPI 卡片、多个图表,或董事会/投资人一页纸的打印交付。不适合单表 CSV 加格式追踪、三表/DCF/LBO 财务模型、少于 10 行的简单周报,这些应使用 officecli-xlsx 或 officecli-financial-model。
限制:图表数据源必须是可见单元格,隐藏列或隐藏工作表在 LibreOffice 渲染时不计算公式,会导致图表空白;每次上游编辑后需刷新下游 cachedValue,fullCalcOnLoad 只调度运行时重算;不要 raw-set <calcPr>;Dashboard 的 sheet 索引须先查询确认,不可硬编码;默认视图中可能出现 ### 或标题裁剪。本文档未提供具体收费、价格或平台支持信息。