creator-hub/docs/plan01.md

# CreatorHub 需求细化与验收标准

> 版本：v1.2 · 2026-09-12
> 状态：业务范围已逐项确认；本文是实现与验收依据，不代表功能已经完成。
> 现状基线：`feat/python-gateway-douyin` 基于 `origin/main@1fbf126`；当前分支已包含 Python gateway、事件边界/确认、动作结果证据、固定采集计划和工作台修正，并完成本地离线验证；真实平台验收仍单独记录。
> 优先级：本需求高于现有实现及旧产品规划；遇到平台能力不足或新的业务歧义，必须向使用者确认，不得自行删减、替换或假装成功。

## 1. 目标、范围与完成定义

在现有账号、浏览器环境与代理管理基础上，形成四个可实际使用的模块：

1. **竞品分析**：导入竞品账号，发现新作品，监测指标，筛选爆款，选择素材并生成仿写文案。
2. **账号管理**：登记实名与登录资料，管理账号状态、大号与小号关系，监听大号收到的互动并按策略响应。
3. **环境管理**：一账号一环境，自动配置稳定指纹，手工管理与分配代理。
4. **工作台**：采集自有与竞品账号的一级评论，识别线索，人工回复/私信；展示并操作所选平台账号的私信会话。

### 1.1 交付范围

- 平台为**抖音、小红书**。分阶段实现：先验证抖音完整流程，再完成小红书；最终交付必须逐平台验收，不能以“能登记小红书账号”替代业务功能。
- 本文及相关旧文档同步是需求基线；当前工作树已补充一批 CreatorHub 本地实现，但不部署、不操作真实平台账号，也不把离线结果当作平台成功证据。
- 后续功能交付以第 8 节的可观察结果为准，既要覆盖成功，也要覆盖缺数据、重复操作、失败和恢复。
- 平台不提供的事件、UID、指标或动作能力属于**待验证的外部依赖**，不是默认排除项。必须给出证据并由使用者决定替代或范围调整；未经确认，该项不能通过验收。

### 1.2 统一术语

| 名称 | 含义 |
| --- | --- |
| 自有账号 | 在本系统登记、由使用者登录操作的平台账号 |
| 竞品账号 | 通过链接加入监测的目标账号，不要求也不收集其登录凭据 |
| 大号 | 开启大号模式、接收互动并配置响应策略的自有账号 |
| 小号 | 被一个同平台大号选中，用于执行响应动作的自有账号 |
| UID | 平台提供的稳定用户标识；不得用昵称、头像或显示名称代替 |
| 账号状态 | 人工维护的正常、禁言、封禁、注销等业务状态，不等于登录状态或环境状态 |
| 自动响应 | 大号收到互动后，系统按启用策略选择一个小号执行一个动作 |
| 人工发送 | 使用者选择账号、确认目标和内容后发送；与自动响应分开记录 |
| 结果不明 | 已尝试执行，但未获得足以判断成功或失败的证据；不得标为成功或自动补发 |

## 2. 当前系统与需求差距

以下来自代码检查，**不是本轮真实平台验证结论**。路径用于定位现状，不冻结后续实现方式。

| 范围 | 已有基础 | 本需求需要补齐或改变 | 代码依据 |
| --- | --- | --- | --- |
| 页面入口 | 账号、任务、审计、环境、代理、镜像、网关等页面 | 竞品池、作品、素材仿写、评论线索、响应策略、私信会话尚无完整入口 | [页面路由](../web/src/app/main.jsx) |
| 账号 | 平台账号 ID、标签、Cookie、暂停/恢复等 | 实名资料、登录用户名/密码、备注、人工业务状态、人工登录与大小号关系 | [账号页面](../web/src/features/accounts/AccountsPage.jsx)、[账号存储](../internal/account/store.go)、[账号接口](../internal/controlplane/api/accounts_operations.go) |
| 平台范围 | 登记项还包含公众号、快手 | 新业务仅承诺抖音、小红书；其他登记项不是业务能力验收结果，也不因此要求删除无关已有功能 | [账号页面](../web/src/features/accounts/AccountsPage.jsx) |
| 作品读取 | 有抖音连接器、指标字段与测试 | 连接器只核验登录者自身、读取首批 20 条，未接成运行中的竞品采集链路；需目标账号解析、分页、保存、查询和定时更新 | [抖音连接器](../internal/platform/douyin/connector.go)、[连接器测试](../internal/platform/douyin/connector_test.go)、[网关读取限制](../browser_gateway/platform/douyin.py) |
| 指纹与环境 | 结构化指纹、独立 Profile、启动/停止/升级及代理接入 | 默认固定 seed 不是自动分配；需首次自动生成、地区匹配及稳定性验证 | [环境页面](../web/src/features/environments/BrowsersPage.jsx)、[指纹参数](../internal/environment/fingerprint.go)、[环境存储](../internal/environment/environment.go) |
| 代理 | 添加、列表、手动检测、停用、实际转发 | 补齐编辑、删除、重新启用及引用约束；不增加自动轮换 | [代理页面](../web/src/features/environments/NetworkExitsPage.jsx)、[代理转发](../browser_gateway/proxy.py) |
| 任务与发送 | 有草稿确认、任务记录、Mock 执行 | 不能作为真实回复、私信、点赞、关注、转发成功的证据；需接通实际平台执行及结果核验 | [任务页面](../web/src/features/operations/TasksPage.jsx)、[任务接口](../internal/controlplane/api/accounts_operations.go) |
| 事件、线索、私信、AI | 未发现完整可运行链路 | 均需新增业务能力，不能把旧文档、类型定义或模拟返回记为已实现 | [页面路由](../web/src/app/main.jsx)、[抖音连接器](../internal/platform/douyin/connector.go) |

### 2.1 已确认的冲突裁决

- [旧探索方案](product/compliance-product-plan.md)排除了自动评论、自动关注、批量私信等；本文明确纳入**由互动触发、按用户冷却限制的单次自动响应**。不得沿用旧排除项阻止实现，也不得扩展为无差别群发。
- 旧流程强调每次草稿人工确认；本文的自动响应由人工配置、启用策略后自动执行，工作台与私信页面则逐次人工确认。不能混为一个审批流程。
- 旧读取代码仅支持登录账号自身与首批作品；本文要求竞品账号和完整范围内分页，后续须接通真实能力，不能只在界面标注支持。竞品仅采公开可访问或已授权的数据，不要求竞品登录，也不以旧“仅自有账号”限制删减竞品范围。
- 账号实名状态、业务状态、登录状态分别记录；禁止把“授权成功”当作“已实名”，或把一次网络错误当作“封禁”。
- 自有账号的互动和私信采用**事件监听**，不以定时轮询替代；竞品作品与评论仍按固定计划采集。现有账号/环境列表不主动检测、不轮询实时状态的约定保持不变。

### 2.2 文档职责与现状边界

- 本文规定目标业务；[旧探索方案](product/compliance-product-plan.md)仅保留历史背景，其阶段 A 离线 Mock 不等于本文 G0/G1。尚未实现是开发差距，不是计划缺陷。
- [架构说明](architecture/container-control.md)集中记录当前生命周期 API；[部署说明](deployment.md)只验证当前可运行代码，不证明本文四模块已验收。当前控制面仍有 Basic Auth；本期开发目标不新增认证、RBAC 或认证 profile，本轮也不删除现有认证。

## 3. 竞品分析

### C1. 账号导入与监测管理

