maogeigei
e1dc14e8a3
- 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 + 失误与规避记录
153 lines
20 KiB
Markdown
153 lines
20 KiB
Markdown
---
|
||
name: mcn-dou-analysis
|
||
description: "MCN 达人爆款视频解析与人设卡生成技能：达人账号信息获取与登记、视频列表抓取、爆款视频拆解分析、人设卡生成、账号数据分析。触发场景：解析抖音达人账号、拆解爆款视频、生成人设卡、分析账号数据、维护达人账号表。"
|
||
---
|
||
|
||
# MCN达人爆款视频解析与人设卡生成 技能
|
||
|
||
> 本文件记录在 MCNDouAnalysis 项目中执行「达人数据获取 → 爆款视频解析 → 人设卡生成 → 账号数据分析」完整工作流的所有执行细节要求。
|
||
> 下次执行同类任务时，按此文件操作即可复现。
|
||
|
||
---
|
||
|
||
## 功能总览
|
||
|
||
本技能包含五大功能，**各功能独立成 MD 文件**（部署时按需手动删除不需要的功能文件即可禁用，无需改代码）：
|
||
|
||
| # | 功能 | 说明 | 对应步骤 | 功能文件（删除即禁用） |
|
||
|---|------|------|----------|----------------------|
|
||
| 1 | 获取账号信息 | 浏览器搜索提取达人账号主页信息（抖音号/抖音地址/粉丝数/简介等），登记到达人账号表 | Step 1 | `references/feature/01_获取账号信息.md` |
|
||
| 2 | 获取视频列表 | 浏览器抓取达人视频列表，保存为13列 Excel | Step 2 | `references/feature/02_获取视频.md` |
|
||
| 3 | 提炼账号设定 | 基于视频 MCP 解析数据，生成人设卡（内容创作维度） | Step 3-6 | `references/feature/03_提炼账号设定.md` |
|
||
| 4 | 分析视频数据 | 基于近4个月 Excel 数据，每月最好/最差各1条综合分析（商业/市场维度） | Step 7 | `references/feature/04_分析视频数据.md` |
|
||
| 5 | 解析视频 | 对**单个视频**进行 MCP 解析（上传→查询→保存 content.json/analysis.json），不依赖功能三筛选流程；由账号详情视频列表「解析视频」触发 | 独立 | `references/feature/05_解析视频.md` |
|
||
|
||
**部署禁用说明**：删除某功能 MD 即禁用对应功能，可连带删除该功能的支撑文件：
|
||
- 功能一：`references/浏览器搜索抖音账号操作规范.md`（功能一/二共用，**两个功能都删除时**才可连带删除）
|
||
- 功能二：`references/浏览器搜索抖音账号操作规范.md`（同上）
|
||
- 功能三：`references/人设卡生成方法.md`、`references/知识库/账号设定/`、`references/解析结果格式规范.md`（**如功能四/五仍启用，解析结果格式规范需保留**，功能四目录结构以其为准）
|
||
- 功能四：`references/账号数据分析方法.md`、`references/知识库/视频拆解/`
|
||
- 功能五：解析结果格式规范（**如功能三/四仍启用需保留**）
|
||
|
||
---
|
||
|
||
## 一、项目规则（红线）
|
||
|
||
| 规则 | 说明 |
|
||
|------|------|
|
||
| 达人账号表.xlsx | **只能根据用户明确要求添加/修改账号**，不得自行添加或扩充。用户说加谁就加谁。输入信息中的账号若不在表中，**先添加到表**：账号ID自增、抖音号/抖音ID(sec_uid)/抖音地址存文本格式，其余字段留空待补。**字段结构（15列）**：账号ID/达人昵称/抖音号/抖音ID/抖音地址/粉丝数/解析状态/人设卡/更新时间/获赞数/关注数/作品数/IP属地/简介/备注。 |
|
||
| 数据格式 | 账号原始数据保存为 **原始 JSON 格式**，不用 Markdown。 |
|
||
| 文件夹命名 | 统一使用 `账号分析/` 作为根目录（默认产出根目录按三环境判定：**①开发机/③用户环境** 桌面 `~/Desktop/MCNSkill项目/`（`{达人昵称}/` 账号层直挂）；**②dsh环境** `D:\dshworkspace\解析任务\`；**实际产出路径以 `references/路径配置.md` 为准**），子文件夹以达人昵称命名。视频文件夹命名规则：`视频标题（去特殊符号）_标签1_标签2`（去掉账号名标签和#号）。 |
|
||
| 视频筛选标准 | 先按发布时间过滤**最近三个月**，排除**视频时长>15分钟**的视频，再按点赞+分享总量降序排列，取 TOP 6（不再设30W互动量门槛）。**本参数为唯一权威参数**：只在 SKILL.md 定义，其他文件（feature/流程/方法/避坑等）引用此处，**不得重复写数字**；调整只改本行，改后自检：`references/` 下 *.md 用 `grep "TOP ?[0-9]|凑满[0-9]|默认取[0-9]"` 应无残留，并同步 `scripts/excel_tool.py` 与 `scripts/select_top6.py` 两处 `count` 默认值（执行镜像）。 |
|
||
| 视频获取数量（**唯一权威参数**） | **≥60 条即停止滚动**；若滚动到底部后无法加载更多视频，也立即停止（两个条件先到者为准，禁止无限滚动）。本参数只在 SKILL.md 定义，其他文件（feature/操作规范等）引用此处，不得重复写数字；调整只改本行。 |
|
||
| 视频补充规则 | 解析失败或无法解析的视频，从视频数据中按排名规则（点赞+分享降序）取下一位视频补充，直至凑满「视频筛选标准」规定的数量（数量见上「视频筛选标准」唯一权威参数）。 |
|
||
| 人设卡方法论 | 必须结合 **脚本创作技能 + 女娲造人术** 两个技能库综合生成，不可仅凭通用知识。**人设卡聚焦内容创作本身（内容基因/打法/情绪/视听/规则/差异化壁垒的内容侧），不含商业化变现路径分析**（商业化/市场分析归功能四账号数据分析）。**人设卡统一 12 段结构**（账号核心定位→内容基因→类型库→情绪结构→视听风格→内容打法→内容规则→系列内容规划→差异化壁垒→红线清单→当前需解决的问题→设定分析说明），详见 `references/人设卡生成方法.md` 5.3。 |
|
||
| 账号类型判定 | 生成人设卡前**必须先判定账号类型**，不同类型使用不同模板结构。判定标准见 `references/人设卡生成方法.md`。 |
|
||
| 浏览器操作规范（红线） | **执行任何浏览器操作（功能一/二及任何网页获取）前，必须先读取 `references/浏览器搜索抖音账号操作规范.md` 全文**，严格遵守：① 环境前置（清除代理环境变量、固定 9223 调试 Chrome 实例）；② **标签页复用（5.5）**——操作前检查已打开标签页，有则 goto_url 直接导航复用，无才 new_tab 新建，用完不关闭；③ 登录检测（弹登录窗口停止操作提示用户）；④ 滚动收集技巧（.route-sc 容器）。浏览器要求由插件 prompt 注入与本规范双重保证。 |
|
||
| 账号信息数据源（红线） | 获取达人账号信息（功能一）**必须浏览器优先**：browser-harness 打开抖音网页版访问达人主页提取（昵称/抖音号/抖音ID(sec_uid)/抖音地址/粉丝数/获赞数/关注数/作品数/IP属地/简介等）。**如无必要不用查 MCP 达人信息**——MCP 的 `list_hot_accounts`/`hot_account_detail` 是**内部账号库查询**（MCN 内部维护的达人账号库，含人设/赛道/标签，非抖音页面实时数据；工具命名 hot_accounts 有误导性），**不是功能一数据源**；仅当浏览器无法访问（账号搜索不到/主页打不开等）时才可兜底补充，并须注明数据来源。 |
|
||
| 赛道标准枚举（29个，**唯一权威**） | 赛道（track/「赛道」键）取值必须属于以下 **29 个赛道**（28 标准 + 1 补充）：个人才艺 / 生活vlog / 财富理财 / 二次元 / 居家装修 / 学习教育 / 小剧场 / 数码科技 / 旅行 / 美食 / 美妆（原「化妆美容」统一更名） / 动物 / 亲子 / 汽车 / 情感 / 三农 / 健康医学 / 潮流风尚 / 舞蹈才艺 / 颜值造型 / 人文 / 音乐 / 影视 / 身体锻炼 / 体育 / 明星娱乐 / 游戏 / 其他 / **剧情**（剧情为用户指定保留，不归一）。**不带「赛道」后缀**（如「生活vlog」）；人设卡/账号设定「赛道」键取首段（" / " 分隔）后去后缀，不在 29 个枚举内则归一到最接近标准值或置空待确认。本参数只在 SKILL.md 定义（源：`dsh-plugin-dev/references/赛道标准枚举.md`），其他文件引用此处，调整只改本行。 |
|
||
| 账号数据分析（功能四） | 独立于人设卡，聚焦「数据表现规律」（内容表现规律/月度趋势/差异化壁垒/商业化空间），产出独立文件 `{达人昵称}账号数据分析.md`，**不与功能三人设卡嵌套**。方法论见 `references/账号数据分析方法.md`。 |
|
||
| 数据分析依据（红线） | 功能四所有分析结论必须有明确数据依据：具体到视频标题 + 具体数值。后台私有数据拿不到时（完播率/留存率/GMV等）标「无数据」，**禁止用间接推断或定性描述替代**。 |
|
||
| 数据分析两段式（红线） | 功能四强制「**逐条拆解 → 汇总分析**」两段式：先对每条入选视频重度调用源技能逐条拆解（拆解内容单独保存到各视频自己的文件夹），**拆解全部完成后**才能进入汇总分析，禁止跳过逐条拆解直接写报告。 |
|
||
| 源技能路径与同步 | 生成账号设定/分析视频数据时，**调用源技能** `{源技能目录}/references/` 下的对应文件（`创作流程/4_账号设定解析和确认.md`、`创作流程/3_对标视频账号拆解.md`、`知识库/01_账号设定/`、`知识库/08_对话风格/`、`知识库/12_爆款拆解/`、`知识库/11_广告植入/` 等）。**三环境判定（锚点 = 本机是否存在 `D:\AgentSkill`，与技能装在什么路径无关）**：① 开发机 = 本机有 `D:\AgentSkill` 且技能路径在 `D:\AgentSkill\` 下（源技能）；② dsh 环境 = 本机有 `D:\AgentSkill` 且技能路径含 `.dsh`（如 `C:\Users\{用户名}\.dsh\skills\`）；③ 用户环境 = 本机**没有** `D:\AgentSkill`（技能装在哪、什么路径都是用户环境）。`{源技能目录}` 仅在 ①/② 存在，③ 不存在（用本技能自有知识库）。**源技能只读，禁止修改（不提供任何改前评估流程，一律视为不可写）**；本技能只能**从源技能单向同步**：① 从源技能**定位相关文件**（账号设定提炼实际依赖）；② **重新整理为适合本技能的流程和知识库**（按本技能自有体系组织，**不复刻源技能目录结构**）。源技能为权威源；本技能 `references/知识库/账号设定/`（账号设定专用）与 `references/知识库/视频拆解/`（账号数据分析专用，23文件）为重组后的自有知识库，③用户环境独立使用。 |
|
||
| 部署场景修改规则 | **仅 ③ 用户环境（本机没有 `D:\AgentSkill`）适用本规则**；① 开发机 / ② dsh 环境（本机有 `D:\AgentSkill`）不适用本规则。用户环境：源技能路径不存在，标准库 `references/`（含自有知识库 `知识库/账号设定/` + `知识库/视频拆解/`）**永远不变**。用户新增/修改内容统一写入 `references-add/` 增量库，**目录结构与标准库镜像对齐**：`feature/`（功能级增量，按 `01_获取账号信息/02_获取视频/03_提炼账号设定/04_分析视频数据` 命名，对应标准库 `references/feature/`）、`知识库/`（方法论增量）、`铁律避坑规则/`（铁律与避坑）。运行时 `references/` + `references-add/` 取并集、标准库优先。**功能禁用判定 = 标准库与增量库中该功能文件都不存在**（只删标准库、增量库仍有时功能仍启用）。产出路径以 `references/路径配置.md` 为准（①开发机/②dsh环境并入标准库；③ 用户环境迁移回 `references-add/` 见其 README）。详见 `references-add/README.md`。 |
|
||
| 技能边界（红线） | 本技能是**账号分析技能**，产出止步于账号分析侧交付物：达人账号表更新（功能一）、短视频数据表格（功能二）、账号设定人设卡（功能三）、账号数据分析报告（功能四）、视频解析产物（功能五）。凡需**生成或改写脚本**（含「基于账号设定替换事件重写」等轻量场景），**必须切换到「短视频脚本创作」技能走 S1-S11 全流程**（含 S11 脚本检查和诊断：数字账取证、开场钩子铁律、编导终审验收），**禁止在本技能会话内直接手写脚本交付**。 |
|
||
|
||
---
|
||
|
||
## 二、关键路径与工具
|
||
|
||
### 2.1 运行时环境
|
||
|
||
> 运行时路径按**当前机器环境动态确定**，不硬编码用户名/盘符。`{主目录}` = 当前用户主目录（Windows 用 `%USERPROFILE%`，Linux/macOS 用 `$HOME`）。
|
||
|
||
| 项目 | 路径 |
|
||
|------|------|
|
||
| Python（首选） | `{主目录}/.workbuddy/binaries/python/`（WorkBuddy 托管，版本以实际安装为准） |
|
||
| Python venv | `{主目录}/.workbuddy/binaries/python/envs/default/`（需装依赖时建于此） |
|
||
| Node（首选） | `{主目录}/.workbuddy/binaries/node/`（WorkBuddy 托管，版本以实际安装为准） |
|
||
|
||
> 无 WorkBuddy 环境：直接用系统 PATH 的 `python` / `node`，执行前先 `python --version`、`node --version` 检测。
|
||
|
||
### 2.2 技能库路径
|
||
|
||
| 技能 | 路径 |
|
||
|------|------|
|
||
| 脚本创作技能（权威源） | `{源技能目录}`（**三环境判定**：① 开发机 = 本机有 `D:\AgentSkill` 且技能在 `D:\AgentSkill\` 下；② dsh 环境 = 本机有 `D:\AgentSkill` 且技能路径含 `.dsh`；③ 用户环境 = 本机没有 `D:\AgentSkill`（源技能不存在）。当前机器源技能路径 `D:/AgentSkill/mcn-video-script/project/短视频脚本创作/V1.0`；生成设定/分析数据时调用此源；**只读，禁止修改，只能从源技能同步到本技能**；本技能 `references/知识库/` 为账号设定 + 账号数据分析两个专用重组库，按两步法同步，不复刻源技能目录结构） |
|
||
| 女娲造人术（nuwa-skill） | `subskills/nuwa-skill-main/`（已内嵌，无需跨 skill 调用） |
|
||
| 人设卡生成方法 | `references/人设卡生成方法.md`（账号类型判定+模板结构+深度分析，已吸收V2.0模板核心；综合人设卡统一12段结构，独立可执行） |
|
||
| 账号设定知识库（自有） | `references/知识库/账号设定/`（功能三人设选项+IP体系+对话风格9法） |
|
||
| 视频拆解知识库（自有） | `references/知识库/视频拆解/`（功能四拆解知识库23文件：开场/框架/情绪/钩子/植入/拆解） |
|
||
| 账号数据分析方法 | `references/账号数据分析方法.md`（功能四六维分析+报告8章结构+13条自查红线） |
|
||
| 解析结果格式规范 | `references/解析结果格式规范.md`（目录结构+JSON格式+维度说明） |
|
||
| 统一JSON工具 | `scripts/json_tool.py`（create-content/create-analysis/inspect/verify-folders 四模式） |
|
||
| 统一Excel工具 | `scripts/excel_tool.py`（select-top6/query/export-selected 三模式，含三比率计算；select-top6 默认数量按 SKILL.md「视频筛选标准」，可用 `--count N` 调整） |
|
||
| 视频筛选脚本 | `scripts/select_top6.py`（已整合到 excel_tool.py，保留向后兼容） |
|
||
| 产出路径配置 | `references/路径配置.md`（🔴 产出路径唯一权威配置：用户自定义路径最高优先，默认桌面 `账号分析/` 兜底） |
|
||
| 增量库（references-add） | `references-add/`（③ 用户环境场景的增量库机制；当前①开发机/②dsh环境状态仅保留 README 机制说明，原增量已并入标准库：`references/路径配置.md` + `references/铁律避坑规则/`（含功能三`账号设定执行避坑.md` + 功能四`账号数据分析执行避坑.md`）） |
|
||
|
||
### 2.3 MCP 工具（myai-mcp-production）
|
||
|
||
本工作流依赖 MCN MCP 服务进行视频解析。
|
||
|
||
- **配置文件**：`scripts/mcp-config.json`
|
||
- **安装引导**：执行工作流前自动检测 → 未安装则提醒（可跳过）→ 同意则先做**部署预检**（运行时版本 → npm缓存权限 → npm源，三步顺序见规范）→ 自动写入 `~/.workbuddy/mcp.json` + 引导 Trust
|
||
- **登录检查**：调用前自动检查飞书登录状态（每天一次），未登录则自动触发 `feishu_login`
|
||
- **降级**：MCP 不可用时，Step 4/7 视频解析无法执行（功能四按拆解降级规则处理：无解析视频不进入逐条拆解，只做数据层分析）
|
||
|
||
> 完整规范（服务依赖表/环境判定/安装引导流程/登录检查5步/降级策略/工具清单）见 → `references/接口调用/MCP_工具调用规范.md`
|
||
> 接口返回字段说明（`short_video_detail` 返回 content/analysis/title/track/authorName 等字段）见 → `references/接口调用/Douyin_Video_Analysis.md`
|
||
|
||
**核心工具：**
|
||
|
||
| 工具 | 用途 | 入参 | 返回 |
|
||
|------|------|------|------|
|
||
| `upload_douyin_video` | 提交视频链接进行解析 | `share_text` = 视频URL | `detailId` |
|
||
| `short_video_detail` | 查询解析结果 | `id` = detailId | `content`(分镜头表) + `analysis`(结构化JSON) |
|
||
|
||
---
|
||
|
||
## 三、功能一：获取账号信息
|
||
|
||
> **完整执行流程见 `references/feature/01_获取账号信息.md`**（Step 1：账号表登记 → 浏览器搜索抖音账号ID）
|
||
|
||
核心流程概要：
|
||
- **Step 1.0 账号表登记（前置）**：先检查 `达人账号表.xlsx`，输入信息中的账号若不在表中，先添加到表（账号ID自增、抖音号/抖音ID(sec_uid)/抖音地址存文本格式，其余字段留空），再继续获取数据
|
||
- **浏览器搜索提取账号信息**：browser-harness 打开抖音网页版搜索账号 ID，进入达人主页提取昵称/抖音号/抖音地址/粉丝数/简介等，登记到 `达人账号表.xlsx`
|
||
|
||
## 四、功能二：获取视频列表
|
||
|
||
> **完整执行流程见 `references/feature/02_获取视频.md`**（Step 2：浏览器抓取视频列表）
|
||
|
||
核心流程概要：
|
||
- **浏览器抓取**：browser-harness 在达人主页滚动加载视频列表（间隔1~3秒），收集数量按本文件「视频获取数量」参数，保存为 Excel 到 `{产出根目录}/{达人昵称}/短视频表格.xlsx`
|
||
|
||
## 五、功能三：提炼账号设定
|
||
|
||
> **完整执行流程见 `references/feature/03_提炼账号设定.md`**（Step 3：筛选 TOP 视频 → Step 4：视频解析 → Step 5：保存解析结果 → Step 6：生成人设卡）
|
||
|
||
核心流程概要：
|
||
- **Step 3**：从 Excel 按「最近三个月 + 时长≤15分钟 + 点赞+分享降序」取 TOP 视频（数量按 SKILL.md「视频筛选标准」；`scripts/excel_tool.py select-top6` 默认数量同标准，可用 `--count N` 调整）
|
||
- **Step 4**：`upload_douyin_video` 提交解析 → 等待 3-5 分钟 → `short_video_detail` 查询（content + analysis）
|
||
- **Step 5**：`scripts/json_tool.py` 保存 content.json / analysis.json（格式规范见 `references/解析结果格式规范.md`）
|
||
- **Step 6**：脚本创作技能 + 女娲造人术两个技能库综合生成人设卡（**12段结构**：账号核心定位→内容基因→类型库→情绪结构→视听风格→内容打法→内容规则→系列内容规划→差异化壁垒→红线清单→当前需解决的问题→设定分析说明，不含商业化变现路径分析）
|
||
|
||
## 六、功能四：分析视频数据
|
||
|
||
> **完整执行流程见 `references/feature/04_分析视频数据.md`**（Step 7：近4个月数据 → 每月最好/最差各1条 → 两段式拆解+汇总 → 产出账号数据分析报告）
|
||
|
||
核心流程概要：
|
||
- **数据范围**：近4个月完整视频数据；每月按 `点赞数+分享数` 降序取最好1条 + 最差1条（最多8条）
|
||
- **两段式强制流程**：先逐条拆解（重度调用源技能，拆解文件单独保存到各视频文件夹）→ 拆解全部完成后才进入汇总分析（月度趋势/爆款共性/低表现共性/内容要素关联/差异化壁垒/商业化空间）
|
||
- **产出**：`{达人昵称}账号数据分析.md`（8章结构：核心结论/五维诊断/月度趋势/最好视频/最差视频/差异化壁垒/商业化空间/行动建议）+ 各视频 `{视频标题}_拆解分析.md`
|
||
|
||
---
|
||
|
||
## 七、注意事项
|
||
|
||
1. **MCP解析等待**：新提交的视频解析需3-5分钟，不要立即查询。批量提交后统一等待再批量查询。
|
||
2. **analysis延迟**：`content`（分镜头表）通常先出，`analysis`（结构化分析）可能延迟1-2分钟。如只有content，稍后重试获取analysis。
|
||
3. **人设卡必须基于视频解析结果生成**：不能仅凭账号简介或通用知识编写，每条内容基因和心智模型都必须有视频证据支撑。
|
||
4. **Excel文件占用**：如达人账号表.xlsx被占用无法直接写入，先保存为临时文件再 `mv -f` 替换。
|
||
5. **Python脚本临时文件**：写到本技能根目录下的 `tmp/` 目录，完成后清理。
|