# 其余功能模块修改 SPEC

更新：2026-11-02。本文规定榜单以外页面的增量改造；总体范围与交付 checklist 见 [README](README.md)，计算、状态与结果协议以 [计算规则 SPEC](计算规则_SPEC.md) 为唯一依据。新增榜单仅保留平台切换与国家/分类、固定近30天发布；本次精简不删改其他模块原有筛选。新增榜单及共用依据抽屉的呈现见 [榜单页 SPEC](榜单页_SPEC.md)。

## 1. 范围与改动原则

目标是在用户现有的找作品、找作者、查看内容与监控链路中消费爆款识别结果。除新增榜单外，沿用原页面布局，只增加必要的筛选、视频标记、简短统计和依据入口；其他模块不再制作独立 Demo。

| 范围 | 模块 | 本期交付 |
| --- | --- | --- |
| 纳入 | 三平台视频搜索 | 只看爆款/识别状态筛选、行内标记与依据 |
| 本期不包含 | 榜单单视频AI推荐关键词及搜索承接 | 删除新增入口、说明弹窗和占位；普通视频搜索与既有频道AI能力保持原样 |
| 纳入，待研发排期 | 三平台频道搜索 | “近期有爆款视频”、计数及书签/恢复配套；关联视频保持原选取与排序，不新增命中作品入口 |
| 纳入 | 频道内容 | 内容 Tab 筛选、视频标记与依据 |
| 纳入 | 内容监控 | 原全局筛选、表格/卡片增加公共识别结果；原增长指标保留，不增加近期识别／增长爆发 |
| 纳入 | 品牌内容资产 | 内容主列表筛选、卡片/表格标记，保留原指标 |
| P1，组件复用，非阻塞 | YouTube 单视频分析 | 可复用视频标签与依据，无新增筛选，不为本入口单独扩建接口或页面 |
| 本期不单独开发 | 其他独立视频入口 | 第7节逐项列出；共享组件自然带出时复用统一结果，不新增独立任务或作为上线阻塞项 |

本期不包含监控近期识别／增长爆发或其他爆款判定类型，也不新增作者综合评分、频道榜、交易爆款、合作成功/履约判断、自动预警、AI 因果解释、开放 API 或独立视频收藏库。平台仍为 YouTube、TikTok、Instagram；不能把同一筛选自动开启到未接通契约的数据来源。

## 2. 所有模块共用的要求

### 2.1 查询与展示

- 服务端返回判定、证据、聚合与排序所需结果；前端不计算阈值、基线、倍数、预测或 fallback 标签。
- 本期采用同作者此前同形态作品的累计快照比较、暂定10×；不再声明同发布年龄。依据说明真实采集时点与限制，最低发布时长、快照质量和计算期限以计算 SPEC 为准；快照不设时间TTL，不由各模块自行规定过期天数。
- 同视频只有在**计算配置、观察范围、批次/版本和权限上下文相同**时要求一致；本期包括内容监控在内均消费公共结果，不另建近期识别用途，监控原增长字段保持独立。
- 查询先确定原业务范围，再关联结果、执行筛选、去重、计算总数和分页。禁止只在当前页补标后过滤、从可见几行计算全量命中数或覆盖率。
- 当前有效命中统一显示“爆款”标签，不展示内部判定类型名。接口、存储及查询继续使用 `account_breakout`，不删除类型维度。完成评估但未达标不叫“已入选”，不可判定不作为普通视频或未达标。
- 状态直接说明结果，例如“数据不足”；保留零值、缺失、受限、不适用、未覆盖、过期与撤销的差别。
- “只看爆款”与状态的组合、冲突禁用/拒绝规则见计算 SPEC；二者均只查询账号突破，不提供判断类型切换。
- 原关键词、地区、分类、形态、日期、业务指标及排序维持各自对象含义。新榜已确认使用频道国家/地区；作者频道国家与内容市场、受众地区分别定义，未知频道国家显示“—”，不拿其他字段补齐。其他模块原地区控件仍保持其原业务对象，不能借接入爆款标签静默改义。
- 切换筛选只查询已发布结果，不触发重算、采集提速、扣配额、创建监控或生成 AI 报告。公共结果以日更为产品目标，允许随公共视频数据更新触发增量计算；不承诺每条视频每天取得新数据或刷新页面即重算。采集、评估与发布/榜单更新时间分开说明，见计算SPEC第3.5节。
- 新榜按判定快照累计播放量降序、同播放量较新发布优先、再按稳定ID；该顺序不覆盖视频搜索、频道内容、监控或品牌资产原有业务排序，各模块保持其原排序。
- 2026-11-02确认新榜固定近30天发布，仅保留平台切换、国家/地区和分类；频道搜索“近期有爆款视频”仍提供30/90天，默认不限、不启用该条件。其他模块保留原发布时间筛选范围，作者历史基线不裁成页面窗口。公共计算另统一遵守发布后90天期限，超过后停止自动首次判定和重算，见计算 SPEC 第3.4节。
- 计算结束不删除旧结果、不自动变为未达标/过期。其他模块继续消费仍可使用且授权的保留结果；依据展示原判定时点及已停止更新。新批次目录时间不能冒充旧视频重算时间。
- 超龄且从未有结果、最后是pending或数据不足时，依据明确已超过识别期及真实状态，不继续暗示自动观察中，也不补造未达标。计算结束信息由服务端提供，放入现有依据/限制说明，不另加类型、筛选或独立区域。

