# 新增爆款视频榜单 SPEC

更新日期：2026-11-02。适用：桌面 Web。页面组织方向已确认；排序口径已确认为快照播放量降序、同播放量较新优先，再保持稳定ID顺序；地区已确认为频道国家/地区，真实字段映射及生产数据发布能力仍待接入。单视频AI推荐关键词及其搜索承接已确定本期不做，不保留入口或占位。本文定义应交付行为，当前 Demo 的差异列在末尾。

2026-11-02已确认：榜单仅保留平台切换、国家/地区与分类筛选，固定展示近30天发布的作品；取消内容形态、作者体量、发布时间、语言、推广属性、关键词及整个高级筛选区。计算仍区分内容形态，公共目标计算期限仍为90天，频道搜索的30/90天条件保持。

## 1. 页面目标与范围

让品牌在指定平台和内容范围中发现表现突出的作品，并从作品进入作者频道判断合作线索。一行代表一条视频；作品入选不等于作者合作效果或内容可复制。

- 本期只使用账号突破规则；不向用户展示该类型名、类型标签或类型切换，内部保留 `account_breakout` 标记；含义与结果契约统一引用[计算规则 SPEC](计算规则_SPEC.md)。监控近期识别／增长爆发为后续 TODO，不新增其他类别榜单、标签、筛选或占位。
- 沿用聚星现有导航、筛选和列表框架，保持“平台 → 范围筛选 → 结果上下文 → 单视频表格”的组织。
- 2026-10-27已确认：新榜单沿用现有榜单权限设定，游客/登录、套餐、可见条数及筛选范围以既有配置为准，不新增爆款专属权益或次数额度。真实配置映射及前后端一致执行需联调验收；本文不另造具体免费条数或套餐价格。
- 当前 Demo 仍在 `/youtube-video-rank?viralDemo=1` 展示三平台页签；正式新榜建议使用独立 `*-viral-video-rank` 路径族，保留旧 HOT URL，详见第 11 节待评审方案。新路由尚未实现或上线。
- 正式接入时明确旧 HOT 榜与新爆款榜的关系，不静默替换旧指标含义。旧榜兼容/重定向方案待路由评审。
- 不纳入作者聚合榜、连续上榜、名次升降、历史榜期、我的榜单、话题/音乐聚合、综合推荐分、预测或自动预警。
- 2026-10-27已确认：本期不额外建设新的榜单导出功能。其他模块已有导出只适配新增筛选范围，保留原模板与对象，不新增爆款字段，见其他模块SPEC第6节。

## 2. 页面结构

| 顺序 | 区域 | 展示与行为 |
| --- | --- | --- |
| 1 | 页面头部 | 面包屑、标题“爆款视频榜单”、一句说明与作者日常表现比较的用途说明、实际更新时间、“榜单说明” |
| 2 | 平台页签 | YouTube / Instagram / TikTok；沿用现有平台组织与图标 |
| 3 | 范围筛选 | 国家/地区、分类两个下拉框，无高级筛选 |
| 4 | 生效条件 | 原 Filter Summary，仅回显平台、国家/分类，支持单项移除与清空 |
| 5 | 结果上下文 | 当前列表总数、评估覆盖、截止时间、排序说明及更新异常；说明固定近30天发布 |
| 6 | 单视频表格 | 名次、视频、作者、播放量、点赞数、评论数、操作 |
| 7 | 分页/空态 | 沿用原组件，保留范围与上下文，不以普通视频补位 |

公共识别以日更为产品目标，允许随公共视频数据更新触发增量计算；不强制每日全量重算，也不承诺每条视频每天取得新快照。结果更新时间只说明发布/榜单更新，不能代替行内依据的实际采集与评估时间。计算可以增量，列表仍须固定版本/截止时间并稳定分页；新上下文按固定30天范围移出超窗作品，不依赖其再次采集。生产触发及发布延迟待研发落实，详见计算SPEC第3.5节。

结果上下文不提供“搜索更多同类视频”全局入口；单视频“AI推荐关键词”及相关内容搜索承接本期也不做，列表、更多菜单与相关复用区域均不留入口、禁用项或占位。保留作者、源站和监控等既定操作，见第7节。

### 2.1 向用户解释爆款口径

不新增完整说明区域或改变表格结构，复用标题下的一句用途说明及右上角“榜单说明”展开入口。

- **默认常驻**：“对比作者此前同一内容形式的视频，累计播放量达到历史中位数的 10 倍及以上。”核心规则不能仅藏在悬停提示中。
- **判定方式**：说明同作者、此前同一内容形式、累计播放和中位数；解释中位数是历史样本排序后的中间水平，不是平均值，且不含本条视频。
- **参与条件**：YouTube长视频需发布满7天，Shorts/TikTok视频/Instagram Reels需满3天，并有足够历史样本；未满时长是待观察，样本不足或关键数据缺失暂不判定，均不入榜。到达时长不代表立即重新采集或自动命中。
- **数据说明**：比较已采集的累计快照，不是同发布年龄的增速；点赞和评论不参与判定，倍数不代表榜单名次；按判定快照播放量降序，同播放量较新发布优先，只显示当前有效结果。
- **Demo 边界**：10倍和7天/3天为当前暂定口径，后续可调整；历史样本量仍未定。明确模拟数据不证明全量覆盖或及时更新，不额外编造未经确认的参数。正式版依据当前已启用规则展示实际阈值和参与条件，不输出“待研发确认”等过程文案；平台切换后说明与实际规则一致；形态仍由每条作品的内部判定配置区分。

时间范围说明固定为“展示近30天发布的作品”，不提供时间控件或90天榜；作者历史参考不受榜单窗口限制。后台90天期限仅控制目标计算，不用于扩展榜单。

“榜单说明”默认收起，通过键盘或点击展开/收起；`aria-expanded` 与内容显示一致。增加“时间范围”和“地区口径”段，说明频道国家、全球包含未知国家以及具体国家仅匹配已知归属；展开说明分段换行，使用现有次级文字与布局，不新增卡片、抽屉或营销式标记。切换说明不更改 URL、筛选、列表、识别状态或排序，也不发起业务请求。当前示例见[口径说明展开态](assets/榜单_口径说明.png)。

设计依据沿用第9节引用的设计规范 README、语义 token 和 Accessibility；代码为 Demo 分支的 `pages/youtube-video-rank.vue` 与 `components/viralVideoDemo/messages.js`。本轮仅在本地3323预览核对文案、键盘状态和布局，不代表线上发布或真实算法验收。

## 3. 入榜资格与排序

### 3.1 入榜资格

服务端对当前平台与固定结果上下文查询账号突破。只有适用、允许读取且 `qualified + fresh + valid`、发布于当前截止时刻前30天内的视频可入榜；状态与契约统一引用计算 SPEC。

固定窗口为连续30×24小时，含下界及截止时刻；不提供发布时间筛选，不允许旧90d/any/7d参数改变范围。清空恢复全球、全部分类及既定默认平台，榜单仍为30天。作者历史基准不受该窗口限制。发布后31—90天的公共目标仍可按计算SPEC计算，超过90天才停止自动首次判定及重算，已有历史结果保留；此规则不新增榜单控件或标签。

