maogeigei
d9576c19dd
- 新建 references/铁律避坑规则/已有数据处理规则.md：分场景决策表+判断依据（产出目录权威/质量校验/增量处理）+散落规则收敛出处 - SKILL.md 加「已有数据处理（统一决策）」引用行 - 工作台 docs/AI会话任务输入输出对照.md 关键细节加已有数据处理条目
4.4 KiB
4.4 KiB
已有数据处理规则（数据库中已有数据时如何处理）
定位：统一决策表——用户要求「获取账号数据 / 提取账号设定 / 分析视频」时，库中已有数据的处理策略。 收敛散落规则：SKILL.md「账号信息数据源（红线）」、
feature/01_获取账号信息.md（更新时间）、feature/06_生成账号设定卡片.md（触发判定链）、feature/04_分析视频数据.md（表格/人设复用）、server.js/api/import/account（入库去重）。 更新：2026-09-01
核心原则（一句话）
库中已有 ≠ 可直接使用。 分两类处理：
- 实时数据（账号信息/视频列表）→ 必须重新获取（红线：数据库不是数据源，禁回填）
- 分析产物（人设卡/视频解析/分析报告）→ 复用优先 + 询问是否更新，只对增量（新视频/未解析）补获取
数据库角色 = 流程状态参考 + 产物复用，不是数据源。
分场景决策表
| 用户要求 | 库中/目录已有数据 | 处理方式 | 依据 |
|---|---|---|---|
| 获取账号数据（功能一） | hot_accounts 有该账号 / 账号表已登记 | 必须浏览器重新抓取，库数据禁止回填（红线）；抓取前查「更新时间」：近 1 个月内 → 提示用户判断是否刷新，避免无谓重复抓取；抓取后回填 + 更新「更新时间」YYYY-MM-DD HH:MM |
SKILL.md 红线 + feature/01 |
| 提取账号设定（功能三） | 产出目录有 {账号名}账号设定.md / 库 account_persona 有该账号 |
复用优先：设定文件已存在 → 走触发判定链「询问覆盖 or 微调」，不静默重跑；无设定 → 才走全链路提炼 | feature/06 触发判定链（7 种情况） |
| 分析视频（功能四/五） | 视频文件夹有 content.json / 库 account_video_source 有该视频解析 | 已解析 → 直接复用解析产物，不重复调 MCP 解析；已有 短视频表格.xlsx → 直接读，不重抓列表；只对未解析/新增视频补解析 |
feature/04「数据缺失处理」+「两段式强制流程」 |
| 重跑入库（工作台侧） | 各表已有行 | 入库接口 upsert 去重：account_video_source/account_video_analysis 按 aweme_id 删旧保新；account_persona/account_analysis 重复跳过（不覆盖已有） |
server.js /api/import/account |
三个判断依据（执行前必查）
-
产出目录是权威，数据库是副本
- 判断「是否已有」优先看产出目录文件：
{产出根目录}/{账号名}/下的{账号名}账号设定.md、短视频表格.xlsx、视频分析/{标题}_标签/目录 - 库表只作状态参考——库可能未入库而缺（分析产物落盘 ≠ 自动入库），也可能含脏数据（见第 2 条）
- 判断「是否已有」优先看产出目录文件：
-
「已有」必须校验内容质量（存在 ≠ 有效）
- 实测案例：库中 1629 有 1 条 8 字符的「连通性测试」假 persona——判定「有设定」前先校验内容长度/完整性，假数据视为「无」
- 人设卡/分析报告：校验关键章节存在（如人设卡含赛道/受众/内容基因等核心维度）；视频解析：校验 content/analysis 非空且为有效结构
-
新增/变更才增量处理
- 同账号二次分析：只对库中/目录中没有的（新视频、未解析视频、新产出类型）增量获取
- 已解析视频重复出现在请求中 → 直接复用，不重跑浏览器/MCP，避免资源重复消耗
已收敛的散落规则出处
| 原规则 | 位置 |
|---|---|
| 数据库仅状态参考、禁回填账号字段 | SKILL.md「账号信息数据源（红线）」 |
| 更新时间近 1 月提示刷新 | references/feature/01_获取账号信息.md |
| 卡片存在询问覆盖/微调（触发判定链） | references/feature/06_生成账号设定卡片.md |
| 已有表格直接读、人设卡对齐、解析降级 | references/feature/04_分析视频数据.md |
| 入库 upsert 去重（删旧保新/重复跳过） | mcn-work-shop/server.js /api/import/account |
相关接口速查
- 工作台库：
mcn-work-shop/mcn-plugin.db（表：hot_accounts / account_persona / account_analysis / account_video_source / account_video_analysis / account_videos） - 产出根目录：以
references/路径配置.md为准（开发机默认桌面MCNSkill项目/）