docx-generation

## 适用场景 - 监测日报/周报/月报导出为 Word 文件 - 技术方案书定稿输出 - 投标技术标文件排版 - 工程勘察报告正式版导出 - 任何需要提交给业主、监理或政府审批的正式文档 ## 核心工作流 ``` 1. 内容准备 → 2. Markdown 排版 → 3. 调用 report_export 工具 → 4. 确认输出 ``` ### 步骤详解 **第一步：内容准备** 确保报告内容已经过完整的编制流程（`technical_writer` 撰写 + `qa_reviewer` 审核通过）。未经审核的内容禁止直接导出。 **第二步：Markdown 排版** 将最终审核通过的内容整理为标准 Markdown 格式。`report_export` 工具支持以下 Markdown 元素： | 元素 | 语法 | 导出效果 | | -------- | ---------- | -------------------------------- | | 一级标题 | `# 标题` | Word 标题1（加粗，16pt） | | 二级标题 | `## 标题` | Word 标题2（加粗，14pt） | | 三级标题 | `### 标题` | Word 标题3（加粗，12pt） | | 加粗 | `**文字**` | Word 加粗 | | 无序列表 | `- 项目` | Word 项目符号列表 | | 有序列表 | `1. 项目` | Word 编号列表 | | 引用块 | `> 内容` | Word 引用段落（左缩进+灰色竖线） | | 普通段落 | 直接文字 | Word 正文（宋体/仿宋，12pt） | **第三步：调用工具** ``` 调用 report_export 工具，传入参数： - markdown: 完整的 Markdown 报告正文 - title: 文档标题（将作为文件名） - outputPath: 可选，指定输出路径 ``` **第四步：确认输出** 工具返回文件路径和统计信息后，向用户报告导出结果。 ## 排版规范（国企/甲方交付标准） ### 文件命名 格式：`[项目简称]-[文档类型]-[日期].docx` 示例： - `望京SOHO基坑-监测日报-20250301.docx` - `地铁16号线-第三方监测月报-202502.docx` - `中关村大厦-变形监测总结报告.docx` ### 报告头部必备要素 每份正式报告必须包含以下信息（作为 Markdown 正文开头）： ```markdown # [项目全称] [报告类型] **报告编号**：RW-[年份]-[项目编码]-[序号] **委托单位**：[甲方名称] **监测单位**：深圳市睿威智测科技有限公司 **编制日期**：[年月日] --- ``` ### 页面结构 | 部分 | 说明 | | -------- | --------------------------------------------------------- | | 封面信息 | 项目名称、报告类型、编号、日期、编制单位 | | 目录提示 | 在正文前写一行 `> 注：正式提交时请在 Word 中插入自动目录` | | 正文章节 | 按标题层级组织 | | 附件说明 | 在报告末尾注明需附的图纸和数据表 | ## 常见文档类型模板 ### 监测日报 ```markdown # [项目名称] 第三方监测日报 **报告编号**：RW-2025-XXX-NNN **监测日期**：2025年XX月XX日 **天气**：晴，气温15～22℃ --- ## 1. 本日监测概况 [概况文字] ## 2. 监测成果 ### 2.1 [监测项目] [数据表格，使用 Markdown 表格] ## 3. 预警情况 [预警或"本日无预警"] ## 4. 结论与建议 [结论] ``` ### 技术方案 ```markdown # [项目名称] 自动化监测技术方案 ## 1. 项目概况 ## 2. 编制依据 ## 3. 监测内容与方法 ### 3.1 监测项目 ### 3.2 测点布设 ### 3.3 仪器设备 ## 4. 监测频率 ## 5. 预警值与控制标准 ## 6. 数据处理与信息化 ## 7. 质量保证措施 ## 8. 安全保障措施 ## 9. 人员与设备配置 ``` ## 注意事项 - `report_export` 工具生成的是基础排版的 Word 文件，复杂格式（页眉页脚、公司 Logo、签章栏）需用户在 Word 中手动调整 - 表格数据量大时（超过 20 行），建议使用 `excel_export` 工具导出 Excel 附件，报告正文仅保留摘要表 - 图表（趋势图等）需先用 `chart_generator` 工具生成 SVG，再由用户手动插入 Word - 文件默认输出到当前工作目录，可通过 `outputPath` 参数指定其他路径