openclaw-voc-skill/docs/voc-skills-course-plan/examples/report-factory-demo

示例：Report Factory Demo

实际调用对象

• 模板目录：voc-report-factory/
• 章节草稿脚本：scripts/tools/chapter-insight-writer.js
• 单平台 mini report 脚本：scripts/tools/platform-mini-report-generator.js
• HTML v2 demo 生成脚本：voc-report-factory/html-v2/gen-report-template.js

输入数据

推荐使用小红书课程样例：

demo/xiaohongshu/normalized/_merged.json
demo/xiaohongshu/normalized/comments-flat.jsonl

Step 1：生成章节草稿

node scripts/tools/chapter-insight-writer.js --input demo/xiaohongshu/normalized --output demo/xiaohongshu/chapter-insights --project xiaohongshu-course-demo --category 冻干益生菌 --version light --min-evidence 3

预期输出：

demo/xiaohongshu/chapter-insights/chapter-insights.md
demo/xiaohongshu/chapter-insights/chapter-insights.json

Step 2：生成单平台 mini report

node scripts/tools/platform-mini-report-generator.js --input demo/xiaohongshu/normalized --output demo/xiaohongshu/platform-mini-report --project xiaohongshu-course-demo --category 冻干益生菌 --platform xiaohongshu --data-nature 课程合成样例 --owner "VOC Skills 课程 demo" --date 2026-04-29

预期输出：

demo/xiaohongshu/platform-mini-report/platform-mini-report.md
demo/xiaohongshu/platform-mini-report/platform-mini-report.json

Step 3：生成 HTML v2

内置 demo：

node voc-report-factory/html-v2/gen-report-template.js --output demo/report-factory/html-v2-demo-report.html

从单平台 mini report 生成 HTML：

node voc-report-factory/html-v2/gen-report-template.js --data demo/xiaohongshu/platform-mini-report/platform-mini-report.json --output demo/xiaohongshu/platform-mini-report/platform-mini-report.html

从章节草稿生成 HTML：

node voc-report-factory/html-v2/gen-report-template.js --data demo/xiaohongshu/chapter-insights/chapter-insights.json --output demo/xiaohongshu/chapter-insights/chapter-insights.html

预期输出：

demo/report-factory/html-v2-demo-report.html
demo/xiaohongshu/platform-mini-report/platform-mini-report.html
demo/xiaohongshu/chapter-insights/chapter-insights.html

常见错误

• 输入目录不对：脚本会优先找 _merged.json，找不到再读 comments-flat.jsonl。
• 输出目录缺失：脚本会自动创建输出目录，但路径应使用项目内相对路径。
• 证据不足：--min-evidence 太高会触发 warning；课堂 demo 建议从 3 开始。
• PowerShell 引号：--owner "VOC Skills 课程 demo" 这类带空格参数要加引号。

课堂讲解点

• 先 Markdown 后 HTML：课堂交付优先生成可编辑 Markdown，再进入 HTML renderer。
• 审计字段：重点看 warnings、unsupportedConclusionCount、hasTraceableEvidence。
• 证据驱动：所有章节结论都要能回到 VOC 原声证据卡。
• 人工编辑：自动生成内容是初稿，交付前要由助教补充业务判断和删改不稳结论。