Merge branch 'feat/home-candidate-notice'

DEVELOPMENT.md

@@ -539,7 +539,7 @@ P3 实现说明：
 
 | 页面 | 内容 |
 |---|---|
-| 首页 | 最新动态优先：标题下显示「收录视频 N」；顶部四个数据卡片为「今日入库→视频榜按入库排序 / 播放增量→视频榜按 1 日增长排序 / 7 日粉丝变化→粉丝页 / 数据日期」；下方为最近发布、增长动态、热度速览三个区块，统一使用竖排媒体卡（封面 + 两行截断标题 + 作者/数据行 + 高亮数据行）与响应式网格：移动端每行 2 个、PC 每行 3 个，每处各取前 6 条；采集/候选等运行期信息只在登录后的「系统」「候选」页可见。 |
+| 首页 | 最新动态优先：标题下显示「收录视频 N」；顶部四个数据卡片为「今日入库→视频榜按入库排序 / 播放增量→视频榜按 1 日增长排序 / 7 日粉丝变化→粉丝页 / 数据日期」；下方为最近发布、增长动态、热度速览三个区块，统一使用竖排媒体卡（封面 + 两行截断标题 + 作者/数据行 + 高亮数据行）与响应式网格：移动端每行 2 个、PC 每行 3 个，每处各取前 6 条；采集状态等运行期信息只在登录后的「系统」页可见；有候选且已登录时，首页显示「N 条候选待确认」提示条（访客不显示）。 |
 | 视频（`/videos`） | 内容效率（默认）、综合热度、发布时间、入库时间、播放/投币/收藏/评论、互动率、播放增量、播放增速；工具条为「排序」下拉 + 时间下拉 + 右侧放大镜搜索框（一行展示），时间支持全部/7 天/30 天/90 天/1 年/年份。 |
 | UP主（`/ups`） | 独立入口，不再与视频混排；卡片显示 UP 头像、视频数与总时长、最新粉丝数，以及当前排序的主/副指标（「总播放」排序时副指标为「平均播放」）；排序下拉含内容效率、互动效率、内容量、总播放、视频数、平均播放、总互动、最近发布；不提供按视频数筛选。 |
 | 数据说明（`/about`） | 数据来源与更新、发布时间/入库时间/快照日期、指标公式、时长与成熟窗口筛选、粉丝快照覆盖与已知局限；数值由 `/api/about` 动态读取。 |

README.md

