把多平台视频导出数据汇总成日报

当视频同时发布到抖音、B 站、小红书和视频号时，逐个平台抄播放、点赞和收藏很容易漏项。这个配方给出一个本地脚本：平台后台只负责导出 JSON，脚本负责汇总、排序和生成 Markdown。账号登录、平台接口和发布动作仍由人或平台官方工具完成。

1. 场景价值与交付产物预览

输入每个平台的一份 JSON 导出，输出一份包含总览、平台汇总和重点视频表格的日报。脚本不会上传数据，也不会保存凭据。

2. 前置准备与环境配置

• Node.js 20 或更高版本。
• 每个平台导出的 JSON 文件，字段见下一节。
• 在仓库根目录执行命令；安装耗时未测量。

3. 核心配置文件

创建 douyin.json：

{
  "platform": "douyin",
  "capturedAt": "2026-09-20T12:00:00+08:00",
  "videos": [
    {
      "title": "示例视频",
      "views": 1200,
      "likes": 42,
      "comments": 3,
      "shares": 8,
      "favorites": 17,
      "completionRate": 0.31
    }
  ]
}

字段缺失时，播放、点赞、评论、分享和收藏按 0 汇总，完播率显示为 —。这代表输入缺失，不代表平台真实为零。

4. Prompt 与执行过程

让 AI 生成这类脚本时，可以使用：

请写一个只处理本地 JSON 的 Node.js 脚本。输入包含 platform、capturedAt 和 videos 数组，输出 Markdown，汇总播放、点赞、收藏、评论、分享，并按播放和收藏排序。不要登录、抓取或上传任何平台数据；缺失指标要明确标记。

从 hyai-studio 工作室仓库取得脚本后运行（把路径替换成你的本地目录）：

node /path/to/hyai-studio/scripts/video-analytics-report.mjs douyin.json bilibili.json --out report.md

打开 report.md 检查平台名称、采集时间和重点视频标题。人工只需要确认导出文件来自正确账号和时间范围。

5. 排障与验收要求

• 需要 platform 和 videos[] 字段：检查 JSON 顶层是否包含 platform 和数组形式的 videos。
• Unexpected token：先用 JSON 校验器检查导出文件是否完整，避免把网页 HTML 当成 JSON 保存。
• 验收条件：命令退出码为 0，输出包含“总览”“平台汇总”“重点视频”，且数值与输入样例相符。
• 本地脚本只验证数据转换；没有平台账号、接口权限或真实导出时，不要宣称完成平台自动抓取。

6. 示例源码与产物资源

• 脚本：scripts/video-analytics-report.mjs
• Node.js 文件系统 API 参考：https://nodejs.org/api/fs.html
• 本配方覆盖固定 JSON 结构与本地 Markdown 转换；平台后台导出和完播率字段取决于各平台实际导出格式。