Huo15 Openclaw Office Doc — Huo15 OpenClaw Office Doc

火一五文档技能 v7.8.5

企业级 Word & 原生 PDF 文档生成 — 青岛火一五信息科技有限公司

愿景： 加速企业向全场景人工智能机器人转变 理念： 打破信息孤岛，用一套系统驱动企业增长

〇、v7.8.5 hotfix（ELEPHANT-IN-THE-ROOM — 记录O 宽度错算导致页眉跑出页面）

用户反馈"v7.8.1/v7.8.2/v7.8.3 还是没有页眉、字体不对" — pdftoppm 栅格化亲眼验证 + PyMuPDF 解 PDF 流 找到真凶：

# v7.7~v7.8.4 错误代码 img = Image(记录o_path, height=tar获取_h) # platypus Flowable iw, ih = img.wrap(page_w, page_h) # iw 返回原图像素宽（如 2048） tar获取_w = iw (tar获取_h / ih) if ih else tar获取_h # ↑ iw=2048, ih=25.5 → tar获取_w = 2048 (25.5/25.5) = 2048pt

drawImage(width=2048, height=25.5, preserveAspectRatio=True) 在 2048pt 宽容器里居中 25.5pt 实际 记录O，居中偏移 (2048-25.5)/2 = 1011pt。记录O 实际 x = 79 + 1011 = 1090pt，远超 page 595pt 宽 — 记录O 跑到页外！页眉文字 text_x = x_启动 + 记录o_w = 79 + 2053 = 2133pt 也跑到页外。

所以"页眉只有一条灰线" — line 用绝对坐标没问题，drawImage/drawString 用 转换 matrix 全跑页外。

修复：用 报告lab.lib.utils.ImageReader.获取Size() 直接读 记录O 像素尺寸等比缩放，不依赖 platypus Image.wrap()。

from 报告lab.lib.utils 导入 ImageReader ir = ImageReader(记录o_path) iw, ih = ir.获取Size() # 像素尺寸，2048×2048 tar获取_w = tar获取_h iw / ih # 25.5 2048/2048 = 25.5pt 正确

v7.8.0~v7.8.4 都修错了方向（字体 subface / fontconfig fallback / two-pass canvas resource / onPage 时机）。这次用 PyMuPDF 解 PDF 流 看到 25.5 0 0 25.5 1090.614 803.622 cm 才直接定位到 记录O 转换 错位。亲眼看 + 拆 PDF 流 是诊断这类视觉 bug 的唯一可靠路径。

附带：chrome 从 two-pass canvas 子类移到 Pa获取emplate.onPage 回调（make_chrome_callback），架构更干净。

〇、v7.8.0~v7.8.4 中间版本（合并摘要 — 都没修到真因） 版本 改动方向 实际效果 v7.8.0 LibreOffice 过滤器 7 项保真 + 平台感知 backend 字体/排版 marginal 改善，元凶未触 v7.8.1 macOS Songti.ttc subface 0→6 / STHeiti 0→1（修繁体特黑） 嵌入字体名变对，但页眉仍隐身 v7.8.2 LibreOffice 路径 docx 字体名平台映射（"宋体"→"宋体-简"） LibreOffice 路径有效，PDF 直出仍隐身 v7.8.3 文案：LibreOffice 标为推荐默认 文档级，无代码影响 v7.8.4 (内部调试，设置FillColor / 字体注册 trick) 都没救页眉

→ 都是错方向。真因在 v7.8.5 才被定位：记录O Image.wrap() 返回 iw 没等比缩放 → tar获取_w 错算 2048pt → drawImage 居中偏移 1011pt → 记录O+chrome 文字跑出页面右边。

〇、v7.7 修复（PDF 直出与 Word 视觉对齐 — 摘要）

修了 3 处对齐：页眉用 stringWidth() 居中（修正中文公司名偏右）/ leading × 1.2 系数（21.6pt 对齐 Word 1.5 倍行距）/ firstLineIndent = size × 2（24pt 对齐 Word firstLineChars=200）。详细数学验证见 git 记录 v7.7.0 提交。