- 用户输入抖音或小红书账号主页链接；平台可解析的作品分享链接可先解析作者，再展示确认。无法确定作者时要求填写主页链接，不猜测账号。
- 保存前展示平台、账号昵称、稳定标识、主页链接及可取得的头像；使用者确认后加入监测。缺少稳定标识不得创建成功。
- 以“平台＋目标账号稳定标识”去重；短链接、长链接指向同一账号时不产生两条监测记录。
- 支持列表查询、启用/暂停监测及手动更新。暂停只停止后续采集，已采数据保留；不默认扩展批量导入、自动发现相似账号。
- 首次默认回溯最近 **30 天**作品，回溯天数可在统一设置中修改。采集全部符合范围且平台可提供的作品，不限制为首页或固定 20 条；可展示进度并在中断后继续。
- 作品以“平台＋作品标识”去重，展示作者、标题/正文、发布时间、原链接、可取得的封面、点赞/评论/转发数及最近采集时间。
- 不可获取的指标显示“不可获取”，未采集显示“待采集”，不能填 0。平台真实返回 0 则显示 0；指标以当前真实值更新，不强制只能增加。

### C2. 两种独立的检查计划

| 配置 | 已确认默认值 | 约束 |
| --- | --- | --- |
| 历史回溯天数 | 30 天 | 正整数；定义首次采集范围，不等于数据删除期限 |
| 账号新作品检查间隔 | 30 分钟 | 正数；与作品指标计划分开 |
| 指标初始间隔 | 1 小时 | 正数 |
| 指标间隔倍数 | 2 | 大于 1，作品越旧检查越少 |
| 指标最大间隔 | 24 小时 | 不小于初始间隔 |
| 指标监测年龄 | 发布满 30 天停止 | 正数；停止采集不删除历史数据 |

- 以上为一组全局设置，不增加每账号覆盖、热度自适应或公式编辑器。
- 以作品发布时间为起点，间隔为 `min(初始间隔 × 倍数^n, 最大间隔)`，`n` 从 0 开始；累计时刻是发布时间后 **1、3、7、15、31、55、79……小时**。
- 计算统一使用 UTC 时刻和固定时长，1 天 = 24 小时，不按本地自然日或夏令时换日；界面可转为本地时间但注明时区。首次回溯以开始时刻 `T` 固定窗口 `[T - 回溯时长, T]`，分页期间不滑动窗口。
- 账号启用时立即检查新作品，以该次启用时刻为固定间隔起点；一级评论补充采集同理。正常到期条件为 `当前时刻 >= 计划时刻`，同一计划点只启动一次；暂停不启动，恢复或重启最多采一次当前结果，再取严格晚于当前时刻的计划点。
- 首次发现先采一次当前指标，再等待该作品严格晚于当前时刻的计划点；发现时恰好到期，这次当前采集即覆盖该点，不再重复。已经错过的历史时刻不逐次补跑。
- 派发前再次检查发布年龄；`当前时刻 >= 发布时间 + 监测年龄` 时不再安排自动指标检查（与计划点重合时停止优先）。首次回溯到比监测年龄更旧的作品，仍采初始资料和当前可得指标，但不创建持续指标计划。
- 暂停、进程重启或短暂中断后，每部作品最多补一次当前采集，不集中回放历史计划；已有作品不重复入库。登录失效、验证挑战等需人工处理的阻断不得靠重试消除。
- 修改设置后以保存时刻重设账号/评论未来检查起点，作品指标仍以发布时间计算未来点；不重写历史指标时间，也不补造过去的数据。
- 缺少可靠发布时间或时区、时间无效/位于未来时，资料标为“发布时间待核验”，不猜日期、不把发现时间当发布时间，不纳入已确认回溯结果或安排年龄相关计划；保留待核验项及范围不完整提示。获得可靠时间后按当前窗口及未来计划处理，不回填错过的采集。

### C3. 爆款筛选

- 支持平台、监测账号、作品发布时间，以及点赞、评论、转发最低值筛选。
- 只对用户填写的条件进行判断，所有已填写条件**同时满足**才入选；数值阈值为非负数，等于阈值也满足。
- 未配置某项阈值不限制该项；配置了阈值但对应指标不可获取，则不进入该筛选结果，并说明缺少指标。
- 不增加系统综合评分、增长预测、AI 爆款推荐或排行榜算法。“爆款”在本期就是满足用户筛选条件的作品。

### C4. 素材与仿写：两次人工确认

固定流程：

`标题/正文 → 人工选取素材 → 下载视频、提取音频、语音转写 → 人工确认是否仿写 → 系统生成标题与口播文案`

- 未被人工选取的作品只获取作品资料，不自动下载媒体、转写或生成文案。
- 选取后可查看各步骤进度、视频、音频、转写文本及失败原因；下载保留平台可获取文件，不包含去水印、视频画面 OCR、配音合成或剪辑。
- “语音转写”是对音轨中说话内容的识别，不能拿作品描述冒充；“分析”用于理解现有标题、正文与转写，不额外输出未经要求的复杂分析报告。
- 无音轨或无可识别语音时明确标注，不编造转写；其他下载/转写失败显示具体失败步骤，不能标成全部素材完成。
- 素材准备成功后，用户可放弃或填写仿写要求并确认。下载或转写失败时，必须先解决失败步骤才允许仿写，不提供“部分素材继续”分支。已确认无音轨/无说话内容属于明确的素材结果，不等于任务失败，仍须如实展示。
- 输出仅为**可编辑的标题与口播文案**，保留来源作品、采用的素材及用户要求；不自动发布、不生成视频、不做多代理创作流程。
- 重复点击同一次选取/确认不得重复启动同一任务。失败允许人工重试失败步骤，已有成功素材不无故重新下载；AI 失败不得用原文或空内容冒充成功。
- 作品/评论分页与媒体下载是不同链路；任务按下载、提音、转写、生成保存步骤状态和产物引用，页面按需预览，不把媒体二进制塞进通用 JSON 读取响应，也不靠放大当前 JSON 上限冒充媒体支持。最终须用超过一页数据及真实媒体证明可用；当前读取限制只是后续接通点。
- 空间不足、文件过大或服务配额不足须明确失败步骤、原因和已有产物；未经用户授权不得自动删除素材腾空间，不静默丢弃成功产物。

## 4. 账号管理与自动响应

### A1. 账号资料与状态

| 字段 | 要求 |
| --- | --- |
| 平台 | 抖音或小红书；和平台稳定账号标识共同确定账号身份 |
| 登录账号、密码 | 可选；与平台 UID 分开，密码输入后不由读取接口回显，也不进入列表、日志或错误信息 |
| 实名状态、姓名、身份证 | 人工记录，用于区分账号；不校验平台真实实名、不代办认证、不上传身份证资料 |
| 备注 | 用户补充说明，不用标签代替 |
| 账号状态 | 人工维护正常、禁言、封禁、注销；需要其他状态时先确认，不设计可编程状态系统 |
| 大号模式 | 开关；开启后可管理本大号的小号、响应策略、冷却时间与 AI 回复要求 |
| 登录情况 | 独立展示已登录、需登录、登录失败/待人工处理等实际结果与时间，不推断处罚状态 |

- 支持账号资料新增、查看、编辑；必填平台及能区分账号的标识，已获得平台 UID 后检查身份重复和登录一致性，不通过改昵称掩盖冲突。
- 登录密码允许由新增/编辑请求输入并进入现有凭据保存流程，账号资料仅关联凭据；读取只显示是否已配置，编辑空白不覆盖已有密码。密码仅供人工核对/维护，不由系统自动注入或登录。
- 实名资料只做输入类型、长度等基本校验；不把人工记录包装成已核验身份，不要求用户为运行普通功能提交身份证证据。
- 正常账号按实际登录及平台能力执行。**非正常账号暂停自动动作**；禁言账号禁止人工评论、私信及带文案转发；封禁、注销账号不参与采集和发送。已有数据仍可查看，人工登录/检查入口保留。
- 账号恢复正常后需人工重新启用受影响策略，不补发暂停期间的历史互动。登录失败不擅自修改上述业务状态。

