头条数据复盘 · 完读率分析
对「今日头条」已发布作品做数据复盘，以完读率为核心，结合点击率、互动、涨粉、粉丝占比，输出横向对比与可执行的优化建议。
> 与 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）
| CTR 优/良（≥8%） | CTR 中/差（<8%） | |
|---|---|---|
| 完读 优/良（≥25%） | 标杆，固化模板 | 内容好但不点→优化标题封面 |
| 完读 中/差（<25%） | 标题吸睛留不住人→强开头/小标题/图文 | 双弱→重选题或对标高完读同类 |
与自动化的衔接（可选）
周期复盘可固化为自动化：每日/每周把头条号后台截图放入指定目录，触发本 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— 样本数据（自测 / 字段示范）