### 2.2 筛选、依据和操作

| 组件 | 增量要求 |
| --- | --- |
| 筛选区 | 放在原筛选面板；默认不限，复用原提交/重置行为，不增加独立全宽说明区 |
| 已选条件摘要 | 用“只看爆款”等用户文案回显生效条件、状态和窗口；支持单项移除与清空，不能回显已被服务端忽略的条件 |
| 视频卡片/表格行 | 标签靠近标题/内容身份区；原播放、赞评、发布日期与业务字段保持 |
| 识别依据 | 复用共用抽屉；先结论与关键解释，再按需展开口径，先说明“已入选爆款”等当前结论及同作者比较依据；数据不足不伪造对照；展开时与榜单读取同一历史中位数，其他模块不强制增加基准列 |
| 返回 | 刷新、分页与返回保留条件；从依据返回恢复原列表位置；可用上下文失效时显式提示重新查询 |
| 原平台、作者、监控 | 沿用原真实入口、权限、项目选择与配额；标签自身不触发写操作 |

### 2.3 统计、异常与权限

2026-10-27已确认：本模块范围内的爆款筛选、标签、中位数/倍数和依据不新增权限限制。用户可访问原模块及相应视频时，新增能力随原模块提供；不新增爆款专属权益、升级套餐提示、额外筛选权限开关或爆款次数额度。原模块/项目/数据的访问边界保持，不能由可见计数或命中作品泄漏不可访问内容。新榜单另按原榜单设定继承权限。

搜索、导出、加入监控继续各自既有权限与配额；本次不新增额外扣量，也不因爆款增强移除原操作限制。现有“受限”状态仅用于原有模块/数据限制，不作为本次新增付费墙。

覆盖统计必须由服务端按全量业务范围和权限计算，返回账号突破的适用、已评估和命中数量；不适用对象排除，待识别/不足保留在适用分母，未知或零分母显示“—”。爆款结果筛选不能把覆盖分母缩成已命中的集合。具体字段与去重口径见计算 SPEC。

| 情况 | 页面行为 |
| --- | --- |
| 列表加载 | 沿用原加载组件，不短暂显示“无爆款” |
| 业务列表成功、个别视频未覆盖 | 保留原内容，局部显示可用结果/限制；不能把缺失结果补成 pending 或未达标 |
| 请求失败 | 错误提示与重试；不得伪装成未覆盖或真实空结果 |
| 依据请求失败 | 保留原列表结果，抽屉提供失败与重试，不编造原因 |
| 批次延迟/不可用 | 显示真实截止时间与延迟；服务端明确不可用或显式stale/撤销时不贴当前爆款标签，单条快照不按时间自动失效 |
| 目标超过90天 | 不触发首次计算、重试或重算；已存在的可用结果和历史依据保留，说明停止更新；无可用结果不伪造判定 |
| 受限 | 服务端先裁剪再聚合/下发；不泄漏隐藏指标、样本、基线、内部原因码及证据 ID |

## 3. 视频搜索

真实入口：`/search/{youtube,tiktok,instagram}/video`。

