核心用法
火一五文档技能（v7.8.6）是面向企业场景的专业文档生成系统，提供三条技术路径：Word直出（python-docx）、原生PDF直出（reportlab）、Word→PDF转换。用户通过自然语言触发词（如"写合同""写方案"）或CLI参数--doc-format指定39种预设规范，系统自动匹配对应的文档结构、版式元素（页眉/页脚/密级标识/审批表等）和Markdown范本。
关键交互流程：
1. 触发识别：用户输入含关键词（如"劳动合同""PRD""风险评估"），系统通过优先级匹配确定文档子类
2. 信息补全：自动拉取本地缓存~/.huo15/company-info.json或Odoo系统公司信息，缺失时触发交互式补录
3. 内容渲染：支持标准Markdown语法，含分页符、元数据表格、代码高亮等扩展；PDF路径采用两遍渲染确保页码准确
4. 输出交付：根据场景选择单一格式或双格式并行
显著优点
- 规范覆盖全面：39类文档涵盖HR/Sales/Legal/Tech/Ops全部门场景，合同细分为7个子类（劳动/服务/技术开发/销售/采购/NDA/合作），避免"一刀切"条款风险
- 版式专业合规：内置【内部】密级横幅、元数据表、版本历史、审批记录等企业级文档壳元素，可按规范自动启用或CLI强制开关
- 双格式一致性：原生PDF不依赖LibreOffice/Office，通过
stringWidth()居中、leading×1.2行距系数等数学对齐实现与Word视觉统一 - 本地化工程成熟：v7.8.x系列持续修复字体子集（macOS Songti.ttc subface）、LOGO缩放计算、emoji字符等CJK/国际化细节
- 模板可扩展：
templates/目录提供22份可直接改写的Markdown范本，降低非技术用户上手门槛
潜在缺点与局限性
- 依赖本地字体生态：PDF渲染依赖系统预装中文字体（macOS Songti.ttc/STHeiti.ttc、Linux Noto CJK），异常环境可能出现字体回退偏差
- 复杂版式受限：不支持修订追踪、批注、水印加密、Jinja2模板槽等高级功能（见"未来路线"章节）；LaTeX公式、交叉引用处于调研未实施状态
- PDF直出性能：reportlab逐元素渲染大文档时速度显著慢于Typst（未来路线提及30×速度差距）
- Odoo耦合风险：企业信息自动拉取默认开启Odoo连接，内网隔离环境需显式
--no-odoo避免超时 - 版本迭代激进：v7.8.0~v7.8.5连续五版均围绕"页眉LOGO错位"同一问题，显示复杂PDF布局的调试难度
适合人群
- 中小企业行政/法务/HR：需批量生成标准化合同、制度、证明类文档，无专业排版人员
- 项目经理/产品经理：快速输出PRD、技术方案、验收报告、复盘文档，满足客户/审计交付要求
- 技术运维团队：生成API文档、部署手册、runbook、故障postmortem，支持代码块语法高亮
- Claude/AI工作流集成者：通过结构化JSON错误码触发补录流程，实现自动化文档流水线
常规风险
| 风险类别 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 法律合规风险 | 自动生成的合同条款未经本地化法务审核，直接签署存在效力争议 | 仅作草案使用，启用前强制人工复核；NDA/劳动合同等敏感子类建议叠加专业法务模板 |
| 信息泄露风险 | 文档元数据（作者、公司名、Odoo连接信息）可能嵌入输出文件 | 对外分发前使用`--no-doc-meta-table`剥离元数据表；敏感文档启用【内部】密级标识 |
| 渲染一致性风险 | 不同Word版本（WPS/Microsoft/LibreOffice）对OOXML`<w:jc>`解析存在差异 | 交付前在目标阅读环境验证；关键文档优先使用PDF直出路径 |
| 版本锁定风险 | 高频hotfix版本（v7.8.x）可能引入回归缺陷 | 生产环境固定minor版本（如v7.8.6），升级前用历史文档样本做diff验证 |