3.5 KiB
3.5 KiB
铁律避坑规则（功能一：获取账号信息）
本文件记录账号信息获取（功能一）执行过程中踩过的坑和沉淀的解决方案，防止重复犯错。 与「账号设定执行避坑.md」（功能三）、「账号数据分析执行避坑.md」（功能四）互为镜像，结构一致。
一、工具/工艺类
| # | 问题现象 | 根因 | 解决方案 | 沉淀状态 |
|---|---|---|---|---|
| 1 | （预留） |
二、数据质量类
| # | 问题现象 | 根因 | 解决方案 | 沉淀状态 |
|---|---|---|---|---|
| 1 | 账号表登记（TC-01）时直接用工作台库 mcn-plugin.db 的 hot_accounts 表读取 sec_uid/抖音号/地址填表，被用户指出「为什么又走到 MCP/库去了」 |
① 就近取数惯性：模型遇到填表需求优先找现成数据（库读取成本低、看起来权威），而非走浏览器实时抓取（成本高）；② 规则覆盖缝隙：SKILL.md L50 红线约束的是「获取达人账号信息（功能一）」抓取流程，Step 1.0 只说「存文本格式」未规定身份标识（sec_uid/抖音号/地址）的数据来源，登记占位阶段钻了空子；③ 同源性未识别：hot_accounts 表 = MCP 内部账号库（list_hot_accounts/hot_account_detail）的本地副本，绕道读 db 拿到的是同一份内部账号库数据，形式上"没碰 MCP"实际同源违规；④ 前置检查（P4 MCP 可用性）在 TC-01 阶段就调 MCP 工具（auth_status），加剧用户观感 |
① 登记只占位 账号ID+达人昵称，身份标识一律留空待浏览器抓取后回填；② 红线明确「禁止从任何数据库读取账号字段回填账号表（含身份标识）」，hot_accounts 表 = 内部账号库本地副本，读其数据等同违反红线（已固化 SKILL.md「账号信息数据源」红线 + feature/01 Step 1.0）；③ 库仅用于流程状态参考（判断是否已解析/产出），不是账号数据来源；④ MCP 工具调用严格限定在 TC-05 视频解析环节，前置检查只确认可用性，TC-01 登记阶段不调用 MCP 工具 |
已沉淀为本规则（2026-08-31 强化） |
三、流程/规范类
| # | 问题现象 | 根因 | 解决方案 | 沉淀状态 |
|---|---|---|---|---|
| 1 | 账号数据来源规则分散在 SKILL.md/feature/浏览器规范多处，无统一避坑记录 | 功能一/二无独立避坑文件 | 新建本文件（功能一避坑），与功能三/四避坑文件并列；数据来源红线唯一权威定义在 SKILL.md，本文件只记录案例与根因 | 已沉淀为本规则 |
快速参考：数据来源红线速查
权威定义：SKILL.md「账号信息数据源（红线）」；执行流程：
references/feature/01_获取账号信息.mdStep 1.0。
| 数据 | 允许来源 | 禁止来源 |
|---|---|---|
| 账号身份标识（抖音号/sec_uid/抖音地址） | 浏览器抓取（browser-harness 访问抖音主页） | 工作台库 mcn-plugin.db（hot_accounts 表 = MCP 内部账号库本地副本）、dsh 原库、MCP list_hot_accounts/hot_account_detail |
| 账号统计数据（粉丝/获赞/关注/作品/IP/简介） | 浏览器抓取（网页实时值） | 同上（MCP 兜底仅限浏览器无法访问时，须注明来源） |
| 流程状态参考（是否已解析/已生成） | 工作台库/dsh 库只读参考 | ——（只用于判断，不回填账号表） |