diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md index d703155..c7ee884 100644 --- a/DEVELOPMENT.md +++ b/DEVELOPMENT.md @@ -509,7 +509,7 @@ P3 实现说明: - `/api/health` 可匿名;配置 `web.auth_token` 后其他 `/api/*` 要求 Cookie 或 `Authorization: Bearer `; - 只读接口不需要 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:可选部署 diff --git a/README.md b/README.md index 3c12a46..72ff753 100644 --- a/README.md +++ b/README.md @@ -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; diff --git a/project.md b/project.md index 027fd29..2175b06 100644 --- a/project.md +++ b/project.md @@ -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 日净增 + 累计增长(只画粉丝,不叠加视频数据) |