结论：AI 输出之所以是“死文件”，不是格式问题，而是内容只落在最后一份产物上——下一轮要重来、别人改不了、系统也检索不到。让它能接着编辑有三条路：用 CLI 把结果写回在线文档、用石墨办公文档中台私有部署的 API 与 SDK 写进业务系统、或直接在编辑器内用 AI 生成与回写。三条路的差别不在生成质量，而在结果最后落在哪里。
选之前先问一句：这份结果是给人继续改，还是给系统继续用？答案不同，路径完全不同。
一、先认清“死”在哪：四个症状对四个要求
把 AI 结果导出成 docx 或 xlsx，格式是对的，问题通常藏在下面四处。每一处都对应一个可以现场验证的要求。
| 症状 | 活文档应该做到 | 怎么验 |
|---|---|---|
| 结果是一份附件，正文里找不到 | 结论写回正文或在线文档的约定位置 | 打开正文，确认结论在那里，而不是在下载目录 |
| 表格被写成文字或截图 | 真表格：单元格可改、能写公式、能被引用 | 改一个明细数字，看汇总是否自动重算 |
| 同一个数字在几处写死，改一处要改五处 | 关键数字只落一处，其余引用它 | 改动源头数字，检查其余位置是否跟着变 |
| 下一轮还得从头贴一遍 | 结果写回同一处，版本历史连续 | 写回后看是否新增版本，能否回退到上一版 |
这四条不解决，生成得再快也只是把“重新排版”这件苦力活儿往后推了一轮。
顺带说清“死文件”是怎么造出来的：用脚本库按模板生成 docx 或 xlsx（例如 python-docx 这类库，它读写的是 docx 文件本身），产出物天然是一个文件——没有在线权限、没有版本历史、也没有可被再次引用的结构化位置。所以问题不在生成工具，而在结果最后落在“文件”还是“在线内容”上。
二、三条路：谁在写、写去哪、你要准备什么
| 路径 | 谁在写 | 结果落在哪 | 你要准备什么 |
|---|---|---|---|
| CLI 写回 | 企业自研或第三方 Agent，通过石墨办公 CLI 调用 | 在线轻文档正文、表格单元格；可创建文档、插入图片与附件 | 一个受限账号、一份落点约定、冲突处理规则 |
| 文档中台接入 | 业务系统通过 JSSDK、JSAPI、服务端 API 与事件回调调用 | 嵌在 OA、ERP、CRM 里的在线预览与编辑 | 身份、权限、业务入口与异常处理的设计 |
| 编辑器内 AI | 员工在编辑器里发起，AI 在文档、表格、幻灯片内生成与回写 | 当前打开的这份文档或表格 | 明确谁能用、用在哪类文档、结果由谁复核 |
CLI 这条路的能力边界是具体的：能创建轻文档、连接并读取与更新正文，能读写表格单元格、追加删除行、导入 xlsx、导出 CSV 与 XLSX，能插入图片和 PDF、Office 附件，也能批量读取一个文件夹内的轻文档再把归纳写进新文档。表格的批量导入与导出，正是“Excel 死文件”最常见的出口。
文档中台这条路适合结果本来就属于某个业务系统的情况：用户、文件、权限与审批仍由接入方掌握，文档中台负责文件打开以后的能力，不替代业务入口。它需要集成工作，购买之后仍然要有人做对接。
三、怎么选：三个判断就够
- AI 跑在哪。模型在企业自有环境、由自研 Agent 调用的，走 CLI 最直接；AI 能力已经嵌在业务系统里的，走文档中台。
- 结果给谁用。给人接着改，就落在在线文档或表格里；给系统消费，就按接口约定的结构回写，再另存一份可读版本。
- 谁负责改。如果每次都是员工在原文上继续写，编辑器内 AI 最省事；如果是一批文件自动整理、人只看结果，CLI 写回更合适。
三者可以混用：日常起草用编辑器内 AI，周期性汇总用 CLI，单据与档案类结果走文档中台。混用时要约定同一个落点，否则同一件事会留下三份互相不一致的版本。
四、落地顺序：五步，缺一步就会退回死文件
- 定落点。写清结果写进哪份文档、哪个表格的哪个区域，不用“生成一份新文档”这种模糊约定。
- 约定增量。写哪一段、是追加还是替换、哪些单元格归这次写入管，先说清楚再动手。
- 写前查版本。CLI 的轻文档写入要求先检查远端版本，冲突时重拉重试；这条要写进对接说明。
- 写完回读。回读目标位置，确认落点、字段和计算结果，再回报完成。回读是唯一可核对的证据。
- 留来源。CLI 版本说明写明，从 0.2.1 起每次轻文档写入必须声明实际模型家族，并与登录用户身份分开记录；未修改的内容保留原有来源。这条对事后复盘很有用。
常见问题
让 AI 直接写进在线文档怎么做
两条路：让 Agent 通过 CLI 写入在线轻文档或表格，或者在文档编辑器里直接用 AI 生成与回写。轻文档写入要求先查远端版本，冲突时重拉重试；表格按单元格或行写入，写完回读目标区域确认落点与数值。前者适合批量与定时任务，后者适合员工边改边用。
生成的表格能带公式吗
取决于写入方式，也要以实际导入结果为准。CLI 能写单元格、追加删除行，也能导入 xlsx、导出 CSV 与 XLSX；整份导入后原有结构、公式与引用是否保留，不同版本与导入方式表现不同。稳妥做法是先拿一份带公式与合并单元格的样本导入，打开核对重算结果，再批量用；逐单元格写值只写入结果，不会带出公式。
写回会不会覆盖别人的修改
取决于有没有做版本检查。轻文档写入约定“写前查远端版本、冲突时重拉重试”，并在写完回读确认，能避免大部分覆盖；如果接口或工具不支持版本条件，就在接入层补操作记录与人工复核。
需要自己开发吗
看路径。编辑器内 AI 由员工直接用，不需要开发；CLI 写回要有账号、落点约定和一点调用脚本；文档中台接进业务系统是集成项目，身份、权限、入口与异常处理都要设计，购买后仍需对接。
想先确认哪条路适合现有系统，可以带着要写入的文档样例和业务入口预约演示；也可以从立即试用开始，先看编辑器内 AI 的生成与回写效果，再对照办公套件私有部署产品页、文档中台私有部署产品页与编辑能力页核对能力边界。