用途:在承诺创建 .docx、.pdf、.xlsx、申请书登记表、评分矩阵、预算、仪表板、价格表、简历包、报告或附件之前,确认本机是否具备生成与校验这些文档/表格的能力;也用于将引擎迁移到新机器时核实工具链是否安装。若用户只需要 Markdown 或概念大纲且不声称生成文件,则无需使用。
必要输入:目标输出格式、本地工具访问权限、插件/连接器可用性,以及所需模板。
工作流:先检查插件/连接器,再检查 Python 包,最后检查二进制程序;在生产导出前运行单文件冒烟测试;选定路线并如实说明回退方案;在文件生成并打开或验证之前,绝不声称文件已存在。
需检查的 Python 包包括 openpyxl、XlsxWriter、pandas、python-docx、docxtpl、docxcompose、pypandoc、markdown、beautifulsoup4、lxml、pillow、PyMuPDF、pypdf、pdfplumber、reportlab;二进制程序包括 pandoc、soffice/LibreOffice、按需的 wkhtmltopdf,以及用于 OCR 任务的 tesseract。
质量要求:文件产出声明属于事实性声明;回退方案须显式说明而非静默替换;承诺 PDF 前必须已知 PDF 转换路线。反模式包括:仅有 Markdown 却声称已生成 Word、PDF 或 Excel;未核查就假定存在 LibreOffice、Pandoc 或插件;工作簿未重新打开或未做公式/控制检查即交付。
输出:工具链检查结果、冒烟测试结果、路线决策、回退计划与验证说明。参考资料包括 references/toolchain-checks.md(命令与包/二进制检查清单)和 references/fallback-routes.md(输出路线与回退决策树)。