| 项目 | 要求 |
| --- | --- |
| UI | 在原筛选区增加只看爆款与识别状态；结果项加标签和“识别依据”，保留原搜索框与结果形态 |
| 数据 | 原业务条件与新条件按已定义语义组合，服务端筛选后分页；保留原相关性及支持的指标排序 |
| 平台 | 三平台分别查询；未知/不适用的视频形态不得强行取得视频标签 |
| 榜单来源 | 本期不新增AI提词或相关搜索承接，不复制榜单条件作为旧搜索替代；视频搜索原有关键词及来源规则保持 |
| 验收 | 同上下文的有效命中与榜单依据一致；账号突破命中与未达标正确；状态含义明确；空、未覆盖、失败和受限可区分 |

2026-10-27已确认：榜单单视频AI推荐关键词及相关搜索承接本期不做，原可选交付条款移除，不新增推荐词确认、生成请求、搜索跳转或占位。视频搜索本身的爆款筛选、标签及依据仍按本文交付；原关键词搜索、打开依据、查看作者与返回流程保持。既有频道搜索AI功能不受影响。

## 4. 频道搜索：近期有爆款视频

真实入口：`/search/{youtube,tiktok,instagram}/channel`。该条件找作者；频道内容筛选则找该作者的具体作品。

### 4.1 控件与唯一含义

2026-10-27已确认：在原高级筛选增加“近期有爆款视频”，仅提供以下三个选项。时间按作品发布时间，不是首次命中时间、算法观察年龄或实时刷新承诺。

| 选项文案 | 含义 |
| --- | --- |
| 不限（默认） | 不启用爆款存在性条件，保持原频道搜索，不表示查找所有历史中曾有爆款的作者 |
| 近30天 | 近30天发布的作品中，至少有一条可访问且当前有效的爆款 |
| 近90天 | 近90天发布的作品中，至少有一条可访问且当前有效的爆款 |

选项复用筛选项名称表达“有爆款视频”，避免在下拉菜单中重复整句。重置、清空或移除该条件均回到“不限”；这与榜单固定近30天且无时间控件不同。已选摘要例如“近期有爆款视频：近30天”。不增加独立勾选开关、全历史爆款选项、次数阶梯、爆款率、“无爆款”反向筛选或类型切换。

说明文案：“按视频发布时间筛选，所选范围内至少有一条已识别爆款即符合条件；命中作品不限定与搜索词相关。”沿用现有筛选说明方式，不新增独立说明区域。

选择近30天或近90天时，频道必须同时满足：**原频道搜索条件 AND 指定发布时间范围内至少一条可访问、适用且当前有效命中的视频**；选择不限时不附加此存在性过滤。服务端在公共存量识别上下文中完成全范围存在性查询、计数、去重和过滤，再计算频道总数与分页。不能用关联视频的有限样本判断作者是否入选。

| 语义 | 规则 |
| --- | --- |
| 近期 | 按视频发布时间，以公共结果批次固定截止时点T解析 `[T−N×24h, T]`（N仅为30或90），与榜单使用相同边界；缺失/异常或未来发布时间不进入范围，不能用首次识别或采集时间代替 |
| 有效命中 | 沿用计算 SPEC 的 qualified、fresh、valid、allowed 与适用形态；过期、撤销、待观察、不足及非视频不计命中 |
| 去重 | 视频按平台+视频 ID、作者按平台+频道 ID；同一视频只计一条 |
| 关键词 | 保留原频道召回语义；默认不要求导致作者入选的爆款与搜索词相关 |
| 原地区/分类 | 保持频道条件原含义，不自动变成视频市场/分类限制；视频约束另标对象和聚合范围 |
| 不可见作品 | 不通过筛选资格、计数或证据 ID 泄漏存在性；不是先聚合隐藏作品再隐藏明细 |

筛选提示使用上面的说明文案，不能把结果称为“该主题爆款作者”。“同一视频同时符合关键词和爆款”是另一种内容级约束，后续单独评审。

### 4.2 计数与上下文

