docs: document path routing and in-place filter updates

This commit is contained in:
kairee committed 2026-11-01 01:55:37 +08:00
1 parent 52a8d90c47
commit 4bb3d3bef5
2 files changed
+3

No files matched your search

+1
View File
@@ -170,6 +170,7 @@ uv run python app.py serve --preview --config data/preview/config.json
- 榜单支持综合热度、七项单项、互动率、播放增量/播放增速,以及 UP 聚合榜;UP 榜默认按**平均播放**排序,总播放和视频数放在排序项末尾;服务端筛选、排序和分页;
- 视频详情提供七项指标、单指标趋势、快照表和同 UP 对比;UP 页提供聚合趋势与单视频对比;
- 粉丝页只绘制粉丝曲线,不叠加视频数据;
- 前端使用 History API 的干净路径路由(`/rank`、`/video/{aid}`、`/up/{mid}`),不使用 `#/` hash;服务端对未知非静态路径回退 `index.html`;
- 候选池和系统状态只读展示,操作入口指向 Telegram/CLI;
- 本地回环地址默认免登录;配置 `web.auth_token` 后启用登录页和 HttpOnly Cookie;非回环地址且未配置 token 时拒绝启动;
- 所有业务接口只接受 GET,写方法返回 `405`。
+2
View File
@@ -680,6 +680,8 @@ fan_delta_cum = follower(d) - follower(首日)
### 9.2 技术
- 单 `index.html` + 原生 ES Module,无构建链;
- History API 路径路由(`/rank`、`/video/{aid}`、`/up/{mid}`),服务端对无扩展名的非静态路径回退 `index.html`;
- 排序、筛选和趋势指标切换用 `replaceState` 更新 URL 并重新取数,保留滚动位置,不整页刷新;
- 图表本地 vendored ECharts(Apache-2.0,离线);
- `/api/*` JSON,前端只渲染;
- 移动端优先,底部 5 项导航;桌面端左侧导航;