feat(growth): same-day 1-day baselines for new videos

Let 1-day view growth use a zero baseline for videos published today, and the first successful sample for older videos ingested today, without mixing those into 7/30-day rankings.

reaction_board/analytics.py

@@ -313,15 +313,20 @@ def compute_growth(
     current: int | float | None,
     previous: int | float | None,
     gap_days: int | float | None,
+    *,
+    allow_zero_gap: bool = False,
 ) -> Growth:
     """计算累计差值、日均差值和相对增速。
 
-    缺失基线或间隔不足 1 天时返回不可用，不把 0 当作真实增长。
+    缺失基线或间隔为负时返回不可用。默认间隔不足 1 天也不可用，不把 0 当成真实增长。
+    ``allow_zero_gap=True`` 时允许同一天的两次采样（或相对 0）计算增量，``per_day`` 为 None。
     """
     if current is None or previous is None or gap_days is None:
         return Growth(available=False)
     gap = int(gap_days)
-    if gap <= 0:
+    if gap < 0:
+        return Growth(available=False)
+    if gap == 0 and not allow_zero_gap:
         return Growth(available=False)
     current_value = max(0, int(current))
     previous_value = max(0, int(previous))
@@ -329,7 +334,7 @@ def compute_growth(
     return Growth(
         available=True,
         delta=delta,
-        per_day=delta / gap,
+        per_day=None if gap == 0 else delta / gap,
         rate=delta / max(previous_value, 1),
         gap_days=gap,
     )

reaction_board/migrations.py

@@ -244,6 +244,18 @@ MIGRATIONS: tuple[Migration, ...] = (
             "CREATE INDEX idx_visit_date ON visit(stat_date)",
         ),
     ),
+    Migration(
+        version=8,
+        name="snapshot open view",
+        statements=(
+            # 同日第一次成功采样的播放量，供近 1 日「入库后增量」做基准。
+            # 已有成功行无法找回被覆盖的入库值，只能把当前 view 当作开盘。
+            'ALTER TABLE snapshot ADD COLUMN view_open INTEGER',
+            "ALTER TABLE snapshot ADD COLUMN open_captured_at INTEGER",
+            'UPDATE snapshot SET view_open = "view", open_captured_at = captured_at '
+            "WHERE ok = 1 AND view_open IS NULL",
+        ),
+    ),
 )
 
 

reaction_board/repository.py

@@ -690,12 +690,17 @@ class Repository:
         src: str = "view",
     ) -> None:
         values = metrics or {}
+        ok_flag = 1 if ok else 0
+        view_value = values.get("view")
+        open_view = view_value if ok else None
+        open_at = int(captured_at) if ok else None
         def run(conn: sqlite3.Connection) -> None:
             conn.execute(
                 """
                 INSERT INTO snapshot(stat_date, aid, "view", "like", favorite, coin,
-                                     share, reply, danmaku, captured_at, ok, err, src)
-                VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+                                     share, reply, danmaku, captured_at, ok, err, src,
+                                     view_open, open_captured_at)
+                VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
                 ON CONFLICT(stat_date, aid) DO UPDATE SET
                   "view" = excluded."view",
                   "like" = excluded."like",
@@ -707,12 +712,22 @@ class Repository:
                   captured_at = excluded.captured_at,
                   ok = excluded.ok,
                   err = excluded.err,
-                  src = excluded.src
+                  src = excluded.src,
+                  view_open = CASE
+                    WHEN excluded.ok = 1 AND snapshot.view_open IS NULL
+                    THEN excluded."view"
+                    ELSE snapshot.view_open
+                  END,
+                  open_captured_at = CASE
+                    WHEN excluded.ok = 1 AND snapshot.open_captured_at IS NULL
+                    THEN excluded.captured_at
+                    ELSE snapshot.open_captured_at
+                  END
                 """,
                 (
                     stat_date,
                     int(aid),
-                    values.get("view"),
+                    view_value,
                     values.get("like"),
                     values.get("favorite"),
                     values.get("coin"),
@@ -720,9 +735,11 @@ class Repository:
                     values.get("reply"),
                     values.get("danmaku"),
                     int(captured_at),
-                    1 if ok else 0,
+                    ok_flag,
                     err,
                     src,
+                    open_view,
+                    open_at,
                 ),
             )
         self.db.write(run)
