核心用法
kai-report-creator 是一个专门用于创建专业级HTML报告的AI技能，通过 /report 命令驱动，支持 --plan（规划结构）、--generate（生成HTML）、--review（自动优化）、--themes（预览主题）等多种模式。用户只需提供原始数据、笔记或主题，AI 自动完成从中间表示（IR）到最终HTML的完整渲染流程。
核心工作流采用「先规划后生成」的两段式设计：--plan 生成 .report.md 中间文件，用户可审查修改；--generate 将其渲染为独立HTML文件。报告内置7种主题（corporate-blue、minimal、dark-tech等），自动根据内容类型（商务/技术/研究/新闻）智能匹配，支持ECharts图表、KPI卡片、时间线、流程图等丰富组件。
关键创新在于「渐进式AI可读结构」——HTML内嵌三层机器可读数据（summary JSON → section标注 → component原始数据），使下游AI代理能高效解析报告内容，而非仅处理渲染后的视觉表面。
显著优点
1. 零依赖部署：单文件HTML，所有CSS/JS内联或CDN加载，无需npm/build工具，可嵌入邮件、IM、内网系统
2. 智能内容适配：自动检测中英文，根据数字密度（<5%叙事型/5-20%混合型/>20%数据型）路由组件策略，避免「空KPI占位」等反模式
3. 严格的硬规则保障：KPI值≤8中文字符、时间线必须含真实日期、禁止U+FE0F变体选择器等8项不可违背的质量红线
4. 双重验证机制：Python guard脚本预检IR有效性，pre-write验证扫描HTML结构，自动降级无效组件（如KPI→callout）
5. 周期报告专项优化：regular-lumen主题专为周报/月报/日报设计，自动计算日期范围，支持Poster-style暖色调布局
6. 完整导出生态：内置打印优化、桌面/移动端PNG导出、IM分享卡片生成（需Playwright）
潜在缺点与局限
- ECharts单一依赖：所有图表强制使用ECharts，熟悉Chart.js的用户需适应新API
- 无实时协作：生成静态HTML文件，不支持多人在线编辑（需配合版本控制）
- 图片导出额外依赖：
--export-image需手动安装Playwright及Chromium，非开箱即用 - 复杂排版受限：基于组件化布局，极度自由的版式设计需通过自定义模板实现
- 主题覆盖盲：7种内置主题虽经精心调校，极端品牌需求仍需自定义CSS
适合人群
- 商务分析师：快速产出季度/月度业绩报告、KPI仪表盘
- 产品经理：用户调研报告、竞品分析、项目进展汇报
- 技术团队：架构文档、性能分析报告、API文档
- 咨询顾问：客户交付物、研究白皮书、战略建议书
- 运营人员：周期性数据复盘（周报/月报）、活动效果总结
常规风险
- 数据真实性：系统强制使用
[INSERT VALUE]占位符，禁止AI编造数字，但用户填写的数据需自行校验 - 模板覆盖风险：自定义
--template可能破坏响应式或导出功能，建议基于官方模板修改 - 浏览器兼容性：虽基于主流CSS特性，极端旧版浏览器（IE11等）未作兼容
- 敏感数据泄露：单文件HTML便于传播，也意味着敏感报告需配合访问控制（密码保护/内网部署）
- 主题色彩冲突：
theme_overrides覆盖主色时，需确保对比度符合WCAG标准（系统不做自动检测）