发布数据归因分析

读取 publish-log.json，从时间、标签、类型、增长四个维度分析内容表现，输出结构化归因报告。

数据层定位

本 SKILL 是归因链的消费层，只读底座、不新建存储、不回写：

数据	权威底座	维护方	本 SKILL 用途
发布事件	outputs/_analytics/publish-log.json	skill-publish-log	模式 A/B/C
粉丝 / 时序快照	outputs/_analytics/snapshots/{profile}/{platform}/{date}.json	skill-data-tracker	模式 D 增长归因

粉丝时序的权威来源是 skill-data-tracker 的快照底座。 模式 D 读取的 outputs/_analytics/follower-log.json 由 track.py export-followers 确定性导出，不应手工维护。字段映射见 references/follower-log-schema.md。

输入

用户指定分析模式（可组合）：

• 模式 A — 最佳发布时间：分析发布时段与互动数据的关系
• 模式 B — 标签效果分析：评估标签对内容表现的影响
• 模式 C — 内容类型对比：按内容类型对比各项指标
• 模式 D — 增长归因：关联发布事件与粉丝增长

未指定模式时默认执行 A + B + C。模式 D 前先运行 python3 skills/builtin/skill-data-tracker/scripts/track.py export-followers。

数据源

publish-log.json 结构

{
  "version": "1.0",
  "entries": [{
    "id": "唯一标识",
    "platform": "xiaohongshu|douyin|bilibili|weibo",
    "title": "标题",
    "url": "发布链接",
    "type": "图文|视频|直播|文章",
    "published_at": "ISO 8601 时间戳",
    "logged_at": "记录时间",
    "initial_metrics": {
      "views": null | number,
      "likes": null | number,
      "comments": null | number,
      "shares": null | number
    },
    "skill_source": "生成该内容的 SKILL",
    "profile": "账号画像名",
    "tags": ["标签列表"],
    "notes": "备注"
  }]
}

数据处理规则

• null 指标：排除出该指标的平均值计算，报告覆盖率百分比
• 样本量警告：单桶 < 5 条时标注 ⚠ 样本不足；全量 < 10 条时在报告头部警告结果可能不具统计意义
• 时区：有 Profile 时使用 Profile 中的时区，无 Profile 时默认 Asia/Shanghai

执行步骤

四种分析模式的全部计算（时段分桶、标签聚合、类型对比、增长归因、样本量警告、 覆盖率）由 scripts/analyze.py 确定性完成。不要用内联 Python 心算，直接调脚本。 LLM 只负责选模式、按 Profile 过滤、解读 JSON、写关键发现/方法论/局限性。

1. 检查 Profile 上下文（=== EASEL ACCOUNT PROFILE === 标记），有则取 profile 名。
2. 调用脚本（--profile 须放在子命令前；publish-log.json 不存在时脚本友好报错）：

python3 skills/builtin/skill-publish-analytics/scripts/analyze.py all
python3 skills/builtin/skill-publish-analytics/scripts/analyze.py --profile 画像名 time
python3 skills/builtin/skill-publish-analytics/scripts/analyze.py --profile 画像名 tags
python3 skills/builtin/skill-publish-analytics/scripts/analyze.py --profile 画像名 types
python3 skills/builtin/skill-publish-analytics/scripts/analyze.py --profile 画像名 growth

3. 脚本输出结构化 JSON：summary（总数/日期范围/平台/各指标覆盖率/全量样本警告）+ 各模式结果。每个分析桶含 count 和 warning（单桶 <5 条标注样本不足）。
4. 解读输出：按下方各模式说明和「输出格式」把 JSON 转成 Markdown 表格 → 关键发现（3 条）→ 方法论 → 局限性。局限性须含"关联性不等于因果性"。

模式 A — 最佳发布时间

步骤：

1. 解析 published_at 提取小时和星期几
2. 将时段分为 6 个桶：早晨(6-9) / 上午(9-12) / 午间(12-14) / 下午(14-18) / 晚间(18-22) / 深夜(22-6)
3. 交叉 initial_metrics 计算每个桶的平均互动量（views、likes、comments、shares）
4. 按平台分别统计

