核心用法
火一五文档技能是面向企业场景的全栈文档生成解决方案，提供三条输出路径：
1. Word直出（create-word-doc.py）：通过python-docx生成原生docx，支持39类文档规范的自动识别与版式渲染
2. 原生PDF直出（create-pdf-doc.py）：基于reportlab直接输出PDF，绕过转换层，格式保真度最优
3. Word→PDF转换（word-to-pdf.py）：智能识别后端环境，优先调用Microsoft Office（macOS/Windows）或docx2pdf，LibreOffice作为兜底
文档规范体系涵盖7大类合同（劳动/服务/技术开发/销售/采购/保密NDA/合作）及HR、Sales、PR、PM、Tech、Legal等全业务场景，每种规范可独立配置文档壳元素：【内部】密级横幅、元数据表、版本历史、审批记录、自动目录等。
关键特性
- 智能触发：53个关键词自动路由39类规范，支持CLI强制覆盖
- 企业信息工作流：四级回退机制（CLI参数→本地缓存→Odoo→交互补录）确保页眉公司信息完整
- 中文排版优化：v7.8修复字体subface索引错位（宋体特黑→常规、黑体繁体→简体），对齐Word 1.5倍行距与首行缩进
- Markdown全支持：GFM标准+扩展分页符+元数据行，22份可改写范本
显著优点
- 格式保真度领先：v7.8平台感知后端优先级，macOS/Windows+Word环境下实现100%版式保真
- 规范覆盖全面：从合同到技术文档、从公关稿件到HR文书，单工具覆盖企业90%文档场景
- 无依赖轻量化：核心仅依赖python-docx与reportlab，无需完整Office套件即可生成PDF
- 工程化设计：版本历史、审批流、密级管理内置，符合中大型企业合规要求
潜在缺点与局限性
- 字体依赖平台：macOS/Linux/Windows字体回退策略复杂，跨平台一致性需额外验证
- 复杂表格局限：reportlab原生表格渲染能力弱于Word，复杂版式PDF建议走Word→PDF路径
- 模板继承未实现：当前无reference docx模板机制，企业VI定制需修改源码
- 公式/修订追踪缺失：LaTeX公式、修订模式、AES加密等功能在路线图中但未实施
适合人群
- 中大型企业行政/法务/HR：需批量生成标准化合同、制度、报告
- 产品经理与技术团队：PRD、API文档、部署手册的技术文档输出
- 咨询公司与乙方交付：方案、投标书、验收单的快速格式化交付
- 追求本地化的数据敏感型企业：全本地运行，无云端上传
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 字体嵌入异常 | 跨平台字体缺失导致PDF fallback | 预置Noto CJK，部署前字体校验 |
| 法律条款效力 | 生成合同需法务审核，非即用 | 明确标注"范本"性质，强制审批流 |
| 版本兼容 | 旧版Word/WPS可能解析OOXML异常 | 推荐Office 2016+，WPS开启兼容模式 |
| 公司信息泄露 | LOGO/地址等敏感信息本地存储 | `~/.huo15`目录权限控制，可选`--no-odoo` |
版本状态
当前v7.8.1（2024-hotfix），核心维护者为青岛火一五信息科技有限公司。