mcn-short-video/project/短视频脚本创作/V1.0/subskills/mcn-dou-analysis/references/铁律避坑规则/账号信息获取执行避坑.md

# 铁律避坑规则（功能一：获取账号信息）

> 本文件记录账号信息获取（功能一）执行过程中踩过的坑和沉淀的解决方案，防止重复犯错。
> 与「账号设定执行避坑.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_获取账号信息.md` Step 1.0。

| 数据 | 允许来源 | 禁止来源 |
|------|---------|---------|
| 账号身份标识（抖音号/sec_uid/抖音地址） | **浏览器抓取**（browser-harness 访问抖音主页） | 工作台库 `mcn-plugin.db`（hot_accounts 表 = MCP 内部账号库本地副本）、MCP `list_hot_accounts`/`hot_account_detail` |
| 账号统计数据（粉丝/获赞/关注/作品/IP/简介） | **浏览器抓取**（网页实时值） | 同上（MCP 兜底仅限浏览器无法访问时，须注明来源） |
| 流程状态参考（是否已解析/已生成） | 工作台库**只读参考** | ——（只用于判断，不回填账号表） |