核心用法
kai-report-creator 是一款零依赖的HTML报告生成工具，专用于从原始笔记、数据文件或结构化计划快速创建自包含的商业报告、研究文档和KPI仪表盘。
显著优点
1. 真正的零依赖输出：生成的HTML文件完全自包含，仅需浏览器即可打开，无需Node.js、Python或任何运行时环境
2. 双阶段工作流：支持 --plan 先生成中间表示文件（.report.md），再 --generate 渲染为HTML，确保复杂报告的结构可控
3. 内置质量门禁系统：12步严格验证流程，包括预写入检查、HTML质量门禁、L2外壳检查及静默终审，大幅降低输出缺陷
4. 企业级主题体系：8种内置主题（corporate-blue、dark-tech、data-story等），支持自定义模板与ECharts图表集成
5. 渐进式信息披露：保留机器可读的 report-summary 和组件数据，便于后续自动化处理
6. 多模态导出：原生支持HTML预览、打印优化及PNG截图导出（通过Playwright）
潜在缺点与局限性
- 非所见即所得：需先理解IR（中间表示）语法和组件围栏（
:::tag），对纯文档用户有学习成本 - 图表依赖ECharts：复杂自定义可视化需熟悉ECharts配置，不如BI工具拖拽灵活
- 静态输出限制：生成的HTML为静态文件，不支持服务端动态数据刷新
- 导出功能依赖外部工具：PNG导出需Playwright，未内置时仅提供安装指引而非自动降级
适合人群
- 商业分析师：需快速将Excel/CSV数据转换为可分享的高管摘要
- 产品经理：定期输出项目进展、竞品对比报告
- 研究人员：生成符合学术规范的文献综述与方法论文档
- 数据工程师：构建自动化报告流水线，将原始日志转为可视化看板
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据真实性 | AI绝不编造数字，缺失数据标记为`[数据待填写]` | 人工复核所有KPI数值 |
| 主题渲染异常 | 自定义CSS可能破坏响应式布局 | 使用`--themes`预览后再应用 |
| 导出依赖缺失 | Playwright未安装时PNG导出失败 | 提前执行安装或仅使用HTML输出 |
| IR语法错误 | 错误的`:::tag`围栏导致渲染中断 | 利用`--plan`阶段验证结构 |
版本与生态
当前版本v1.23.1，与 kai-html-export（PPTX/PNG导出）和 kai-slide-creator（幻灯片）形成互补工具链。