ARTICLE · 1243956

文档智能体的实践(二):操作更新和流程重构

发布时间：2026-10-24 22:30:24 最近访问：2026-10-24 22:30:25

先看这张图。

工作台现在的样子：五个页面，从传资料到导出 Word 的完整链路

上一篇介绍了我做的一套文档写作工作台。这一篇介绍最近两轮改动：工作台的完整操作流程，以及底层文件路线的调整。

先说明背景：这是个人项目，功能是辅助写项目建议书、可行性研究报告、设计说明类文案。智能体部分用 Claude Agent SDK，模型接 DeepSeek。目前处于测试阶段，功能还在调整。

5 步
操作流程定型58 个
小节一键巡检3 项
底层流程调整

操作流程

工作台分五个页面，按写作顺序排列：背景资料、大纲生成、智能写作、逻辑校验、一键成文。

第一步背景资料

上传 docx、pdf、txt、md、xlsx 文件，单文件上限 50MB，同名覆盖。上传后系统自动解析，切成 300 到 500 字的片段存入检索库。列表里"切片数"列显示每份资料切了多少片。

图片（png、jpg）只存储归档，不参与检索。AI 写作时按片段做相似度检索，引用资料内容，检索方式是 jieba 分词加 BM25。

资料上传后的列表，含类型、大小、解析状态、切片数

第二步大纲生成

模板两种来源：内置标准模板，或上传自己的 Word 模板。内置模板是政府投资项目可行性研究报告模板，按发改投资规〔2023〕304 号的十大大纲编制。

解析后得到 67 个标题节点，其中 62 个写作节点各带一张指令卡，内容包括：内容要点、成文结构、篇幅、图表要求、资料依据。指令卡可以逐节修改。

在这一步勾选哪些背景资料参与检索，同时填写项目名称、总投资等基础信息。生成后得到一份 markdown 格式的大纲草稿。

模板选择、背景资料勾选、项目信息数据卡

第三步智能写作

左侧显示文档目录树、写作要求和正文，右侧是对话窗口。两种方式修改文档：

① 对话修改：给 AI 发指令，例如"这个表格右侧加一列，其他不动"。AI 直接改 markdown 源文，改完左侧即时刷新。

② 手动修改：在左侧编辑面板直接改，确认保存后生效。

两种方式的修改都先自动备份原文。AI 写作时会按当前小节的指令卡检索背景资料，并在回复中注明引用了哪些资料。

左侧目录树和正文，右侧对话框改稿

第四步逻辑校验

这个页面管理写作规则，具体形式是一份 YAML 执行剧本。

以可研报告为例，一条基本规则是：设备列表里的设备，要在投资估算章节里有对应的费用；需求章节列出的功能，要能在设备章节找到对应。需求、功能、设备、概算、绩效五层要一一对应。

剧本内容包括：7 个写作阶段的推进顺序、11 条一致性规则、23 个章节的数据绑定。智能体写作时按剧本执行，参数只能从参数卡取——站点数、用户数、数据量、等保等级等，先登记再引用，不允许编造。

资料不全时可以降档执行：L1 完整、L2 类比、L3 假设三档，假设值会明确标注来源。剧本可以复制一份自己修改，改完要通过 lint 检查才能保存。

剧本工作台：内置剧本只读，自洽校验通过，下方是人话说明

第五步一键成文

前四步完成后，点"一键生成 Word"。流程是：

① 智能体巡检全文，找出没写的、带占位符的、内容单薄的章节，按各自的写作要求补齐。

② 做一致性校验，不通过就把报告返回给智能体修复，最多 3 轮。

③ 装配导出 Word。封面、目录、页码、横纵页、表格题注由程序统一处理。

截图里那份任务报告是真实运行记录：全文 58 个正文小节检查一遍，报告了三处写作要求落实不完整，并列出了修改位置。每次成文存一个版本，可以下载、预览、查看报告、删除。

任务报告弹窗和版本列表，每版可下载、可回看

全文改为 markdown 格式

原来的设计是 AI 直接写 Word 文件（docx）。实际使用中遇到几个问题：python-docx 库处理样式和自动编号能力有限；AI 改动 docx 后，数据库里的内容快照容易和文件不一致，需要反复修复。

现在改为：markdown 是文档的唯一内容源，Word 只是导出产物。

所有修改都在 markdown 上进行。前端直接渲染 markdown 预览。导出 Word 时走固定流程：lint 门禁检查结构违规；渲染 mermaid 逻辑图和引用图片；按模板组装，字体、题注、页眉页脚、分页由程序控制。

这样做的结果是：AI 只负责内容，格式由程序负责，两者分开处理。

不足之处：markdown 不支持合并单元格，这类表格改用测算底稿处理。导出多了一次转换步骤。

过程文件可下载

原来 AI 算完概算，过程不可见，只能看到结果数字。

现在计算类表格有固定流程：AI 先生成一张 Excel 测算底稿，和文档放在同目录。底稿分三个工作表：录入（原始数据）、过程（计算公式）、汇总（进正文的数据）。

模型只写结构和公式，不写最终数字。之后由 LibreOffice 无头模式重算，重算结果写入正文表格。哪笔数字怎么算的，打开底稿就能核对。

另外，每轮一键成文的 Word 版本可以下载，AI 生成的插图和 mermaid 渲染的图也有文件可取。

Skill 和 MCP 默认全开

原来 Skill 和 MCP 的调用规则是：用户不勾选，AI 就不使用。实际效果是技能很少被调用——模型不知道有哪些技能，用户也想不起来选。

现在改为：不勾选就是全部启用，由模型按需自主调用；需要限制时再手动指定名单。修改后，联网搜索、画拓扑图等功能开始被实际使用。

已知问题

目前的限制，都是实测出来的：

问题	现状与处理
概算精细化程度有限	底稿保证数字来源可追溯，但取费标准是否适合具体项目，仍需人工把关
剧本只有信息化行业一个版本	换行业需要重写数据模型和规则
一键成文不负责内容质量	检查的是结构和数据一致性，能补全缺失章节，补出来的内容好坏要靠人判断
markdown 表达能力有限	复合表头这类需求目前通过测算底稿绕开