mcn-short-video/project/短视频脚本创作/V1.0/subskills/mcn-dou-analysis/SKILL.md

name, description

name	description
mcn-dou-analysis	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
6	生成账号设定卡片	基于功能三产出的 {达人昵称}账号设定.md，生成竖版长图 SVG 信息图（账号设定卡）：深色/浅色长图风、模块映射 12 段人设卡、含内容基因/角色类型库/情绪图/红线清单等模块	功能三自动联动（默认）：产出设定后自动生成，无需单独要求	references/feature/06_生成账号设定卡片.md

部署禁用说明：删除某功能 MD 即禁用对应功能，可连带删除该功能的支撑文件：

• 功能一：references/浏览器搜索抖音账号操作规范.md（功能一/二共用，两个功能都删除时才可连带删除）、references/铁律避坑规则/账号信息获取执行避坑.md
• 功能二：references/浏览器搜索抖音账号操作规范.md（同上）、references/铁律避坑规则/视频列表获取执行避坑.md（2026-08-31 新建：defaultDataList 一次拿全含 createTime、搜索路径进主页模拟点击、禁止逐条开视频页）
• 功能三：references/人设卡生成方法.md、references/知识库/账号设定/、references/解析结果格式规范.md（如功能四/五仍启用，解析结果格式规范需保留，功能四目录结构以其为准）
• 功能四：references/账号数据分析方法.md、references/知识库/视频拆解/
• 功能五：解析结果格式规范（如功能三/四仍启用需保留）
• 功能六：无连带文件（依赖功能三产出的账号设定.md 作输入，但功能三删了也可单独对有存量账号设定的账号生成卡片）。默认联动：功能三产出账号设定后自动生成设定卡；删除功能六文件则功能三产出后不再自动生成（存量账号仍可手动要求生成）

---

一、项目规则（红线）

🔴 技能内一切文件引用必须用相对路径（绝对路径随部署机器变化失效；md 链接相对自身文件解析、禁止越级出技能根）→ 路径引用规范.md