- 频道聚合须独立返回范围完整性（完整/部分/未知）及计数精度，不复用单视频的 `coverageStatus`。单视频账号突破纳入结果服务（`coverageStatus=full`），不代表数据充分或作者整个发布时间窗口已完整覆盖；精确值或已知下界由服务端在账号突破与权限范围内判定。
- 完整已声明范围内的精确计数可显示“近 30 天有 2 条已识别爆款”；覆盖不全但已有可见命中时显示“近 30 天至少识别到 2 条”。不得从已知下界反推精确总量或爆款率。
- 作者发布时间范围尚未完整评估时，仍可凭明确命中入选；未检出不代表该作者没有爆款。空结果用“当前已覆盖范围未找到符合条件的频道”。
- 2026-10-27已确认暂不调整关联视频展示：启用爆款筛选后，搜索结果卡片及原详情抽屉仍沿用现有视频选取、相关性和排序规则；不优先展示爆款、不替换关联内容，不新增“查看命中作品”按钮、专门明细/抽屉或匹配视频分页接口。该展示方案可能与原规则冲突，留待后续另行评估，不属于本期必做配套。
- 原关联视频未展示导致频道入选的爆款，不代表筛选错误，也不能从可见样本判断是否应入选；资格必须来自服务端全范围存在性查询。筛选说明继续明确按作者近期作品判断，作品不限定与搜索词相关。
- 30/90天窗口随新查询/新发布上下文的截止时点推进，即使视频没有新数据也须按发布时间移出范围；这不触发旧视频重算。搜索资格、总数、计数与翻页固定同一用途/范围、截止时间、批次/版本和权限上下文。服务端参与资格判断的视频必须属于当前频道并符合窗口与账号突破条件；不要求前台关联视频改为该集合。
- 原作者详情跳转、视频区域及返回保持既有行为；不因新增此筛选增加命中作品下钻。本次频道搜索翻页/返回的上下文失效或权限变化时提示重新查询，不静默换批次或窗口。

### 4.3 服务端必须提供的聚合能力

| 部分 | 最小消费语义 |
| --- | --- |
| 查询 | 相对发布时间窗口、账号突破、至少一条的存在性条件、原频道条件及关键词语义版本 |
| 上下文 | 计算用途/范围、截止时点、解析后的起止范围、结果批次/版本、权限范围或可校验的上下文 ID |
| 频道行 | 平台、频道 ID、可见命中数、精确值/已知下界、独立的聚合范围完整性 |
| 内部可追溯性 | 服务端可追溯使频道符合存在性条件的视频及判定上下文，用于正确性核查；本期不要求新增对用户的命中作品列表、证据入口或分页接口 |
| 响应 | 过滤后的频道总数/分页；不支持、失败、批次过期时有明确响应，不能忽略条件返回未过滤列表 |

字段名、URL、索引/预聚合方案、成本和性能由研发评审决定；当前关联视频 API 的存在不证明该能力已经具备。仅在接通上述契约的普通频道搜索来源启用；相似网红、营销项目、AI 扩量/匹配不因共用组件自动启用。

### 4.4 条件保存与恢复

URL、摘要、书签和返回恢复同时保存窗口、账号突破条件、存在性条件及语义版本，保留原关键词/排除词/筛选。

- **书签重开**：保存相对窗口，按新的查询截止时点解析；不保存固定命中作者名单或把旧批次当实时结果。
- **本次分页/返回**：保持当前快照和已解析范围；上下文失效时重新查询并提示。
- **旧书签**：缺新增字段按不限恢复；过时/不支持的非默认条件须提示，不能静默删除。

## 5. 频道内容、监控、品牌资产与视频详情

| 模块与真实入口 | 最小 UI 改动 | 数据与边界 | 必须验收 |
| --- | --- | --- | --- |
| 频道内容 `/:plat/channel/:channelId?tab=content` | 原内容筛选加只看爆款/状态；每条视频加标签/依据 | 保留视频类型、播放量、日期和排序；统计限定该作者、当前形态/时间及权限范围；不生成“爆款频道” | 原列表/分页不漏数据；识别状态明确说明且不显示类型名；作者跳转和返回保持条件 |
| 内容监控 `/video-monitor/monitor` | 原全局筛选和表格/卡片增加判定；保留原监控状态、增长和项目操作 | 读取公共服务的账号突破判定，与同上下文其他页面一致；监控当前指标和判定快照分别说明时间。项目私有修正不得回写公共结果 | 新状态不替代增长热度；手录/缺基线/受限有明确状态；筛选不触发采集、重算、任务或 AI 日报 |
| 品牌资产 `/brand/brand-analysis?tabId=assets&subTab=content` | 原筛选加只看爆款/状态；卡片、表格均加标签/依据 | 保留关键词、国家、语言、相关性、形态、指标、日期、排序；使用品牌相关视频集合，私有修正不重算公共结果 | 卡表一致、原筛选有效；品牌旧指标不被替换；范围变化后计数/覆盖及时更新 |
| YouTube 分析 `/youtube/video-analytics/:videoId`（P1，组件复用非阻塞） | 共享组件自然带出时复用视频标签与依据；不单独开发或增加筛选 | 从已识别入口传入上下文；当前服务无结果时说明未覆盖，失败不冒充未覆盖 | 与来源上下文一致；不从旧分数补标签；原报告、刷新和 SEO 行为保持 |

