# v7.6.3 共同上下文 v1：内容监控自动追踪 QoL

> 阶段：`phase_1_spec_source_frozen`
> 版本：`v7.6.3`
> 上游：`input_v1.md`
> 用途：统一后续 Spec、Design、研发和测试对自动追踪规则的产品语义理解。

## 1. 产品单位

本版本的产品单位是“自动追踪规则”。规则包含项目范围、频道集合、关键词/短链匹配条件、生命周期、时长选择和可选历史补扫设置。

收藏夹和其他规则只是频道选择来源，不是规则保存动作；它们不携带关键词或短链，也不自动触发规则保存。其他规则来源只允许当前项目内可见规则。

## 2. 规则保存和生命周期

- 新建规则：用户填写规则名、频道、关键词/短链、时长和可选历史补扫设置后保存。
- 更新规则：编辑保存只能更新原规则，不触发或取消历史补扫设定。
- 另存为：生成新规则；原规则的状态、时间和历史任务不变。新规则保存成功后追加“是否立即生效”确认，确认后运行，取消后保持未生效。
- 暂停：停止未来追踪并暂停计费；不删除已有监控内容和来源关系。
- 恢复：重新计算新的生效起点和到期时间，并恢复未来追踪与计费。
- 项目归档或撤销归档不能默默恢复规则。

## 3. 生效期和计费

```text
durationMode = 7d | 30d | permanent
startsAt      = 服务端确认生效时间
expiresAt     = 7d/30d 的到期时间；permanent 无自然到期时间
```

- 30 天和长期本版本暂沿用 7 天计费方式。
- 不在本版本新增高于 7 天的计费规则。
- 暂停期间计费暂停，恢复时重新计算生效周期。
- 长期规则仍受现有权限、席位、监控能力和停止/删除规则约束。

## 4. 历史补扫

- 未来追踪继续只命中规则生效后新增内容。
- 历史补扫是可选能力，当前产品开关默认关闭。
- 只在新建规则或另存为保存动作触发，编辑保存不能触发或取消。
- 用户选择 `3d | 7d | 30d`；范围覆盖规则支持的全平台。
- 内部保留 `historicalStartAt` 与 `historicalEndAt`，当前终点为保存时当前时间，时长用于反推起点，为后续自定义起止时间预留。
- 历史补扫与未来追踪使用一致的规则条件、权限、异步执行、重试、失败和通知语义。
- 历史补扫不消耗独立配额，沿用现有监控配额、席位和权限约束。
- 用户感知上是即时异步任务，不要求暴露独立的历史任务产品形态。

## 5. 去重和多来源

- 同一平台内容只创建一个监控任务。
- 已有监控内容命中历史补扫时不追加新监控任务。
- 同一内容可同时命中多个自动追踪规则；内容来源展示为多来源。
- 来源筛选按规则命中关系工作；一条内容还有其他来源时仍应出现在目标规则筛选中。
- 暂停、过期或删除规则不删除已有内容和其他来源关系。
- 多来源的具体存储方案不属于产品约束，由研发决定。

## 6. 字段和兼容口径

- 关键词产品上限统一为 10，前后端需要同步修正现有不一致。
- 规则名同一项目内唯一。
- 频道去重优先使用 `platform + channelId`，兼容 URL/alias 归一化。
- 现有 `monitor_duration=null` 不能直接解释为长期；旧规则需要兼容映射。
- 现有规则状态的技术编码可以继续兼容，但用户可见语义必须区分运行中、暂停、过期、配额阻断和未生效。

## 7. 研发归属和验证边界

- 当前自动追踪真实服务端实现仍在旧 `KOLServer`；`kol_server_v2` 未发现对应自动追踪端点。
- 前端真实入口在 `kol-next` 的 `videoMonitor/monitor/addAndAutoTrack` 组件族。
- 产品 Spec 定义外部行为、数据口径和验收条件；不提前规定多来源存储、clone 接口形式或任务内部实现。
- 线上浏览器登录态页面未在本轮完成实测；后续研发/QA 需要补充真实环境验证。