DOCX模板绑定填充

解决的数据与文档割裂问题

在复杂业务系统中，结构化数据（如本体实例）往往需要输出为格式固定的 Word 报告。手动复制粘贴不仅效率低下，还容易破坏原有的排版、样式和文档结构。当数据包含多条记录需要映射到表格行时，处理逻辑会变得更加复杂。本技能旨在自动化这一过程，直接在 OOXML 层面将本体绑定的字段值精确填充到现有的 DOCX 模板中，无需人工干预。

核心工作流与实现机制

该技能通过一套严格的流水线完成模板渲染：

• 上下文解析与拆分：从用户查询中提取 task_context，下载并解析 JSON。脚本将其拆分为四个关键片段：.tmp/currentDocx.json、.tmp/annotations.json、.tmp/mapping.json 和 .tmp/ontologyInstance.json。
• 占位符绑定构建：根据注解和映射规则，提取 propertyId 并收集对应的本体值。关键逻辑：保留值的出现顺序和重复次数（不进行去重），以支持多行表格的按序填充。
• OOXML 精准替换：直接操作 DOCX 的底层 XML 结构。如果占位符在表格内且对应多个值，会自动复制模板行并按索引填充；如果值缺失，则保留原占位符不变。
• 文件上传：生成的文档上传至 TUSD 服务器并返回可访问的链接。

适用边界与注意事项

虽然该技能高度自动化，但在使用时需注意以下约束：

• 严格替换保护：仅替换双花括号包裹的精确占位符（如 {{propertyId}}），绝不修改占位符周围的任何上下文文本，确保文档原有语义和结构完整。
• 作用域限制：替换操作严格限制在段落（paragraph）作用域，不会在文档根节点、表格或单元格级别进行全局破坏性修改。
• 异常处理：若 task_context 缺失或源文档 URL 无法下载，技能会主动报错并提示；上传失败时不会伪造 URL。