mcn-dou-analysis 内嵌副本结构整合（08-27 主版本定稿）

- references-add/ 内容迁入 references/：路径配置.md、铁律避坑规则/（账号数据分析执行避坑、账号设定执行避坑）改为标准库，references-add 仅留 README
- 五功能文件（01获取账号信息/02获取视频/03提炼账号设定/04分析视频数据/05解析视频）与 SKILL.md、MCP 规范、excel_tool.py、select_top6.py 同步更新
- 记忆日志（08-26 追加/08-27 新增）+ MEMORY.md + 失误与规避记录

project/短视频脚本创作/V1.0/subskill/mcn-dou-analysis/references/铁律避坑规则/账号设定执行避坑.md

@@ -0,0 +1,32 @@
+# 铁律避坑规则（功能三：提炼账号设定）
+
+> 本文件记录账号设定提炼（功能三）执行过程中踩过的坑和沉淀的解决方案，防止重复犯错。
+> 与「账号数据分析执行避坑.md」（功能四）互为镜像，结构一致。
+
+## 一、工具/工艺类
+
+| # | 问题现象 | 根因 | 解决方案 | 沉淀状态 |
+|---|---------|------|---------|---------|
+| 1 | PowerShell `ConvertTo-Json` 序列化大文本（人设卡全文约 1.5 万字符）后 `Invoke-RestMethod` POST 接口超时（120s 卡死，后台任务被终止） | PowerShell `ConvertTo-Json` 对大字符串序列化性能差，请求发送阶段卡住；最小 payload（几十字节）46ms 即成功，证明是**请求体大小**问题而非接口问题 | 接口调用改用 **Python 直连构造 JSON**（`urllib.request` + `json.dumps(ensure_ascii=False)`），绕开 PowerShell ConvertTo-Json；大文本一律走 Python，不用 PowerShell 序列化 | 已沉淀为本规则 |
+| 2 | 写库后无法确认是否写入成功（后台任务消失、无输出） | 后台 job 被终止后状态丢失，接口又无查询列表端点 | 用**幂等重试**验证：同 payload 重复提交，返回 `analyses:0` 即证明已去重入库（脚本层自动去重）；POST 接口本身是最可靠的验证手段 | 已沉淀为本规则 |
+| 3 | 人设卡写入数据库时误用测试 payload 探测接口，留下脏数据 | 先用最小 payload 测连通性，意外写入 1 条测试记录 | 探测接口连通性用 `GET`（如 `/mcn/api/account/videos?accountId=X`），**不用写接口探测**；若已写入测试数据，同账号+type 重复提交正式内容会覆盖（脚本层按 账号+类型 去重） | 已沉淀为本规则 |
+
+## 二、数据质量类
+
+| # | 问题现象 | 根因 | 解决方案 | 沉淀状态 |
+|---|---------|------|---------|---------|
+| 4 | 平台返回的 analysis 为 6 字段简化格式（缺赛道/人设/框架/事件等核心维度） | 部分视频平台侧解析版本较旧，仅返回简化分析 | 以平台实际返回为准照实保存，在人设卡「设定分析说明」中标注该条深度弱于其他条；不得凭印象补造缺失维度；后续可用功能五单独重解析替换 | 已沉淀为设定分析说明规则 |
+| 5 | 既有解析产物 detailId 与 aweme_id 不一致（如 26164 vs 7667477088350044069） | detailId 是业务解析 ID，aweme_id 是抖音视频 ID，两者本就不同 | 校验产物归属时用**标题匹配**而非 ID 匹配；detailId 不用于对照视频来源 | 已沉淀为校验规则 |
+
+## 三、流程/规范类
+
+| # | 问题现象 | 根因 | 解决方案 | 沉淀状态 |
+|---|---------|------|---------|---------|
+| 6 | 本地接口（`/mcn/api/...`）调用规范未沉淀，每次现查 | 无统一接口调用规范文件 | 新建 `references/接口调用/本地接口调用规范.md`，记录接口基地址判定（`$env:DSH_WEB_URL` → 3080/3081 兜底）、接口清单、请求构造方式（Python 直连优先） | 已沉淀为本规则 |
+| 7 | 生成人设卡前未先判定账号类型就套模板 | 账号类型判定是模板选择前置 | 严格执行 5.0 判定：从筛选出的 TOP 视频 analysis「人设」字段提取主角名称 → 全部不同=群像型 / 同一主角=固定主角+轮换搭档 / 全固定=单一达人型 | 已沉淀为人设卡生成方法 5.0 |
+
+---
+
+## 快速参考：本地接口调用（功能三写库用）
+
+> 接口基地址判定、接口清单、请求构造铁律，见 `references/接口调用/本地接口调用规范.md`。