Menu
录入和分析发布后的数据。当需要记录文章表现、对比历史数据、分析趋势时使用。支持阅读、点赞、收藏、分享等指标的追踪和分析。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | zzhub-analytics |
| description | 录入和分析发布后的数据。当需要记录文章表现、对比历史数据、分析趋势时使用。支持阅读、点赞、收藏、分享等指标的追踪和分析。 |
zzhub-pipeline 数据分析系统的编排层。通过 analytics 命令组录入和分析发布后的数据。
开始前先确认 workspace 路径。按优先级尝试：
ZZHUB_PIPELINE_WORKSPACE_ROOTzzhub-pipeline config --key paths.workspaceRoot 读取配置中的默认值后续示例中用 {workspace} 表示 workspace 路径。
全局命令：zzhub-pipeline（或简写 zzp），安装后即可在任何目录执行。
所有分析数据存储在 {workspace}/zzhub.db（SQLite 数据库）的 analytics 表中。
数据结构：
{
"run_id": "run_001",
"topic_id": "topic_001",
"title": "文章标题",
"publish_date": "2026-06-11",
"reads": 1500,
"likes": 45,
"favorites": 23,
"shares": 12,
"comments": 8,
"notes": "表现良好",
"recorded_at": "2026-06-15T10:00:00Z"
}
发布完成后录入数据：
zzp analytics record \
--state {workspace}/posts/{date-slug}/workflow-state.json \
--reads 1500 \
--likes 45 \
--favorites 23 \
--shares 12 \
--comments 8 \
--notes "标题效果好，转化率高"
参数说明：
--state (必填): 任务状态文件路径--reads: 阅读量--likes: 点赞数--favorites: 收藏数--shares: 分享数--comments: 评论数--notes: 备注，记录关键观察或特殊原因数据来源：
录入时机：
幂等性：同一 run_id 可以多次录入，数据会更新而不是重复。
查看发布数据的列表：
# 查看所有数据
zzp analytics list --workspace {workspace}
# 查看最近 30 天
zzp analytics list --workspace {workspace} --days 30
# 按阅读量排序
zzp analytics list --workspace {workspace} --sort reads
# 按点赞排序
zzp analytics list --workspace {workspace} --sort likes
# 限制数量
zzp analytics list --workspace {workspace} --limit 20
# 组合使用
zzp analytics list --workspace {workspace} --days 7 --sort reads --limit 10
排序字段：
publish_date (默认): 按发布日期reads: 按阅读量likes: 按点赞数常用场景：
zzp analytics list --days 7 查看本周发布zzp analytics list --days 30 查看本月发布zzp analytics list --sort reads --limit 10 查看 Top 10对比多篇文章的数据表现：
# 未来支持
zzp analytics compare \
--run-ids "run1,run2,run3" \
--metrics reads,likes
分析数据趋势：
# 未来支持
zzp analytics trend \
--workspace {workspace} \
--period 90d \
--group-by week
# 1. 发布后 24 小时录入初步数据
zzp analytics record \
--state ./posts/2026-06-11-article/workflow-state.json \
--reads 500 \
--likes 15 \
--notes "24 小时数据"
# 2. 发布后 7 天更新数据
zzp analytics record \
--state ./posts/2026-06-11-article/workflow-state.json \
--reads 1500 \
--likes 45 \
--favorites 23 \
--shares 12 \
--notes "7 天数据，表现良好"
# 3. 发布后 30 天最终数据
zzp analytics record \
--state ./posts/2026-06-11-article/workflow-state.json \
--reads 2200 \
--likes 68 \
--favorites 35 \
--shares 18 \
--comments 8 \
--notes "最终数据"
# 1. 查看本周发布
zzp analytics list --workspace ./ws --days 7
# 2. 查看本周表现最好的
zzp analytics list --workspace ./ws --days 7 --sort reads --limit 5
# 3. 导出数据（未来支持）
zzp analytics export --days 7 --format csv --output weekly-report.csv
# 1. 查看本月所有发布
zzp analytics list --workspace ./ws --days 30
# 2. 查看本月 Top 10
zzp analytics list --workspace ./ws --days 30 --sort reads --limit 10
# 3. 分析表现好的文章特点
# 查看 Top 10 的标题、标签、发布时间等
影响因素：
基准值（仅供参考）：
影响因素：
基准值：
影响因素：
基准值：
影响因素：
基准值：
影响因素：
基准值：
CLI 命令失败时：
ls {workspace}/zzhub.db计划中的功能：
analytics compare: 对比多篇文章的数据analytics trend: 趋势分析和可视化analytics export: 导出数据为 CSV/JSONanalytics query: 自定义 SQL 查询