### A2. 登录

- 已存在有效登录时复用；未登录或会话失效时进入可见浏览器人工登录。系统不得自动注入用户名、密码、Cookie、验证码或绕过扫码/设备确认。
- 人工登录失败显示真实原因：例如凭据错误、验证码/扫码/设备确认、网络失败或页面变化；未知原因明确写“无法确认”，不能猜测。
- 失败后保留同一环境交用户人工处理，不循环尝试、不自动更换账号/代理/指纹，也不绕过验证码。
- 登录后核对实际平台账号身份；与选定账号不一致时停止该账号任务并提示纠正，不能把别的账号登录结果保存为成功。

### A3. 大小号关系与策略

- 一个小号只归属一个**同平台**大号；不能自己关联自己，大号不能再作为其他大号的小号，不建立多层关系。
- 大号可关联多个小号，并配置有明确先后顺序的策略。每条策略包含：启停、适用事件类型、一个执行小号、**一个动作**及动作所需内容。
- 事件是大号**收到**评论、点赞、转发、关注等互动，不是跟随大号主动操作。以上四类全部纳入，不因平台获取困难自行删除；其他事件类型须说明含义后确认。
- 同一事件按顺序找到第一条匹配、账号可用且目标明确的策略执行。较早策略因登录/业务状态/缺少目标而不可用时可检查下一条，并记录原因；一旦选中并开始执行，不再换小号或换动作补发。
- 大号模式关闭、策略停用、关系调整时停止受影响的未执行动作；关系调整后需人工重新配置并启用。已发送动作不能假装撤回；在途动作实际结果继续保留。

| 响应动作 | 目标与必要条件 |
| --- | --- |
| 给用户发私信 | 互动者的稳定 UID；需要文本 |
| 回复评论 | 事件中明确关联的评论；需要文本 |
| 点赞评论或作品 | 策略明确选择评论或作品，事件中存在对应目标标识 |
| 关注互动用户 | 互动者的稳定 UID |
| 转发作品 | 事件中明确关联的作品；平台要求文案时还需文本 |

所有自动动作都必须另有互动者稳定 UID 供 A5 冷却使用，即使点赞/转发只需作品 ID 也不例外。缺少必要目标时不猜测、不搜索用户的其他作品代替。例如关注事件只有用户而没有评论，不能执行“回复评论”；只有聚合点赞数却没有互动者 UID 时，不能触发面向用户的响应。

### A4. 文本来源与 AI

- 需要文本的动作允许预填多条非空候选文本；每次随机选择其中一条。只有一条时直接使用，不要求轮换不重复。
- 未填写候选文本时，使用 AI 按**大号统一的回复要求**生成。启用此类策略前必须具备有效 AI 配置及该大号回复要求。
- AI 输入限于当前事件、相关作品/评论、允许使用的业务说明和回复要求；不新增知识库、长期记忆、多轮自动聊天。
- AI 失败、内容为空或超出平台限制时停止本次响应并显示原因，不改用隐藏的默认话术、不截断后强发、不自动重发。
- 用户内容是待分析材料，不应改变大号预设要求、执行账号或目标；保存实际选中文本或生成文本与执行结果的对应关系。

### A5. 同一用户只自动响应一次

- 冷却范围为**平台＋大号＋互动用户 UID**，该大号下所有小号、所有事件和所有动作共同计算。
- 大号可配置正数冷却时间，默认 **24 小时**；不能把 0 解释成禁用冷却。
- 从选中小号、开始执行时占用响应名额并计时。一个 UID 在冷却内不论触发什么事件，都只允许一次自动动作，不执行“关注后再私信”等组合。
- 冷却检查和占用必须不可被并发穿透；服务重启、监听重连、策略重启、修改候选文本不能清除已占用的冷却。事件身份及永久去重按 A6；冷却到期只允许新事件，不允许旧事件重放。
- 失败、AI 生成失败、结果不明均保留已经开始执行的冷却，不自动尝试下一个小号。没有匹配策略、账号不可用等尚未开始执行的情况不占用名额。
- 修改冷却时长只作用于新开始的响应；已占用名额保留其原到期时间，避免修改设置意外提前解锁。
- **人工回复和人工私信不受自动响应冷却限制**，不拿自动冷却阻止用户逐次确认的发送；必须明确标识人工/自动来源，仍防止同一次提交重复发送。

### A6. 事件监听与接近实时

- 自有账号登录后由后台监听大号互动和私信新消息；关闭页面不停止后台监听。私信事件更新会话，不触发自动聊天；竞品采集不依赖竞品登录。
- **事件身份**为“平台＋接收账号＋平台稳定事件 ID”；也可使用经真机验证能唯一定位事件、跨重连/重启仍稳定的游标。普通翻页游标不当然是事件身份；不得用昵称、时间/内容哈希猜唯一。缺少可靠身份属于 G0 阻塞，不启用该类自动响应。
- 首次监听及每次重新启用先保存已验证的历史基线（平台事件时间边界或可验证的事件位置），基线建立期间不执行自动动作；从确定的新事件边界开始响应，旧通知只作历史展示。平台没有时间标识时必须证明游标/事件位置可区分新旧；两者都没有则标为边界不明，不猜测。
- 持久保存已接收事件的最小身份、边界归类和处理结论（含未匹配、跳过、失败与结果不明），同一旧事件永不因策略修改、冷却到期或重启再次执行；该最小去重记录不随冷却到期删除，不要求永久保存原始消息全文。
- 断连、登录失效、解析失败可见；恢复时核对持久基线和平台恢复位置，重复只更新原记录。**迟到/待核验事件**指恢复时取得的断连期间事件，或无法证实发生在持续启用的新事件边界内的事件，不以“晚了几秒”任意划线。默认只记录、不补发自动动作；是否能可靠恢复、缺失范围以及恢复事件是否允许触发，须在 G0 提交平台证据并取得用户批准后明确，不默认授权历史补发。停用期间及启用前事件始终不触发。
- 进程重启按断连恢复处理，不清除基线、事件去重或冷却；无法确认恢复连续性时显示数据缺口，从重新确认的新边界开始。私信历史可按平台能力恢复显示，但不触发发送；不能以重连成功声称事件无遗漏。
- **平台→后台的事件监听**与**后台→页面的业务更新**分层验收：前者不得用固定轮询或 Mock 替代；后者采用一种适合现有服务的推送方式即可，不要求 SSE/WS 双实现，不引入新基础设施。禁止账号/环境列表实时状态探测不等于禁止业务事件推送。
- 监听正常时，从系统收到事件起 **5 秒内开始处理**；已打开且正常连接的相关页面 **30 秒内可见**。自动响应展示接收/处理中，不承诺 30 秒内 AI 或动作完成。页面关闭、离线时不测页面可见时限；重新打开先读取持久结果，再接后续更新，页面断连须可见，不能记成准时展示。
- 分别记录平台事件时间（若提供）、系统接收、处理开始、已打开页面展示及动作结束；缺少平台时间则来源延迟不可测，不填 0。只有系统处理快不证明平台投递及时；每类事件、UID、恢复边界和接近实时能力须经真机证据验收，缺口交用户裁决而非自行删除。

