docs: update readme for video/up split and follower backfill

This commit is contained in:
kairee committed 2026-11-01 11:37:40 +08:00
1 parent cb9e8e031b
commit b017af7593
1 file changed
+13 -6
+13 -6
View File
@@ -21,7 +21,7 @@
| 粉丝追踪 | 可用(P1) | 每日记录咻咻满等配置 UP 的粉丝数。 | | 粉丝追踪 | 可用(P1) | 每日记录咻咻满等配置 UP 的粉丝数。 |
| 搜索发现与候选池 | 可用(P3) | 每小时搜索前 2 页,分类打分后写入候选池。 | | 搜索发现与候选池 | 可用(P3) | 每小时搜索前 2 页,分类打分后写入候选池。 |
| Telegram 通知与一键加入 | 可用(P3) | 收藏 / 忽略 / 拉黑按钮,`deal` + `sort` 回读校验。 | | Telegram 通知与一键加入 | 可用(P3) | 收藏 / 忽略 / 拉黑按钮,`deal` + `sort` 回读校验。 |
| 本地数据看板 | 可用(P2) | 只读总览、榜单、视频/UP 详情、粉丝曲线、候选池和系统状态。 | | 本地数据看板 | 可用(P2/P9) | 只读总览、视频榜、UP 主榜、内容效率、视频/UP 详情、粉丝曲线、数据说明、候选池和系统状态。 |
## 核心工作流 ## 核心工作流
@@ -99,6 +99,10 @@ uv run python app.py snapshot
# 忽略当日完成标记,重新采集 # 忽略当日完成标记,重新采集
uv run python app.py snapshot --force uv run python app.py snapshot --force
# 回填历史视频的 UP 粉丝数快照(第 9 轮,只补空值)
uv run python app.py backfill-followers
uv run python app.py backfill-followers --dry-run
# 分别为只读和写入账号扫码授权(默认 read) # 分别为只读和写入账号扫码授权(默认 read)
uv run python app.py auth uv run python app.py auth
uv run python app.py auth --account write uv run python app.py auth --account write
@@ -167,12 +171,14 @@ uv run python app.py serve --preview --config data/preview/config.json
``` ```
- 首页默认“最新动态”:今日增量、最新入库、最近发布、增长动态、热度速览、收藏夹容量与采集状态; - 首页默认“最新动态”:今日增量、最新入库、最近发布、增长动态、热度速览、收藏夹容量与采集状态;
- 榜单支持综合热度、七项单项、互动率、播放增量/播放增速,以及 UP 聚合榜;UP 榜默认按**平均播放**排序,总播放和视频数放在排序项末尾;服务端筛选、排序和分页; - 「视频」与「UP主」是两个独立入口:视频榜支持内容效率(默认)、综合热度、播放/投币/收藏/评论、互动率、播放增量/播放增速;UP 榜展示视频数、总时长、总播放、播放·小时、互动·小时等,可分别排序;
- 视频详情提供七项指标、单指标趋势、快照表和同 UP 对比;UP 页提供聚合趋势与单视频对比; - 内容效率 = 播放 / 内容小时,只统计时长 ≥ 600 秒且发布满 14 天的视频;UP 内容效率用经验贝叶斯收缩,避免极小样本冲榜;
- 「数据说明」(`/about`)说明数据来源、发布时间/入库时间/快照日期、指标公式、筛选口径与已知局限,数值由 `/api/about` 动态读取;
- 视频详情提供分 P 数、七项指标、内容/互动效率、入库时粉丝数、单指标趋势、快照表和同 UP 对比;UP 页提供聚合趋势、单视频对比与入库时/当前粉丝数;
- 粉丝页只绘制粉丝曲线,不叠加视频数据;支持 7/30/90/全部与自选日期,范围超过一年时按每月峰值日期聚合;最近记录默认 14 天并显示较上一成功日的增量; - 粉丝页只绘制粉丝曲线,不叠加视频数据;支持 7/30/90/全部与自选日期,范围超过一年时按每月峰值日期聚合;最近记录默认 14 天并显示较上一成功日的增量;
- 前端使用 History API 的干净路径路由(`/rank`、`/video/{aid}`、`/up/{mid}`),不使用 `#/` hash;服务端对未知非静态路径回退 `index.html`; - 前端使用 History API 的干净路径路由(`/videos`、`/ups`、`/video/{aid}`、`/up/{mid}`、`/about`),不使用 `#/` hash;旧 `/rank` 链接仍可用;
- 候选池和系统状态只读展示,操作入口指向 Telegram/CLI; - 候选池和系统状态只读展示,操作入口指向 Telegram/CLI;
- 首页、榜单、视频/UP、粉丝等页面和接口访客可见; - 首页、视频榜、UP 主榜、视频/UP 详情、粉丝页和数据说明页对访客可见;
- 配置 `web.auth_token` 后,“候选”和“系统”页面及其接口需要登录,启用登录页和 HttpOnly Cookie;访客的底部导航只显示公开页面; - 配置 `web.auth_token` 后,“候选”和“系统”页面及其接口需要登录,启用登录页和 HttpOnly Cookie;访客的底部导航只显示公开页面;
- 本地回环地址且未配置 token 时视为无鉴权,全部页面可见;非回环地址且未配置 token 时拒绝启动; - 本地回环地址且未配置 token 时视为无鉴权,全部页面可见;非回环地址且未配置 token 时拒绝启动;
- 所有业务接口只接受 GET,写方法返回 `405`; - 所有业务接口只接受 GET,写方法返回 `405`;
@@ -187,7 +193,8 @@ uv run python app.py serve --preview --config data/preview/config.json
- 默认包含少量缺失日、3 条失败快照、4 条预览候选和 1 条预览黑名单; - 默认包含少量缺失日、3 条失败快照、4 条预览候选和 1 条预览黑名单;
- `--profile first-day` 可生成保持“首次导入”状态的冷启动库; - `--profile first-day` 可生成保持“首次导入”状态的冷启动库;
- 预览配置不包含真实 Cookie,端口 8081,Telegram 关闭; - 预览配置不包含真实 Cookie,端口 8081,Telegram 关闭;
- 重新生成前必须先停止预览服务,否则 Windows 会因数据库被占用而拒绝覆盖。 - 重新生成前必须先停止预览服务,否则 Windows 会因数据库被占用而拒绝覆盖;
- 第 9 轮起本地不再保留 `data/app.db` 真实副本,重新生成请加 `--source data/backup/<真实库备份>`;预览库会自动升级到当前 schema(含 `up_profile` / `pages`)。
### 粉丝历史回填(CSV) ### 粉丝历史回填(CSV)