核心用法
火一五文档技能是企业级文档自动化生成工具,覆盖企业全场景39类文档规范,核心能力包括:
1. 三路径输出:Word直出(create-word-doc.py)、原生PDF直出(create-pdf-doc.py)、Word→PDF转换(word-to-pdf.py),推荐默认路径经v7.8.x字体预处理后视觉一致性达⭐⭐⭐⭐⭐
2. 39类智能规范:合同细分7类(劳动/服务/技术开发/销售/采购/保密NDA/合作)+ HR/Sales/PR/PM/Ops/Tech/Legal/Reporting各类文体,自动识别触发词,CLI可强制覆盖
3. 文档壳精细控制:每类规范独立配置【内部】banner、元数据表、版本史、审批记录、TOC,通过--with-xxx/--no-xxx参数开关
4. 企业信息工作流:支持Odoo自动拉取、本地缓存~/.huo15/company-info.json、CLI显式参数三级回退,缺失时结构化JSON触发Claude补录
显著优点
- 中文排版保真度高:v7.8.x修复字体subface索引错位(宋体特黑→Regular、黑体繁体→简体简体)、LibreOffice字体fallback预处理、leading系数1.2×对齐Word 1.5倍行距
- 规范覆盖全面:从劳动合同到postmortem故障报告,ToB场景全栈覆盖,templates/提供22份可直接改写的markdown范本
- 工程化成熟:Block AST解析、NumberedCanvas真总页数、Pygments代码高亮、CJK段落OOXML直写避免WPS样式继承
潜在局限
- 依赖本地字体:macOS需Songti.ttc/STHeiti.ttc,Linux需Noto CJK,Windows依赖SimSun/SimHei;无字体时渲染降级
- LibreOffice路径仍有微差:虽v7.8.2预处理大幅改善,但行距/列表缩进算法与Word原生仍非100%一致,需装Word+docx2pdf才能完全保真
- 公式/复杂表格待完善:LaTeX→OMML、交叉引用、修订追踪等列在未来路线,当前未实现
适合人群
- 企业法务/HR/运营:高频合同、制度、SOP、证明类文档批量生成
- 产品经理/项目经理:PRD、技术方案、项目计划书、结项报告标准化输出
- 市场/公关:新闻稿、BP、演讲稿、白皮书快速出稿
- 技术团队:API文档、部署文档、runbook、测试/故障报告自动化
常规风险
- 内容合规风险:39类文档含大量法律/财务/人事敏感模板,生成内容需人工审核,不能替代专业法律意见
- 企业信息泄露:Odoo集成、本地缓存公司信息,多租户环境需权限隔离
- 版本混淆:v7.8.x hotfix密集(字体/leading/页眉),需及时更新避免已知渲染问题
- CLI注入:
--content @/path支持文件读取,需确保路径可控,避免路径遍历