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