未达标、数据不足、待观察、未覆盖、过期、撤销、不适用或受限均不能入榜。没有结果不补成“未达标”或“待识别”。

榜单不提供普通列表的复杂识别状态筛选，也不提供与入榜资格必然冲突的未覆盖、数据不足或待观察选项。评估范围与覆盖限制保留为结果说明，不另建筛选维度。

### 3.2 排序与名次

- 资格决定能否入榜，排序决定名次。已确认按判定快照累计播放量降序；同播放量优先发布时间较近的视频，仍相同以平台原生视频ID固定字典序升序，倍数不参与名次。
- 正式列表由服务端返回账号突破的顺序、分页与名次，使用已发布的排序策略版本与 `rankKey`。前端不重排、不从播放量/倍数重算名次。
- 2026-10-27 已确认上述业务顺序。名次为当前筛选范围内的连续序号，跨页延续，不显示并列名次。服务端稳定分页、排序键编码及缺键异常仍需联调验收；Demo 用固定键模拟已排序的结果，不能将其编码直接搬作生产实现。
- 页面“排序依据”直接说明“按判定快照累计播放量降序，同播放量优先发布时间较近的视频；仍相同时保持固定顺序”，不再对用户展示“按模拟排序键降序”。
- 不在跨平台、不同用途、不同观察范围或不兼容版本间比较名次。切换平台后从第一页重新展示。
- 首期播放、点赞、评论表头不提供自由排序；按原指标查找通过视频搜索完成，搜索顺序不保证复现榜单名次。
- 更新采用实际成功发布的结果；刷新只取结果，不触发采集/重新计算。每日更新、实时更新等频率须有服务端 SLA 后才能对外承诺。

## 4. 筛选与上下文

### 4.1 条件语义

| 条件 | 要求 |
| --- | --- |
| 平台 | 独立页签；切换时保留仍受支持的国家/分类，否则说明后移除，并回到第一页 |
| 频道国家/地区 | 沿用频道榜中频道记录的国家归属；全球不加国家限制，未知国家仅进全球；不与内容市场、受众地区或视频语言映射 |
| 分类 | 使用结果服务声明的内容分类，缺失/不支持不暗中转为其他分类 |
| 固定发布时间窗口 | 近30天发布，无筛选控件；按固定截止时点回推，不代表快照采集时间，也不更改历史基线 |

旧链接仅恢复合法平台、国家、分类及分页。`contentType/creatorSize/publishedRange/language/promotion/keyword`及旧`batchId`等退休参数从URL和摘要移除，不作为隐藏过滤继续生效；旧90d统一回固定30天。非默认旧条件被移除时用现有轻提示说明范围已调整；不恢复高级筛选或抽屉。改变实际国家/分类/平台回第一页，单纯兼容清理可保留合法分页。内部`batchId/resultVersion`及固定上下文继续保存，用户只见实际更新和截止时间。

所有条件在服务端按约定组合并过滤后分页；改变条件回到第一页。生效条件在摘要中完整显示，移除后结果/URL/分页同步更新。加载失败保留用户当前条件供重试，不静默清空。

### 4.2 覆盖率与结果数

“已评估”表示完成账号突破的有效评估，“命中/已入选”表示达到账号突破条件。用户文案不得把二者都叫“已识别”。

以当前平台、频道国家/地区、分类及固定近30天发布时间定义业务范围 S；不先以“已命中”缩小 S。

- 服务端在 S 中按平台+视频 ID 去重，并先执行权限裁剪。
- `eligible`：S 内账号突破可适用的视频数。不适用对象排除；待识别、不足、未覆盖、过期/撤销留在适用分母中。无法知道全量适用数时返回未知，不用已加载页数代替。
- `evaluated`：S 内账号突破结果新鲜、有效且已判定为命中或未达标的视频数。
- `hits`：S 内账号突破当前有效命中的视频数。该计数与可入榜列表总数分开；缺少兼容排序键的有效命中仍计入 `hits`，但不能入榜。仅在排序数据完整可用时二者才可能相等。
- 覆盖率 = `evaluated / eligible`，由服务端返回；未知或零分母显示“—”。前端不从分页数据推算。
- 单记录 `coverageStatus=full` 仅表示账号突破纳入服务，不等于数据充分或业务范围已完整评估。

界面优先显示“共 N 条入选视频 · 数据截至……”。覆盖率旁用轻量说明解释“已评估 E / 适用 A；命中 H”，避免所有计数常驻抢占主阅读路径。未知分母同时说明“覆盖范围暂不可确认”。

## 5. 视频表格与下一步操作

| 列 | 展示要求 | 操作 |
| --- | --- | --- |
| 名次 | 服务端返回当前筛选范围的连续名次，跨页延续；同值已按发布时间和稳定ID分出顺序，无并列名次 | 无升降/新上榜标记 |
| 视频 | 原平台封面、标题、形态、发布日期；标题最多两行 | 新标签页打开源站原视频，保留榜单条件与位置 |
| 作者 | 头像、名称、粉丝数、频道国家/地区（未知显示“—”） | 进入现有频道内容页 |
| 播放量 | 主行本条播放量与已提供的倍数；次行“历史中位数 + 基准原值”，不新增列 | 悬停/键盘聚焦查看样本与比较范围；不自由排序 |
| 点赞数/评论数 | 与播放同一声明快照；缺失“—”，真实零显示 0 | 不自由排序 |
| 操作 | 更多 | 提供加入现有内容监控；本期不提供AI推荐关键词；原视频入口与内容链接合并 |

- 不设置整行点击；作者、视频和更多动作彼此独立。
- 作者频道国家未知显示“—”，禁止用内容市场、受众地区、语言或访问IP补齐；频道国家不解释为作者国籍或实际居住地。
- “账号突破”只表达相对作者常态的突出表现，不合成总分或作者等级。该名为研发内部定义；榜单所有记录都已入选，不单列“爆款判定”或逐条重复标记，移除榜单“查看依据”入口及抽屉，比较范围与样本放在行内基准说明中。
- 播放量单元格维持两级信息：主数值按原正文样式，倍数用小号品牌色弱强调；历史中位数用次级文字，数值等宽对齐，不新增进度条或独立类型列。例：“980,000  20× / 历史中位数 49,000”。这些数字为模拟示例，不是正式阈值。
- 本期计算使用中位数，界面不能改叫“频道平均值”。悬停或键盘聚焦基准行说明：同频道、此前同形态作品的累计播放中位数、样本量、不含本条、使用判定快照；采集时点可能不同，不是同龄对比或频道全部作品平均值。说明入口有明确焦点态。
- 榜单行内对照与其他模块的依据读取相同上下文的 `evidence.baseline.medianViews`、`multiplier` 和样本信息。基准必须为服务端已授权的有限正值，作者/形态一致；过期/撤销/受限不继续展示当前对照。基准缺失时显示“基准未提供”，不从播放量和倍数反推；倍数缺失仅隐藏倍数，不隐藏已有有效中位数。该展示缺失不改写判定状态，正式接口需保证可用证据一致。
- 短对照只用服务端可公开证据。账号倍数需有效正基线与符合最低发布时长及快照政策的历史样本，不再要求同龄匹配。未提供时说明“当前未提供该项对照”，不补百分比、门槛或图表。
- “为什么入选”和“为什么排在前面”分别说明。累计播放快照决定主排序，突破倍数解释入选；不以倍数冒充排名依据。
- 原平台与监控继续原权限、项目选择和配额链路；查看行内说明或改变筛选不创建任务、不扣配额、不触发 AI。加入监控不自动触发公共爆款重算，不承诺早期识别或立即获得新判定。

