核心用法
kai-report-creator 是面向报告生成场景的专业工具，核心命令为 /report [flags] [content]。支持两种工作流：
1. 规划优先流（--plan）：先输出 .report.md 中间表示文件（IR），确认结构后再渲染
2. 直接生成流（无flag或--generate）：从上下文或文件直接输出完整HTML报告
关键flag包括：--plan（仅生成IR结构）、--generate（渲染HTML）、--review（自动优化现有报告）、--from（从文件智能识别）、--theme（覆盖主题）、--bundle（内联CDN资源）、--export-image（导出PNG/打印版）。
IR格式包含YAML frontmatter、Markdown正文和组件围栏（如 :::kpi、:::chart），支持7种内置主题（corporate-blue、dark-tech、data-story等）和完整自定义。
显著优点
- 零依赖自包含：生成的HTML单文件即可运行，仅按需引入CDN资源
- 数据忠实性：绝不虚构数据，缺失值明确标记为
[数据待填写] - 渐进式披露：保留机器可读的报告摘要、章节注解和组件数据
- 主题智能匹配：根据关键词自动推荐主题（周报→regular-lumen、销售→corporate-blue等）
- 完整性保障：内置guard验证、降级策略（如无效chart自动转为table）、多层校验流程
- 导出能力：支持打印、桌面PNG、移动端PNG、IM分享图等多种输出格式
潜在缺点与局限性
- 非所见即所得编辑：IR中间格式对非技术用户存在学习成本
- 图表依赖ECharts：复杂可视化需求受限于ECharts能力边界
- 图片导出需Playwright：环境未配置时会跳过该步骤，需手动安装
- 幻灯片场景不适用：明确排除PPTX生成（需用kai-slide-creator）和HTML转PPTX（需用kai-html-export）
- AI不替代数据：用户必须提供原始数据，工具仅提供结构
适合人群
- 产品经理/运营：快速产出周报、月报、项目进展报告
- 商业分析师：构建KPI仪表盘、销售数据看板
- 研究人员：生成调研报告、白皮书结构化文档
- 技术团队：输出系统架构文档、API文档、性能报告
常规风险
- 数据泄露风险：
--bundle内联模式会将所有资源嵌入HTML，敏感数据需脱敏处理 - 版本漂移：IR文件与生成HTML可能存在版本不一致，建议通过
ir-hash校验 - 降级静默执行：自动降级可能损失预期可视化效果，需人工复核review输出
- 主题覆盖冲突：
theme_overrides使用不当可能破坏响应式布局