技能介绍

解决的问题

在办公自动化场景中，经常需要将结构化的本体数据（ontology instance）回填到预置的 Word 模板里。手动逐字段替换占位符不仅效率低，还容易误改模板中无关的格式、表格结构或页眉页脚。这个技能把「读取任务上下文 → 解析绑定关系 → OOXML 级占位符替换 → 上传交付」整条链路脚本化，确保编辑只发生在精确匹配的双花括号占位符内，其余内容保持原样。

核心能力与关键步骤

输入解析：从用户查询中提取 task_context 下载链接，拉取完整任务 JSON 并拆分为 currentDocx.json、annotations.json、mapping.json、ontologyInstance.json 四个片段。
模板下载：优先从 currentDocx.sourceFetchUrl 获取源 DOCX，失败时回退到通用 URL 字段。
绑定构建：将每个 annotation id 关联到 mapping[id].bindings[0].propertyId，再按 ontologyInstance.json 中该属性的出现顺序与次数收集值序列。重复值被保留，因为同一属性多次出现往往对应不同表格行。
OOXML 填充：fill_docx_template.py 直接在 XML 段落级做替换，跨 run 合并被拆散的占位符；表格行遇到多值时自动复制模板行并按索引逐行填充；缺失值保留原占位符不动。
上传交付：将生成的 DOCX 推送至 TUSD 文件服务，最终仅返回一个结果块，不暴露本地路径或中间 JSON。

适用边界与注意点

严格替换守卫：只替换与 annotations.json 中双花括号文本精确匹配的占位符，不会改写、合并或润色占位符以外的任何文字，替换范围限定在段落级而非文档/表格/单元格级。
占位符映射约束：同一占位符文本若在不同文档位置绑定不同 property id，各位置保持独立值变体；同一 property 被多个 annotation 引用时，值序列只收集一次。
失败处理：task_context 缺失或无效、源模板 URL 不可达、TUSD 上传失败时，技能明确报错而非静默降级或伪造 URL。
TUSD 配置：默认指向内网 http://192.168.0.192:1080/plm/files/，可通过 TUSD_BASE_URL 或 --base-url 覆盖；鉴权由 TUSD_AUTHORIZATION 或 --authorization 控制。