输出：

• 热力图表格（星期 × 时段），单元格为平均互动综合分
• 推荐 Top 3 发布时段（含具体星期和时间段）
• 各平台分别的最佳时段

互动综合分计算： engagement_score = views × 0.1 + likes × 1.0 + comments × 2.0 + shares × 3.0

模式 B — 标签效果分析

步骤：

1. 提取每条记录的 tags[]，统计各标签使用频次
2. 对每个标签计算其关联条目的平均 views、likes、comments、shares
3. 构建标签共现矩阵：标签 A 与标签 B 同时出现的次数
4. 识别高效标签（平均互动高于全局均值）和低效标签

输出：

• 标签效果排名表：标签 / 使用次数 / 平均浏览 / 平均点赞 / 平均评论 / 平均转发
• Top 5 与 Bottom 5 标签对比
• 标签共现矩阵（仅展示共现 >= 2 次的组合）

模式 C — 内容类型对比

步骤：

1. 按 type 字段分组（图文 / 视频 / 直播 / 文章）
2. 计算每类的发布数量、平均 views、likes、comments、shares
3. 交叉平台与类型生成二维表

输出：

• 类型对比表：类型 / 数量 / 平均浏览 / 平均点赞 / 平均评论 / 平均转发
• 每个指标标注 "winner"（最高值类型）
• 平台 × 类型 交叉表

模式 D — 增长归因

前置条件： outputs/_analytics/follower-log.json（从 skill-data-tracker 快照底座导出的派生视图，schema 与字段映射见 references/follower-log-schema.md）

步骤：

1. 读取 follower-log.json，若不存在则输出提示并跳过本模式
2. 将每条发布事件与发布后 24h / 48h / 7d 的粉丝变化关联
3. 计算每条发布的粉丝增量（发布后快照 - 发布前最近快照）
4. 按粉丝影响力排名

输出：

• 发布事件粉丝影响排名表：标题 / 平台 / 发布时间 / 24h增量 / 48h增量 / 7d增量
• 高增长条目的共性分析（类型、标签、时段）
• 若 follower-log.json 不存在，输出：

  "模式 D 需要粉丝数据。请在 outputs/_analytics/follower-log.json 中记录粉丝快照数据，schema 见 skill-publish-analytics/references/follower-log-schema.md"

输出格式

每个模式的输出均包含以下部分：

## 数据摘要
- 总条目数 / 日期范围 / 涉及平台
- 各指标覆盖率（非 null 比例）

## 分析结果
（模式对应的表格和图表）

## 关键发现
1. （最重要的可执行洞察）
2. （第二重要）
3. （第三重要）

## 方法论
- 互动综合分计算公式
- 聚合方式（均值 / 中位数）
- 时段划分标准

## 局限性
- 样本量说明
- null 数据覆盖率
- "关联性不等于因果性 — 时段/标签分析反映相关关系，不能直接推导因果"

Profile 感知

• 有 Profile：
  • 按 profile 字段过滤，只分析当前账号的数据
  • 使用 Profile 中的 platform 和 timezone 字段
  • 输出标注 "当前分析范围：{profile_name} @ {platform}"
• 无 Profile：
  • 分析全部条目，按平台分组展示
  • 报告附注："提供 Profile 可按账号过滤数据并使用平台特定时区"

规则

1. 不捏造数据 — 所有数字必须来自 publish-log.json，不得推测或补全
2. 报告样本量 — 每个分析桶必须标注条目数
3. 关联非因果 — 时段和标签分析中必须注明"关联性不等于因果性"
4. 样本不足警告 — 全量 < 10 条时在报告头部加粗警告
5. 计算透明 — 展示每个指标的计算公式和聚合方式

自研备注

参考产品：Metricool analytics、Iconosquare insights、SocialBee performance reports、Later analytics。 本 SKILL 侧重中文社媒平台（小红书、抖音、B站、微博）的发布节奏与互动规律分析。