## 5. 环境与代理

### E1. 自动配置环境指纹

- 一账号一环境，首次创建自动生成不同 seed 及相容参数；沿用现有指纹 Chromium 与独立 Profile，不再要求用户手填所有参数。
- 语言、时区按所选代理的明确地区匹配；地区未知或不足以唯一判断时显示待确认并要求人工选择，不默默填入猜测地区。
- 指纹与 Profile 在重启、普通升级后保持；必要手工调整只在环境停止后进行，并显示影响。不每次启动自动换指纹。
- 指纹必须在真实浏览器中生效，不能只验证保存了 JSON；不同账号不串 Profile 或登录资料。
- 不承诺“无法识别”“永不封号”，不开发额外反检测评分或新指纹内核。

### E2. 代理管理

- 支持新增、查看、编辑、删除、停用、重新启用及**手动检测**；支持 HTTP、HTTPS、SOCKS4、SOCKS5 与协议允许的认证配置。
- 显示名称、协议、地址、端口、启停状态、可取得的地区/出口 IP、最近一次检测时间和结果。历史检测不是实时状态，不自动轮询检测。
- 一个环境指定一个代理，多个环境可共用；绑定代理时明确使用哪个记录。环境原有的显式直连能力不作为故障替代路径。
- 更换代理、修改正在被环境使用的连接参数前，必须停止受影响环境；再次启动使用用户明确选定的配置。
- 被环境引用的代理不能直接删除，先解除或更换。停用后不能用于新启动；被运行环境使用时提示先停环境，避免管理状态与实际连接不一致。
- 代理失败显示原因，不静默直连、不自动换代理，不增加批量导入、供应商采购、自动轮换或代理池调度。

### E3. 原生浏览器、多机与任务清理（新增目标，尚未实施）

- 浏览器环境不再由 Docker 创建；复用现有多 gateway 控制，每台 gateway 直接管理本机浏览器进程，由 Xvfb 提供虚拟显示。控制面、数据库的部署方式不因此强制改变。
- 一账号一稳定环境与 Profile，不等于浏览器永久运行。采集任务实际执行时按需启动；成功、失败、取消和超时后均回收任务自建进程、缓存、临时下载等资源，并处理异常退出遗留。
- 账号登录状态、稳定指纹、正式采集结果及素材必须保留；人工登录和自有账号持续事件监听不得被无关任务清理中断。借用既有会话时，只释放本任务创建的资源和使用权。
- Profile 同时只供一个浏览器实例使用；冲突明确等待或拒绝，不复制活跃 Profile、不抢占监听。节点不可达时如实报告，不自动跨机重建账号环境。
- 控制面与 gateway 分别清理本机创建的临时文件；清理校验机器、运行代次与执行归属，旧任务不得覆盖新结果、删除新资源。业务完成与清理完成分别显示，失败不得隐瞒。
- 原生浏览器继续满足 E1 的指纹与 E2 的代理要求；启动成本、内存和磁盘改善必须实测，不以移除 Docker 代替验收。
- 具体方案和待批准项见[变更评审](native-browser-change-review.md)、[实施计划](native-browser-implementation-plan.md)与[验证文档](native-browser-verification.md)。本轮仅文档，不代表已具备原生运行能力。

## 6. 工作台

### W1. 评论来源与采集

- 来源可区分自有账号、已启用的竞品账号；默认覆盖其最近 30 天作品，复用 C2 的回溯天数及 30 分钟更新间隔。
- 本期**只采集一级评论，不采集楼中楼回复**；即使自有账号事件监听能及时发现评论，也不取消这一范围内的定时补充采集与去重。
- 分页获取范围内全部平台可提供的一级评论，支持中断后继续；不能以首屏、热门评论或前 N 条宣称完整。
- 展示来源类型、平台、作品、评论内容、作者 UID/可得昵称、发表时间、采集时间；没有 UID 可查看文字，但不可执行面向该用户的动作。
- 同一平台评论只保存一个逻辑对象；来源同时命中自有和竞品范围时保留来源关联，不生成重复评论或重复线索。删除、隐藏或平台限制导致不可获取时如实说明。

### W2. 主题、关键词及 AI 线索规则

每条规则只包含：名称、启停、来源范围、内容主题说明、包含关键词、排除关键词、AI 线索判定说明。

执行顺序固定：

1. **作品主题**：AI 根据作品标题与正文判断是否符合该规则的主题，不先下载整个视频做主题分析。
2. **评论关键词**：作品主题通过后，评论包含任一包含词且不含任何排除词才通过；词按文本包含匹配，不增加正则表达式编辑器。
3. **评论 AI 判断**：仅对前两步通过的评论判断是否符合线索要求；全部通过才标记线索。

- 关键词采用确定的原文子串匹配：保存时仅去除每个词首尾的普通空格、制表符、CR/LF，空词拒绝；不改变评论原文。区分大小写，不折叠内部空白、不合并全半角、不做 Unicode 规范化。例如 `AI` 不匹配 `ai`，`买 车` 不匹配 `买车`，`é` 不匹配 `e` 加组合重音；包含与排除使用同一规则，不增加可配置归一化系统。
- 必填主题、至少一个包含词和 AI 判定说明，排除词可空。规则可创建、编辑、启停，禁用规则不再参与新判断。
- 同一评论命中多条规则时仍为一条线索，展示所有命中规则、关键词和简短判定原因，不复制成多条待联系对象。
- 显示未分析、非线索、已识别线索、分析失败等真实结果。AI 不可用、结果无法解析或依据不足不能标成“无符合线索”。
- 规则修改不偷偷重写历史结论；记录当时规则内容，用户可明确对已采评论重新分析，并展示最新结果，不增加复杂版本管理界面。
- 线索可按来源、平台、账号、规则、时间筛选；本期不增加销售漏斗、CRM、自动打分和跟进任务系统。

### W3. 人工回复与私信

- 从评论或线索选择发送账号、确认目标，输入/编辑文本后显式发送评论回复或向评论作者发私信。
- 只能选择同平台且具备相应操作条件的自有账号；执行前核对实际登录身份和目标。平台不允许跨账号回复时明确失败，不假装已发送。
- 用户人工确认的操作**不受 A5 自动冷却限制**；线索识别本身不自动发送。
- 成功必须有平台侧可核验证据；未返回确认则标为结果不明，提示先检查原生平台，不能自动重发。
- 一次人工确认在提交前取得持久操作标识，固定账号、目标和实际文本；双击、网络重试、页面重开与进程重启均查询/提交同一标识，不再生成第二次发送。服务端保证同标识至多执行一次，不能只靠按钮禁用。
- 结果不明只提供查询/人工核验并记录证据，不将“重试”变成重新发送；确认未发送也不重用原操作触发。用户确需另发时须重新核对账号、目标和文本、明确再次确认，产生新的操作标识。记录两次操作关系及原因，不能把新发送伪装成结果核验。

### M1. 私信会话

- “登录用户”指当前选择的**已登录平台账号**，不是 CreatorHub 的登录用户名。支持切换账号，展示会话列表、对方、最近消息、时间和消息详情。
- 详情区分收发方向、文本、时间及发送状态；历史消息按平台可提供范围加载，不承诺恢复已删除、不可见或平台未返回的完整历史。
- 新消息通过 A6 的监听更新，不需要持续手动刷新；切换账号和查看历史时可主动读取。监听断开时展示状态并保留已有消息。
- 支持人工输入、确认并发送文本，遵循 W3 的身份、状态、重复提交与结果核验要求，不受自动冷却限制。
- 不新增群聊管理、附件发送、已读回执、AI 自动聊天。平台收到非文本消息时至少标明消息类型/不支持展示，不当作空白文本或丢失会话。