一、v7.5 关键变化（合同细分 7 类 + 配套范本）

用户反馈："合同帮我再细分"。

通用"合同"在 ToB 场景下太粗 — 一份合同应不应该带 试用期 / 知识产权 / 退换货 / 保密期限 / 收益分配 等条款，取决于具体合同子类。v7.5 把合同细分为 7 类：

子类 触发关键词 适用场景 范本 劳动合同 劳动合同 / 雇佣合同 / 用工合同 / 实习合同 HR 招聘入职 templates/劳动合同.md 服务合同 服务合同 / 技术服务 / 咨询 / 维保 / SaaS / 运维 长期服务 templates/服务合同.md 技术开发合同 软件开发 / 委托开发 / 定制开发 / 开发合同 一次性开发 templates/技术开发合同.md 销售合同 销售合同 / 货物销售 / 软件许可 / 经销 售方角度 templates/销售合同.md 采购合同 采购合同 / 物资采购 / 设备采购 / 框架采购协议 购方角度 templates/采购合同.md 保密协议 保密协议 / NDA / 信息保密 / 双向保密 保密信息保护 templates/保密协议.md 合作协议 战略合作协议 / 联营协议 / 联合开发协议 有约束力合作 templates/合作协议.md

通用"合同"作为兜底保留 — 输入命中"合同"但没匹配到具体子类时使用。

视觉上 7 个合同子类共享通用合同的版式（宋体 / 标准页边距 / 无文档壳 / 第一条 ~ 第N条结构）；差异在 正文结构 与 范本内容。格式化_KEYWORDS 顺序保证子类 关键词在通用"合同"之前命中。

历史变更详见文末 §十 版本历史。

二、39 类文档规范（v7.5）

列含义：banner = 顶部右上 【内部】 红字；meta = 文档编号/版本/密级/日期 2 列表； 版本史 = 末尾"版本历史"表；审批 = 末尾"审批记录"表；TOC = 自动目录。 命中顺序由上至下；auto 命中后立即返回；--doc-格式化 <规范> 强制覆盖。