规则	说明
达人账号表.xlsx（外部数据文件，不入技能包）	账号登记台账为外部数据文件，技能包不内置（09-03 起：原内置副本为 08-26 早期过期数据已删除）。权威台账 = 数据目录的桌面 MCNSkill项目/达人账号表.xlsx（①开发机/③用户环境，含俊希等最新登记）；②dsh 环境侧数据已停更（dshworkspace 遗留表为 08-26 死数据），不作为权威、不维护。表缺失时按 15 列结构现场新建：账号ID/达人昵称/抖音号/抖音ID/抖音地址/粉丝数/解析状态/人设卡/更新时间/获赞数/关注数/作品数/IP属地/简介/备注。只能根据用户明确要求添加/修改账号，不得自行添加或扩充。用户说加谁就加谁。输入信息中的账号若不在表中，先添加到表：账号ID自增、抖音号/抖音ID(sec_uid)/抖音地址存文本格式，其余字段留空待补。
数据格式	账号原始数据保存为 原始 JSON 格式，不用 Markdown。
文件夹命名	统一使用 账号分析/ 作为根目录（默认产出根目录按三环境判定：①开发机/③用户环境 桌面 ~/Desktop/MCNSkill项目/（{达人昵称}/ 账号层直挂）；②dsh环境 D:\dshworkspace\解析任务\；实际产出路径以 references/路径配置.md 为准），子文件夹以达人昵称命名。视频文件夹命名规则：视频标题（去特殊符号）_标签1_标签2（去掉账号名标签和#号）。
视频筛选标准	先按发布时间过滤最近三个月，排除视频时长>15分钟的视频，再按点赞+分享总量降序排列，取 TOP 6（不再设30W互动量门槛）。实际满足条件的视频不足 6 条时，按实际条数取（TOPn 的 n=实际解析条数，如王微斯 4 条→TOP4），产出文件（设定 md/卡片）的「TOPn」均按实际条数写，不写 6。本参数为唯一权威参数：只在 SKILL.md 定义，其他文件（feature/流程/方法/避坑等）引用此处，不得重复写数字；调整只改本行，改后自检：references/ 下 *.md 用 `grep "TOP ?[0-9]
视频获取数量（唯一权威参数）	≥60 条即停止滚动；若滚动到底部后无法加载更多视频，也立即停止（两个条件先到者为准，禁止无限滚动）。本参数只在 SKILL.md 定义，其他文件（feature/操作规范等）引用此处，不得重复写数字；调整只改本行。
视频补充规则	解析失败或无法解析的视频，从视频数据中按排名规则（点赞+分享降序）取下一位视频补充，直至凑满「视频筛选标准」规定的数量（数量见上「视频筛选标准」唯一权威参数）。
人设卡方法论	必须结合 脚本创作技能 + 女娲造人术 两个技能库综合生成，不可仅凭通用知识。人设卡聚焦内容创作本身（内容基因/打法/情绪/视听/规则/差异化壁垒的内容侧），不含商业化变现路径分析（商业化/市场分析归功能四账号数据分析）。人设卡统一 12 段结构（账号核心定位→内容基因→类型库→情绪结构→视听风格→内容打法→内容规则→系列内容规划→差异化壁垒→红线清单→当前需解决的问题→设定分析说明），详见 references/人设卡生成方法.md 5.3。
账号类型判定	生成人设卡前必须先判定账号类型，不同类型使用不同模板结构。判定标准见 references/人设卡生成方法.md。
浏览器操作规范（红线）	执行任何浏览器操作（功能一/二及任何网页获取）前，必须先读取 references/浏览器搜索抖音账号操作规范.md 全文，严格遵守：① 环境前置（清除代理环境变量、固定 9223 调试 Chrome 实例）；② 标签页复用（5.5）——操作前检查已打开标签页，有则 goto_url 直接导航复用，无才 new_tab 新建，用完不关闭；③ 登录检测（弹登录窗口停止操作提示用户）；④ 滚动收集技巧（.route-sc 容器）；⑤ 访问账号主页必须走搜索路径→模拟点击进入，禁止直接构造 /user/{sec_uid} 地址跳转；⑥ 视频数据提取首选列表组件 Fiber defaultDataList（一次拿全含 createTime），禁止逐条打开 /video/{id} 视频页抓字段（详见规范「提取方法优先级」）；⑦ 浏览器进程生命周期：已开启的 Chrome（9223 调试实例/用户 Chrome）一律不主动关闭，除非用户明确要求（详见规范 5.7）。浏览器要求由插件 prompt 注入与本规范双重保证。
browser-harness 依赖（红线）	功能一/二（浏览器抓取）执行前必须先检测 browser-harness 是否可用：检测方法（任一即可判定）——① 可执行文件存在性：~/.local/bin/browser-harness.exe（Windows）/ ~/.local/bin/browser-harness（macOS/Linux）；② command -v browser-harness（macOS/Linux）/ where browser-harness（Windows）有输出。未安装 → 提醒用户安装（可跳过：改用三方数据 API / MCP 兜底数据源，但功能一/二浏览器抓取无法执行；同意后安装）→ 执行 uv tool install --python 3.12 --upgrade --force browser-harness → browser-harness doctor 验证三要素（工具/daemon/Chrome）全绿。技能本体位置（09-02 调整）：主技能 短视频脚本创作/subskills/browser-harness/（源仓库 project/短视频脚本创作/V1.0/subskills/browser-harness/，含 envs 环境与 src；不再挂在 mcn-dou-analysis 下）；dsh 部署环境 ~/.dsh/skills/browser-harness/（随 dsh_MCNProject 仓库分发，换机器自带）。检测与安装细节见 references/浏览器搜索抖音账号操作规范.md 第五节。
账号信息数据源（红线）	获取达人账号信息（功能一）必须浏览器优先：browser-harness 打开抖音网页版访问达人主页提取（昵称/抖音号/抖音ID(sec_uid)/抖音地址/粉丝数/获赞数/关注数/作品数/IP属地/简介等）。禁止从任何数据库读取账号字段回填账号表（含身份标识 sec_uid/抖音号/抖音地址）：工作台库 mcn-plugin.db 的 hot_accounts 表 = MCP 内部账号库（list_hot_accounts/hot_account_detail）的本地副本，读取其数据填表等同违反本红线；dsh 原库（~/.dsh/mcn-plugin.db）同样只读参考。这些库仅用于流程状态参考（判断是否已有解析/产出），不是功能一数据源；账号表登记（Step 1.0）只占位 账号ID+达人昵称，抖音号/sec_uid/地址等一律留空，待浏览器抓取后回填（浏览器抓取到的值才写）。仅当浏览器无法访问（账号搜索不到/主页打不开等）时才可兜底补充，并须注明数据来源。详见 references/铁律避坑规则/账号信息获取执行避坑.md。
已有数据处理（统一决策）	用户要求「获取账号数据/提取账号设定/分析视频」时，库中已有 ≠ 可直接使用：实时数据（账号信息/视频列表）必须重新获取（红线禁回填）；分析产物（人设卡/视频解析/分析报告）复用优先 + 询问是否更新，只对增量（新视频/未解析）补获取；「已有」须校验内容质量（存在≠有效，假数据视为无）。分场景决策表见 references/铁律避坑规则/已有数据处理规则.md（收敛更新时间检查/卡片覆盖询问/表格复用/入库去重等散落规则）。
赛道标准枚举（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-short-video/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/feature/06_生成账号设定卡片.md（生成账号设定卡片五步执行：读设定→读模板样例→模块映射→SVG手绘→验证交付）
账号设定卡模板样例	references/样例/（最佳成品模板：模板_旧梦留声机账号设定卡.svg + 渲染参考 参考_旧梦留声机_账号设定卡_长图版.png；新账号复用版式骨架与样式常量，内容全替换）
产出路径配置	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（外部数据文件，不入技能包——位置见红线「达人账号表.xlsx」行；表缺失先按 15 列结构现场新建），输入信息中的账号若不在表中，先添加到表（账号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段结构：账号核心定位→内容基因→类型库→情绪结构→视听风格→内容打法→内容规则→系列内容规划→差异化壁垒→红线清单→当前需解决的问题→设定分析说明，不含商业化变现路径分析）
• Step 7（自动联动）：人设卡 {达人昵称}账号设定.md 落盘后，自动执行功能六生成 {达人昵称}账号设定卡.svg（无需用户单独要求）；设定后续被修改（内容/模块/命名）时，卡片必须同步修改（双向联动维护，详见 references/feature/06_生成账号设定卡片.md「双向联动维护」）

六、功能四：分析视频数据

完整执行流程见 references/feature/04_分析视频数据.md（Step 7：近4个月数据 → 每月最好/最差各1条 → 两段式拆解+汇总 → 产出账号数据分析报告）

核心流程概要：

• 数据范围：近4个月完整视频数据；每月按 点赞数+分享数 降序取最好1条 + 最差1条（最多8条）
• 两段式强制流程：先逐条拆解（重度调用源技能，拆解文件单独保存到各视频文件夹）→ 拆解全部完成后才进入汇总分析（月度趋势/爆款共性/低表现共性/内容要素关联/差异化壁垒/商业化空间）
• 产出：{达人昵称}账号数据分析.md（8章结构：核心结论/五维诊断/月度趋势/最好视频/最差视频/差异化壁垒/商业化空间/行动建议）+ 各视频 {视频标题}_拆解分析.md

七、功能五：解析视频

完整执行流程见 references/feature/05_解析视频.md（单视频 MCP 解析：上传→等待→查询→保存 JSON，不依赖功能三 TOP 筛选）

核心流程概要：

• 触发：账号详情视频列表「解析视频」按钮 / 用户指定单条视频
• 流程：upload_douyin_video 提交（3-5 分钟等待）→ short_video_detail 查询（content + analysis）→ scripts/json_tool.py 保存到 {产出根目录}/{达人昵称}/视频对标/{视频文件夹}/
• 可选写库：① 环境有 MCN 插件接口（dsh）时补录 account_video_source 并提取选题；② 工作台环境（mcn-work-shop，本机 http://localhost:8900）：功能三/五解析产物落盘后调用 POST /api/import/account（body {"account":"{达人昵称}"}）同步入库——扫描账号产出目录写工作台库 mcn-plugin.db（视频分析/*/analysis.json→account_video_analysis、content.json→account_video_source、{达人昵称}账号设定.md→account_persona、{达人昵称}账号数据分析.md→account_analysis、短视频表格.xlsx→account_videos 补视频列表），供工作台选题（/api/ai/topics）基于真实视频解析内容生成。入库实现见工作台 server.js（09-01 新增）

八、功能六：生成账号设定卡片

完整执行流程见 references/feature/06_生成账号设定卡片.md（读账号设定 → 模块映射 → SVG 手绘 → 验证交付）

核心流程概要：

• 自动触发（默认）：功能三产出 {达人昵称}账号设定.md 后自动执行本功能生成设定卡，无需用户单独要求；用户单独要求生成/调整时也可独立触发
• 触发判定（先判定再执行）：三问判定链（①有无账号设定→无则功能三或全链路 ②卡片是否已存在→有则询问覆盖/微调 ③设定模块是否完整→缺则裁剪适配），7 种情况处理详见 references/feature/06_生成账号设定卡片.md「触发场景处理」
• 双向联动维护：设定 md 与设定卡同步修改（任一边改动另一边必须跟随），规则详见 06 文档「双向联动维护」
• 输入：功能三产出的 {达人昵称}账号设定.md（人设卡 12 段）
• 产出：{达人昵称}账号设定卡.svg（竖版长图信息图，viewBox="0 0 680 ~1700"，深色长图风），与账号设定.md 同目录
• 方式：读设定全文 → 读模板样例 references/样例/模板_旧梦留声机账号设定卡.svg + 参考_旧梦留声机_账号设定卡_长图版.png（复用版式骨架与样式常量，内容全替换） → 12 段模块映射 → 手写 SVG → 结构+坐标+间距三重校验 → present_files 预览确认
• 模块裁剪适配：按设定文件实际内容裁剪/增补模块（无流程删叙事结构、无角色库删角色库、基因按条数定列数），禁止照搬模板模块清单；每个保留模块须能在设定中找到原文
• 配色适配：底色 = 整卡背景色，跟随账号风格，禁止一律模板深棕红底（深棕红+浅米只是旧梦留声机风格）；底色分两系——深沉/浓郁调性走深色系、明快/甜美/治愈调性走浅色系。按设定「色彩体系」真实色值 + 赛道归入背景色映射（暖怀旧→深棕红、亲子/治愈→深焦糖、科技/冷淡→深灰蓝、清新三农→深墨绿、潮流都市→深紫黑、活力运动→深海军、甜美/甜宠→深莓紫「深沉时」/ 玫瑰金 #D6A3A9→#9A5563「明快时，如王微斯定稿」…）；深色系公式：主色压暗 15-25% 降饱和 → 深色渐变底；浅色系公式：主色提亮+降饱和至中浅明度 → 浅色渐变底。底色决定色系：深色系内部元素=浅米卡+深色字+珊瑚红强调，浅色系内部元素=白卡+粉边+深粉字+粉强调；背景上直接书写的文字随背景深浅提亮保可读。「色彩体系」色块用账号真实色值
• 要点：GENE 0X 小标签 + 角色英文代号；情绪图条形底边对齐、峰谷差 ≥40px；红线全量；文字垂直居中（y=中心）；批量移动坐标用脚本统一加减防双重偏移

---

九、注意事项

1. MCP解析等待：新提交的视频解析需3-5分钟，不要立即查询。批量提交后统一等待再批量查询。
2. analysis延迟：content（分镜头表）通常先出，analysis（结构化分析）可能延迟1-2分钟。如只有content，稍后重试获取analysis。
3. 人设卡必须基于视频解析结果生成：不能仅凭账号简介或通用知识编写，每条内容基因和心智模型都必须有视频证据支撑。
4. Excel文件占用：如达人账号表.xlsx被占用无法直接写入，先保存为临时文件再 mv -f 替换。
5. Python脚本临时文件：写到本技能根目录下的 tmp/ 目录，完成后清理。
6. 产物入库标题匹配（红线）：工作台入库接口按标题匹配 aweme_id，权威映射 = 短视频表格.xlsx（第2列视频ID），匹配前标题规范化必须删除全角/半角标点（！、“” 等——xlsx 标题带「！」而解析文件夹名无，未规范化时 4/6 匹配失败并产生 aweme_id=null 脏数据，09-01 已修复）。入库接口幂等：同视频重新解析删旧保新，历史 aweme_id=null AND video_id=null 脏数据自动清理。