核心用法
火一五文档技能（v7.8.5）是一套面向企业场景的全栈文档生成系统，提供三条输出路径：Word直出、原生PDF直出、Word→PDF转换。用户通过自然语言触发词（如"写劳动合同""写PRD"）或CLI参数 --doc-format 指定39类文档规范，系统自动匹配版式、元数据表、审批流程等结构化元素。
关键工作流：
1. 规范识别：内置劳动合同/服务合同/技术开发合同等7类合同细分，以及HR、Sales、Tech、Legal等32+业务文体，通过关键词优先级自动命中
2. 公司信息注入：支持CLI显式参数、本地缓存~/.huo15/company-info.json、Odoo系统三级回落，缺省时触发补录流程
3. 渲染引擎：Word端基于python-docx直写OOXML并强制清除样式继承；PDF端基于reportlab原生渲染，v7.8.5修复了LOGO宽度计算导致的页眉错位问题
4. Markdown输入：支持标准GFM+扩展语法（分页符---PAGE---、元数据行自动转表格、代码块语法高亮）
显著优点
- 场景覆盖极全：39类规范涵盖从劳动合同到API文档、从投标书到postmortem的企业全生命周期，每类配备可改写的Markdown范本
- 中文排版专业：v7.7起针对Word/PDF视觉对齐进行数学级调优（leading×1.2系数、首行缩进=字号×2、stringWidth居中），解决中文文档常见的偏右、行距错乱问题
- 工程化程度高：版本历史、审批记录、密级标识、文档编号等元数据支持CLI级开关控制；故障报告/测试报告等涉密文档自动带【内部】banner
- 无外部依赖路径：原生PDF直出不依赖LibreOffice/Microsoft Office，适合CI/CD自动化场景
潜在局限
- 模板继承待完善：当前不支持Pandoc/Quarto式的reference docx模板继承，企业VI定制需直接修改Python渲染逻辑
- 公式支持缺失：LaTeX→OMML数学公式管线仅处于调研阶段，技术方案中的复杂公式需手动插入
- 修订追踪空白：无修订模式/批注功能，合同协同评审需回退到传统Word流程
- 加密水印低优先级：AES加密、水印功能在roadmap中标记为低优先级，金融级合规场景受限
适合人群
- 中小企业运营团队：缺乏专职法务/HR/技术写作的初创公司，需快速产出合规文档
- DevOps/运维工程师：需要批量生成部署文档、runbook、故障报告的技术团队
- 咨询与项目管理：频繁产出方案、立项书、验收单的乙方顾问
- Claude自动化工作流：已通过
company-info.py封装为可脚本化的企业记忆组件
常规风险
- 法律文本合规性：自动生成的合同条款需经执业律师审核，工具本身不提供法律责任担保
- 公司信息泄露：
~/.huo15/company-info.json本地存储明文，共享环境需权限管控 - PDF渲染回归风险：v7.8.0-v7.8.4连续4个版本未定位LOGO错位根因，显示复杂PDF可视化问题诊断依赖PyMuPDF拆流等底层技能
- Odoo依赖耦合：企业信息自动拉取默认开启，内网/离线环境需显式
--no-odoo避免超时