docs: update ranking labels, palette and export removal

This commit is contained in:
kairee committed 2026-11-01 00:37:28 +08:00
1 parent c2ef998720
commit 7674fc2c47
3 files changed
+8 -7

No files matched your search

+4 -5
View File
@@ -509,7 +509,7 @@ P3 实现说明:
- `/api/health` 可匿名;配置 `web.auth_token` 后其他 `/api/*` 要求 Cookie 或 `Authorization: Bearer <token>`;
- 只读接口不需要 CSRF;登录 POST 只建立会话,不修改业务数据;
- API 返回 JSON;前端不复制热度、状态机或收藏夹归属判断;
- CSV 导出由后端根据当前筛选条件生成。
- 不提供导出接口,结果只通过页面浏览。
核心接口:
@@ -525,14 +525,13 @@ P3 实现说明:
| `GET` | `/api/fans` | 粉丝曲线与增量 |
| `GET` | `/api/candidates` | 候选池(只读) |
| `GET` | `/api/system` | 最近任务、下次任务、备份、黑名单 |
| `GET` | `/api/export.csv` | 按当前视频筛选导出 CSV |
### 9.2 页面
| 页面 | 内容 |
|---|---|
| 首页 | 最新动态优先:今日增量、最新入库、最近发布、增长动态、热度速览、容量与采集状态。 |
| 榜单 | 综合热度、七项单项、增长、增速、互动率、UP 聚合、筛选和 CSV。 |
| 榜单 | 综合热度、七项单项、播放增量、播放增速、互动率、UP 聚合和筛选。 |
| 视频详情 | 元数据、七项指标、单指标趋势、快照表、失败标记、同 UP 对比。 |
| UP 页 | UP 的全部视频、聚合趋势、单视频对比和平均互动率。 |
| 粉丝页 | 粉丝总数、日增、7 日净增、累计增长;不叠加视频数据。 |
@@ -545,7 +544,7 @@ P3 实现说明:
- 合成快照写 `src='preview'`,预览库写 `kv preview:seeded=1`;
- `python app.py serve --preview` 校验标记,缺失时拒绝启动;
- 预览配置不包含真实凭据,默认端口 8081,Telegram 关闭;
- 预览页面显示固定“预览数据 · 只读”横幅;
- 预览页面显示固定“预览数据 · 不影响真实数据库”横幅,右上角入口显示“预览”;
- 重新生成预览库前必须停止预览服务,避免 Windows 文件占用。
---
@@ -695,7 +694,7 @@ uv run python tests/test_moves.py
- UP 榜默认平均播放,总播放/视频数排到末尾;单视频 UP 不显示单视频对比图;
- 实现 `tools/seed_preview_db.py`:复制真实库并回填 7 天合成快照,支持 `--profile live|first-day`;
- 实现 `tools/import_fans_history.py`:从小满虫之家 `data.js` 回填 90 天粉丝历史,支持 dry-run、缺口停止和幂等写入;
- `serve --preview` 校验 `preview:seeded=1` 标记,预览页面显示只读横幅;
- `serve --preview` 校验 `preview:seeded=1` 标记,预览页面显示“预览数据”横幅;
- 自动化测试见 `tests/test_analytics.py`、`test_preview_seed.py`、`test_web_queries.py`、`test_web_server.py`。
### P4:可选部署
+1 -1
View File
@@ -167,7 +167,7 @@ uv run python app.py serve --preview --config data/preview/config.json
```
- 首页默认“最新动态”:今日增量、最新入库、最近发布、增长动态、热度速览、收藏夹容量与采集状态;
- 榜单支持综合热度、七项单项、互动率、增长/增速,以及 UP 聚合榜;UP 榜默认按**平均播放**排序,总播放和视频数放在排序项末尾;服务端筛选、排序、分页和 CSV 导出;
- 榜单支持综合热度、七项单项、互动率、播放增量/播放增速,以及 UP 聚合榜;UP 榜默认按**平均播放**排序,总播放和视频数放在排序项末尾;服务端筛选、排序和分页;
- 视频详情提供七项指标、单指标趋势、快照表和同 UP 对比;UP 页提供聚合趋势与单视频对比;
- 粉丝页只绘制粉丝曲线,不叠加视频数据;
- 候选池和系统状态只读展示,操作入口指向 Telegram/CLI;
+3 -1
View File
@@ -624,6 +624,8 @@ w = {view:0.30, like:0.20, coin:0.20, favorite:0.15,
### 8.2 增长榜
> 看板 UI 中“增长”标注为**播放增量**(区间内绝对增量),“增速”标注为**播放增速**(增量 / 基线播放)。两者基线都取不早于 `最新快照 - N 天` 的最近一条成功快照。
```
d7 = (view_today - view_{today-7}) / 实际间隔天数
r7 = (view_today - view_{today-7}) / max(view_{today-7}, 1)
@@ -668,7 +670,7 @@ fan_delta_cum = follower(d) - follower(首日)
| 页面 | 内容 |
|---|---|
| 首页 | 最新动态优先:今日增量、最新入库、最近发布、增长动态、热度速览、收藏夹容量、采集状态 |
| 榜单 | Tab:综合热度/播放/点赞/投币/收藏/转发/评论/弹幕/互动率/增长/增速;视频与 UP 范围切换;筛选、搜索、导出 CSV |
| 榜单 | Tab:综合热度/播放/点赞/投币/收藏/转发/评论/弹幕/互动率/播放增量/播放增速;视频与 UP 范围切换;筛选与搜索 |
| 视频详情 | 元数据 + 七项指标 + 单指标趋势(7/30/90/全部)+ 同 UP 对比 + 快照表(含失败标记) |
| UP 页 | 该 UP 全部视频、聚合趋势、单视频对比、平均互动率 |
| **粉丝页** | 咻咻满粉丝数曲线 + 每日/7 日净增 + 累计增长(只画粉丝,不叠加视频数据) |