# 爆款视频识别：保留结论与交付限制

更新日期：2026-11-02。本页集中保留影响产品决策和研发实施的结论；具体需求以[计算规则](计算规则_SPEC.md)、[榜单页](榜单页_SPEC.md)及[其他模块](其余功能模块修改_SPEC.md)三个 SPEC 为准。

## 1. 产品方向

| 结论 | 对交付的影响 |
| --- | --- |
| 优先服务品牌发现合作作者 | 视频是了解作者的入口；频道搜索增加“近期有爆款视频”：不限（默认）/近30天/近90天，按作品发布时间至少一条有效命中；不新增作者综合评分。2026-10-27补充：不改变关联视频选取/排序，爆款优先及新命中作品入口暂不考虑 |
| 识别已经发生的突出表现 | 不承诺预测、未来成功率、自动预警、AI 因果分析或复制建议 |
| 本期仅保留账号突破 | 比较作品与作者自身常态；小号突破不等于大范围传播，不生成作者评级 |
| 监控连续观测与公共快照有不同数据条件 | 本期监控只消费公共识别结果，原增长指标保持；单视频增长爆发／近期识别移至后续 TODO，私有数据不混入公共库 |
| 简单、能复述，比复杂公式优先 | 主规则以播放及可比对象为核心；互动辅助，不引入未经验证的固定权重或黑箱总分 |
| 导出范围裁剪 | 2026-10-27已确认：原导出跟随新增筛选，视频仍导出视频、频道仍导出频道；保持原字段、格式、数量/权限/配额。本期不新增爆款导出列、不额外建设榜单导出功能；后续离线分析扩列不作为本期待决项 |
| 权限与套餐继承 | 2026-10-27已确认：新增榜单沿用现有榜单设定；其他模块内新增爆款筛选、标签、基准及依据不增加权限门槛、独立权益或爆款次数。原模块/项目/数据访问边界及既有搜索、导出、监控、主动AI配额保持，实际配置映射待联调 |
| 全站导航追加方案 | 2026-10-27：Header保留五列，各平台原两项后追加YouTube/TikTok/Instagram爆款视频排行榜；Footer按平台插入同名入口，8条变11条。仅链接平台全球近30天榜，国家由榜单页原筛选承接，不新增国家快捷区；方案已写入榜单SPEC 11.5.1，未改线上。用户截图与首页公开DOM已核对，移动/多语言视觉仍待验收 |
| 在现有产品中增加能力 | 保留榜单Demo；其他核心页面只做必要筛选、标记、短计数与依据，不新增其他模块Demo。2026-10-27确认推广视频、商品/合作抽屉、单任务详情、相关推荐及P1单视频分析等零散入口不单独开发、不阻塞本期；共享组件自然带出时同源复用，不扩建接口、筛选或统计 |
| 榜单筛选精简 | 2026-11-02确认仅保留平台切换、国家/地区和分类；固定近30天发布，删除内容形态、作者体量、发布时间、语言、推广、关键词及高级筛选。公共计算仍为90天，频道搜索30/90天不变 |
| 单视频AI推荐关键词本期不做 | 2026-10-27明确移出本期：删除菜单、提示与占位，不增加提词或搜索承接；此前复用方向及实验仅作后续参考，既有频道AI功能保持 |

**类型只保留在内部。** 当前用户界面只使用“爆款”“已入选”等结果表达，不展示“账号突破”类型名、类型列或切换；同作者历史比较仍在依据中解释。代码、协议与存储保留 `account_breakout`，为未来扩展保留维度。

**历史取舍：广泛热门已移除。** 本期规则、契约、筛选、标签、覆盖统计与榜单只保留账号突破；下文历史同类分位及样本实验仅用于留存研究证据，不构成本期规则要求，也不构成后续交付承诺。

### 单视频 AI 推荐关键词的决策依据

**当前决定（2026-10-27）：该能力本期不做，原可选交付方案已撤下。** 以下为历史研究与可能的后续方向。

2026-10-23曾按复用频道搜索“AI推荐关键词”的能力设计，入口与单条视频绑定，用户确认或修改后进入同平台视频搜索。原“搜索更多同类视频”的全榜单条件跳转不再作为目标方案；它既缺少源主题，也不能证明结果属于同类内容。

- 本轮从三平台各抽 10 条真实视频，基于全部可读取业务字段固定 23 个查询，7 条因信息不足弃权；共评审 2,203 条线上主视频结果。具体对象、动作或角色有用，但多义词、短剧同名句、稀疏文案会带来跑题或无法判断。
- 评审仅证明当前元数据与默认视频搜索之间的可行性；没有取得完整画面/音轨/字幕，原始全量库也未连接成功。它不等于相似视频效果验收，不证明现有 AI 推荐接口已经满足本场景。
- 静态源码已确认现有推荐输入包含 `videoIds`：`kol-next/components/searchV2/SearchBox/aiSuggest.vue`、`api/search/inputOption.js`；旧服务 `KeywordExpansionParam` 与三平台 `keywordExpansion` 会读取视频标题/描述、标签。现有 `Prompt.NL_SEARCH_EXTEND_KEYWORDS` 面向扩词找作者，会扩展品牌、竞品与场景；视频主题提取、限定词保留与无可靠输入时不生成的规则仍需适配。
- 当前版本直接删除该入口及占位，不再由研发在本期选择是否启用。后续若重启该方向，需重新确认输入、原词准确性、交互、效果及排期，不能沿用历史方案视为已批准。