## 7. 必须遵守的最小实现约束

### 7.1 保留必要能力，不扩展通用平台

- 复用当前 Go 控制面、Docker 网关、数据库、浏览器环境以及 React/Refine/shadcn/ui；先核实已安装依赖能力，再决定是否新增依赖。
- 为实际需要的采集、监听、执行和 AI 调用分别划清职责，但**不预建插件市场、通用工作流引擎、任意条件编辑器或多代理框架**。
- 先完成一个平台、少量真实账号的完整流程，不为了假定的海量并发引入微服务拆分、额外 MQ、Redis、分布式调度或多租户系统。确需新增基础设施时说明已有方案不足并确认。
- 复用已有持久任务与记录能力前，必须确认它能处理真实任务；不能把 Mock 换个名字接到界面。不继续保留已被替代的旧业务代码路径或兼容层。
- 指数监测用确定的间隔规则；冷却用明确的用户范围；策略用有序单动作列表；线索用固定三步判断。不要实现能表达任意业务的通用规则系统。
- AI 仅服务于已确认的语音转写/素材理解、仿写、主题与线索判断、无候选文本时的单次响应；配置只满足真实调用，不增加模型市场、自动供应商切换或隐藏降级。

### 7.2 不允许以“简单”为由省略

- 不能省略真实平台接通、分页、断连可见、身份核对、重复事件去重、并发冷却、人工确认、失败与结果不明区分。
- 关键记录能关联平台、账号、作品/评论/事件、命中策略或规则、所选小号、人工确认和最终结果；已有任务/日志页面能承载的内容不另建监控系统。
- 记录排查所需的时间和原因，但不把密码、身份证、Cookie、代理凭据或无关完整私信写入日志。
- 只读采集的临时中断可按下一计划或人工操作恢复；明确的登录/平台验证阻断需人工解决；已经开始的自动写动作及结果不明动作不自动重试。
- 同一执行账号的所有写操作（人工回复/私信及自动动作）统一串行协调，不只锁小号自动任务；实际写入前重新核对停用、业务状态、当前登录身份及目标，自动动作另核对关系/策略。等待执行时条件变化即阻止未开始的操作；已开始结果如实保留，不以停止冒充撤销。并发竞争、重启恢复须有可重复测试。
- 表格、筛选、操作按钮保持克制，沿用现有布局与 RemixIcon；不另造大屏、营销式卡片或装饰性流程编辑器。键盘操作、加载/空/错误/禁用状态必须可用。

### 7.3 成熟产品参考的使用边界

