القائمة
录入和分析发布后的数据。当需要记录文章表现、对比历史数据、分析趋势时使用。支持阅读、点赞、收藏、分享等指标的追踪和分析。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| 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 查询