头条数据复盘 · 完读率分析

对「今日头条」已发布作品做数据复盘，以完读率为核心，结合点击率、互动、涨粉、粉丝占比，输出横向对比与可执行的优化建议。

与 toutiao-search（爆款检索）互补：search 看「别人什么火」，analytics 看「自己什么行」。

触发场景

| 场景 | 用户示例 | |------|----------| | 周期复盘 | 「帮我复盘这周头条的数据」「分析一下这个月头条的完读率」 | | 单篇诊断 | 「这篇头条完读率为什么这么低」「看看昨天那篇头条表现」 | | 优化决策 | 「头条哪些内容留不住人」「下期头条标题怎么改」 | | 截图分析 | 用户直接发来头条号后台数据面板截图 |

数据流（核心流程）

头条号/西瓜后台截图
   │  (1) 用 Read 工具识图提取
   ▼
标准 JSON（每篇作品指标，字段见下）
   │  (2) 写入临时文件
   ▼
scripts/analyze.py  ──►  深色 HTML 报告 + CSV + 终端结论

Step 1 · 提取指标（识图）

用 Read 工具直接读取用户提供的截图（可多张，单篇详情或作品列表均可）。按 references/metrics.md 的字段 schema，逐篇提取为如下 JSON。完读率/粉丝占比若截图显示百分比（如 32%），写 32 或 0.32 均可，脚本自动归一。

{
  "account": "杨振工程小杨哥",
  "period": "2026-08-03 ~ 2026-08-09",
  "source": "头条号后台数据面板截图",
  "works": [
    {
      "title": "光伏运维系统怎么选？3 个坑别再踩",
      "published_at": "2026-08-08",
      "impressions": 12000,
      "reads": 2400,
      "finish_rate": 0.42,
      "avg_duration_sec": 68,
      "likes": 180,
      "comments": 52,
      "favorites": 96,
      "shares": 24,
      "new_fans": 18,
      "fan_read_ratio": 0.55
    }
  ]
}

若用户给的是 CSV/Excel 或粘贴文本，先规整为同一 JSON 结构再继续；无需重新识图。字段缺省可留空，但 reads 与 finish_rate 尽量齐全（核心指标）。

Step 2 · 运行分析

将 JSON 写入临时文件（如 /tmp/toutiao_works.json），执行：

PY="C:/Users/10428/.workbuddy/binaries/python/versions/3.13.12/python.exe"
"$PY" "$SKILL_PATH/scripts/analyze.py" --input /tmp/toutiao_works.json

默认输出到 ~/Downloads/ToutiaoAnalytics/（HTML + CSV）。
--no-html / --no-csv 可关闭对应产出；--input - 支持从标准输入读 JSON。
样本数据见 references/sample_works.json，可用于自测。

Step 3 · 呈现结论

终端已打印「总览 + 标杆 + 短板 + 行动清单」。
用 present_files 打开生成的 HTML 报告给用户看（完读率排行、阅读量×完读率散点、互动构成、单篇诊断、总体结论，均为内联 SVG，无需联网）。
结论撰写严格遵循 references/metrics.md 第五节模板；归因改法参考第四节（工程/新能源自媒视角）。

关键指标与分级（速查）

| 指标 | 优 | 良 | 中 | 差 | |------|----|----|----|----| | 完读率（核心） | ≥35% | 25–35% | 15–25% | <15% | | 点击率 CTR | ≥15% | 8–15% | 3–8% | <3% | | 粉丝阅读占比 | ≥50% 强私域 | 20–50% 健康 | <20% 偏公域 | — |

阈值均为图文经验基准，scripts/analyze.py 顶部常量区可改；不同账号阶段应回调。

诊断矩阵（完读率 × CTR）

与自动化的衔接（可选）

周期复盘可固化为自动化：每日/每周把头条号后台截图放入指定目录，触发本 skill 跑分析并推送结论。创建方式：用 automation_update（mode=create），prompt 写「读取 <目录> 下头条后台截图，按 toutiao-analytics 技能做复盘并输出结论」，scheduleType 用 recurring + rrule （如 FREQ=WEEKLY;BYDAY=MO 每周一复盘上周）。

资源

scripts/analyze.py — 分析引擎（JSON→HTML+CSV+结论）
references/metrics.md — 指标 schema、分级基准、归因手册、结论模板
references/sample_works.json — 样本数据（自测 / 字段示范）