规范 触发关键词 banner meta 版本史 审批 TOC 个人简历 ⭐v7.4 简历 / 恢复 / CV ❌ ❌ ❌ ❌ ❌ 报价单 ⭐v7.4 报价单 / 商务报价 / 报价书 / 询价回复 ❌ ❌ ❌ ❌ ❌ 新闻稿 ⭐v7.4 新闻稿 / 媒体通稿 / 发布稿 / press release ❌ ❌ ❌ ❌ ❌ 复盘报告 ⭐v7.4 复盘 / 项目复盘 / 项目总结 / 月度复盘 ❌ ✅ ✅ ❌ ✅ 测试报告 ⭐v7.4 测试报告 / QA报告 / 验证报告 / 性能测试 ✅ ✅ ✅ ✅ ✅ 故障报告 ⭐v7.4 故障报告 / 事故报告 / 故障复盘 / postmortem ✅ ✅ ❌ ❌ ❌ 任命书 ⭐v7.4 任命书 / 聘任书 / 委任书 / 任命决定 ❌ ❌ ❌ ❌ ❌ 应急预案 ⭐v7.4 应急预案 / 应急响应预案 / 应急处置方案 ✅ ✅ ✅ ✅ ✅ 在职证明 ⭐v7.4 在职证明 / 离职证明 / 工作证明 / 收入证明 ❌ ❌ ❌ ❌ ❌ 风险评估报告 ⭐v7.4 风险评估 / 风险报告 / 安全评估 ✅ ✅ ✅ ✅ ✅ 项目计划书 ⭐v7.4 项目计划书 / 项目执行计划 / 项目章程 ✅ ✅ ✅ ✅ ✅ 项目结项报告 ⭐v7.4 结项报告 / 项目收尾报告 / 项目交付总结 ❌ ✅ ✅ ✅ ✅ API文档 ⭐v7.4 API文档 / 接口文档 / 接口规范 / openAPI ❌ ✅ ✅ ❌ ✅ 部署文档 ⭐v7.4 部署文档 / 部署手册 / 上线手册 / 运行book ❌ ✅ ✅ ❌ ✅ 备忘录 ⭐v7.4 备忘录 / MOU / 合作意向书 / 战略合作备忘录 ❌ ❌ ❌ ❌ ❌ 验收单 ⭐v7.3 验收单 / 验收报告 / 交付确认书 / 项目验收 ❌ ❌ ❌ ❌ ❌ 项目立项书 ⭐v7.3 立项申请 / 立项书 / 项目建议书 / 可行性研究报告 ✅ ✅ ✅ ✅ ✅ 操作SOP ⭐v7.3 SOP / 标准作业指导书 / 工艺文件 / 操作规程 ❌ ✅ ✅ ❌ ✅ 公司制度 ⭐v7.3 规章制度 / 管理办法 / 实施细则 / 管理细则 ✅ ✅ ✅ ✅ ✅ 信函 ⭐v7.3 公函 / 商务函件 / 求职信 / 推荐信 / 邀请函 ❌ ❌ ❌ ❌ ❌ 招投标书 招标书 / 投标书 / 投标文件 / 响应文件 ✅ ✅ ✅ ✅ ✅ 商业计划书 商业计划书 / BP / 融资计划书 / 路演稿 ❌ ❌ ✅ ❌ ✅ 用户手册 用户手册 / 操作手册 / 使用说明 / Manual ❌ ❌ ✅ ❌ ✅ 培训手册 培训手册 / 培训教材 / 教学大纲 / 员工手册 ❌ ❌ ✅ ❌ ✅ 演讲稿 演讲稿 / 致辞稿 / 讲话稿 / 主题分享 ❌ ❌ ❌ ❌ ❌ 研究报告 研究报告 / 学术论文 / 调研报告 / 白皮书 ❌ ✅ ✅ ❌ ✅ 劳动合同 ⭐v7.5 劳动合同 / 雇佣合同 / 用工合同 / 实习合同 ❌ ❌ ❌ ❌ ❌ 服务合同 ⭐v7.5 服务合同 / 技术服务 / 咨询 / 维保 / SaaS 合同 ❌ ❌ ❌ ❌ ❌ 技术开发合同 ⭐v7.5 软件开发合同 / 委托开发合同 / 定制开发 ❌ ❌ ❌ ❌ ❌ 销售合同 ⭐v7.5 销售合同 / 货物销售 / 软件许可合同 / 经销 ❌ ❌ ❌ ❌ ❌ 采购合同 ⭐v7.5 采购合同 / 物资采购 / 设备采购 / 框架采购 ❌ ❌ ❌ ❌ ❌ 保密协议 ⭐v7.5 保密协议 / NDA / 信息保密 / 双向保密 ❌ ❌ ❌ ❌ ❌ 合作协议 ⭐v7.5 战略合作协议 / 联营协议 / 联合开发协议 ❌ ❌ ❌ ❌ ❌ 合同（通用兜底） 合同 / 协议 / 协议书 / 补充协议 ❌ ❌ ❌ ❌ ❌ 会议纪要 会议纪要 / 纪要 ❌ ✅ ❌ ❌ ❌ 技术方案 技术方案 / 实施方案 / 解决方案 / 设计文档 / 架构设计 ✅ ✅ ✅ ✅ ✅ 需求文档 需求规格 / SRS / PRD / 需求说明 / 需求文档 ✅ ✅ ✅ ✅ ✅ 工作报告 工作报告 / 周报 / 月报 / 季报 / 年报 / 述职报告 ❌ ✅ ❌ ❌ ❌ 公文（默认） 未命中其他关键词 ✅ ✅ ✅ ✅ ❌

一行命令看全 17 种：python3 scripts/创建-word-doc.py --列出-格式化s。 命令行工具 精细控制：--with-version-历史 / --no-version-历史 / --with-应用roval / --no-应用roval / --with-classification-banner / --no-classification-banner / --with-doc-meta-ta