本期跨页操作边界见[榜单SPEC第7节](榜单页_SPEC.md#7-跨页操作与返回)。本页只保留研究结论与限制，不把未来提词流程列成本期契约。

## 2. 旧指标为什么不能代替新识别

| 现有指标/做法 | 已知边界 | 处理 |
| --- | --- | --- |
| YouTube `video_score` | 旧移动端公式按播放/赞/评分段加权并做时间衰减；没有证据证明它就是当前日榜写入公式 | 不映射为新爆款标签，不据日期索引宣称每日采集 SLA |
| 监控增长 `hotLevel` | 读取前两天自然日期记录，与严格 t−48h 不同；旧分支对播放下降也可能落入非零档 | 原字段保留；不能当新爆款、实时增速或近期突破的真值 |
| 品牌 `topVideoRate` | 查询品牌范围内，互动量高于该品牌样本平均互动量 2 倍的视频占比 | 原字段及历史值保留，明确为品牌范围旧指标，不能静默换成新视频识别占比 |
| 搜索观看/粉丝比 | 所审数学工具把返回比例上限截到 1；2 倍与 20 倍可能都显示 1 | 不能拿展示值计算突破倍数；播放次数也不等于独立观众或非粉丝触达 |
| 累计播放÷发布时长 | 是发布以来平均速度，无法区分最近正在增长与早已停滞 | 不能冒充最近一小时增量、加速度或预测信号 |
| 旧综合公式 | 部分乘积可约去播放因素；部分互动率组合在其他量固定时会随播放增加而下降 | 保留简单对照思路，不采用旧总分/固定权重作为生产判定 |

品牌指标的固定区分说明可使用：**“爆款制造率沿用品牌范围内的高互动占比口径，与本次视频爆款识别不同。”** 需要更精确的定义时在指标说明中补充“高于品牌样本平均互动量 2 倍”；不把它解释成作者能力或合作转化率。

关键代码位置（静态证据，未证明部署与当前数据质量）：

- 搜索比例/互动展示：[KolMathUtil.java](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol_server_v2/common/src/main/java/com/nox/kol/common/tool/KolMathUtil.java)。
- YouTube 旧分数：[VideoScoreCalculation.java](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/KOLServer/Entity/src/main/java/com/nox/kol/constant/VideoScoreCalculation.java)。
- 监控日期与增长：[VideoMonitorDailyChangesMapper.xml](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/KOLServer/ServiceInternal/src/main/resources/com/nox/kol/mapper/VideoMonitorDailyChangesMapper.xml)、[VideoMonitorIndependentModularityService.java](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/KOLServer/ServiceInternal/src/main/java/com/nox/kol/service/monitor/video/VideoMonitorIndependentModularityService.java)。
- 品牌旧比例：[BrandVideoRelation.xml](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/KOLServer/ServiceInternal/src/main/resources/com/nox/click/mapper/brand/BrandVideoRelation.xml)，`selectCooperateInfo` 的品牌范围聚合。

## 3. 已有数据证据：能说明什么

以下为既有 **2026-10-14 的监控样本记录**，本轮没有重跑该日全量查询；2026-10-26 新增的窗口核对另见第 3.1 节。范围为 `nox_kol_v2` 中 `video_monitor_task`、`video_monitor_changes_daily_mv`、`video_monitor_task_snapshot`，单日以 `monitor_date = '2026-10-14'` 查询 YouTube/Instagram/TikTok。数据由用户监控任务构成，有选择偏差，不能作为全量公共视频库或真实效果回测。

| 保留证据 | 结论及边界 |
| --- | --- |
| 三平台原始 73,879 行；按平台+视频去重 65,790 条，减少 10.95% | 按任务行计算参考组会重复加权；同一视频必须稳定取点并去重 |
| Instagram 原始 24,368 行，播放缺失 2,177 行（8.93%） | 核心播放缺失要显式不可判定，不能改用点赞冒充同一规则 |
| YouTube/Instagram 严格同形态、至少 10 条历史的基线在该样本未得到验证 | 不能据作者有历史就声称三平台账号突破已具备上线数据条件 |
| TikTok 严格同形态基线有 158 个分组、2,687 行可进入局部候选回放 | 仅支持有限样本实验，不代表全平台可用 |
| 三平台 0–1d 分组样本分别为 104/184/143，均低于当时实验线 200 | 该样本不能稳定估计早期分位；不能推断所有新视频都无法识别 |
| 旧校准尝试过 5 倍、P95 加 100,000 播放下限 | 属于历史实验条件，不与当前暂定 10 倍并列生效，不构成生产参数 |

仍需补齐：公共库指标观测时间、可靠内容形态、累计历史快照及最低发布时长覆盖、实际采集频率、账号历史覆盖及权限来源。不能从接口 DTO 有字段推断采集完整，也不能由任务快照外推全量视频快照。没有真实“发布后第 7 日”的观测点，就不能从今天累计值倒推该日播放量。

冻结规则前至少按平台/形态分别验证：可评估覆盖、人工有效发现、误报类型、低基数偏差、作者体量偏差、跨批次稳定性、延迟与成本。当前没有可保留为正式结论的生产准确率、预测能力或统一刷新 SLA。

**当前比较口径决定（2026-10-26；2026-10-27补充）。** 用户确认采用累计快照比较：目标视频达到按平台/形态设置的最低发布时长后，与其作者此前同形态作品的累计播放中位数比较，暂定≥10×。不再要求历史同龄快照，也不再把缺少同龄历史本身作为不可评估条件。目标和历史快照均需符合最低发布时长及快照有效性政策，按实际采集时点判断；2026-10-27 用户同意最低发布时长暂按YouTube长视频7天、Shorts/TikTok视频/Instagram Reels 3天执行（分别168/72小时，包含等于门槛）；后续可调。本期快照不设按时间自动过期门槛；目标发布超过90天停止自动首次判定、重试及重算，保留全部已发布判定和依据，历史参考不受90天限制。来源、质量和取点实现仍需核对。该选择提高与已知公共快照能力的适配性，但未验证生产覆盖，且保留发布年龄、采集延迟和低基数偏差。不得把它描述为严格同龄、早期速度或最终生命周期表现。

### 3.1 近期监控的观测窗口核对（后续 TODO 的保留证据）

2026-10-26 用户已确定：监控近期识别／增长爆发留待后续版本，当前只记为 TODO，不再属于本期范围。以下保留既有观测核对，避免后续重复研究，不构成当前计算规则、生产覆盖或 SLA 承诺。账号突破倍数已于同日暂定为10×，后续再调；最低历史样本量仍待评审。

**线上只读证据。** 2026-10-26 10:07（Asia/Shanghai）读取 `nox_kol_v2`；session transaction read-only=1，global read_only=0，查询后回滚关闭。每平台取 2026-09-26 至 2026-10-19（不含）创建、未删除且 ID 倒序的 100 个任务，不按运行状态筛选。日表读取 `[2026-10-05, 2026-10-26)`，原始明细读取 `[2026-10-18, 2026-10-26)`。这是偏向近期且已积累历史任务的便利样本，不是全量或随机抽样，不能外推公共库、全部项目、新视频覆盖或 SLA。

| 平台 | 原始明细条数（100 个任务） | 相邻明细间隔中位数 / P90 | 约 24h 端点配对，误差 ≤2h 且播放差非负/非缺失 |
| --- | --- | --- | --- |
| YouTube | 8,204 | 2.00h / 2.15h | 700 / 700（100%） |
| TikTok | 8,799 | 2.00h / 2.01h | 679 / 679（100%） |
| Instagram | 771 | 23.21h / 34.05h | 324 / 632（51.3%） |

配对以最后七个自然日各自最后一条实际明细为终点，寻找同任务最接近“终点−24h”的实际起点；不补点、不插值、不按小时外推。±2h 只是诊断候选，不是已批准的生产容差，也不是严格 24h。三个平台各有 100 个不重复的 `utm_content` 身份字段；该字段在源码中写入解析的视频 ID，但本轮未向平台独立校验。回放排除 IG 8 个、TT 3 个已知非视频任务；YT 95 个任务的形态字段缺失，尚需核对链接等来源，配对成功不代表其已满足视频形态或参考组条件。表中间隔统计包含抽取任务的全部明细，与排除非视频后的回放分母不同。

样本日表共 2,369 条，均可按任务+`monitor_time` 回连原始明细且播放值相符；这是样本对账，不能据此证明所有日表记录的生成政策、平台实测时刻或未延迟。IG 的 48h/72h 回放在同一 ±2h 诊断条件下分别为 263/541、237/450，简单改成长窗口没有自动解决取点偏移。完整口径和脱敏汇总见[观测窗口证据](assets/近期监控_观测窗口核对_2026-10-26.json)。

**静态代码证据。** 旧服务 `KOLServer/master@706dc8ea0e` 为本轮监控读取链路；新服务 `kol_server_v2/master@234e9dad` 未检索到对应监控观测实现，不能因此推断线上所有写入归属。需要注意：

- 原始读取为 `VideoMonitorChangesMapper.xml:9`；`:23` 按日取最后一条整行，`:43` 的另一读取却逐字段取 MAX，可能拼接不同观测。新判定不应复用后者。
- `VideoMonitorDailyChangesMapper.xml:74` 的旧热度取前两天自然日，与严格滚动 48h 不同。
- `VideoMonitorIndependentModularityService.java:7691`、`:7752` 会为图表复制上条累计值、将补点时间设为当天零点并置零增量；图上连续点不能当连续真实采集。
- 同 Mapper 的 `:571`、`:601` 存在缺基线补零、负差截零的展示计算；新识别应保留缺失和修正状态。
- `update_time` 也可能因用户修改更新，`video_monitor_task_snapshot.create_time` 的采集含义与 writer 未在本轮核实；二者不能代替可信指标观测时刻。原始 `monitor_time` 的上游写入/指标截至时间也仍待确认。

**数据分工的最新产品前提。** 用户已明确：内容监控有独立更新机制，可满足发布早期 48 小时及所需采样频率；非监控公共数据仅是不保证更新时间/频率的快照。此前便利样本用于核对历史记录，不作为否定监控能力的总体结论。后续近期方案以单视频自身连续数据为研究方向，不要求公共或作者其他作品同步观测，见第 3.2 节；当前不实施。本轮未新增平台级 SLA 实测。

### 3.2 仅依赖单视频连续观测的增长爆发候选（后续版本 TODO，本期不包含）

**已确认的版本取舍。** 2026-10-26：仅记录后续版本 TODO，不再继续本期方法校准，也不作为当前评审阻塞项。本期只交付公共“账号突破”，内容监控消费同一公共结果；不新增其他判定或近期模式。以下方法作为后续参考保留。

**研究问题。** 在不依赖其他视频、作者历史或公共参考集合的条件下，能否识别这条视频在已观测时段发生的持续快速增长？答案是存在可实现的方法，具体效果和阈值尚未验证。这属于独立于“相对作者常态”的增长研究方向。后续若产品将其纳入爆款类型体系，可暂名“增长爆发”；本期已明确不交付，未来是否新增及最终命名另行评审。本期账号突破采用累计快照比较、倍数暂定10×；最低发布时长已暂定7天/3天，历史样本量与快照来源/质量仍待评审；快照不设时间TTL，目标超过90天停止自动计算。

**方法选择及证据。** 单序列的强度变化/变点检测不要求其他对象作实时对照。[NIST CUSUM](https://www.itl.nist.gov/div898/handbook/pmc/section3/pmc323.htm)以自身参考均值的累计偏差识别变化；[Adams/MacKay 在线变点方法](https://arxiv.org/abs/0710.3742)逐步推断距最近变点的长度；[Kleinberg 突发模型](https://www.cs.cornell.edu/home/kleinber/bhs.pdf)以不同强度状态及切换成本描述突发。这些是方法存在性的依据，不是聚星视频效果证明。Kleinberg 原模型使用事件到达间隔，聚星的累计快照不含逐次播放时间，不能原样套用；短视频早期曲线也不能默认是稳定均值过程。

后续版本可先验证可复述的规则，再以复杂变点模型作对照；以下不是本期验收要求：

1. 仅使用同视频、同口径、权限范围内的真实累计观测。实际区间平均增速 `r_i = (V_i − V_(i−1)) / (t_i − t_(i−1))`；它不是瞬时速度，也不是把不齐整窗口外推成精确 24h 播放。
2. 将满足预定时长、取点容差和质量要求的连续观测组成可比窗口；用事件前若干窗口增速的中位数构建自身基线 B，近期窗口不混入 B。
3. 同时要求：近期增速明显高于 B；新增播放达到最低绝对量；连续多个互不重叠窗口维持高增长。仅有增长倍数或曲线变陡不能单独认定。
4. 首次出现候选后冻结事件前基线，后续新窗口负责确认；进入高位平稳期不要求持续加速。事件结束与再次识别须独立定义，避免同一波增长反复贴标。
5. 每次确认只用当时已取得的数据，记录观测区间、候选/确认时点、基线、绝对新增与限制；观测到变化的时段不等于真实流量爆发的准确发生时刻。保持历史事件与当前状态分离。

窗口长度、基线窗口数、提升倍数、最低绝对量、持续窗口数、退出/冷却条件均为待验证参数，不沿用账号突破的历史数量或倍数候选。本轮没有批准具体取值。2h/4h 可作为监控短窗口实验候选，是否可用依实际采样配置验证；识别无需强制等到视频发布满 24h/48h，但必须先积累足够自身观测，不能承诺发布即判。

**必须单独覆盖的两类情况。** B=0 时不计算无限倍、不人为加平滑常数；只能按明确的绝对新增/增速与持续条件研究“从零起量”，或继续等待。若从第一条观测起就一直高速平稳增长，倍数方法会漏检；若希望覆盖，需增加“持续快速增长”的绝对增速/新增量分支。该分支的“快”需要明确的业务门槛，无法仅由自身曲线形状推出。它可作为同一监控增长识别的不同原因，是否并入“增长爆发”名称需评审，不能假装与突增相同。

**不可消除的边界。** 成比例放大一条曲线，形状和倍数保持不变，因此绝对规模政策仍需产品决定；只用相对指标无法区分 1→10 与 1,000→10,000 的业务价值。平台延迟集中更新与真实增长可能产生相同累计快照，持续确认只能减少部分误报，不能彻底区分；不得据此推断自然推荐、非投流、未来持续增长或全平台热门。首条观测不得假定为发布时零点，晚加入监控不能复原之前的曲线。负修正、长缺口、字段口径变化中断可比链，不置零、不跨缺口拼出持续性。

**后续验证 TODO。** 历史回放按观测逐点截断，模拟当时可取得的数据，禁止用完整 48h 结果倒称提前识别。必须覆盖：低基数大倍数、零基线、单次跳涨后停滞、从首点持续高速、正常缓慢爬升、高位平台期、二次爆发、采集间隔变化、缺口后补报、负修正及多次集中更新。需人工评估可用线索、误报、漏检与确认延迟。本轮仅完成逻辑反例推演，没有真实效果准确率或生产覆盖结论。

**本期边界（已确认）。** 当前监控只增加公共识别结果的必要标记、筛选与依据，保留原增长指标，不扩建 UI；没有增长爆发算法、标签、筛选、聚合、导出或占位。后续若获批，需另定结果协议、类型、有效期与权限边界，不静默塞入“账号突破”或其评估覆盖率。项目私有结果不回写公共榜单，观察与查看不自动触发预警、AI 日报或未来预测。Demo 无需为延期修改。

## 4. 页面与服务接入事实

| 事实 | 对研发的要求 |
| --- | --- |
| 有三平台视频/频道搜索、频道内容、监控、品牌资产等现有入口 | 在真实路由增量接入；新生产能力不依赖 `viralDemo=1` |
| 搜索关联视频和抽屉视频是不同读取链路 | 作者近期命中不能由几条关联样本推断；服务端按全范围结果筛选并保留内部追溯。2026-10-27已暂缓爆款优先展示及专门命中作品入口，前台关联视频保留原规则，不要求新增证据读取接口 |
| 搜索 `SearchResult` 还被相似网红、营销项目和 AI 来源复用 | 按来源能力开启新条件，不因共享组件自动扩大接入范围 |
| 搜索书签另有条件序列化 | 新条件需保存/恢复；当前列表快照与日后书签重查分开 |
| 收藏夹主要存频道 | 不以“复用收藏”暗中新增视频收藏对象 |
| 新旧服务端均有搜索/抽屉相关代码 | 按环境实际路由确认归属，不能仅看 `/ws` 或仓库名分配任务 |

服务端归属线索：

- 新搜索控制器：[YtbSearchController.java](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol_server_v2/main.server/src/main/java/com/nox/kol/main/server/modules/search/channel/controller/YtbSearchController.java)，同目录有 TT/IG 实现。
- 关联样本查询：[ResultVideoSearchQuery.java](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol_server_v2/data.api/src/main/java/com/nox/kol/data/api/channel/dto/ResultVideoSearchQuery.java)，默认每频道 4 条，不能证明全频道存在性或精确计数。
- 旧频道抽屉：[YoutubeSearchController.java](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/KOLServer/WebService/src/main/java/com/nox/kol/ws/upgrade/search/YoutubeSearchController.java)。

上述只是静态归属证据。接口路径、数据物化/索引、批次发布、缓存、失败响应、权限、配额与性能仍须实现前确认；具体需求见其他模块 SPEC。

## 5. Demo 已验证与尚未实现的差异

历史清理提交：`63042dc45`，分支 `codex/viral-video-demo`。当时的结果契约、范围隔离、五语抽屉检查通过；榜单定向浏览器 29 项通过（无页面错误和业务请求），新标签页的关键词及语言条件恢复通过。1280 未登录页壳最小宽度仍是既有限制。

历史评审基线只保留账号突破榜单；当时已清理旧判断切换、协议、标签及截图，已于2026-10-27提交并推送至`codex/viral-video-demo`，该阶段评审提交为`f0ae8ca81`。本地定向浏览器46项检查通过，43 条样例契约和五语抽屉检查通过；页面错误与生产业务请求均为 0。旧搜索、频道、监控和品牌 Demo 接入已移除；跨模块入口只读提示不代表正式产品承接已经实现。

| 项目 | 当前状态 |
| --- | --- |
| 榜单组织方式 | 已由用户认可，作为页面结构参考；不等于服务端已上线 |
| 依据展示 | 榜单采用行内中位数、倍数和样本提示，已移除查看依据入口及抽屉；其他模块继续保留独立状态解释要求 |
| 本地样例 | 43 条确定性样例，仅保留账号突破；13条命中样例已从旧3.6～8.6倍修正为10～38倍，含10倍边界，播放量/中位数/倍数一致，与当前暂定10倍口径保持一致；10×后续可调，完整算法仍待验收，不是真实识别效果评估 |
| 榜单时间范围 | 2026-11-02更新为固定近30天发布，无时间控件；仅平台切换和国家/分类。按固定批次截止回推，作者历史参考不受窗口影响；31—90天作品仍可计算和供其他模块消费；超90天才停止自动计算。快照不设时间TTL，历史结果不因退榜或停算失效 |
| 更新目标与触发 | 2026-10-27：日更是产品目标；允许公共视频数据更新后触发增量计算，不要求每天固定全量计算。无新数据沿用原结果，不刷新实际采集/评估时间；发布需保持跨模块及翻页一致，时间窗口维护不依赖再次采集。触发链路和发布延迟尚未生产验收 |
| 计算生命周期与历史 | 2026-10-27：为限制累积计算量，公共目标发布超过90天后停止自动首次判定、更新触发、重试和规则换版重算；已有快照及全部已发布判定保留，旧作品仍可作新目标的历史参考。不为使用历史样本强制补采或判定旧目标；生产调度未实施，详见计算SPEC第3.4节 |
| 榜单排序 | 2026-10-27 已确认快照累计播放量降序，同播放量优先较新发布时间，再按稳定ID；三平台固定样例与页面说明已对齐，原生视频ID比较由服务端固定实现，未改变其他模块或旧HOT排序 |
| 批次展示裁剪 | 2026-10-27：删除榜单高级筛选、结果信息及模拟提示中的批次编号；旧batchId URL参数清理且不恢复摘要，保留更新时间/截止时间。内部批次、版本和同上下文一致读取不受影响 |
| 用户可见口径 | 2026-10-27 在标题下常驻10×核心规则，复用“榜单说明”展开六段说明；明确待观察/不足不入榜、累计快照限制及历史样本量未定；7天/3天暂定门槛已同步说明，识别计算未改动，排序样例已按快照播放量降序、同播放量较新优先对齐，仍不代表生产服务已接入 |
| 真实生产数据/权限/性能 | 未完成接入或验收；新筛选及聚合不因文档形成就视为已实现 |
| 本轮裁剪 | 已清理双判断依赖和冲突筛选；旧 URL 转为账号突破，仅保留合法平台/国家/分类/分页；退休条件移除且不暗中影响结果，依据入口已删除 |

需要按 SPEC 继续落实的差异：

1. 2026-10-27已确定移除单视频AI推荐关键词及对应说明，不再作为可选交付；全局旧搜索入口也不恢复。历史真实视频实验只保留研究参考，不代表本期功能。
2. 本地榜单已移除覆盖状态筛选；正式接入仍需将无命中、未覆盖、计算失败和更新延迟分开。
3. 普通列表仅保留账号突破筛选与状态，按计算 SPEC 处理冲突组合；“已评估”与“已入选”不得混用。抽屉已优化，不能据此认为所有列表已修复。
4. 覆盖统计需由服务端提供全范围分母，界面解释已评估/适用/命中，不从当前页或仅命中结果计算 100%。
5. 地区已确认为频道榜的频道国家/地区归属；Demo已去除市场兜底并补未知国家样例。仍需研发接通真实频道国家与视频作者的关联及来源，不重新做国家推断。
6. 已确认的榜单顺序（判定快照播放量降序、同播放量较新优先、再按稳定ID）仍需服务端分页与版本接入；定量识别证据和合法不足/未覆盖/失败响应也需接入，不能将固定样例键编码直接搬作生产实现。

Demo的yt-022、tt-009、ig-008发布时间设为2026-07-20，用于验证固定30天榜单排除窗口外的有效命中（旧30/90天切换方案已撤下）；它们的10×以上命中、基准与排序键保持有效示例。该日期相对模拟批次截止时间计算，不代表线上视频或真实覆盖。

## 6. 验证限制与上线前决策

- 2026-09-15 的真实页面记录只核过部分环境的页面结构，未逐一验证三平台/所有套餐。
- 2026-10-22 本地榜单和抽屉完成桌面检查；为避开不可达的内网 Redis，临时预览采用内存缓存和未登录会话。因此它不构成登录/权限或生产 API 验收。
- 同日尝试线上频道搜索时，内置浏览器与 Chrome 读取超时，未取得可信的账号、权限及同源接口结果。当前文档没有宣称新筛选在线上已存在。
- 2026-10-23 经 Playwright MCP 已完成三平台视频搜索的同源只读实验；这不覆盖现有 AI 推荐实际调用、频道近期聚合、新爆款筛选或生产权限/配额验收。
- 历史本地通过的测试只证明当时的示例契约、适配和界面呈现，不证明真实数据覆盖、算法有效性、授权、成本或服务可用性。

本期评审仍需明确公共识别的观察条件、可用数据与候选参数；已确认排序的服务端落地与稳定分页；已确认频道国家的真实字段关联与编码；已确认频道30/90天窗口的聚合及内部入选追溯实现（不含已暂缓的关联视频优先展示/命中作品入口）；已确认权限继承与项目可见范围的映射、90天停算与已确认历史保留的实现；接口归属和批次 SLA。监控近期识别／增长爆发已移至后续 TODO，不再作为本期必决项。三个 SPEC 中的待确认项需要逐项落实，不能用“文档完整”替代这些决定。

## 7. 保留的外部启发

历史调研支持几项有用设计方向：视频库的筛选与榜单相互衔接；从作品进入作者和相关作品；平台、分类和时间条件放在原有发现链路中。低粉爆款不等于严格的账号常态突破，竞品增量榜也不能直接套在只有累计值的数据集上。未登录入口、产品介绍或历史帮助页不能证明实际阈值、算法效果、数据授权或实时 SLA。

可供后续需要时重新核对的原始产品入口：[Tubular](https://tubularlabs.com/)、[vidIQ](https://vidiq.com/)、[BuzzSumo](https://buzzsumo.com/)、[蝉妈妈视频榜](https://www.chanmama.com/awemeRank/)、[飞瓜](https://www.feigua.cn/)。这里保留的是调研线索，不是本轮重新验证的产品能力对比，也不作为聚星公式参数的依据。


## 8. SEO 入口拆分的核查结论（2026-10-26）

当前推荐方案集中在[榜单 SPEC 第11节](榜单页_SPEC.md#11-seo-多入口拆分方案2026-10-26待评审)。沿用多入口思路已由用户提出；频道国家口径已于2026-10-27确认；2026-10-27收敛为仅新增三平台全球导航入口，国家复用原页内筛选并保留对应URL及SEO表达；不新增国家快捷区，撤回固定六国/21页候选要求。真实字段映射、具体URL和索引发布配置仍待实施核对，不承诺收录。

### 8.1 静态代码证据

本轮只读核查 `kol-next`、`kol_server_v2` 和 `KOLServer` 的本地 master；代码事实不等于当前线上已部署事实。

| 证据 | 核查结果 |
| --- | --- |
| [频道榜路由配置](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol-next/assets/script/util/channelRankSeo.js:37) | YouTube/Instagram/TikTok 通过国家、分类、排序、周期组合路径；TikTok 当前分类只允许 all |
| [站点一级榜单导航](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol-next/components/layout/landing/header.vue:199) | 每平台少量榜种入口，不在总导航穷举国家；新榜可增加同级入口并在榜单页继续选国家 |
| [频道榜索引分类](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol-next/assets/script/util/channelRankSeo.js:241)、[sitemap常量](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol-next/assets/script/constant/seo.js:77)、[sitemap生成器](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol-next/server/services/seo/sitemap.js:31) | 国家路径存在不表示进入 sitemap；默认无query的全球频道榜才进入当前频道榜 sitemap 白名单。分页/tagId 有自己的 noindex 规则，不可把这些规则直接当新榜发布规则 |
| [旧视频榜路径与SEO](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol-next/assets/script/util/youtubeVideoRank.js:27)、[元信息生成](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol-next/assets/script/util/youtubeVideoRank.js:188) | `/youtube-video-rank` 和国家/分类/日期子路径已有旧 HOT 用途；国家与分类进入标题、H1和canonical，新榜需独立命名空间 |
| [旧服务HOT查询](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/KOLServer/Elasticsearch/src/main/java/com/nox/kol/elasticsearch/service/EsVideoService.java:125)、[新服务HOT查询构造](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol_server_v2/data.provider/src/main/java/com/nox/kol/data/provider/modules/video/service/YtbVideoSearchService.java:167) | 两处均按data_region/data_category筛选、video_score排序；未证明data_region是作者国家，新服务查询也不证明旧榜接口已迁移 |
| [旧服务按IP补国家](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/KOLServer/ServiceInternal/src/main/java/com/nox/kol/service/InternalVideoRankingService.java:154) | 缺国家且有IP时可能补访问者国家。新榜全球范围必须显式、稳定，不能照搬这一默认行为 |
| [页面命名知识](</Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol_brain/wiki/concepts/NoxInfluencer 页面 Title 命名口径.md>) | 既有知识强调榜单标题区分对象和功能，不共用宽泛标题；国家页还需使路径、H1和真实范围一致 |

### 8.2 公开页面读取与浏览器边界

公开网页读取可确认：YouTube 美国榜的 URL 和标题包含美国范围；TikTok 美国榜有对应国家入口；英文旧 YouTube 视频榜仍表达24小时热门视频。参考 [YouTube 美国榜](https://cn.noxinfluencer.com/youtube-channel-rank/top-100-us-all-youtuber-sorted-by-subs-weekly)、[TikTok 美国榜](https://cn.noxinfluencer.com/tiktok-channel-rank/top-100-us-all-sorted-by-followers-weekly)、[旧视频榜](https://www.noxinfluencer.com/youtube-video-rank)。

公开读取的 Instagram 美国路径返回了未带国家的宽泛标题与空态，来源缓存时间也不同；不能据此诊断当前线上错误或证明国家过滤正确。新方案以“路径、标题、筛选、结果一致”为验收要求，不直接复制该读取结果。

Codex 内置 Browser 打开目标超时，随后 Chrome 导航和读取也超时；本轮未取得可信的交互式截图、账号/权限/地区或同源接口结果。公开网页读取与静态代码证据分开记录，不能宣称完成线上交互验收。本轮不改 Demo、真实前端或后端，也未进行流量/搜索量/真实可用视频数量查询。

### 8.3 保留的SEO规则依据

采用小规模、明确白名单的固定入口，避免把所有筛选组合暴露为可索引地址。各国家页的规范地址对应自身范围；分页不能全部指向第一页；额外筛选是否进入索引与入口路由是否可访问分开管理。参考 [Google canonical指南](https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls)、[筛选导航指南](https://developers.google.com/crawling/docs/faceted-navigation)、[分页指南](https://developers.google.com/search/docs/specialty/ecommerce/pagination-and-incremental-page-loading)。这些原则支持方案约束，不证明具体国家具有关键词收益。

### 8.4 线上 SEO meta 实读补充

2026-10-26 继续按字段读取线上 head，补充第8.2节的证据边界。共发起9次公开 HTTPS 请求、取得8个不同中文榜单页面的 HTML；另一次 www 英文域名请求实际重定向至中文美国榜，不能作为英文站 meta 样本。证据保存于[线上榜单 SEO meta 快照](assets/线上榜单_SEO_meta_2026-10-26.json)，仅含公开标题、meta、规范链接及响应信息，无登录凭据。

| 线上样本 | 实际 title 的主要部分 | description 与其他字段 |
| --- | --- | --- |
| [YouTube 全球粉丝榜](https://cn.noxinfluencer.com/youtube-channel-rank/top-100-all-all-youtuber-sorted-by-subs-weekly) | Top 100 YouTube网红排行榜 | 全球通用描述；canonical 指向全球路径 |
| [YouTube 美国粉丝榜](https://cn.noxinfluencer.com/youtube-channel-rank/top-100-us-all-youtuber-sorted-by-subs-weekly)、[日本粉丝榜](https://cn.noxinfluencer.com/youtube-channel-rank/top-100-jp-all-youtuber-sorted-by-subs-weekly) | 分别增加“美国”“日本” | description 也随国家变化，canonical 各自指向本国路径 |
| [YouTube 美国涨粉榜](https://cn.noxinfluencer.com/youtube-channel-rank/top-100-us-all-youtuber-sorted-by-growth-weekly) | 涨粉最快的美国Top 100 YouTube网红排行榜 | 描述同步表达涨粉榜与美国范围，说明榜种也是区分维度 |
| [TikTok 美国粉丝榜](https://cn.noxinfluencer.com/tiktok-channel-rank/top-100-us-all-sorted-by-followers-weekly) | 美国 Top 100 TikTok网红排行榜 按粉丝数排序 | 标题含国家；description 是未带国家的通用 TikTok 描述 |
| [Instagram 美国粉丝榜](https://cn.noxinfluencer.com/instagram-channel-rank/top-100-us-all-sorted-by-followers-weekly) | Top 100 Instagram网红排行榜 按粉丝数排序 | 本次 title、H1、description 均未体现美国，canonical 仍是美国路径；记录为范围文案不一致，不由此推断结果过滤正确与否 |
| [旧 YouTube 全球视频榜](https://cn.noxinfluencer.com/youtube-video-rank)、[美国音乐视频榜](https://cn.noxinfluencer.com/youtube-video-rank/top-us-music-video-day) | 后者增加美国和音乐类 | title/description 随国家及分类变化；两页 keywords 相同，`og:url` 带分享来源参数。新榜不能照搬其旧 HOT 语义或 URL 追踪方式 |

抽查页面的 `og:title`、`og:description` 和 `twitter:title` 跟随各自标题/描述；未观察到频道榜输出 keywords 或 twitter:description。频道榜共用品牌分享图片，无须按国家强行区分图片。静态源码[频道榜 head](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol-next/components/channelRank/mixin.js:50) 传入 title/description、使用公共 SEO 构造器且设置 `suppressKeywords: true`，与本次输出一致；[Instagram 文案生成](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol-next/pages/instagram-channel-rank/_url.vue:132) 虽传入 country 参数，不能据此假定线上翻译模板实际使用了国家。

内置 Browser 读取仍超时后，回退 Playwright MCP，只读检查 YouTube/TikTok/Instagram 美国榜的浏览器 DOM head，观察结果与上述 HTTP 读取一致。TikTok/Instagram 在限定等待时间内未达 network idle，故这里只确认采样时的 DOM，不能宣称完成所有异步加载或交互验收。未执行登录、账号/租户/权限校验、列表接口同源读取或真实数据验证；没有修改线上、Demo 或生产代码。

新榜采用“固定入口分别生成 title/description，分享字段同步，canonical 对应本页”的规则，详见[榜单 SPEC 11.7.1](榜单页_SPEC.md#1171-seo-meta-按入口区分)。Google 对标题和描述有明确的页面相关性建议，同时不使用 meta keywords 参与索引/排名；这些是字段设计依据，不代表收录或流量保证。参考[标题指南](https://developers.google.com/search/docs/appearance/title-link)、[描述指南](https://developers.google.com/search/docs/appearance/snippet)、[meta 支持说明](https://developers.google.com/search/docs/crawling-indexing/special-tags)。


### 8.5 频道榜国家口径核查与本版决定

2026-10-27 用户确认新爆款榜沿用频道榜的频道国家/地区归属：按频道记录国家先筛作者，再取其有效爆款视频；全球不加国家限制，未知国家可在其他条件满足时进入全球，不进入具体国家榜。它不代表作者国籍、实际居住地或观众来源。业务对象已决定，真实字段来源、编码与关联仍需接入验证。

本次只读核查前端kol-next当前业务分支及新旧服务端本地master，不据此证明线上已部署：

| 源码证据 | 已确认的查询语义 |
| --- | --- |
| [前端国家参数](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol-next/store/channelRank.js:123)、[频道榜接口](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol-next/api/channelRank.js:16) | ALL在请求前被移除；按平台请求/ws/rank/{platform}/kol |
| [旧兼容入口](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/KOLServer/WebService/src/main/java/com/nox/kol/ws/upgrade/rank/KolRankingController.java:27)、[新服务条件](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol_server_v2/main.server/src/main/java/com/nox/kol/main/server/modules/ranking/service/KolRankingCriteriaService.java:28) | 本地当前兼容入口转发新main.server；country随请求进入provider查询，不从访问IP推国家 |
| [新查询](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol_server_v2/data.provider/src/main/java/com/nox/kol/data/provider/modules/ranking/service/KolRankingSearchService.java:115)、[字段常量](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol_server_v2/common/src/main/java/com/nox/kol/common/constant/ESFieldConstant.java:57)、[旧查询](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/KOLServer/Elasticsearch/src/main/java/com/nox/kol/elasticsearch/upgrade/service/rank/AbstractRankStarService.java:106) | 新旧查询均精确过滤榜单频道记录country；没有国家条件时不增加此过滤，非受众国家分布条件 |

查询层没有证明country最初由平台资料、采集还是推断生成；不能将它宣称为已核验居住地。频道详情库可能使用country_code，接入时需复用同一归属映射，不能把旧HOT的data_region照搬为该字段。本轮没有新增线上登录、权限、同源接口或字段回源验收，之前线上国家入口的meta证据见8.4节。

Demo显式维护独立频道国家资料creator.country：Milo Makes为未知国家，内容市场仍为US；其作品在全球显示地区“—”，在美国榜排除。地区控件、筛选摘要与显示均读取频道国家，保留市场作为独立样例字段；旧market URL不再转成country，移除时提示并保留其他有效条件。识别阈值和排序规则未因此改变。

2026-11-02当前评审提交为`3ac500453`，已推送`codex/viral-video-demo`。固定30天、仅国家/分类与平台切换，退休参数清理；51项浏览器检查、43条契约、43×5语言渲染、query回归与隔离检查通过，运行错误和生产业务请求均为0。旧截图及离线补丁已刷新，仍非生产数据/权限验收。