核心功能
火一五文档技能是一套面向企业全场景的智能文档生成系统，由青岛火一五信息科技有限公司开发。该系统支持三条生成路径：Word直出（python-docx）、原生PDF直出（reportlab）、Word→PDF转换，满足从快速草稿到正式交付的不同需求。
文档规范体系（39类）
系统内置39类专业文档规范，核心包括：
- 合同7类细分：劳动合同、服务合同、技术开发合同、销售合同、采购合同、保密协议（NDA）、战略合作协议，每类配备独立Markdown范本与条款结构
- 技术/产品类：需求文档/PRD、技术方案、API文档、部署文档/runbook、测试报告、故障报告/postmortem
- 项目管理类：立项书、项目计划书、项目结项报告、验收单、SOP、风险评估、应急预案
- 商务/HR类：商业计划书/BP、招投标书、报价单、演讲稿、简历/CV、任命书、在职证明
- 内容/传播类：新闻稿、研究报告、白皮书、复盘报告、用户手册、培训手册、备忘录/MOU
每类规范独立配置文档壳元素：【内部】密级横幅、元数据表、版本历史、审批记录、自动目录，可通过CLI精细开关。
关键特性
| 特性 | 说明 |
|------|------|
| 智能规范识别 | 80+触发词自动匹配文档类型，支持`--doc-format`强制覆盖 |
| 中文排版优化 | v7.9起非合同文档默认仿宋正文，契合GB公文规范；PDF直出修复CJK行距、首行缩进对齐 |
| 模板化工作流 | `templates/`目录提供22份可直接拷贝改写的Markdown范本 |
| 企业信息整合 | 本地缓存+Odoo自动拉取，缺失时触发补录流程 |
| 代码高亮支持 | 可选Pygments依赖实现技术文档代码块语法高亮 |
| 分页与结构控制 | `---PAGE---`强制分页、多级章节编号自动识别（第X章/一、/1.1/（一）等） |
技术架构亮点
- PDF渲染深度优化：v7.8.5修复重大视觉bug（LOGO宽度错算导致页眉元素跑出版面），采用PyMuPDF逆向分析PDF stream定位根因
- 跨平台字体适配：macOS（STFangsong/Songti.ttc subface）、Windows（SimSun/SimHei）、Linux（Noto CJK）自动映射
- 多后端转换链：Word→PDF支持LibreOffice→docx2pdf→Word COM优先级自动回落
局限性与注意事项
1. 公式支持待完善：LaTeX→OMML数学公式管线已调研但未实施，当前技术文档建议以代码或文字描述替代复杂公式
2. 修订追踪缺失：文档审阅批注、修订模式需后续迭代
3. 字体依赖：PDF直出依赖系统自带中文字体，极端环境下可能出现fallback问题
4. 模板继承：reference docx模板继承（Pandoc/Quarto风格）在路线图中，当前以程序化生成优先
适合人群
- 创业公司/中小企业：缺乏专职文档团队，需快速产出标准化合同、BP、技术方案
- 产品经理/项目经理：PRD、立项书、验收单等高频文档的自动化生成
- HR/法务/运营：劳动合同、NDA、公司制度、SOP的规范输出
- 技术团队：API文档、部署手册、runbook、故障报告的技术写作
安全风险与合规
- 数据本地化：企业信息存储于
~/.huo15/company-info.json，不上传云端 - 文档密级控制：内置【内部】/【机密】等密级横幅，支持审批记录表
- 输出格式安全：原生PDF不依赖外部Office进程，减少宏病毒攻击面
- 开源依赖：核心依赖python-docx、reportlab均为成熟MIT/Apache许可库