频道内容如展示“已评估、命中、覆盖率”，仅计算账号突破，遵循第 2.3 节；是否占用现有统计位由交互确认。首期不默认加爆款率，更不将一次命中或命中率解释为作者能力。

本期内容监控只增加公共结果的筛选、标记和依据。公共结果使用判定时快照，原监控指标继续使用自身更新链路；二者不同时，依据明确显示识别数据截至时间，不拿当前监控值临时重算标签。加入监控不保证立即有公共结果，不触发公共加速采集或重算；只有服务确实声明未覆盖才显示未覆盖，数据不足、受限与失败分别处理。

监控近期识别／增长爆发已移至[后续 TODO](README.md#后续版本-todo不属于本期交付或评审阻塞项)。本期没有该类型、模式切换、筛选、统计、导出列或占位，也不因延期修改原监控增长字段及其功能。

品牌 `topVideoRate` 沿用原口径；新标签说明固定表达：“视频级爆款识别与品牌原‘爆款制造率’口径不同，不能直接比较。”旧指标的可证实定义及限制见 [保留结论汇总](保留结论汇总.md)，不得静默改名、换分母或回填历史值。

## 6. 书签、导出与正式接入

| 配套 | 本期要求 | 尚待确认 |
| --- | --- | --- |
| URL / 摘要 / 返回 | 新条件在支持的页面完整承接，来源上下文可校验；不能承接时提示放宽哪些条件 | 各模块字段命名及搜索映射 |
| 搜索书签 | 第 4.4 节窗口/账号突破条件/存在性/语义版本序列化；旧书签兼容 | 废弃枚举的迁移提示 |
| 原导出结果范围 | 已确认：支持新筛选的原有导出沿用同条件、固定上下文、去重及权限；视频导出匹配视频，频道导出匹配频道，不能退回未过滤全集 | 筛选后服务端导出实现、固定上下文与原数量限制的验收 |
| 导出模板与新增入口 | 已确认：本期不新增爆款状态、中位数、倍数、判定时间等导出列，保持原字段、格式、对象与数量/权限/配额；不额外建设新的榜单导出功能 | 新字段或新导出入口留待后续需求评估，不属于本期待决或交付项 |
| 正式功能 | 普通真实路由接入真实结果并允许展示新筛选/标签，保留原权限及默认业务含义 | 发布开关、灰度、SLA 和服务归属 |
| 本地 Demo | `viralDemo=1` 只用于显式模拟/回归，普通模式不读取 mock | 不把 Demo 隔离要求用于禁止正式能力 |

2026-10-27已确认：导出只适配筛选范围，不扩展模板。选择“只看爆款”后，原视频导出只输出符合条件的视频；频道搜索选择近30/90天有爆款后，原频道导出只输出符合条件的频道，不改成视频明细。保留原有当前选择/全部结果、数量上限和文件格式规则；“同条件”不表示只导出当前可见页，也不代表放开原数量限制。

原页面仅“增加标记”而未接通服务端筛选的来源，不得显示看似有效的新过滤控件；已有导出须同步适配筛选，原无导出的模块不因本次增加导出入口。用户已有导出权限并不自动获得新的隐藏证据或其他租户内容访问权。

## 7. 其他应用点的分级

2026-10-27已确认：以下零散入口本期不单独开发，不作为核心页面交付或上线验收的阻塞项。仅在原共享组件已能自然读取同源结果时允许带出标记，且保持原视频集合、排序、权限和状态语义；不为覆盖这些入口新增接口、筛选、统计、抽屉或独立页面。组件未带出时不设占位，也不将其列为本期遗漏。P1单视频分析同样按组件复用、非阻塞处理，原设计作为复用参考。

| 分级 | 入口 | 可复用内容与限制 |
| --- | --- | --- |
| 暂不考虑，后续另评 | 频道搜索关联视频爆款优先展示、专门命中作品明细/抽屉 | 可能与既有相关性/选取规则冲突；本期保留原展示，不新增“查看命中作品”，不作为频道筛选交付依赖 |
| 本期不单独开发 | 搜索频道抽屉其余视频 | 仅可随原共享组件带出标签/依据，保留既有选取/排序；不单独新增只看爆款筛选 |
| 本期不单独开发 | `/:plat/channel/:id?tab=brand` 推广视频及品牌合作抽屉 | 共享组件自然复用时仅视频级标记；不新增“近期推广内容有爆款”聚合，不表示品牌转化有效 |
| 本期不单独开发 | 品牌商品关联视频抽屉 | 主内容改造不视为该链路已覆盖；仅随原组件复用，不为本入口单独接通接口；实际带出时仍需核对平台/身份 |
| 本期不单独开发 | 监控单任务详情抽屉 | 自然复用时同用途、同范围与列表一致；不增加趋势解释、预警或AI日报 |
| 本期不单独开发 | YouTube 相关推荐 | 自然复用时仅带出标签/依据，保持原推荐集合和排序，不建立新推荐策略 |
| 后续评审 | TT 频道带货、商品/店铺视频 Tab | 传播识别不等于销量/GMV/交易爆款；直播不冒充视频 |
| 后续评审 | 收藏作者、相似网红、营销项目找作者 | 可复用作者近期聚合或下钻；不新增作者分、不改变候选池、履约或付款 |
| 后续评审 | 品牌概览/动态、监控项目列表/看板 | 先定窗口、去重、分母、权限和用途，再考虑聚合/下钻，不先加统计卡 |
| 后续评审 | Amazon 商品视频、自然语言/智能精选/Agent/API | 视频身份可靠才加标；智能精选只冻结筛选后候选快照，不自动增加策略或开放能力 |

## 8. 研发定位与设计校验

下列为当前源码定位；项目根为 `/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol-next/`。静态路径证明入口存在，不证明线上已接入新结果或接口覆盖完整。

| 功能 | 代码入口 |
| --- | --- |
| 搜索与频道聚合 | `pages/search/_platform/_searchType.vue`；`components/searchV2/SearchFilter/index.vue`；`components/searchV2/SearchResult/channelResult.vue`；`api/search/searchResult.js` |
| 关联视频与搜索详情 | `components/searchV2/SearchResult/components/youtubeChannelItem.vue` 及 TT/IG 对应项；`components/searchV2/SearchResult/components/detailDrawer.vue` |
| 条件书签 | `components/searchV2/SearchBox/bookMarkDrawer.vue`；`api/bookMark/bookMark.js` |
| 频道内容 | `pages/_plat/channel/_channelId.vue`；`components/profile/contentTab/index.vue`；`components/profile/common/media/` |
| 监控 | `pages/video-monitor/monitor.vue`；`components/videoMonitor/monitorDetail/index.vue`；`components/videoMonitor/monitorDetail/MonitorGlobalFilters.vue`；`components/videoMonitor/monitorDetail/MonitorContentMonitor.vue` |
| 品牌内容资产 | `pages/brand/brand-analysis.vue`；`components/brandAI/tabComponent/assets/components/contentData.vue`；`components/brandAI/tableComponent/videoList.vue`；`components/brandAI/tableComponent/videosTable.vue` |
| 单视频分析 | `pages/youtube/video-analytics/_videoId.vue`；`components/youtube/videoAnalytics/PageContent.vue` |

[设计规范 README](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol2.0-design-specification/README.md)、[Filter Summary](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol2.0-design-specification/playbook/components/filter-summary.md)、[Tag](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol2.0-design-specification/playbook/components/tag.md)、[Table](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol2.0-design-specification/playbook/components/table.md)、[Accessibility](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol2.0-design-specification/playbook/accessibility.md)为设计依据。具体颜色/状态沿用 [Semantic Tokens](/Users/yukuangji/Work/NoxInfluencer/pm-workspace/kol2.0-design-specification/playbook/semantic-tokens.md)，不新造视觉值；移动端与多语言长文案需另验收。

真实环境边界：榜单 Demo 只证明本地参考交互；本轮频道搜索的内置浏览器及 Chrome 读取超时，未验证账号、地区、权限或同源接口。其他独立入口以源码定位为据，正式实施前须完成所在真实页面与接口校验，不能以主列表截图代替。

补充校验（2026-10-23）：三平台视频搜索与源视频详情已通过 Playwright MCP 同源只读获取，用于关键词提取可行性实验；没有调用现有 AI 推荐接口，也没有验证新增爆款筛选、频道近期聚合或生产权限/配额链路。上述早期频道搜索限制仍保留，不将视频搜索读取成功等同频道新功能验收。

## 9. 模块验收 Checklist

- [ ] 本期排除项：新增榜单无AI推荐关键词入口、弹窗及占位，不增加生成或相关搜索链路；既有频道AI功能保持。
- [ ] 视频搜索：三平台账号突破筛选/状态组合、过滤后分页、原排序、空态/失败/受限均正确。
- [ ] 频道搜索：筛选名“近期有爆款视频”，仅不限/近30天/近90天三个选项；默认、重置、移除及清空均不限，不启用存在性条件，也不默认为全历史有爆款。
- [ ] 频道搜索：启用30/90天时，仅范围内可访问有效命中才入选；旧视频近期新识别不误入；窗口两端均计入，未来/缺失/异常发布时间排除，搜索计数及翻页截止时点一致。
- [ ] 频道搜索：同一视频不重复计数；作者聚合范围未完整评估时显示至少数；隐藏作品不泄漏资格、计数或 ID。
- [ ] 频道搜索：服务端入选资格可追溯到同频道、同窗口的有效命中；关联视频仍按原选取/排序展示，不被优先爆款替换，无新增命中作品入口/明细。不可用当前关联样本替代全范围存在性筛选。
- [ ] 频道搜索：关键词只按已说明的频道语义使用；没有暗示命中作品必与搜索词相关。
- [ ] 保存/恢复：书签相对窗口重解析，本次分页/返回固定快照；旧书签默认不限，非法条件不静默丢弃。
- [ ] 来源隔离：无聚合能力的相似、营销、AI 来源不启用新筛选，也不忽略已提交的非默认条件。
- [ ] 频道内容：同上下文标签/状态一致；统计只含账号突破、分母明确；返回原列表位置。
- [ ] 监控：与同上下文公共结果一致；判定快照与监控指标时点可辨，私有数据隔离；原增长字段和项目操作保持；无近期识别／增长爆发类型、筛选或占位。
- [ ] 品牌资产：卡表一致；旧 `topVideoRate` 与新视频标签的区分文案可见；原筛选、排序与权限不变。
- [ ] 组件复用校验（仅实际带出时）：P1视频详情及第7节零散入口保持原行为、排序、权限与SEO；标记与同上下文来源一致。未带出不阻塞本期，不单独建接口、筛选或页面。
- [ ] 导出：筛选后的同条件与固定上下文、权限裁剪和去重正确；不输出未筛选全集。频道仍导出频道、视频仍导出视频；原字段/格式、选择/全部范围及数量限制保持，本期不新增爆款导出列或新榜单导出入口。
- [ ] 正式路由：读取真实结果而非 mock；本地 Demo 隔离不阻止正式标签展示。
- [ ] 权限继承：原模块可用且内容可访问时，新增爆款筛选、标签、基准与依据不另锁定、不要求升级套餐、不新增爆款额度；原模块/项目/数据边界及既有操作额度保持。
- [ ] 只读交互：打开依据/筛选/分页/返回不重算、不扣额外爆款配额、不创建任务、不触发 AI 或预警；原搜索等已有操作计数按既有规则执行。

上述为研发验收要求，不代表其他模块已经实现。上线前仍需确认公共计算参数/数据条件、接口归属、已确认权限继承的快照/裁剪映射、索引聚合性能、窗口控件与筛选后原有导出的一致性；其余结论见 [保留结论汇总](保留结论汇总.md)。