@@ -741,18 +758,23 @@ class Repository:
                 """
                 INSERT INTO snapshot(
                   stat_date, aid, "view", "like", favorite, coin,
-                  share, reply, danmaku, captured_at, ok, err, src
+                  share, reply, danmaku, captured_at, ok, err, src,
+                  view_open, open_captured_at
                 )
                 SELECT
                   ?, aid, "view", "like", favorite, coin,
-                  share, reply, danmaku, ?, 1, NULL, ?
+                  share, reply, danmaku, ?, 1, NULL, ?,
+                  "view", ?
                 FROM snapshot
                 WHERE stat_date = ? AND ok = 1
                   AND aid NOT IN (
                     SELECT aid FROM snapshot WHERE stat_date = ?
                   )
                 """,
-                (target_date, int(captured_at), src, source_date, target_date),
+                (
+                    target_date, int(captured_at), src, int(captured_at),
+                    source_date, target_date,
+                ),
             )
             return int(cur.rowcount or 0)
         return self.db.write(run)

reaction_board/services/snapshot.py

@@ -310,7 +310,8 @@ class SnapshotService:
         """刷新近 N 天新视频的当日快照；不碰完成日标记与日备份。
 
         「近 N 天」按 pubdate 墙钟窗口：``now - recent_video_days * 86400``，
-        不是上海日历日差。允许覆盖同日已有 ``ok=1`` 行以便小时级刷新。
+        不是上海日历日差。当天入库但发布更早的旧片不进小时任务。
+        允许覆盖同日已有 ``ok=1`` 行以便小时级刷新。
         """
         cfg = self.config_store.get()
         client = self._client()

reaction_board/web/queries.py

@@ -385,6 +385,18 @@ class DashboardQueries:
         percentiles = score_percentiles(scores)
         return videos, snapshots, scores, percentiles
 
+    @staticmethod
+    def _publish_date(pubdate: object) -> str | None:
+        if pubdate is None or isinstance(pubdate, bool):
+            return None
+        try:
+            ts = int(pubdate)
+        except (TypeError, ValueError):
+            return None
+        if ts <= 0:
+            return None
+        return shanghai_date(ts)
+
     @staticmethod
     def _growth_for(
         snapshot: Mapping[str, Any] | None,
@@ -406,6 +418,68 @@ class DashboardQueries:
                 gap = None
         return compute_growth(current, before, gap)
 
+    @classmethod
+    def _same_day_growth(
+        cls,
+        snapshot: Mapping[str, Any] | None,
+        video: Mapping[str, Any],
+        metric: str = "view",
+    ) -> dict[str, Any] | None:
+        """近 1 日、没有更早快照时：当日发布相对 0；否则用 view_open。"""
+        if snapshot is None:
+            return None
+        current = snapshot.get(metric)
+        if current is None:
+            return None
+        stat_date = str(snapshot.get("stat_date") or "")
+        published_on = cls._publish_date(video.get("pubdate"))
+        if published_on is not None and published_on == stat_date:
+            growth = compute_growth(current, 0, 0, allow_zero_gap=True)
+            payload = growth.as_dict()
+            payload["baseline"] = "zero"
+            return payload
+        try:
+            open_at = snapshot.get("open_captured_at")
+            captured_at = snapshot.get("captured_at")
+            view_open = snapshot.get("view_open")
+            open_ready = (
+                open_at is not None
+                and captured_at is not None
+                and int(open_at) < int(captured_at)
+                and view_open is not None
+            )
+        except (TypeError, ValueError):
+            open_ready = False
+        if not open_ready:
+            return None
+        growth = compute_growth(current, view_open, 0, allow_zero_gap=True)
+        payload = growth.as_dict()
+        payload["baseline"] = "open"
+        return payload
+
+    @classmethod
+    def _growth_result(
+        cls,
+        video: Mapping[str, Any],
+        snapshot: Mapping[str, Any] | None,
+        previous: Mapping[str, Any] | None,
+        *,
+        days_back: int,
+        metric: str = "view",
+    ) -> dict[str, Any]:
+        if previous is not None:
+            growth = cls._growth_for(snapshot, previous, metric=metric)
+            payload = growth.as_dict()
+            payload["baseline"] = "snapshot" if growth.available else None
+            return payload
+        if days_back == 1:
+            fallback = cls._same_day_growth(snapshot, video, metric=metric)
+            if fallback is not None:
+                return fallback
+        payload = compute_growth(None, None, None).as_dict()
+        payload["baseline"] = None
+        return payload
+
     def _item(
         self,
         video: Mapping[str, Any],
@@ -415,6 +489,7 @@ class DashboardQueries:
         percentile: float | None = None,
         previous: Mapping[str, Any] | None = None,
         include_growth: bool = False,
+        growth_days: int | None = None,
     ) -> dict[str, Any]:
         metrics = _metric_map(snapshot)
         duration = video.get("duration")
@@ -455,7 +530,9 @@ class DashboardQueries:
             ),
         }
         if include_growth:
-            item["growth"] = self._growth_for(snapshot, previous).as_dict()
+            item["growth"] = self._growth_result(
+                video, snapshot, previous, days_back=int(growth_days or 1),
+            )
         return item
 
     # ------------------------------------------------------------ overview
@@ -474,7 +551,7 @@ class DashboardQueries:
             videos = self._videos(conn)
             aids = [int(video["aid"]) for video in videos]
             snapshots = self._snapshot_map(conn, aids)
-            # 播放增量：按片相对当前点的相邻成功日，避免 seed/recent 拉到 T-2。
+            # 播放增量：近 1 日。有更早日用相邻成功日；当日发布相对 0；否则用 view_open。
             previous = self._snapshot_previous_relative(conn, snapshots, days_back=1)
             totals = {metric: 0 for metric in METRICS}
             for video in videos:
@@ -489,12 +566,13 @@ class DashboardQueries:
             for video in videos:
                 aid = int(video["aid"])
                 snapshot = snapshots.get(aid)
-                prior = previous.get(aid)
-                if snapshot is None or prior is None:
+                if snapshot is None:
                     continue
-                growth = self._growth_for(snapshot, prior)
-                if growth.available and growth.delta is not None:
-                    view_delta_sum += growth.delta
+                growth = self._growth_result(
+                    video, snapshot, previous.get(aid), days_back=1,
+                )
+                if growth.get("available") and growth.get("delta") is not None:
+                    view_delta_sum += int(growth["delta"])
                     available_deltas += 1
             if available_deltas:
                 view_delta = view_delta_sum
@@ -868,6 +946,7 @@ class DashboardQueries:
                     percentile=percentiles.get(int(video["aid"])),
                     previous=previous.get(int(video["aid"])),
                     include_growth=sort in {"growth", "growth_rate"},
+                    growth_days=growth_days,
                 )
                 for video in videos
             ]
@@ -977,9 +1056,15 @@ class DashboardQueries:
             reason = None
             if sort in {"growth", "growth_rate"} and not growth_available:
                 available = False
