核心用法
kai-report-creator 是一款专业的报告生成技能,通过 /report 命令将原始笔记、数据或计划文件渲染为精美的单文件HTML报告。支持 --plan(先生成结构大纲)、--generate(渲染HTML)、--review(自动优化)、--themes(预览主题)等多种模式。
显著优点
- 零依赖部署:单HTML文件包含所有CSS/JS,CDN或完全内联两种模式可选,无需npm或构建工具
- 丰富组件生态:内置KPI卡片、ECharts图表(条形/折线/饼图/雷达/漏斗/Sankey)、表格、时间线、流程图/时序图/树图/思维导图、代码块、提示框等
- AI原生设计:三层机器可读结构(摘要JSON→章节标注→原始数据),便于下游AI代理解析
- 智能内容分类:自动检测数据密度,将报告归类为 narrative/mixed/data 三类,分别应用最优视觉节奏
- 主题自适应:6款内置主题(corporate-blue/minimal/dark-tech/dark-board/data-story/newspaper),支持自定义品牌覆盖
- 移动端优先:完整响应式布局,所有功能在移动端可用
- 防幻觉机制:强制使用占位符
[INSERT VALUE],禁止捏造数据
潜在缺点与局限性
- 需要用户预先准备数据,无法自动抓取或补全缺失信息
- 复杂图表(Sankey、思维导图)依赖ECharts,完全内联模式会显著增加文件体积
--export-image需额外安装 Playwright,非内置功能- 主题自定义需了解CSS变量覆盖机制,对非技术用户有一定门槛
- 不支持直接生成PPTX,需配合
kai-html-export使用
适合人群
- 数据分析师、产品经理、运营人员:快速生成周报/季报/项目复盘
- 咨询顾问、研究员:结构化呈现调研结论与对比分析
- 技术团队:API文档、架构说明、性能报告的技术写作
- 需要异步阅读场景:报告内置AI摘要卡片,方便决策者快速抓取要点
常规风险
- 数据占位符未替换即发布,导致报告出现
[INSERT VALUE]裸露文本 - 错误选择图表类型(如用Sankey展示简单比例),造成读者认知负担
- 主题颜色与品牌规范冲突,需通过
theme_overrides手动校准 - 时间线组件误用于非时序内容(如能力清单),违反语义有效性规则