Files
Agent-System-Documents/docs/records/2026-10-15-unified-document-renderer/08-template-onboarding-and-migration.md
T

2.8 KiB

08 模板接入与迁移

1. 当前 44 份模板

第一阶段逐份生成 RenderProfile,不按文件名硬编码渲染逻辑。每个配置包绑定:原件、转换派生、规范化 DOCX、结构合同、渲染底稿、规则快照、资产和人工评审结论。

当前 42 PASS、2 EXPECTED_BLOCKED。完成前必须补齐对应文档类型字典登记和存量数据库迁移,并在 SQLite、PostgreSQL 与真实产品链重放;不能把“预期阻止”计为已接入。

2. 接入步骤

  1. 原件保全:文件名、格式、大小、SHA256、来源和许可。
  2. 安全检查:宏、OLE、外链、嵌入对象、损坏部件。
  3. 规范化:旧 DOC 生成受控 DOCX 派生并记录转换器版本和输入输出哈希。
  4. 结构分析:章节、段落、表格、重复块、图片、页眉页脚和签署区。
  5. 视觉普查:字体、页面、标题、编号、颜色、Logo 和模板例外。
  6. 锚点化:把可填写位置转换成书签或内容控件。
  7. 规则生成:建立 RenderProfile 和 Markdown 节点映射。
  8. 正反样例:完整输入、缺字段、超长内容、复杂表格和权限拒绝。
  9. 预览对照:原模板、空模板、填充结果和回读结构。
  10. 人工发布:内容、格式、安全和适用范围全部通过后进入 published。

3. 公司通用规则

通用规则不是 44 份模板中的任意一份。它由公司视觉普查结论生成,服务于没有专用受控模板的普通报告、纪要、说明和分析文档。

4. 字典门禁迁移

对两份阻塞模板:

  • 明确对应文档类型、阶段和用途。
  • 新增版本化字典迁移,而不是只修改新库种子。
  • 迁移前生成备份和对账清单。
  • 存量项目不自动创建文档;只增加可选择类型。
  • 旧二进制遇到新字典/schema 时拒绝写入。
  • 迁移后重新执行 44 份全链矩阵。

5. 规则版本迁移

已发布规则不可改写。模板修订、Logo 更新或样式调整创建新版本;旧交付物和旧规则包永久可取。文档升级保存旧/新预览、内容映射差异和影响分析,经真人确认后应用。

6. 用户上传规则生成(后续)

分析器输出:

  • 候选 RenderProfile。
  • 资产清单和哈希。
  • 识别到的样式、锚点和结构。
  • 未识别/低置信度项。
  • 安全风险。
  • 样例 Markdown。
  • 预览 DOCX。
  • 原件与预览的结构/视觉差异报告。

候选规则只能保存为 draft。用户可在规则编辑器中修改允许字段;复杂新能力提交为渲染器原语需求,不允许嵌入代码绕过。

7. 回滚

回滚是把默认绑定指回旧发布版本,不删除新版本。已经用新规则生成的草稿保留;批准文件永不重新渲染覆盖。规则包、字典和资产迁移分别拥有对账及恢复记录。