@@ -166,7 +166,7 @@ uv run python tools/seed_preview_db.py --days 7
 uv run python app.py serve --preview --config data/preview/config.json
 ```
 
-- 首页默认“最新动态”：标题下显示「收录视频 N」，顶部四个数据卡片为「今日入库 / 播放增量 / 7 日粉丝变化 / 数据日期」（前三项可点击跳转）；下方为最近发布、增长动态、热度速览三个区块，统一使用竖排卡片（封面 + 两行截断标题 + 作者/数据行 + 高亮数据行），并统一为响应式网格（移动端每行 2 个、PC 每行 3 个），每处各取前 6 条；采集/候选等运行期信息只在登录后的「系统」「候选」页可见；
+- 首页默认“最新动态”：标题下显示「收录视频 N」，顶部四个数据卡片为「今日入库 / 播放增量 / 7 日粉丝变化 / 数据日期」（前三项可点击跳转）；下方为最近发布、增长动态、热度速览三个区块，统一使用竖排卡片（封面 + 两行截断标题 + 作者/数据行 + 高亮数据行），并统一为响应式网格（移动端每行 2 个、PC 每行 3 个），每处各取前 6 条；采集状态等运行期信息只在登录后的「系统」页可见；有候选且已登录时，首页显示「N 条候选待确认」提示条（访客不显示）；
 - 「视频」与「UP主」是两个独立入口；工具条顺序为「排序」下拉 → 时间下拉（无需 label）→ 右侧自适应搜索框（最大 320px，放大镜按钮在输入框内），三者在 PC 与移动端都保持一行；
 - 视频排序：内容效率（默认）、综合热度、发布时间、入库时间、播放/投币/收藏/评论、互动率、播放增量/播放增速；UP 排序：内容效率、互动效率、内容量、总播放、视频数、平均播放、总互动、最近发布；
 - UP 卡片显示 UP 头像（无头像时显示首字母占位）、视频数/总时长与最新粉丝数；「总播放」排序时副指标显示「平均播放」（相当于平均播放榜，主副指标对调）；UP 详情页也显示头像；

reaction_board/web/static/app.js

@@ -1,6 +1,7 @@
 import { session, visit } from "./api.js";
 import { disposeAll } from "./charts.js";
 import { onRoute, parseLocation, startRouter } from "./router.js";
+import { canAccessProtected, setSession } from "./session.js";
 import { renderCandidates } from "./views/candidates.js";
 import { renderFans } from "./views/fans.js";
 import { renderHome } from "./views/home.js";
@@ -51,12 +52,6 @@ function renderLegacyRank(root, context) {
     : renderVideos(root, context);
 }
 
-let authState = { authEnabled: false, authenticated: true };
-
-function canAccessProtected() {
-  return !authState.authEnabled || authState.authenticated;
-}
-
 function requireAuth() {
   if (canAccessProtected()) return true;
   const { path, query } = parseLocation();
@@ -152,10 +147,7 @@ async function boot() {
   const banner = document.querySelector("#preview-banner");
   try {
     const data = await session();
-    authState = {
+    setSession(data);
-      authEnabled: Boolean(data?.auth_enabled),
-      authenticated: data?.authenticated !== false,
-    };
     if (data?.preview) {
       banner.hidden = false;
     }

reaction_board/web/static/session.js

@@ -0,0 +1,26 @@
+// 登录态与预览态的进程内共享状态。
+// app.js 在 boot 时写入，各视图（如 home.js）读取，避免重复请求 /api/session。
+
+let state = { authEnabled: false, authenticated: true, preview: false };
+
+export function setSession(data) {
+  state = {
+    authEnabled: Boolean(data?.auth_enabled),
+    authenticated: data?.authenticated !== false,
+    preview: Boolean(data?.preview),
+  };
+  return state;
+}
+
+export function getSession() {
+  return state;
+}
+
+// 可访问「候选 / 系统」等受保护页面：未启用鉴权，或已登录。
+export function canAccessProtected() {
+  return !state.authEnabled || state.authenticated;
+}
+
+export function isPreview() {
+  return state.preview;
+}

reaction_board/web/static/views/home.js

@@ -4,6 +4,7 @@ import {
   escapeAttr, escapeHtml, formatCount, formatDate, formatDelta,
   formatDuration, formatPercent, formatScore,
 } from "../format.js";
+import { canAccessProtected } from "../session.js";
 
 function statChip(label, value, { href = null, tone = "" } = {}) {
   const inner = `<span>${escapeHtml(label)}</span><strong>${value}</strong>`;
@@ -55,6 +56,9 @@ export async function renderHome(root) {
     ? formatCount(overview.initial_import_count)
     : formatCount(overview.added_today);
   const activeCount = overview.counts?.active || 0;
+  const pending = overview.counts?.candidates_pending || 0;
+  // 候选提示仅对已登录（或未启用鉴权）用户可见，访客不展示运行期信息。
+  const showCandidates = pending > 0 && canAccessProtected();
 
   root.innerHTML = `<section class="page home-page">
     <header class="page-head home-head">
@@ -78,6 +82,11 @@ export async function renderHome(root) {
       ${statChip("数据日期", escapeHtml(overview.data_date || "—"))}
     </div>
 
+    ${showCandidates ? `<a class="notice-row" href="/candidates">
+      <strong>${formatCount(pending)} 条候选待确认</strong>
+      <span>请在 Telegram 中处理 →</span>
+    </a>` : ""}
+
     <section class="panel">
       <div class="section-head">
         <h2>最近发布</h2>