-                reason = (
-                    f"近 {growth_days} 日增长需要至少 {growth_days + 1} 天快照"
-                )
+                if growth_days == 1:
+                    reason = (
+                        "近 1 日增长需要前一日快照；当日发布有一次成功采样即可；"
+                        "更早发布的新入库需要当天至少两次成功采样"
+                    )
+                else:
+                    reason = (
+                        f"近 {growth_days} 日增长需要至少 {growth_days + 1} 天快照"
+                    )
             duration_filter = None
             if sort in duration_sorts:
                 duration_filter = {
@@ -1031,16 +1116,19 @@ class DashboardQueries:
                 video = dict(row)
             snapshots = self._snapshot_map(conn, [aid])
             snapshot = snapshots.get(aid)
-            previous = self._snapshot_map(conn, [aid], before=snapshot["stat_date"] if snapshot else None).get(aid)
+            previous = self._snapshot_map(
+                conn, [aid], before=snapshot["stat_date"] if snapshot else None,
+            ).get(aid)
             _, _, heat, percentiles = self._global_heat(conn)
-            growth = self._growth_for(snapshot, previous)
             item = self._item(
                 video,
                 snapshot,
                 heat=heat.get(aid),
                 percentile=percentiles.get(aid),
             )
-            item["growth"] = growth.as_dict()
+            item["growth"] = self._growth_result(
+                video, snapshot, previous, days_back=1,
+            )
             item["snapshot_count"] = int(conn.execute(
                 "SELECT COUNT(*) FROM snapshot WHERE aid = ?", (aid,)
             ).fetchone()[0])

reaction_board/web/static/components.js

@@ -30,6 +30,12 @@ export function avatar(item, className = "avatar") {
     loading="lazy" referrerpolicy="no-referrer"></div>`;
 }
 
+function growthBaselineTag(growth) {
+  if (growth?.baseline === "zero") return "<small>今日</small>";
+  if (growth?.baseline === "open") return "<small>入库后</small>";
+  return "";
+}
+
 export function videoCard(item, {
   rank = null, primary = "view", primaryLabel = "", primaryText = null,
   showStatus = false,
@@ -73,7 +79,7 @@ export function videoCard(item, {
           <span class="primary-stat">
             <b>${escapeHtml(primaryValue ?? "—")}</b><small>${escapeHtml(label)}</small>
           </span>
-          ${delta !== null ? `<span class="delta ${delta >= 0 ? "up" : "down"}">${formatDelta(delta)}</span>` : ""}
+          ${delta !== null ? `<span class="delta ${delta >= 0 ? "up" : "down"}">${formatDelta(delta)}${growthBaselineTag(growth)}</span>` : ""}
           <span class="secondary-stat">互动 ${formatPercent(item.interaction_rate)}</span>
         </div>
       </div>
@@ -118,7 +124,7 @@ export function metricGrid(item) {
   return `<div class="metric-grid">
     ${["view", "like", "coin", "favorite", "share", "reply", "danmaku"].map((metric) => {
       const extra = metric === "view" && growth?.available
-        ? `<span class="metric-delta ${growth.delta >= 0 ? "up" : "down"}">${formatDelta(growth.delta)}</span>`
+        ? `<span class="metric-delta ${growth.delta >= 0 ? "up" : "down"}">${formatDelta(growth.delta)}${growthBaselineTag(growth)}</span>`
         : "";
       return `<div class="metric-cell">
         <span class="metric-label">${escapeHtml(metricLabel(metric))}</span>

reaction_board/web/static/views/about.js

@@ -92,7 +92,7 @@ export async function renderAbout(root) {
         <li>B 站不公开完播率与单 P 播放，内容小时是“供给时长”，不是“实际观看时长”。</li>
         <li>多 P 可能让同一用户产生多次播放计数，本站不单独校正，属于已知偏差。</li>
         <li>粉丝数可能包含不活跃账号；粉丝快照暂不参与任何榜单。</li>
-        <li>样本不足（少于 2 天快照、单视频 UP）会显示提示，不伪造 0。</li>
+        <li>近 7/30 日增长仍要跨日快照。近 1 日：当日发布按 0 起算；更早发布的新入库按入库时播放量起算，需当天至少两次采样。样本不足时显示提示，不伪造 0。</li>
       </ul>
     </section>
 

reaction_board/web/static/views/home.js

@@ -69,7 +69,7 @@ export async function renderHome(root) {
   const growthEmptyTitle = growth.reason
     || `近 ${growthDays} 日增长暂不可用`;
   const growthEmptyHint = growthDays <= 1
-    ? "当前快照不足，完成至少 2 天快照后即可显示播放增量。"
+    ? "当日发布按 0 起算；更早发布的新入库需要当天至少两次采样。"
     : `需要至少 ${growthDays + 1} 天快照才能计算近 ${growthDays} 日增长。`;
   const updatedLabel = formatClock(overview.updated_at);
   const dataDateLabel = formatDataDate(overview.data_date);

reaction_board/web/static/views/rankings.js

@@ -179,6 +179,12 @@ function durationNote(data) {
   return `<div class="section-note">内容效率与互动效率：时长 ≥ ${filter.min_duration_seconds} 秒、发布满 ${filter.maturity_days} 天、播放 ≥ ${filter.min_view}${shrink}；时长缺失不参与。</div>`;
 }
 
+function growthNote(sort, growthDays) {
+  if (sort !== "growth" && sort !== "growth_rate") return "";
+  if (Number(growthDays) !== 1) return "";
+  return `<div class="section-note">近 1 日：当日发布按 0 起算；更早发布的新入库按入库时播放量起算，需要当天至少两次采样。</div>`;
+}
+
 function bindControls(root) {
   root.querySelector("#rank-sort")?.addEventListener("change", (event) => {
     replaceQuery({ sort: event.target.value, page: null });
@@ -245,6 +251,7 @@ async function renderScope(root, { query }, scope) {
     </header>
     ${controls({ scope, sort, within, year, growthDays, q, years })}
     ${durationNote(data)}
+    ${growthNote(sort, growthDays)}
     ${data.available === false ? `<div class="notice-row warning">
       <strong>${sort.startsWith("growth") ? "增长数据尚不可用" : "榜单筛选后为空"}</strong>
       <span>${escapeHtml(data.reason || "")}</span>

reaction_board/web/static/views/video.js

@@ -62,7 +62,7 @@ export async function renderVideo(root, { params, query }) {
           <span>${escapeHtml(formatDuration(detail.duration))}</span>
           ${detail.pages ? `<span>${formatNumber(detail.pages)} P</span>` : ""}
           ${badge(statusLabel(detail.status), `status-${detail.status}`)}
-          ${samples < 2 ? badge("样本不足", "warning") : ""}
+          ${samples < 2 && !detail.growth?.available ? badge("样本不足", "warning") : ""}
         </div>
         ${detail.blacklisted ? `<p class="section-note warning-text">该 UP 在黑名单中；黑名单只影响未来发现，不影响当前视频追踪。</p>` : ""}
         ${detail.up_follower_backfilled ? `<p class="section-note">UP 粉丝数为回填值，不是真实的入库时点。</p>` : ""}