功能定位
kai-report-creator 是一款用于生成专业级HTML报告的AI技能，核心理念是「用户给数据，AI给结构」。它通过中间表示格式（.report.md）将原始内容转化为单文件HTML报告，零构建依赖、全平台兼容、支持移动端响应式渲染。
核心用法
双阶段工作流：--plan 先生成结构化大纲（.report.md），--generate 再渲染为HTML。支持从原始笔记、数据、URL或已审核的计划文件直接生成。高级模式包括 --review（自动优化）、--themes（预览7种主题）、--bundle（CDN资源内联）、--export-image（导出图片）。
智能内容分类：根据数字密度自动判定 narrative（<5%数字，文字为主）、mixed（5-20%，图文混合）、data（>20%，数据驱动），并路由至相应的视觉锚点策略。
显著优点
1. 零依赖部署：单HTML文件含内联CSS/JS或CDN引用，无需npm、构建工具或服务器环境
2. AI可读结构：嵌入三层机器可读数据（summary JSON → section annotations → component raw data），便于下游AI代理解析
3. 主题自适应：7种内置主题（corporate-blue/minimal/dark-tech等），根据关键词自动推荐，支持自定义覆盖
4. 严格质量控制：硬性规则禁止KPI值过长、时间线伪日期、通用标题等反模式，内置预写验证与静默终审
5. 周期报告优化：针对周报/月报/日报的特殊内容提取规则，自动计算日期范围
潜在局限
- 非实时协作：生成静态HTML，不支持多人在线编辑
- 图表库单一：仅支持ECharts，复杂自定义图表需手动扩展
- 图片导出依赖：
--export-image需Playwright环境，非纯前端方案 - 中文场景优先：主题命名、占位符文本、日期格式对中文支持更完善
适合人群
- 需要快速产出数据可视化报告的分析师、产品经理
- 追求「一次生成、随处打开」的咨询顾问、研究团队
- 希望报告能被AI后续读取处理的自动化工作流搭建者
- 周期性汇报场景（周报/月报/季度复盘）的职场用户
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据幻觉 | 严禁编造数字，但占位符可能被误读为真实值 | 使用显式占位符 `[INSERT VALUE]` 并标注待填写 |
| 视觉过载 | 组件过多导致阅读疲劳 | 遵循「3个以上纯文字段落必插视觉锚点」规则 |
| 主题冲突 | 自定义theme_overrides可能破坏响应式 | 仅覆盖CSS变量，不修改结构类名 |
| 导出失败 | Playwright未安装时图片导出中断 | 优雅降级，输出安装指引但不报错 |