榜单当前参考：[列表](assets/榜单_列表.png)、[内容链接示意](assets/榜单_源站跳转示意.png)、[累计快照基准说明](assets/榜单_累计快照基准说明.png)。Demo 点击标题/封面仅展示正式版的源站新标签页跳转方式；不实际打开模拟作品的源站搜索页。作者入口提示正式版进入聚星频道详情；“更多”不再重复原平台查看。旧 `evidenceVideoId` 仅作为过期参数移除，保留其它筛选，不再恢复抽屉。

## 6. 共用“识别依据”抽屉

**本节仅供搜索、频道、内容监控与品牌等其他模块的状态解释参考，榜单不再挂载此抽屉，也没有查看依据入口。**

默认先回答“是什么作品、是否突破作者常态、与谁比较”，具体结构如下：

1. 固定标题“识别依据”和关闭按钮，合并视频/作者身份。
2. 一句话结论，如“已入选爆款”；不展示判定类型名。下方直接解释相对作者常态的表现与当前状态。
3. 播放、点赞、评论三个主要指标，附快照观测时间。
4. “比较范围与数据说明”默认收起，不再按类型增加小标题，包含比较对象、历史播放中位数、样本量、补充互动、观察及评估时间、限制。
5. 批次、算法/结果/排序版本位于第二级“版本信息”，默认收起。
6. 固定底部：查看作者频道为主操作，原平台查看、加入监控为次操作；正文独立滚动。

保留的独立组件历史参考图（仅看其他模块的状态解释结构，并非当前榜单；图中旧样例数字及同龄表述早于本次口径调整，不作为当前判定或数据条件的依据）：[概览](assets/识别依据_概览.png)、[数据不足](assets/识别依据_数据不足.png)、[展开详情](assets/识别依据_展开详情.png)。已移除旧来源视角图，不保留多判断展示。

- 只有新鲜且有效的命中用“已入选”。失效、数据不足、待识别、不适用、未覆盖与受限分别解释，不合并成未达标。
- 账号突破有效且新鲜的未达标才可说明未达标；未纳入结果服务时说明未覆盖，纳入服务但不足时说明数据不足。
- 原因码仅转为已审核的用户文案；未知码不显示翻译键，也不回退成“符合条件”。无权限不得下发隐藏指标、样本、基线、队列或内部原因码。
- 列表成功而依据请求失败时保留列表，抽屉显示失败与重试；不能把请求失败写成未覆盖。
- 折叠支持键盘 Enter，状态不只靠颜色；关闭后保留原条件、页码与位置；重新打开默认收起详情。
- 生产展示不含模拟字样；本地 Demo 保留“模拟数据，算法未冻结”，模拟作品的原平台搜索链接不冒充真实作品链接。

## 7. 跨页操作与返回

2026-10-27已确认：本期不交付单视频AI推荐关键词、提词确认或推荐词搜索承接。列表、更多菜单、相关复用区域均删除该入口，不留禁用按钮、说明弹窗、“敬请期待”或空占位；不以无关键词搜索或旧“搜索更多同类视频”替代。原视频/频道搜索的关键词及既有频道搜索AI功能保持原样；榜单不提供关键词筛选。

- 内容标题/封面：正式版在新标签页打开真实源站作品，保留当前榜单；Demo只解释跳转方式。
- 作者信息：正式版进入聚星作者频道详情，沿用原权限；Demo保留只读提示。
- 加入监控：沿用原项目选择、权限和配额；Demo只提示范围，不创建任务或写模拟存储。
- 进入作者或监控后返回，保持原榜单的平台、有效筛选、页码、位置和结果上下文；不把另一页面的条件覆盖回榜单。站内返回地址须合法，不能接收站外目标。

