Kai Report Creator V1.23.3 Publish

核心用法

kai-report-creator 是一款面向报告生成的专业工具技能，处理从结构化计划到最终HTML渲染的完整工作流。用户可通过 /report 命令配合多种 flags 调用：

• `--plan "topic"`：先生成 .report.md 中间表示（IR）文件，建立报告结构后再渲染，适合复杂报告
• `--generate [file]`：将 IR 文件或上下文中的 IR 内容渲染为自包含 HTML；无文件参数时自动提取上下文中的有效 IR 块
• `--review [file]`：基于检查清单对已有 HTML 报告进行自动优化
• `--themes`：生成主题预览文件
• `--from <file>`：智能识别输入类型（IR 或原始内容），自动选择处理路径
• `--theme/--template/--output`：分别用于覆盖主题、使用自定义模板、指定输出路径
• `--bundle`：将 CDN 资源内联，实现完全离线可用
• `--export-image [mode]`：生成 PNG 截图（支持即时通讯、移动端、桌面端三种模式）

默认输出文件名为 report-<YYYY-MM-DD>-<slug>.html，slug 经标准化处理（小写、ASCII、30字符限制）。

显著优点

1. 零依赖部署：生成的 HTML 文件自包含，无需外部服务器或运行时依赖，CDN 资源可选内联
2. 数据与表现分离：强制使用 IR（中间表示）作为桥梁，用户负责数据真实性，AI 负责结构设计，杜绝虚构数据
3. 严格的契约验证：从 IR 语法检查、HTML 质量门控到 L2 Shell 检查的多层验证体系，确保输出可靠性
4. 渐进式披露设计：保留 report-summary、章节标注和组件数据的机器可读性，兼顾人工阅读与自动化处理
5. 丰富的主题生态：内置 8 种主题（corporate-blue、minimal、dark-tech 等），支持自定义模板扩展
6. 中英双语同等支持：自动检测 CJK 内容并适配占位符、目录标签、日期显示等元素
7. 全链路质量保障：12 步生成流程包含预写入验证、HTML 质量门控、L2 Shell 检查、静默审阅四道关卡

潜在缺点与局限性

• 非 PPT/PNG 导出工具：明确不负责将成品 HTML 转换为演示文稿或图片序列，需配合 kai-html-export 或 kai-slide-creator 使用
• 图表依赖 ECharts：所有图表必须基于 ECharts，不支持其他可视化库
• Playwright 可选依赖：图片导出功能需要 Playwright，未安装时仅打印指引而不阻断主流程
• 主题定制门槛：自定义主题需遵循 CSS 变量契约，需阅读 references/theme-css.md 等参考文档
• IR 学习成本：复杂报告需理解中间表示（IR）的 YAML frontmatter、Markdown 正文、组件围栏三段式结构

适合人群

• 需要定期产出数据看板、商业报告、研究文档的分析师与产品经理
• 追求报告可移植性、需离线交付或嵌入内网的政企用户
• 希望建立标准化报告模板、实现人机协作工作流的团队
• 中英文双语工作环境下的国际化业务团队

常规风险

| 风险类别 | 说明 |

|---------|------|

| 数据真实性 | AI 绝不虚构数据，缺失值明确标注 `[数据待填写]`，需人工补全 |

| 版本兼容性 | 依赖 `data-version` 等元数据锚点，跨版本模板混用可能导致样式异常 |

| 导出功能依赖 | `--export-image` 需 Playwright 环境，生产环境部署前需验证 |

| 自定义模板维护 | 非官方主题/模板不受长期兼容性承诺保护 |

| 自动审阅边界 | `--review` 的 AI 建议规则仅在置信度高且事实准确性可保障时应用，关键内容仍需人工复核 |

架构特色

采用"薄路由 + 引用分离"设计：SKILL.md 仅保留命令路由与核心原则，详细规则分散在 15+ 个引用文件中，按需加载避免提示膨胀。同时通过 shell 模板、IR 契约、渲染规则三层抽象，实现主题、内容、交互的解耦。

核心用法

Kai Report Creator 采用「规划-生成-审阅」三段式工作流，用户通过 /report 命令调用，支持 --plan、--generate、--review、--themes 等核心子命令。规划阶段将用户输入转换为 .report.md 中间表示（IR），明确报告结构、KPI 指标与组件布局；生成阶段将 IR 渲染为自包含 HTML，内置 ECharts 图表、主题样式与导出功能；审阅阶段自动执行质量门控检查。支持从原始笔记、数据、URL 或已批准的规划文件生成，提供 8 种内置主题与自定义模板能力。

显著优点

零依赖架构是最大亮点——生成的 HTML 文件完全自包含，无需 Node.js、Python 运行时或任何第三方包即可在浏览器中打开。配合 --bundle 模式可将 CDN 资源内联，实现完全离线可用。数据安全方面，纯本地执行、无网络外发，天然适合处理敏感商业数据与内部 KPI。AI 结构化能力突出，通过 IR 合约约束 AI 输出，避免幻觉数据，强制使用 [数据待填写] 标记缺失值。工程成熟度高，具备完整测试覆盖（46 个测试文件）、版本历史（v1.0.0 至 v1.23.2）与自动化质量门控。

潜在缺点与局限性

生态隔离明显——输出格式仅限 HTML，如需 PPTX 需配合 kai-html-export 技能，幻灯片需切换至 kai-slide-creator，增加多工具协同成本。可视化深度有限，图表依赖 ECharts，复杂交互式仪表板或实时数据接入能力较弱。中文排版虽支持，但 8 种内置主题以西式企业风格为主，深度本地化视觉需自定义 CSS。图片导出依赖可选 Playwright，离线环境中若未安装则功能降级。此外，IR 学习曲线存在，新用户需理解中间表示概念才能高效规划复杂报告。

适合的目标群体

企业数据分析师与产品经理是核心用户，尤其适合需要定期生成内部数据看板、季度复盘报告、竞品对比文档的团队。离线环境工作者如金融、医疗、政府等受监管行业，对数据外发敏感的场景。技术写作者与研究人员可利用其结构化输出能力，将零散笔记快速转换为可交付的 HTML 文档。不适合需要实时协作编辑、复杂权限管理或原生 PPT 输出的重度办公场景。

使用风险

性能风险极低，纯静态 HTML 生成无服务端压力；供应链风险为零，无第三方依赖。主要风险在于数据验证——AI 可能生成看似合理但实际错误的 KPI 数值，用户必须严格遵循「AI 提供结构，用户填入数据」原则，避免直接采信 AI 推算的数字。浏览器兼容性方面，ECharts 与 CSS Grid 在现代浏览器支持良好，IE11 等旧版环境可能渲染异常。长期维护需关注，当前为个人开发者维护（T3 来源），若作者停止更新，自定义主题与模板可能面临迁移成本。