参考 Hootsuite 的[消息条件自动处理](https://help.hootsuite.com/s/article/automatic-actions)、[统一收件箱](https://help.hootsuite.com/s/article/inbox-faq)及[关键词包含匹配](https://www.hootsuite.com/whats-new/partial-keyword-matching-for-inbox-automations)：采用常规的会话列表、保存文本、有序条件判断和可解释分类，不复制其完整企业功能。

这些资料仅作产品行为参考，**不证明抖音/小红书提供相同能力**，也不授权复制源码或界面资产。本次未引入上游代码。

### 7.4 页面地图与操作闭环（推荐路由，不代表已实现）

沿用现有 HashRouter、Layout、表格及抽屉/页签；下列路径省略 `#`。主导航为竞品分析、账号管理、环境管理、工作台；任务/审计保留共用入口，镜像/网关留在现有环境管理入口。设置只含 C2 采集计划与**批准后**的 AI/转写调用配置，不建模型市场。

| 页面与推荐入口 | 列表、详情及关键字段 | 编辑、按钮与跳转 | 对应验收 |
| --- | --- | --- | --- |
| 竞品 `/competitors`，分享任务 `/creator/competitors` | 竞品作者展示平台、昵称/稳定标识、主页、监测启停、最近/下次采集、进度和失败；分享任务展示链接、平台、处理状态、尝试次数和失败原因 | 分享链接直接入队→后台最多尝试3次解析→成功后自动保存作者并监控；失败可查询原因并重新入队；竞品作者启用/暂停、手动更新 | AC-C1、AC-C2、AC-C3、AC-U1 |
| 作品（竞品详情作品页签，跨账号筛选复用同一列表） | C1 字段、C3 筛选、多页加载、已采页/条数及总量未知提示；详情展示原文、指标时间、下一指标计划/停止原因 | 筛选/清空、分页、打开原平台、选取素材；详情抽屉返回保留筛选与页码，进度不以首屏当完成 | AC-C2、AC-C4、AC-C5、AC-C6、AC-U1 |
| 素材（作品详情“素材/文稿”页签） | 选中来源、分步状态、视频/音频预览、转写、无音轨/无语音结果、产物引用与失败原因 | 第一次确认选取后才准备；只重试失败步骤；准备完成后填要求并第二次确认仿写/放弃；标题/口播编辑、保存，保存失败保留输入，无发布按钮 | AC-C7、AC-C8、AC-C9、AC-C10、AC-U2 |
| 账号 `/accounts`、`/accounts/:id` | A1 资料、业务/登录/环境状态分列；详情“资料/登录/大小号与策略/监听记录”页签 | 新增/编辑抽屉、保存/取消；密码只显示已配置；打开绑定的同一浏览器人工登录、重核身份，冲突显示期望/实际标识并停止；跳转环境与任务 | AC-A1、AC-A2、AC-A3、AC-U3 |
| 大小号与策略（账号详情页签） | 同平台小号归属、策略顺序/事件/执行号/单动作、候选文本、大号 AI 要求、冷却时长与占用记录 | 大号开关、关联/解除、策略编辑/启停、上移/下移、保存/取消；文本列表增删；缺 UID/目标/AI 条件显示禁用原因；监听记录可跳转事件任务 | AC-A4、AC-A5、AC-A6、AC-A7、AC-A8、AC-A9、AC-A10、AC-A11、AC-A14、AC-U3 |
| 环境 `/browsers`、`/browsers/:id`；代理 `/network-exits`、`/network-exits/:id` | 账号绑定、指纹、代理地区、历史检测时间和状态；代理引用列表 | 创建/启动/停止/升级/回收保持显式动作；停止后修改、待定地区人工选择；代理增改删/停启/手动检测，引用冲突跳转相关环境。回收不宣称永久删除 | AC-E1、AC-E2、AC-E3、AC-E4、AC-E5、AC-U1 |
| 评论/线索 `/workbench` 的“评论/线索/规则”页签 | W1 字段、W2 筛选、分析状态、命中原因；评论详情展示来源作品与原规则依据 | 规则新增/编辑/启停；明确选择已采评论范围后确认重新分析，展示进度/失败；回复/私信抽屉选择同平台账号、目标/文本预览并确认；跳转作品、账号、任务 | AC-W1、AC-W2、AC-W3、AC-W4、AC-W5、AC-U4 |
| 私信 `/workbench` 的“私信”页签 | 顶部账号选择器、会话列表及消息详情双栏；收发方向/时间/发送结果、历史范围、非文本类型、监听连接状态 | 账号/会话切换隔离请求与草稿；旧请求返回不能覆盖新账号，草稿不带到别的目标；切换有未保存文本时提示保留当前并取消切换或放弃再切换；发送前确认，历史加载/读取失败可重试 | AC-M1、AC-M2、AC-M3、AC-U5 |
| 任务 `/tasks`、`/tasks/:id`，关联 `/audit` | 来源人工/自动、操作/事件标识、账号与目标、策略/规则、实际文本、步骤/时间、证据引用、失败/结果不明 | 由任一业务结果跳转任务，再跳回原作品/评论/会话；只读/素材失败可按规则重试，写结果不明仅“查看平台/核验结果”，新发送需回业务页重新确认 | AC-A12、AC-A13、AC-W5、AC-M3、AC-B1、AC-B2、AC-B3 |
| 设置 `/settings` | 全局采集计划；获批 AI/转写服务、模型/版本、参数和配置记录；秘密仅显示是否配置 | 编辑/保存/取消；校验 C2 边界，保存计划提示只改未来；未批准调用配置不启用相关 AI 动作 | AC-C4、AC-C5、AC-A11、AC-U6 |

**各页共用交互约定**：首次加载显示加载状态，空数据区别于筛选无结果及读取失败；错误保留已有数据和输入并提供适用的重试。翻页失败停在原页；提交中禁用重复按钮、说明具体禁用原因，不把失败清成空列表。只读重试不触发写入；写入结果不明遵循 W3。表单离开、取消或切换页签前提示未保存内容，可留在原处继续编辑或明确放弃；可保存的资料/文稿先保存成功才离开，发送草稿不能以“保存”代替发送确认。键盘可达、焦点回到触发入口，详情返回保留原列表筛选和分页；无权取得的字段明确不可获取，不能编造默认值。

## 8. 验收清单

下表是功能验收要求。本轮仅执行本地单元测试、构建和静态诊断，未执行真实平台功能测试。每项记录平台、输入、操作、预期、实际结果和证据；“不支持/待验证”不得填写通过。

### 8.1 竞品与素材

| 编号 | 场景 | 必须观察到的结果 |
| --- | --- | --- |
| AC-C1 | 主页链接、可解析分享链接、重复链接、无效链接 | 正确确认目标；同账号不重复；无效/身份不明有具体错误，不创建假账号 |
| AC-C2 | 在回溯范围内准备超过一页作品，包含窗口内外作品 | 页间无漏项/重复；范围边界按发布时间正确处理；首批 20 条不是完成标志 |
| AC-C3 | 采集中断、恢复，暂停后到检查时间 | 可继续采集，已完成内容不重复；暂停不再启动新采集，历史数据仍可查看 |
| AC-C4 | 使用可控时钟测试新作品与指标计划 | 新作品默认每 30 分钟检查；指标累计 1/3/7/15/31/55 小时，24 小时封顶，满 30 天停止；两种计划独立 |
| AC-C5 | 首次发现旧作品、服务中断、修改计划 | 即时采一次后按未来时刻执行；不补跑全部错过计划，不制造历史指标 |
| AC-C6 | 阈值以下/等于/以上、缺失指标、真实 0、指标下降 | 等值入选；所有已填条件同时满足；缺值不当 0；真实值正确更新 |
| AC-C7 | 浏览爆款但不选取；选取后不确认仿写 | 前者没有媒体/AI 转写任务；后者只准备素材，不生成仿写稿 |
| AC-C8 | 素材成功、无音轨、转写失败、重复点击 | 视频/音频/真实转写可核验；异常分步显示；一次确认不产生重复任务 |
| AC-C9 | 素材准备后确认或放弃仿写 | 确认后才生成可编辑标题及口播文案；来源、用户要求对应；放弃不调用生成；不发生自动发布 |
| AC-C10 | AI 失败或素材步骤失败 | 失败不冒充成功；下载/转写失败时禁止确认仿写，解决失败后才可确认；无音轨与任务失败明确区分 |

### 8.2 账号、自动响应与监听

| 编号 | 场景 | 必须观察到的结果 |
| --- | --- | --- |
| AC-A1 | 新增/修改资料，区分账号 UID、用户名、实名与业务状态 | 字段分别保存与显示；不伪称平台已实名；凭据不进入日志 |
| AC-A2 | 有/无密码、有效登录、密码错误、验证码、身份不符 | 有效会话复用；失效后进入人工登录；错误有原因，不循环尝试、不误认别的账号 |
| AC-A3 | 正常→禁言/封禁/注销→正常 | 执行限制符合 A1；已有数据可查；恢复后不擅自重启策略或补发历史互动 |
| AC-A4 | 自关联、跨平台、重复归属、大小号循环、调整关系 | 非法关系被拒绝；变更停用受影响策略，不产生错误账号动作 |
| AC-A5 | 四类大号收到的互动 | 评论、点赞、转发、关注均用真实事件证明；大号主动操作不误触发；无 UID/目标明确提示 |
| AC-A6 | 多条策略匹配、首条不可用、选中后失败 | 按优先顺序仅执行一个可用策略的单个动作；开始后不换小号补发 |
| AC-A7 | 私信、回复、点赞评论/作品、关注、转发 | 各动作在真实平台确认目标、账号及结果；不相容事件/动作不猜目标，不能用一次私信证明所有动作可用 |
| AC-A8 | 同 UID 多事件、多小号并发及跨动作 | 同一大号冷却内总共只开始一个自动动作；不是每个小号各执行一次 |
| AC-A9 | 不同 UID、不同大号、到期边界、重复事件、重启 | 冷却范围正确；到期可响应新事件；旧事件永不重放；重启不清空冷却 |
| AC-A10 | 失败、结果不明、AI 失败、修改冷却时长 | 已开始的名额保留到原到期；不补发；未开始的无匹配事件不占用冷却 |
| AC-A11 | 多条候选文本、单条文本、空候选、无 AI 配置 | 文本来自候选集；空候选才使用大号 AI 要求；配置不足不能启用；生成失败/空/超长停止 |
| AC-A12 | 监听建立、启用、断连、重连、登录失效 | 新互动被处理；历史通知不触发；断连/缺口可见；重连无重复动作，不用轮询冒充监听 |
| AC-A13 | 监听正常时收到互动与私信 | 收到后 5 秒内开始处理、30 秒内页面可见；平台推送与最终动作耗时单独记录，不掩盖来源延迟 |
| AC-A14 | 关闭大号模式、停用策略、账号状态改变与执行竞争 | 尚未开始的动作被阻止；已开始的实际结果可追踪，不假装撤销或再执行 |

### 8.3 环境与代理

| 编号 | 场景 | 必须观察到的结果 |
| --- | --- | --- |
| AC-E1 | 至少两个账号新建环境、重启、升级 | 自动生成不同 seed；单账号指纹/Profile 保持，真实浏览器参数生效，登录不串号 |
| AC-E2 | 代理地区明确、未知、多时区 | 可确定时正确匹配；不确定时请求人工确认，不静默猜测 |
| AC-E3 | 四类代理按合法配置连接、认证失败、网络失败 | 真实浏览器走选定出口；支持的认证方式有证据；失败不静默直连或轮换 |
| AC-E4 | 编辑、停用、重新启用、删除被引用代理 | 运行引用须先停环境；引用未解除不得删除；重新启动使用明确配置 |
| AC-E5 | 打开账号/环境/代理列表，点击手动检测 | 打开列表不触发实时状态探测或轮询；只在用户明确操作时检测，显示检测时间 |

### 8.4 评论线索与私信

| 编号 | 场景 | 必须观察到的结果 |
| --- | --- | --- |
| AC-W1 | 自有/竞品来源、多页评论、楼中楼、重复来源 | 范围内一级评论无页间遗漏/重复；不采楼中楼；来源正确，缺 UID 禁止定向动作 |
| AC-W2 | 主题不匹配、主题匹配但无关键词、命中排除词、AI 否定/肯定 | 严格按“作品主题→关键词→评论 AI”执行；只有全部通过才生成线索 |
| AC-W3 | AI 异常、规则禁用/修改、显式重新分析、多规则命中 | 失败不当非线索；禁用不再判断；历史依据保留；多规则只产生一个评论线索 |
| AC-W4 | 人工回复/私信，自动冷却尚未到期 | 人工确认仍可发送；线索出现不自动发送；账号、目标、文本及平台结果一致 |
| AC-W5 | 双击发送、错账号、超时、平台拒绝 | 一次操作至多发送一次；身份不符拒绝；超时不明不自动重发；平台失败如实显示 |
| AC-M1 | 切换两个已登录账号、查看列表与消息详情 | 会话按所选账号隔离；收发方向、时间、历史范围正确，不串消息 |
| AC-M2 | 收到新文本、非文本、断连后重连 | 文本接近实时更新；非文本有类型提示；断连可见、重连不重复，不自动回复 |
| AC-M3 | 会话内人工文本发送、禁言账号、结果不明 | 正常账号人工确认后发送；禁言被阻止；证据不足保持结果不明、不补发 |

### 8.5 新增页面与边界验收（原 37 项编号及含义保留）

| 编号 | 场景 | 必须观察到的结果 |
| --- | --- | --- |
| AC-U1 | 页面地图列表/详情跳转，加载/空/错误/禁用，分页失败及返回 | 导航可达；字段、进度、计划和原因可读；错误不当空数据；筛选/页码保留，不触发状态探测 |
| AC-U2 | 素材两次确认、分步失败/重试、无语音、文稿保存失败及离开 | 两道确认独立；成功产物复用；无音轨/无语音可继续；保存失败保留编辑，未保存离开有提示 |
| AC-U3 | 账号编辑、密码配置、人工登录、身份冲突、策略排序与监听记录 | 资料保存准确；密码可输入而不回显/泄露；同环境处理登录；策略顺序可见可保存，身份冲突阻止执行 |
| AC-U4 | 规则编辑、显式选择范围重新分析，查看线索并人工确认 | 原依据可查；新分析范围/进度/失败可见；线索不自动发送，确认中账号与目标明确 |
| AC-U5 | 两账号/会话切换，草稿未保存、旧请求迟返、非文本/断连 | 消息与草稿不串号；离开可取消/放弃；旧响应不覆盖新视图，非文本及断连可见 |
| AC-U6 | 修改设置、未批准 AI 配置、表单校验/保存失败 | 只含批准范围；未批准不调用；无效时间拒绝，失败保留输入且未来计划不误改 |
| AC-B1 | 缺事件身份、首次历史、缺时间、断连/停用/重启、冷却到期旧事件 | 按 A6 基线与永久去重；不猜唯一、不擅自补发，缺口/迟到可见；缺 UID 的所有自动动作均阻止 |
| AC-B2 | 人工/自动同账号并发、等待中停用/换身份/目标变化、发送后响应丢失 | 写操作不串扰且执行前重核；同操作跨重启不再发送；不明仅核验，新发送另行确认 |
| AC-B3 | 后台监听时关页、打开正常页面、页面独立断连再打开 | 关页不停止监听；5 秒处理与正常已开页面 30 秒可见分别有时间证据；重开恢复持久结果，来源延迟不可测不填 0 |
| AC-B4 | UTC 跨夏令时、恰好计划/回溯/30 天边界、缺发布时间 | 按 C2 固定时长及包含边界；到期一次、停止优先、不猜时间、不回填历史 |
| AC-B5 | 大小写、内部空白、全半角、组合字符、空关键词 | 严格按 W2 原文子串匹配与保存规则，可用确定样例重现，不隐含规范化 |
| AC-B6 | 多页读取、真实媒体产物预览、磁盘/配额不足 | 读取和媒体分离且有真实证据；资源不足分步失败可查，不未经授权删除素材 |

### 8.6 AI 质量与真实平台门槛

- 在相关功能开发前，与使用者共同选取脱敏的主题/非主题、包含词/排除词、线索/非线索、边界评论样本，逐条标注预期。硬性三步执行、停用、失败和禁发规则必须全部通过，不能交给 AI 自行决定。
- 转写样本包含清晰语音、背景音乐、无语音；用户核对关键内容及缺失提示。仿写样本核对标题/口播结构、用户要求、来源关联和可编辑性；自动文本样本核对大号回复要求、目标与平台长度限制。
- 已确认采用**使用者批准的样本逐项验收**；AI 语义准确率、转写误差率和创作质量尚无量化阈值，不编造 95% 等承诺。在相关功能开发前共同标注样本与可接受误差，再确定质量门槛；未经样本确认不能将 AI 质量标为已验收。
- 每个平台至少使用一个大号、两个小号及可控互动账号验证关系和冷却；竞品/评论样本需包含超过一页数据。只读样本与可控写入样本分别准备，不向无关真实用户发送测试消息。
- 为每个平台填写下方能力证据表；全部未接通项均保持未通过。
- 本期不承诺任意规模吞吐或永久不受平台限制；生产规模需要真实使用数据后再确认，不预先添加容量平台。

### 8.7 逐平台能力证据矩阵模板

状态仅为**待验证 / 支持 / 条件支持 / 不支持**；支持不等于验收已通过，仍须有对应 AC 结果。每个分项逐平台记录测试日期、客户端/平台版本、授权样本、复现操作、脱敏证据位置及限制；条件支持/不支持不得自动删项，范围改变另记用户批准。下表为初始登记，**无真机结论**；复合行执行时按行内分项各填一行，不以某一事件/动作成功代表全部。

| 能力（须逐分项记录） | AC 关联 | 抖音状态 | 小红书状态 | 证据 | 限制 | 用户变更批准 |
| --- | --- | --- | --- | --- | --- | --- |
| 主页/分享链接解析、稳定账号标识 | AC-C1 | 待验证 | 待验证 | 待提供 | 待核实 | 无 |
| 作品/一级评论全部分页、发布时间/窗口 | AC-C2、AC-W1、AC-B4 | 待验证 | 待验证 | 待提供 | 待核实 | 无 |
| 点赞数、评论数、转发数 | AC-C6 | 待验证 | 待验证 | 待提供 | 待核实 | 无 |
| 视频下载、音频提取、无语音结果 | AC-C8、AC-C10、AC-B6 | 待验证 | 待验证 | 待提供 | 待核实 | 无 |
| 登录复用、用户名密码、同环境人工登录/身份核对 | AC-A2、AC-U3 | 待验证 | 待验证 | 待提供 | 待核实 | 无 |
| 评论、点赞、转发、关注事件各自的 ID/UID/目标/时间 | AC-A5、AC-A12、AC-B1 | 待验证 | 待验证 | 待提供 | 待核实 | 无 |
| 基线、断连恢复/缺口、游标稳定性、迟到分类、投递延迟 | AC-A9、AC-A12、AC-A13、AC-B1、AC-B3 | 待验证 | 待验证 | 待提供 | 待核实 | 无 |
| 私信、回复评论、点赞评论/作品、关注、转发动作及成功核验证据 | AC-A7、AC-W4、AC-W5、AC-B2 | 待验证 | 待验证 | 待提供 | 待核实 | 无 |
| 私信账号隔离、历史范围、文本/非文本监听、人工文本发送 | AC-M1、AC-M2、AC-M3、AC-U5 | 待验证 | 待验证 | 待提供 | 待核实 | 无 |
| 指纹/Profile 稳定、代理实际出口及认证方式 | AC-E1、AC-E2、AC-E3 | 待验证 | 待验证 | 待提供 | 待核实 | 无 |

## 9. 实现顺序与检查要求

| 阶段 | 可交付结果 | 通过条件 |
| --- | --- | --- |
| G0：证据与输入冻结 | 抖音能力矩阵、事件身份/基线/恢复边界、AI 验收包 | 缺可靠事件身份/UID/目标/监听证据即阻塞相应自动能力；不以 Mock 通过。冻结脱敏样本及逐条预期、允许误差、服务商/模型版本/参数/提示要求等配置记录；服务商、样本、质量阈值或费用未获批准仍为前置待确认，不作已批准声明 |
| G1.1：抖音账号与环境 | 账号资料、凭据、同环境登录/身份核对、稳定指纹与代理 | AC-A1、AC-A2、AC-A3、AC-E1、AC-E2、AC-E3、AC-E4、AC-E5、AC-U3 的相关部分独立验证 |
| G1.2：抖音只读采集 | 竞品导入、作品/一级评论分页、计划与筛选 | AC-C1、AC-C2、AC-C3、AC-C4、AC-C5、AC-C6、AC-W1、AC-U1、AC-B4 |
| G1.3：抖音媒体与 AI | 两次素材确认、文稿编辑保存、主题/关键词/线索及重新分析 | AC-C7、AC-C8、AC-C9、AC-C10、AC-W2、AC-W3、AC-U2、AC-U4、AC-U6、AC-B5、AC-B6；批准样本逐项核验 |
| G1.4：抖音人工动作 | 评论/线索逐次确认、真实执行、任务证据与不明核验 | AC-W4、AC-W5、AC-B2 的人工部分；私信动作先验证发送，不以此代替完整会话 |
| G1.5：抖音监听与自动响应 | 大小号、有序五动作、四事件、AI 候选、冷却与恢复 | AC-A4、AC-A5、AC-A6、AC-A7、AC-A8、AC-A9、AC-A10、AC-A11、AC-A12、AC-A13、AC-A14、AC-B1、AC-B2、AC-B3；补齐人工/自动竞争证据 |
| G1.6：抖音私信及完整回归 | 账号隔离会话、历史/非文本、新消息、人工文本发送 | AC-M1、AC-M2、AC-M3、AC-U5；G1 全部片段及第 8 节所有抖音适用项通过后才称抖音完整完成 |
| G2：小红书完整流程 | 先独立重复 G0 证据核实，再按 G1.1 至 G1.6 同范围验证 | 每项取得小红书证据；差异须用户批准，不以抖音、账号登记或部分功能替代 |
| G3：整体回归 | 两平台共存、错误恢复、无串号及无重复发送 | 所有适用项有证据，未通过项清零或经用户明确调整需求；分段验收不替代最终完整范围 |

后续代码变更遵循 [AGENTS.md](../AGENTS.md)：

- 非平凡行为先写能在未实现时失败的最小回归测试，单元测试覆盖率至少 65%；尤其覆盖时间边界、并发冷却、监听重复、平台失败及人工/自动区别。
- 控制面通过 `go test ./...`、`go vet ./...`，并构建 `./cmd/control-plane`；并发、生命周期与共享状态变更运行 `go test -race ./...`。Python gateway 通过 `python3 -m unittest discover -s cmd -p 'test_*.py'` 和覆盖率检查；Compose 变更运行 `docker compose config --quiet`。
- 前端从 lockfile 安装、通过非交互测试及 `npm --prefix web run build`；关键页面覆盖加载、空数据、错误、禁用、确认/取消和重复点击。
- 离线测试只证明本地逻辑，真实平台必须另外验收；请求返回 200、任务入队、模拟连接器成功均不能代替平台动作成功。

### 9.1 本轮文档完成标准

- 原始四模块需求均有对应细化、边界及验收项；逐项确认的业务选择无遗漏、无相反表述。
- 区分现状、目标、已确认规则与待真实验证的外部条件，不将建议数值或 AI 质量写成未经确认的承诺。
- 相对链接有效、验收编号唯一、Markdown 检查通过；代码修正与本文件的现状描述同步。

### 9.2 后续必须确认而不得猜测的事项

业务流程已按本轮对话确定。以下依赖真实验证或尚未提供的材料，**不阻塞本文交付，但阻塞相应功能最终验收**：

1. 两平台每类事件是否提供可靠事件身份、互动者 UID、明确目标、历史基线和接近实时投递；断连恢复范围及迟到事件处理须按 A6/G0 验证并批准，无法提供时由使用者决定该项替代或范围调整。
2. 平台未提供的指标、下载能力、动作限制、账号密码登录方式及历史消息范围，须逐项给证据，不能通用地写成“尽力支持”。
3. 使用者指定/批准的 AI、转写服务及调用配置、脱敏评价样本与质量门槛；不擅自选择付费服务或上传整库资料。
4. 遇到本文之外的事件类型、业务状态、自动聊天、批量发送、视频生成或规模要求，重新确认需求，不顺带扩展。

### 9.3 本轮评审处理表

| 问题或评审说法 | 修复位置 | 处理结论 |
| --- | --- | --- |
| 旧“仅自有/阶段 A 离线”覆盖新范围，架构栈/生命周期互相矛盾 | 2.1、2.2；旧产品首页、架构、部署 | 历史与目标分开，当前代码事实单独说明，不新增永久删除 API 或认证方案 |
| 功能尚未实现即计划缺陷 | 第 2 节、第 9 节 | 评审误判：属于实现差距，不用 Mock 冒充完成，也不删需求 |
| 无音轨/无语音必须重新决定；API 应禁止接收密码 | C4、A1、AC-U2、AC-U3 | 评审误判：已确认可继续；密码允许输入凭据流程，禁止回显/日志泄露，不阻断录入 |
| 页面不够可执行，缺跳转与异常状态 | 7.4、8.5 | 紧凑页面地图与共用交互，优先现有页签/抽屉，无新通用系统 |
| 去重/冷却、基线/断连、人工重试与并发边界不足 | A3、A5、A6、W3、7.2、AC-B1 至 AC-B3 | 可靠身份、永久最小去重、迟到核验、持久操作标识及同账号写协调 |
| 时间/文本匹配不确定，媒体读取限制误当需求缺陷 | C2、W2、C4、AC-B4 至 AC-B6 | 固定 UTC 时长、原文匹配、分步产物引用；真实分页/媒体另验，不预设扩容或自动删素材 |
| AI 输入未冻结、平台能力无证据模板、G1 过大 | 8.6、8.7、第 9 节 | G0 保留外部批准前置，矩阵全为待验证；G1 分段可验但不替代最终完整流程 |

### 9.4 当前本地实现状态

- 已有：CreatorHub 数据表与 API、账号/大小号关系约束、规则与线索判断、作品/一级评论分页采集边界、断点租约、来源关联、固定指标计划、抖音自有/竞品只读采集调度、Python gateway 事件 ACK/恢复边界、写操作证据分类、媒体下载/FFmpeg 提音轨/显式转写命令链，以及工作台的错误/确认状态。
- 尚未完成或尚未取得外部证据：转写供应商质量样本、小红书同范围动作、真实平台事件连续性及每类写操作成功证据。未提供配置或平台能力时，接口应明确返回 unavailable/uncertain/failed，不以 Mock 通过代替。
- 本地限制：数据库集成测试必须提供专用 PostgreSQL 地址并保留实际 executed/skipped 记录；Python gateway 生产覆盖率必须按排除测试代码的同次报告验收。CI 或后续环境需重复这些验证。