关于AI提词的历史实验与复用方向，仅保留在[结论汇总](保留结论汇总.md#单视频-ai-推荐关键词的决策依据)，不作为本期研发契约或待启用能力。当前操作菜单见[截图](assets/榜单_操作菜单.png)。

## 8. 加载与异常状态

| 状态 | 页面行为 |
| --- | --- |
| 加载中 | 保留筛选与表头，显示 loading，不闪成 0 条 |
| 正常空榜 | 有可用评估范围但无有效命中：“本范围暂无符合条件的视频”，可调整筛选；不展示无源视频的 AI 推荐入口 |
| 整体未覆盖 | “该范围暂未完成识别”，说明覆盖限制并保留调整范围/返回能力；不称无爆款，不以空关键词跳转补位 |
| 范围未完整评估 | 展示已确认的命中与全范围评估说明，未评估对象不当作未达标；此说明不使用单记录覆盖枚举 |
| 批次延迟 | 保留可用成功批次并标明实际截止时间与延迟；服务端明确批次不可用时说明异常，不以旧数据冒充新批次，也不按单条快照年龄自动过期 |
| 查询失败/批次不可用 | 显示失败与重试，保留条件；不返回普通视频或空数组假装成功 |
| 无权限 | 明确权限提示，先裁剪再汇总，不泄漏隐藏数量和依据 |
| 上下文过期/权限变化 | 提示重新查询，不能静默混合另一批次的名次或证据 |

## 9. 设计与实现依据

采用[设计规范 README](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol2.0-design-specification/README.md)、[语义 token](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol2.0-design-specification/playbook/semantic-tokens.md)、[表格](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol2.0-design-specification/playbook/components/table.md)、[筛选摘要](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol2.0-design-specification/playbook/components/filter-summary.md)、[标签](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol2.0-design-specification/playbook/components/tag.md)、[按钮](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol2.0-design-specification/playbook/components/button.md)、[轻提示](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol2.0-design-specification/playbook/components/tooltip.md)和[可访问性](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol2.0-design-specification/playbook/accessibility.md)。保持原页面密度，指标使用等宽数字，标题与操作不无限压缩；长文案允许合理换行，采用既有焦点/禁用/减弱动效状态，不新增视觉 token。移动端、完整五语言与多地区权限另验收。

代码归档：`Influencer/Client/kol-next`的远端分支`codex/viral-video-demo`，已推送评审提交`3ac500453`（2026-11-02）；基线为`uat`的`e7bd23838`。分支推送不等于部署或生产验收。

Demo 范围仅限榜单。单视频AI推荐关键词本期不做，已移除菜单及对应说明。标题与封面只显示源站新标签页跳转示意；作者频道和加入监控仍提示“本 Demo 不演示后续流程”，不跳转其它模拟页面或创建模拟监控。正式产品的跨模块承接仍按本 SPEC 和《其余功能模块修改 SPEC》实施。

代码入口（均为当前本地实现依据，不证明线上已接入）：

- [榜单页面](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol-next-viral-video-demo/pages/youtube-video-rank.vue)：平台、账号突破、条件、上下文和跳转。
- [表格](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol-next-viral-video-demo/components/viralVideoDemo/ViralTable.vue)、[依据抽屉](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol-next-viral-video-demo/components/viralVideoDemo/ViralEvidenceDrawer.vue)：单视频呈现；抽屉组件仅为其他模块隔离参考，榜单不消费。
- [本地结果适配器](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol-next-viral-video-demo/components/viralVideoDemo/data/adapter.js)：固定样本用于契约验证，模拟前端排序不得进入生产实现。

真实环境边界：已记录的本地 1440×1000、1280×900 抽屉检查说明当前布局可用；当时使用模拟数据、临时本地预览会话，不代表生产权限/数据/排序通过。2026-11-02已对照线上YouTube视频榜及四平台频道榜筛选组织；不代表新爆款服务已上线。正式导航、真实 API、聚合性能、全量覆盖和刷新 SLA 均待联调。

2026-11-02筛选组织的设计-代码-线上校验：在内置浏览器及Chrome连接超时后，使用Playwright MCP只读访问中文站。旧[YouTube视频榜](https://cn.noxinfluencer.com/youtube-video-rank)为地区＋分类；YouTube频道榜为地区＋Nox分类＋YouTube分类；Instagram频道榜为地区＋Nox分类；TikTok频道榜仅地区；Twitch频道榜为分类＋语言。与只读源码 `kol-next/pages/youtube-video-rank.vue` 的 `.filter-section`、`components/channelRank/const.js` 的 `platformFilterOptions` 及 `rankList/index.vue` 一致。平台和榜种切换属于导航，不计入范围筛选。当前新榜按视频榜的轻量结构仅保留国家/分类；国家沿用已确认的频道归属，分类仍按结果服务口径，不直接混用不同榜单的分类对象。本次只核查可见页面组织，未核验具体账号、租户、套餐或私有接口，不证明新榜已经上线。设计依据仍为本节Filter Summary、Table及Accessibility，未增加样式token。

AI 推荐的设计-代码-线上校验：静态源码 `kol-next/components/searchV2/SearchBox/aiSuggest.vue` 与 `api/search/inputOption.js` 已接入 `/ws/{platform}/star/ai/keywordExpansion`；旧服务 `KeywordExpansionParam` 包含 `videoIds`，三平台搜索服务会取视频标题/描述及标签。现有 Prompt 侧重扩词找作者，视频场景的提取、限定词保留与弃权需另行适配。2026-10-23 三平台真实视频搜索已通过 Playwright MCP 同源读取，取得 30 条源视频及 2,203 条检索结果；该实验没有调用现有 AI 推荐接口，不构成此功能的效果、权限或配额验收。该AI方向已移出本期，以上仅作历史研究事实，不列为本期联调或验收。具体视觉沿用本节引用的Button/Filter Summary，未新增布局和token。

## 10. 验收与当前 Demo 差异

| 验收项 | 要求 / 当前状态 |
| --- | --- |
| 页面组织 | 保留已确认的结构和真实路由，其他模块按[其余模块 SPEC](其余功能模块修改_SPEC.md)增量接入 |
| 账号突破 | 只允许当前有效且具备兼容排序键的账号突破入榜；本地 Demo 已隐藏判断类型名称、类型列与类型标签；内部类型键保留 |
| 真实名次 | 业务顺序已确认：快照播放量降序→发布时间较新优先→稳定ID；Demo固定键及同播放量较新优先样例已对齐，生产分页仍待接入 |
| 样例一致性 | 本地13条命中样例已以固定历史中位数和10～38倍证据对齐当前暂定10倍口径，含10倍边界；播放量/中位数与倍数一致。10×后续可调；累计快照比较已确认，最低发布时长已暂定7天/3天，历史样本量和快照来源/质量仍待确认；快照不设时间TTL、目标超90天停止自动计算的任务规则仅为SPEC交付，固定排序键已对齐确认顺序，不以倍数排名；同为10万播放的样例用较新发布时间验证次序 |
| 覆盖统计 | 全范围 `eligible/evaluated/hits` 及未知原因；Demo 尚缺完整分母解释 |
| 固定范围与旧链接 | 2026-11-02确认固定近30天发布，仅平台、国家/分类；31—90天命中样例不入榜。旧高级及时间参数移除，不作为隐藏过滤；生产服务端固定范围仍需接入 |
| 地区 | 已确认按频道国家；Demo使用独立creator.country筛选和展示，不回退scope.market，含未知国家仅进全球榜样例。真实频道字段关联仍需接入 |
| 本期操作范围 | AI推荐关键词和相关搜索入口/占位均不存在；保留既定作者、源站与监控操作，不发起推荐生成 |
| 无覆盖空态 | 本地 Demo 已移除覆盖状态筛选；旧 URL 有效条件移除会提示。真实无覆盖、无命中及失败响应仍待服务端接入 |
| 依据展示 | 榜单已改为行内中位数/倍数及样本说明；移除查看依据和抽屉。其他模块继续按第6节处理状态解释 |
| 边界与回归 | 生产真实路由消费真实结果并允许显示新标签；本地 Demo 的 mock 隔离单独验收，不能把标签永久限制在 Demo 参数后 |
| 业务操作 | 监控/导出仍使用现有权限与配额；本地模拟操作不能作为真实写入成功证据 |

完整跨模块结果与异常契约引用计算 SPEC；当前数据条件、未决事项及保留结论见[保留结论汇总](保留结论汇总.md)。以上差异是待研发完成的验收要求，不因本次文档整合宣称已修复代码。


## 11. SEO 多入口拆分方案（2026-10-26，待评审）

### 11.1 决策范围与现状依据

本轮已确定沿用聚星“同一榜单页面、国家筛选对应独立URL及SEO表达”的思路。2026-10-27收敛：全站只增加三平台全球入口，国家切换复用页内筛选，不新增国家快捷导航、固定首批六国或21页候选要求。以下具体路由命名、真实字段映射及索引发布规则仍需研发/SEO核对，不代表功能已实施或保证收录。本节仅补充SEO入口方案，不改Demo路由及线上现有榜单；判定与排序统一引用第3节和计算SPEC，不由各SEO入口另行定义。

三平台各提供全球默认榜，页内国家选择产生对应国家范围的URL、标题和描述；分类继续用页内筛选，不提供其他高级条件。复用同一页面模板和公共结果协议，路由支持范围与索引发布配置分别维护，不逐国复制页面。

| 核查项 | 已确认事实与本次应用 |
| --- | --- |
| 现有导航组织 | 源码一级导航按平台提供少量榜种入口；国家由榜单页继续选择。新榜一级入口也按平台组织，不把所有国家都塞入总导航 |
| 现有国家路由 | 三平台频道榜国家/分类/排序/周期写入路径；旧 YouTube 视频榜使用 `/youtube-video-rank/top-{country}-{category}-video-day[-date]`。复用固定条件路由模式，新增独立新榜前缀 |
| 旧榜语义 | 旧 YouTube 视频榜公开页面仍是 Daily hot / Most Viewed in 24 hours；新榜是相对作者历史常态的突出表现，不能把旧 URL 直接改成新算法含义 |
| 现有 sitemap | 当前前端源码仅将四个平台全球默认频道榜列入频道榜 sitemap 白名单；国家路径存在、允许索引与已进入 sitemap 是三件事。新榜需新增自己的入口注册及 sitemap 清单 |
| 国家字段 | 新旧 HOT 查询按 `data_region` 过滤、旧 `video_score` 排序，不能由参数名 country 推断就是作者所在地。新榜已确认沿用频道榜的频道国家归属，真实字段映射需核对 |

具体源码、公开页面与浏览器核验边界见[保留结论汇总第 8 节](保留结论汇总.md#8-seo-入口拆分的核查结论2026-10-26)。

### 11.2 全站入口与国家筛选的范围

2026-10-27已确认采用最小追加：

| 部分 | 本期范围 |
| --- | --- |
| Header / Footer | YouTube、TikTok、Instagram各一个全球爆款榜入口；不铺国家链接 |
| 榜单页内 | 沿用现有国家/地区下拉筛选，不新建国家导航条、快捷链接区或国家入口门户 |
| 国家URL与SEO | 支持国家筛选对应可恢复的URL，并同步title、description、H1及实际结果；国家支持范围依据原国家数据与接口能力，不固定为六国 |
| 索引发布 | 真实字段、固定30天供给及SEO规则核对后按可用性配置；可筛选、路由可用和可索引是不同条件，不要求固定国家数量或页面总数 |

前一版固定首批六国、最多21个候选入口的建议已撤回，不作为交付或评审必决项。国家数据未可靠接入时不提供看似有效的国家筛选或国家URL；可用全球榜仍按其开放条件提供。分类、国家×分类、形态等独立SEO入口不在本期额外扩展。

### 11.3 国家含义与数据前提

**2026-10-27 已确认：沿用频道榜的频道国家/地区归属。** 新增榜单筛选明确标为“频道国家/地区”。先圈定归属匹配的频道，再查询这些频道的有效爆款视频；例如美国榜表示频道记录国家为US的作品，不解释为作者国籍、实际居住地、观众来源或内容发生地。

业务对象已确认，不再作为待评审取舍；仍须研发对齐频道榜国家字段与视频作者关联、来源和可用性，才能启用生产国家筛选及SEO入口。已核查频道榜新旧查询均过滤频道记录的country；详情库字段可能叫country_code，需显式映射。不得把旧HOT的data_region或视频内容市场当作该字段。Demo已使用独立固定频道资料creator.country，scope.market保留为不同对象，不再用于榜单国家筛选或展示兜底。源码证据见[结论汇总8.5](保留结论汇总.md#85-频道榜国家口径核查与本版决定)。

- 国家未知的作品可在适用且有效时进入全球范围，不分配到某个国家；频道国家未知继续显示“—”。
- 国家筛选不改变作者历史基线或判定；频道信息、列表、计数与结果上下文应一致，不能翻页时临时换用另一版本的频道地区。
- 当前筛选示例见[频道国家筛选](assets/榜单_频道国家筛选.png)。Demo旧market查询不是频道国家同义参数：移除非默认market时明确提示重新选择，保留合法country及其他筛选。不得静默把旧市场条件当作频道国家；正式旧HOT页面不受此兼容处理影响。
- 全球指没有国家限制的已覆盖公共结果，不承诺覆盖全网；同一全球 URL 不因访问 IP、登录账号、站点语言或历史偏好改变默认国家。
- 前端、结果查询、聚合分母、排名、SEO 标题及缓存键必须使用同一国家范围。切换国家只筛选结果，不能更换作者历史基线或重算阈值。
- 规范国家码建议使用 ISO 两位码，路径小写；英国使用 `gb`，展示可用“英国 / UK”。如实际服务仍需 UK，必须在接口适配中显式映射；新路径 `uk` 仅作为别名重定向到 `gb`，不更改旧 HOT 路径。
- 站点语言与内容语言分开：英文站的日本国家榜仍是日本作者范围，不自动附加“视频必须英语”。本榜不提供内容语言筛选。

### 11.4 新榜规范路由（拟定）

| 页面 | 拟定规范路径 | 中文 H1 示例 |
| --- | --- | --- |
| YouTube 全球榜 | `/youtube-viral-video-rank` | 全球 YouTube 爆款视频排行榜 |
| YouTube 美国榜 | `/youtube-viral-video-rank/top-us-all-video` | 美国 YouTube 爆款视频排行榜 |
| YouTube 日本榜 | `/youtube-viral-video-rank/top-jp-all-video` | 日本 YouTube 爆款视频排行榜 |
| TikTok 全球榜 | `/tiktok-viral-video-rank` | 全球 TikTok 爆款视频排行榜 |
| TikTok 美国榜 | `/tiktok-viral-video-rank/top-us-all-video` | 美国 TikTok 爆款视频排行榜 |
| Instagram 全球榜 | `/instagram-viral-video-rank` | 全球 Instagram 爆款视频排行榜 |
| Instagram 美国榜 | `/instagram-viral-video-rank/top-us-all-video` | 美国 Instagram 爆款视频排行榜 |

其他受支持国家沿用同一模板：`/{platform}-viral-video-rank/top-{country}-all-video`。`all` 为分类保留位，本期路径只开放这个分类值；后续分类入口另行评审。大小写、尾斜杠及全球长路径别名统一重定向到唯一规范形式，例如 `top-all-all-video` → 平台根路径。

- 不写 `top-100`、`daily`、`24-hours` 或日期段：当前未承诺每榜固定条数、日更 SLA 或早期识别。
- 不把 `account_breakout`、`batchId`、结果版本写进 SEO 路径，也不向用户展示类型名。稳定入口始终读取当前成功且有效的公共结果。
- `/youtube-video-rank` 及其 `top-…-video-day` 系列继续保留旧 HOT 含义。新旧榜可用“相关榜单”互链，不互相做 canonical 或直接 301。
- 当前本地 Demo 继续使用 `viralDemo=1`、保持 noindex，不因提出新路径就解除开发开关或生产隔离。

### 11.5 入口与筛选的衔接

1. **一级导航**：在对应平台下增加“爆款视频榜”入口，先落到该平台全球榜；不新增“账号突破榜”等类型入口。
2. **国家筛选**：沿用现有榜单国家/地区下拉；不新增六国快捷链接、国家导航条或独立门户。选项根据实际支持的国家范围提供。
3. **国家URL与标题**：国家切换后恢复对应范围，地址、title/description、H1与列表一致，不要求另建可见国家入口。直接进入国家URL时固定近30天，不附加隐藏关键词或其他退休条件。
4. **筛选控件**：改变国家时保留受支持的分类，以“国家路径 + 分类query”恢复；分类非默认时按分类筛选结果页处理，不冒充纯国家SEO页。摘要仅显示实际国家/分类。
5. **切换平台**：国家和分类受支持时保留；未有该国家独立 SEO 入口、但接口支持该国家筛选时，可保留为不索引的 query 结果，不为跳到静态入口而擅自清空条件。不支持的条件明确提示后移除。
6. **URL 恢复**：已有独立 SEO 路径的仅含国家的 query 同义入口归一到该规范路径；尚未登记独立路径、但接口支持的合法国家继续保留 query，不执行到不存在路径的重定向。路径国家与 query 国家冲突须明确报错/提示纠正，不静默忽略有效条件。无意义默认参数及追踪参数归一不改变结果范围。
7. **站内互链**：复用现有导航和相关榜单位承接三平台全球榜；回到全球通过原国家筛选选择“全球”。不额外增加国家快捷区或跨平台同国链接区，不改变旧页面默认结果。

交互继续沿用现有表格、筛选摘要和链接的语义 token、焦点状态与键盘行为。设计依据见第 9 节的设计规范 README、Filter Summary 与 Accessibility 引用，不新增一套榜单 UI。

### 11.5.1 Header / Footer 新榜单入口追加方案（2026-10-27）

本方案按用户提供的桌面截图、当前前端源码及线上首页DOM核对制定，交付范围是导航追加规格，尚未改造线上或本地Demo的全站导航。正式路由命名、国家字段映射及SEO索引白名单仍按本节各自评审状态处理；国家筛选不额外增加固定国家入口清单。

**参考复用规则**

- 参考：[Header用户截图](assets/导航_Header_用户参考.png)、[Footer用户截图](assets/导航_Footer_用户参考.png)。两图是现状参考，不是已经实现的新增入口截图。
- 必须复用：Header现有“网红排行”展开菜单的五列和平台顺序（YouTube、TikTok、Instagram、Twitch、TT Shop），Footer现有“网红排行”栏目及按平台连续排列的链接；沿用原字号、行距、列宽、悬浮/焦点状态和区域显隐，不增加独立门户、卡片或新一级导航。
- 按当前对象调整：前三个平台各增加一个全球爆款视频榜入口；Header平台分组同时容纳频道榜和视频榜，四个平台分组后缀统一由“网红榜单”简化为“榜单”（保留各平台Logo）；顶层“网红排行”和Footer栏目标题维持现有称呼，TT Shop分组标题维持原样。仅调整Header这处用途，不能直接全局替换共享翻译key影响其他页面。
- 不照搬：旧榜链接中的TOP100、增长、互动或国家文案不作为新榜固定条数、算法或国家范围的承诺；不新增Twitch爆款或TT Shop爆款入口，不把旧HOT入口改指新榜。

**Header：各平台原有两项之后追加第三项**

| 分组 | 原有入口（保留） | 追加入口 |
| --- | --- | --- |
| YouTube 榜单 | TOP100 YouTube网红排行榜 → YouTube网红增长排行榜 | YouTube 爆款视频排行榜 |
| TikTok 榜单 | TOP100 TikTok网红排行榜 → TikTok美国网红排行榜 | TikTok 爆款视频排行榜 |
| Instagram 榜单 | TOP100 Instagram网红排行榜 → Instagram美国网红排行榜 | Instagram 爆款视频排行榜 |
| Twitch 榜单 | 原两项及其顺序 | 本期不追加 |
| TT Shop | 原三项及其顺序 | 本期不追加 |

保持五列，仅前三列各加一条普通文本链接；新链接使用与同列现有项相同的层级和样式，不单独加NEW、热度标识、分割线或“视频榜”子分组。前三列由两项变三项，已有TT Shop列也是三项，复用当前菜单高度与自适应布局，实际CSS和多语言换行需实现时验证。

**Footer：在同平台最后一项后插入，按平台保持连续**

| 顺序 | “网红排行”栏目中的链接 |
| --- | --- |
| 1—3 | YouTube 粉丝排行榜 → YouTube 涨粉排行榜 → **YouTube 爆款视频排行榜（新增）** |
| 4—6 | TikTok 粉丝排行榜 → TikTok 互动排行榜 → **TikTok 爆款视频排行榜（新增）** |
| 7—9 | Instagram 粉丝排行榜 → Instagram 互动排行榜 → **Instagram 爆款视频排行榜（新增）** |
| 10—11 | Twitch 粉丝排行榜 → Twitch 热门游戏榜 |

栏目从8条变为11条，自然增高，不改变Footer其他栏目位置，不压缩文字/行距以强行保持旧高度，不增加第二个“爆款排行”栏目。Header与Footer三个新入口使用完全相同的平台名称和“爆款视频排行榜”文案。

**统一跳转与开放条件**

| 入口文案 | 目标范围 | 拟定目标路径（正式路径仍按11.4评审） |
| --- | --- | --- |
| YouTube 爆款视频排行榜 | YouTube全球榜，固定近30天 | `/youtube-viral-video-rank` |
| TikTok 爆款视频排行榜 | TikTok全球榜，固定近30天 | `/tiktok-viral-video-rank` |
| Instagram 爆款视频排行榜 | Instagram全球榜，固定近30天 | `/instagram-viral-video-rank` |

- 两处入口始终进入对应平台的全球默认榜，不按IP或上次浏览记录改成国家榜，不继承隐藏关键词或其他退休筛选；站点语言按现有站内路由规则保留。
- 各平台国家范围由榜单页内原国家筛选承接。全站Header/Footer仅新增3种平台全球榜入口，页内也不新增固定国家快捷链接区；国家URL及SEO表达保留。
- 新平台榜未正式就绪时，Header与Footer同步不展示该平台新入口；正式入口不得跳向Demo参数、旧HOT、空壳或404。路由功能开放与SEO索引白名单分别管理，不因尚未索引便禁止正常功能访问。
- 新入口的游客、登录及套餐行为继承现有榜单设定；保持现有Header/Footer所在区域的地区/部署显隐。源码中的`!isCN()`不能直接解释为简体中文或cn域名，实际环境配置需核对，不借此扩开原先隐藏的导航区域。
- 复用原文本链接交互；语义链接和真实目标地址可被读取，支持键盘焦点、Enter访问及既有展开/收起行为。新增链接不得只能靠hover才可操作，字体、间距与状态使用既有样式，不从SaaS侧栏尺寸推导营销站导航尺寸。

**设计规范引用**

采用[设计规范README](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol2.0-design-specification/README.md)、[Navigation](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol2.0-design-specification/playbook/components/navigation.md)、[语义token](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol2.0-design-specification/playbook/semantic-tokens.md)与[Accessibility](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol2.0-design-specification/playbook/accessibility.md)的层级、短文案、文本/交互语义及焦点规则。Navigation/Layout中的后台侧栏尺寸不适用于本次营销站Header/Footer；本次复用现有`.kol-list/.kol-item`、`.link-list/.link-item/.link`对应样式，不发明新视觉值。营销站专用的精确样式、不同语言换行及窄屏布局仍需实现时实测。

**设计-代码-线上校验**

| 来源 | 已核对内容与边界 |
| --- | --- |
| 用户截图 | 桌面Header五列，前三平台各两项、Twitch两项、TT Shop三项；Footer网红排行8条，与本方案的插入位置一致 |
| 当前代码 | `kol-next/components/layout/landing/header.vue`约176—304行；`footer.vue`约87—162行。只读核对分组、链接及`!isCN()`容器；当前主仓分支为`codex/752-brand-reputation-radar`，本轮未改动 |
| 线上实读 | 2026-10-27，`https://cn.noxinfluencer.com/`，zh-CN。内置Browser与Chrome控制读取分别超时后，通过Playwright MCP新开首页，只读DOM确认Header/Footer公开链接，见[导航现状证据](assets/导航现状_2026-10-27.json)。页面出现“进入工作台”，但未核验具体账号、租户、套餐及受限访问行为；本次不涉及私有接口 |
| 已见差异 | Header的“TikTok美国网红排行榜”“Instagram美国网红排行榜”实际分别指向全球`all-all`互动排序URL，Footer相应文案为互动排行榜。属于既有文案/目标差异，本轮保留原项；新爆款文案、范围及URL必须一致，不能照此误映射成美国页。源码展开触发主要为mouseover/mouseleave，键盘展开尚未验证，实施时需保证触发器及新增链接键盘可达，不将现状当作已通过可访问性验收 |
| 移动端与多语言 | 存在独立`header-mobile.vue`、`footer-mobile.vue`；源码移动版保留旧`/youtube-video-rank`入口，不能替换为新榜。当前方案和截图以桌面Web为准，移动版如纳入本期需按原折叠/平铺结构追加对应入口，单列验收；本次未验证移动端或五语言视觉，不能直接套用桌面五列 |

验收：三平台各1个入口同时出现在Header与Footer、顺序及文案一致；默认全球近30天；关闭平台入口时两处同步；旧链接保持；站点语言、地区显隐、登录/套餐继承正确；键盘可达；桌面常见宽度与五语言不截断、不覆盖其他列；国家筛选不会扩展成新的全站或页内国家导航条。以上为交付要求，未实施或宣称线上改造完成。



### 11.6 哪些页面可索引

| URL 类型 | 首期策略 | canonical / sitemap |
| --- | --- | --- |
| 已登记且审核通过的平台全球页、国家页 | 可索引；SSR 输出该范围的公开结果、唯一标题与 H1 | 自指规范路径；列入本语言站的新榜 sitemap 白名单 |
| 大小写/尾斜杠/全球长路径/UK 等同义别名 | 单跳永久重定向到相同范围的规范路径 | 不单独进入 sitemap |
| 仅带来源追踪的等价页面 | 归一到不含追踪参数的同范围 URL；不改变用户结果 | canonical 使用干净路径 |
| 非默认分类筛选 | 保留功能，`noindex,follow`；不自动生成 SEO 落地页 | 使用归一后的同范围 URL，不把不同结果集合一律 canonical 到全球；不进 sitemap |
| 分页第二页及以后 | 首期不作为独立 SEO 落地入口，`noindex,follow`；仍可分享并服务端恢复 | canonical 保留自己的页码，不指到第一页；第1页归一到不带 page 的 URL |
| 历史批次、内部类型、Demo 参数 | 不是首期索引入口；生产拒绝未支持的业务参数，Demo 保持 noindex | 不进 sitemap，不产生历史榜期承诺 |
| 未登记的国家独立 SEO 路径、非法国家码或非法路径组合 | 404；接口支持但没有独立 SEO 路径的合法国家 query 按上方 noindex 筛选结果页处理；不得返回“全球榜”冒充有效国家页 | 不进 sitemap |

所有新榜入口固定展示近30天发布的结果；旧30d/90d等时间参数移除并归一到同一平台/国家、分类及页码范围，不保留90天榜或隐藏时间过滤。国家入口供给按30天范围审核，空榜不扩至90天，也不补普通视频。

国家是不同业务范围。**美国页不能全部 canonical 到全球页，否则该国家入口失去独立规范页面身份。** Google 的 canonical 用于重复或非常相似的页面，不应被用来掩盖不同筛选集合；分页也不应全部指向第一页。参考 [Google canonical 指南](https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls)、[分页指南](https://developers.google.com/search/docs/specialty/ecommerce/pagination-and-incremental-page-loading)。

本方案选择对可分享的非默认分类结果页使用 noindex，并控制自动生成链接与 sitemap 范围；不要同时用 robots.txt 阻止这些页面抓取，导致搜索引擎读不到 noindex。抓取规模的进一步控制由 SEO/研发单独配置，不把全部筛选排列暴露成链接池。参考 [Google 筛选导航指南](https://developers.google.com/crawling/docs/faceted-navigation)及 [noindex指南](https://developers.google.com/search/docs/crawling-indexing/block-indexing)。

### 11.7 页面内容、元信息与发布门槛

- **标题**：`{国家或全球} {平台} 爆款视频排行榜 - Nox聚星`；英文示例 `Viral YouTube Videos in the United States | NoxInfluencer`。H1 表达同一范围，站点语言与国家分别解析。
- **用途说明**：说明已覆盖范围、国家对象和相对作者历史表现；不把本榜叫作 Most Viewed、实时热点、全网最热或投放效果榜，不暴露内部类型名。
- **真实差异**：国家页必须实际过滤同一国家结果，并展示对应有效入榜总数、当前批次/截止时间、历史中位数对照与限制。只换标题、列表仍是全球结果不能发布。
- **SSR**：首屏在服务端输出可授权公开的标题、说明、视频列表、现有导航链接与元信息，不能只有客户端执行后才出现的空壳。不能为 SEO 绕过权限；没有合法公共内容的入口不发布为可索引页。
- **多语言**：复用现有语言域名策略；仅在对应翻译与内容页面就绪时设置同一国家/平台范围的 hreflang，不能把日本国家榜的英文页配成美国国家榜。各语言站按实际就绪情况发布，不自动承诺全部语言或国家同时开放。
- **入口注册表**：集中维护平台、国家、规范路径、标题 key、路由可用性和 `indexEnabled` 等发布配置。路由登记与允许索引分开：已登记但暂不索引的有效入口仍可正常访问；未登记的独立路径才返回404。结果从当前成功批次读取，发布开关依据真实内容量与连续可用性审核，不从 Demo 的43条样例推出生产门槛；索引门槛与负责人需在上线清单记录。
- **空态与失败**：尚未具备稳定内容的国家入口不加入索引白名单。已登记入口暂时无有效结果时诚实展示空态，保留该路由并按 noindex 暂停索引发布，不重定向到全球、不补普通视频。接口失败独立处理：可保留仍有效的上次成功结果并标明实际时间；无可用结果时返回可重试的服务失败，不把服务故障当作不存在或成功的空榜。
- **sitemap**：只列已审核可索引的规范首屏地址，lastmod 使用实际成功更新时点，不写请求时间。国家页新增后必须同步 sitemap 生成器，不能只把 URL 加进导航。

#### 11.7.1 SEO meta 按入口区分

**每个可索引的固定榜单入口都要有准确表达其范围的 title 和 description，不能只区分 URL 或 H1。** 本次线上实读中，YouTube 国家榜和涨粉榜已体现这种差异；TikTok 美国榜的 description 仍通用，Instagram 美国路径本次读取的 title/description 未体现美国，不能直接照搬。原始响应和浏览器 DOM 证据见[保留结论汇总 8.4](保留结论汇总.md#84-线上-seo-meta-实读补充)。

| 字段 | 本版交付规则 |
| --- | --- |
| `<title>` | 按站点语言、平台、全球/国家及“爆款视频排行榜”生成；同一语言站内不同固定入口可区分，不沿用频道榜、旧 HOT 榜或通用全站标题。当前只有一种判定，不加“账号突破”类型名 |
| `meta description` | 用可读句子说明对应平台、国家对象及相对作者历史表现的用途；国家页明确国家范围，不能所有页面共用全球描述。不堆关键词，不承诺全网覆盖、固定100条、实时/日更或投放效果 |
| H1 与页内说明 | 不是 meta 字段，但必须与 title/description 和真实列表的范围一致。H1 可省品牌尾缀，不能路径美国而页面仍叫全球榜 |
| `canonical` | 使用第11.6节的规范 URL；不同国家自指各自入口，去除追踪参数。不是所有榜单统一指向平台全球页 |
| Open Graph | 输出 `og:title`、`og:description`，与当前页 title/description 表达同一范围；`og:url` 使用同范围的干净规范 URL，不附加分享来源参数。`og:type=website`、站点名和分享图片可以共用，不为形式上的差异逐国制作图片 |
| Twitter Card | 沿用站点分享卡片能力，title/description 与当前页同步，图片可复用。不得残留上一次平台或国家的字段 |
| `robots` | 按索引发布状态、额外筛选和分页策略生成，遵循第11.6节；不因国家不同而随意改变。同一响应的 meta 与 HTTP 索引指令不得冲突 |
| `hreflang` | 链接到已就绪的同平台、同国家、不同站点语言的等价页面；不自动附加内容语言条件 |
| `meta keywords` | 本方案默认不输出。当前频道榜公共 head 已通过 `suppressKeywords` 抑制该字段；旧 HOT 榜虽保留 keywords，但本次全球/美国音乐页读到相同内容。不能把“每页填写不同 keywords”当作 SEO 验收目标；如另有站内兼容用途，单独记录 |

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)。

#### 11.7.2 文案示例与生成边界

以下为中文站推荐示例，国家页以第11.3节已确认的频道国家口径为依据，真实字段接入后发布；字段未确认前不能直接拿旧 `data_region` 套用。品牌尾缀按站点统一命名确认，其他语言须分别翻译。

| 固定入口 | title 示例 | description 示例 |
| --- | --- | --- |
| YouTube 全球 | 全球 YouTube 爆款视频排行榜 - Nox聚星 | 浏览聚星已覆盖且近30天发布的 YouTube 爆款视频，对比作品播放量与作者历史中位数，查看相对倍数和作者信息，发现表现突出的作品。 |
| YouTube 美国 | 美国 YouTube 爆款视频排行榜 - Nox聚星 | 浏览美国地区 YouTube 频道近30天发布的爆款视频，对比作品播放量与作者历史中位数，查看相对倍数和作者信息。榜单基于聚星已覆盖的视频识别。 |
| TikTok 日本 | 日本 TikTok 爆款视频排行榜 - Nox聚星 | 浏览日本地区 TikTok 频道近30天发布的爆款视频，对比作品播放量与作者历史中位数，查看相对倍数和作者信息。榜单基于聚星已覆盖的视频识别。 |
| Instagram 美国 | 美国 Instagram 爆款视频排行榜 - Nox聚星 | 浏览美国地区 Instagram 频道近30天发布的爆款视频，对比作品播放量与作者历史中位数，查看相对倍数和作者信息。榜单基于聚星已覆盖的视频识别。 |

- 由同一份已解析入口范围生成规范路径、meta、H1及结果查询条件；复用入口注册表和国际化文案，不逐页面硬编码。国家翻译缺失不得输出原始 key，也不得静默退回全球文案后继续索引发布。
- 首次 HTTP 返回的 HTML head 与浏览器接管后的 head 必须一致；切换平台/国家时同步更新，并去重 title、description、canonical 及同名分享字段，不能只改可见标题。
- 分类筛选和分页仍按第11.6节 noindex；文案准确说明当前是筛选结果/第几页，不误称默认首屏榜。无需为每个 query 组合另策划一套可索引的 SEO 文案。
- 不在稳定 SEO 标题中加入内部类型、批次、阈值、候选参数、样例名次或未经承诺的更新周期；结果数量和真实截止时间放在页内上下文。有效国家页空态/失败时仍保留其真实国家标题，按发布策略处理索引，不改名成全球榜。

### 11.8 实施顺序与验收

建议顺序：确认国家字段/编码 → 确认新旧榜路由隔离 → 配置三平台全球入口 → 对齐受支持的国家筛选、URL与索引配置 → SSR/head/导航/sitemap 联调。分类独立SEO入口留到后续评审；形态筛选及其SEO入口不在本期，不阻塞本期国家筛选及SEO接入。

- [ ] 国家口径、源字段、未知值、GB/UK 映射及全球不按 IP 补国家已确认。
- [ ] 同一模板按入口恢复筛选，路径/标题/H1/列表/计数/缓存范围一致。
- [ ] 新旧榜独立，旧 HOT URL 和 `video_score` 语义未改变；正式新榜不依赖 Demo 参数。
- [ ] 每个平台至少逐条验证全球与一个已启用国家；通过后检查全部启用白名单，跨平台返回/分享保持条件。
- [ ] 每个可索引入口唯一 canonical、SSR 有授权内容、sitemap 可找到；空态/失败不伪装有结果。
- [ ] 全部启用固定入口逐条验证 title/description 含正确平台与国家范围，彼此可区分，与 H1/查询条件一致；全球页不按访问者位置改成国家页。
- [ ] 对照原始 HTTP head 与浏览器 DOM head：description/canonical/同名分享字段各一份，Open Graph/Twitter 文案同步；站内切换与直接进入均不残留旧 meta。
- [ ] 国家页自指，分页/分类筛选不误 canonical 到全球或第一页；无效组合404，别名不出现重定向链。
- [ ] 域名语言、内容语言与国家互不混用，hreflang 仅指向已就绪的等价页面。

**评审要定的不是复制多少页面，而是：已确认频道国家的真实字段接入、受支持国家的字段/路径恢复、新路径命名及索引发布条件；不再决定固定首批国家数量。** 本节给出可执行推荐，不替代真实数据可用性、生产排序和接口能力的验收。

2026-11-02本地简化版验证：51项浏览器检查、43条样例契约、43×5语言渲染、query回归及榜单隔离通过；运行错误与生产业务请求均为0。截图已刷新为固定30天、两项筛选，旧高级/90天截图移除。1280未登录页壳溢出仍为既有限制。