docs(分析技能+工作台): 固化已有数据处理规则(库中已有≠可直接使用,复用优先+询问更新)
- 新建 references/铁律避坑规则/已有数据处理规则.md:分场景决策表+判断依据(产出目录权威/质量校验/增量处理)+散落规则收敛出处 - SKILL.md 加「已有数据处理(统一决策)」引用行 - 工作台 docs/AI会话任务输入输出对照.md 关键细节加已有数据处理条目
This commit is contained in:
1 parent
4d5c50ef47
commit
d9576c19dd
4 files changed
+59
No files matched your search
@@ -0,0 +1,51 @@
|
||||
# 已有数据处理规则(数据库中已有数据时如何处理)
|
||||
|
||||
> 定位:**统一决策表**——用户要求「获取账号数据 / 提取账号设定 / 分析视频」时,库中已有数据的处理策略。
|
||||
> 收敛散落规则: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` |
|
||||
|
||||
## 三个判断依据(执行前必查)
|
||||
|
||||
1. **产出目录是权威,数据库是副本**
|
||||
- 判断「是否已有」优先看产出目录文件:`{产出根目录}/{账号名}/` 下的 `{账号名}账号设定.md`、`短视频表格.xlsx`、`视频分析/{标题}_标签/` 目录
|
||||
- 库表只作状态参考——库可能**未入库而缺**(分析产物落盘 ≠ 自动入库),也可能含**脏数据**(见第 2 条)
|
||||
|
||||
2. **「已有」必须校验内容质量(存在 ≠ 有效)**
|
||||
- 实测案例:库中 1629 有 1 条 8 字符的「连通性测试」假 persona——判定「有设定」前先校验内容长度/完整性,**假数据视为「无」**
|
||||
- 人设卡/分析报告:校验关键章节存在(如人设卡含赛道/受众/内容基因等核心维度);视频解析:校验 content/analysis 非空且为有效结构
|
||||
|
||||
3. **新增/变更才增量处理**
|
||||
- 同账号二次分析:只对**库中/目录中没有的**(新视频、未解析视频、新产出类型)增量获取
|
||||
- 已解析视频重复出现在请求中 → 直接复用,不重跑浏览器/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项目/`)
|
||||
Reference in new issue
Block a user