一份事实源，三种交付语法：可算、可读、可讲。

✦ ① 真正的问题不是格式，而是阅读目的

把同一张业务表直接复制进三个文件，得到的通常是三份难看的重复品。更稳的做法是先形成统一视图模型：标题、时间范围、核心指标、明细、异常、结论和行动项；随后 Excel、Word、PPT 各取所需。

事实口径只维护一次；展示结构在最后一公里分叉。

✦ ② Excel：从“数组下载”升级为可工作的网格

V8.Office.ExportExcel 既能用 ExcelData + ExcelHeader 输出标准表格，也能用 ExcelLayout 描述单元格、合并、公式、边框、列宽和行高；多 Sheet 中两种模式还可以混用。

明细、版式、计算和打印是 Excel 成品的四个层次。

return V8.Office.ExportExcel({
  OsClient: V8.OsClient,
  ExcelSheets: [
    { SheetName: '审批单', ExcelLayout: {
      Cells: [
        { Range:'A1:H1', Value:'月度经营审批单', Merge:true },
        { Range:'H8', Formula:'SUM(H3:H7)' }
      ]
    }, ExcelOptions:{ FreezeRows:2, PrintOrientation:'Landscape' } },
    { SheetName:'明细', ExcelData: rows, ExcelHeader: headers }
  ]
});

这意味着接口引擎不用为了一个复杂审批单退回手工拼二进制，也不用把数据口径散落到前端。

✦ ③ Word：把字段转换成可以连续阅读的报告

Word 的核心是顺序：先结论，再解释，再证据。

ExportWord 接受 Title、Paragraphs、Tables、HeaderText、FooterText 与 ShowPageNumber。它不是把 HTML 改名为 docx，而是让标题、段落、表格和页级元素进入真实文档结构。

return V8.Office.ExportWord({
  Title:'月度经营报告',
  HeaderText:'吾码 · 内部资料',
  FooterText:'数据口径：已审核订单',
  ShowPageNumber:true,
  Paragraphs:[
    { Text:'本月收入增长，续约稳定。', FirstLineIndent:0.74 }
  ],
  Tables:[{ Headers:['指标','值'], Rows:[['收入',1280000]] }]
});

✦ ④ PPT：同一数据必须重新编排为现场叙事

会议屏幕不是纸张。ExportPowerPoint 用 Slides 表达页面节奏：封面负责建立主题，结论页先给判断，证据页只保留支撑判断的指标，最后一页给行动。

报告可以完整，演示必须克制；一页只承担一个判断。

return V8.Office.ExportPowerPoint({
  Title:'季度经营复盘', ShowSlideNumber:true,
  Slides:[
    { Layout:'TitleSlide', Title:'季度经营复盘', Subtitle:DateNow('yyyy-MM-dd') },
    { Title:'核心结论', Bullets:['收入增长','续约稳定'] },
    { Title:'下一步', Bullets:['聚焦高复用客户','缩短交付周期'] }
  ]
});

✦ ⑤ 文件生成后，还有一条安全交付边界

返回文件要同时满足格式、命名、权限、脱敏和审计。

接口引擎开启“响应文件”后，最终响应应明确 FileName、ContentType 与 FileByteBase64。导出前仍要按 DiyToken、菜单、表、行权限和字段脱敏过滤；不能因为结果变成文件，就把列表里不可见的手机号、密钥或跨部门数据带出去。

✦ ⑥ 一份事实源如何避免三份文档口径漂移

• 查询层只产生一次标准业务数据与统计口径。
• 视图模型显式区分结论、指标、明细、异常和行动。
• Excel 映射表格与计算，Word 映射叙事与归档，PPT 映射演示节奏。
• 文件名、时间范围、口径说明和权限审计由同一接口上下文生成。
• 生成后真实打开三种文件，核对公式、分页、字体、图表和损坏情况。

如果三种导出各写一套查询，半年后几乎必然出现“Excel 是 128 万、Word 是 126 万、PPT 是 130 万”的解释灾难。结构可以分叉，事实不能分叉。

✦ ⑦ 证据边界：本文确认了什么

当前实现、参数模型和项目 Skill 支持本文 API 结论；生产文件质量仍需真实回读。

本文交叉读取了 v8-export-import Skill、Word/PPT 导出实现、OfficeParam 参数模型与 OfficeDocumentSecurityTests。它们证明当前代码存在真实 Open XML 导出路径与安全测试合同，但不等于某个生产租户已经完成三种文件的业务验收。

• 已确认当前源码存在 Excel、Word、PowerPoint 三条真实导出实现。
• 已确认参数模型覆盖多 Sheet、段落表格、幻灯片与文件响应所需字段。
• 未把源码存在等同于任一生产租户已经完成真实文件回读验收。