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 + 失误与规避记录
This commit is contained in:
maogeigei committed 2026-08-27 10:25:00 +08:00
1 parent e53c314617
commit e1dc14e8a3
17 files changed
+113 -25

No files matched your search

@@ -37,19 +37,20 @@ description: "MCN 达人爆款视频解析与人设卡生成技能:达人账
|------|------|
| 达人账号表.xlsx | **只能根据用户明确要求添加/修改账号**,不得自行添加或扩充。用户说加谁就加谁。输入信息中的账号若不在表中,**先添加到表**:账号ID自增、抖音号/抖音ID(sec_uid)/抖音地址存文本格式,其余字段留空待补。**字段结构(15列)**:账号ID/达人昵称/抖音号/抖音ID/抖音地址/粉丝数/解析状态/人设卡/更新时间/获赞数/关注数/作品数/IP属地/简介/备注。 |
| 数据格式 | 账号原始数据保存为 **原始 JSON 格式**,不用 Markdown。 |
| 文件夹命名 | 统一使用 `账号分析/` 作为根目录(默认产出根目录按三环境判定:**①开发机/③用户环境** 桌面 `~/Desktop/MCNSkill项目/`(`{达人昵称}/` 账号层直挂);**②dsh环境** `D:\dshworkspace\解析任务\`;实际产出路径以 `references-add/路径配置.md` 为准),子文件夹以达人昵称命名。视频文件夹命名规则:`视频标题(去特殊符号)_标签1_标签2`(去掉账号名标签和#号)。 |
| 文件夹命名 | 统一使用 `账号分析/` 作为根目录(默认产出根目录按三环境判定:**①开发机/③用户环境** 桌面 `~/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-add/路径配置.md` 为准。详见 `references-add/README.md`。 |
| 源技能路径与同步 | 生成账号设定/分析视频数据时,**调用源技能** `{源技能目录}/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 脚本检查和诊断:数字账取证、开场钩子铁律、编导终审验收),**禁止在本技能会话内直接手写脚本交付**。 |
---
@@ -72,7 +73,7 @@ description: "MCN 达人爆款视频解析与人设卡生成技能:达人账
| 技能 | 路径 |
|------|------|
| 脚本创作技能(权威源) | `{源技能目录}`(**三环境判定**:① 开发机 = 本机有 `D:\AgentSkill` 且技能在 `D:\AgentSkill\` 下;② dsh 环境 = 本机有 `D:\AgentSkill` 且技能路径含 `.dsh`;③ 用户环境 = 本机没有 `D:\AgentSkill`(源技能不存在)。当前机器源技能路径 `D:/AgentSkill/mcn-video-script/project/V1.0`;生成设定/分析数据时调用此源;**只读,禁止修改,只能从源技能同步到本技能**;本技能 `references/知识库/` 为账号设定 + 账号数据分析两个专用重组库,按两步法同步,不复刻源技能目录结构) |
| 脚本创作技能(权威源) | `{源技能目录}`(**三环境判定**:① 开发机 = 本机有 `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法) |
@@ -82,7 +83,8 @@ description: "MCN 达人爆款视频解析与人设卡生成技能:达人账
| 统一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-add) | `references-add/`(部署后用户新增/修改内容;README.md 说明机制,`路径配置.md` 为产出路径权威配置) |
| 产出路径配置 | `references/路径配置.md`(🔴 产出路径唯一权威配置:用户自定义路径最高优先,默认桌面 `账号分析/` 兜底) |
| 增量库(references-add) | `references-add/`(③ 用户环境场景的增量库机制;当前①开发机/②dsh环境状态仅保留 README 机制说明,原增量已并入标准库:`references/路径配置.md` + `references/铁律避坑规则/`(含功能三`账号设定执行避坑.md` + 功能四`账号数据分析执行避坑.md`)) |
### 2.3 MCP 工具(myai-mcp-production)
@@ -1,4 +1,8 @@
# references-add(增量库)
# references-add(增量库)—— 机制说明
> **三环境判定(两步判定,与 SKILL.md 一致)**:第一步查本机是否存在 `D:\AgentSkill`——**无 = ③ 用户环境**(技能无论装在哪、什么路径);有 → 第二步看技能路径——**在 `D:\AgentSkill\` 下 = ① 开发机(源技能)**、**含 `.dsh` = ② dsh 部署环境**(如 `{主目录}/.dsh/skills/`)。
>
> **references-add 机制只服务 ③ 用户环境**:① 开发机 / ② dsh 环境标准库 `references/` 可正常修改(新增内容直接并入标准库对应位置),本目录可仅保留本说明(机制文档);③ 用户环境部署后标准库 `references/` **永远不变**,新增/修改内容统一写入本目录。
## 用途
@@ -9,13 +13,13 @@
| 目录 | 定位 | 内容来源 | 修改策略 |
|:---:|------|------|------|
| `references/` | 原始标准库(内置) | 开发时固化(含从源技能按两步法重组的账号设定知识库 + 视频拆解知识库) | **部署后永远不变** |
| `references-add/` | 动态增量库 | 用户对话中积累 | 随使用持续增长 |
| `references-add/` | 动态增量库 | ③ 用户环境中用户对话中积累 | 随使用持续增长 |
## 目录结构
```
references-add/ ← 增量库(与标准库 references/ 结构镜像对齐)
├── README.md ← 本说明
├── README.md ← 本说明(机制文档)
├── 路径配置.md ← 🔴 产出路径唯一权威配置(用户自定义路径在此记录)
├── feature/ ← 功能级增量(对应标准库 references/feature/,删除即禁用该功能)
│ ├── 01_获取账号信息.md ← 功能一增量
@@ -33,7 +37,7 @@ references-add/ ← 增量库(与标准库 references/ 结构
| 功能 | 标准库(references/) | 增量库(references-add/) |
|------|------|------|
| 1. 获取账号信息 | `references/feature/01_获取账号信息.md` + `浏览器搜索抖音账号操作规范.md` | `feature/01_获取账号信息.md` |
| 2. 获取视频 | `references/feature/02_获取视频.md` + `浏览器搜索抖音账号操作规范.md` | `feature/02_获取视频.md` |
| 2. 获取视频列表 | `references/feature/02_获取视频.md` + `浏览器搜索抖音账号操作规范.md` | `feature/02_获取视频.md` |
| 3. 提炼账号设定 | `references/feature/03_提炼账号设定.md` + `人设卡生成方法.md` + `知识库/账号设定/` + `解析结果格式规范.md`(功能四仍启用时需保留) | `feature/03_提炼账号设定.md` + `知识库/账号设定/` |
| 4. 分析视频数据 | `references/feature/04_分析视频数据.md` + `账号数据分析方法.md` + `知识库/视频拆解/` | `feature/04_分析视频数据.md` + `知识库/视频拆解/` |
@@ -51,9 +55,16 @@ references/(标准库) + references-add/(增量库) → 取并集
2. 两处都存在时以 `references/` 为准(增量不覆盖标准)
3. **唯一例外:路径配置**。`路径配置.md` 中用户自定义的产出路径**覆盖**标准库默认路径
## 修改规则(区分场景)
## 修改规则(区分场景,判定标准与 SKILL.md 一致)
| 场景 | 判断依据 | 生成设定调用的文件 | 修改方式 |
| 场景 | 判断依据(两步判定) | 生成设定调用的文件 | 修改方式 |
|------|---------|------------------------|---------|
| **① 开发机 / ② dsh 环境** | 本机有 `D:\AgentSkill` | 调用源技能对应文件 | **源技能只读,禁止修改**;只能从源技能**单向同步**到本技能:按两步法(① 从源技能定位相关文件 → ② 重组为本技能自有流程/知识库)同步到 `references/知识库/` |
| **③ 用户环境** | 本机**没有** `D:\AgentSkill` | 调用本技能 `references/`(标准库,含账号设定 + 视频拆解自有知识库) | **不修改 `references/`**,新增/修改内容写入 `references-add/` 对应目录 |
| **① 开发机** | 本机有 `D:\AgentSkill` 且技能路径在 `D:\AgentSkill\` 下(源技能) | 调用源技能对应文件 | **源技能只读,禁止修改**;只能从源技能**单向同步**到本技能:按两步法(① 从源技能定位相关文件 → ② 重组为本技能自有流程/知识库)同步到 `references/知识库/`;标准库 `references/` 可正常修改(开发机直接改标准库,不使用增量库机制) |
| **② dsh 环境** | 本机有 `D:\AgentSkill` 且技能路径含 `.dsh`(如 `{主目录}/.dsh/skills/`) | 调用源技能对应文件 | **源技能只读,禁止修改**;只能从源技能**单向同步**到本技能:按两步法(① 从源技能定位相关文件 → ② 重组为本技能自有流程/知识库)同步到 `references/知识库/`;标准库 `references/` 可正常修改,增量内容直接并入标准库对应位置 |
| **③ 用户环境** | 本机**没有** `D:\AgentSkill`(技能装在哪、什么路径都是用户环境) | 调用本技能 `references/`(标准库,含账号设定 + 视频拆解自有知识库) | **不修改 `references/`**,新增/修改内容写入 `references-add/` 对应目录 |
## ③ 用户环境启用流程(如未来部署)
1. 把 `references/路径配置.md`、`references/铁律避坑规则/` 移回 `references-add/` 对应位置
2. 删除标准库中③ 用户环境不需要的增量内容
3. 按本文件「修改规则」维护增量库
@@ -7,6 +7,10 @@
## Step 1:获取达人账号信息
### 数据源优先级(红线)
获取达人账号信息**必须浏览器优先**:默认用 browser-harness 访问抖音网页版账号主页提取(流程见下)。**如无必要不用查 MCP 达人信息**——MCP 的 `list_hot_accounts`/`hot_account_detail` 是**内部账号库查询工具**(MCN 内部维护的达人账号库,含人设/赛道/标签,非抖音页面实时数据),**不是本功能数据源**;仅当浏览器无法访问(账号搜索不到/主页打不开)时,才可用 MCP 达人信息兜底,并须在账号表「备注」列注明数据来源。
### Step 1.0 账号表登记(前置)
先检查 `达人账号表.xlsx`,输入信息中的账号若不在表中,先添加到表(账号ID自增、抖音号/抖音ID(sec_uid)/抖音地址存文本格式,其余字段留空),再继续获取数据。
@@ -27,4 +31,4 @@
- 账号信息登记到 **`达人账号表.xlsx`**(权威源,字段:账号ID/达人昵称/抖音号/抖音ID/抖音地址/粉丝数/解析状态/人设卡/更新时间/获赞数/关注数/作品数/IP属地/简介/备注;抖音号/抖音ID/抖音地址存文本格式。**注:仅保留网页可获取的账号数据列 + 内部主键/更新时间/流程状态,已删除非网页字段「类别/数据来源/对标视频数」**)
- **「更新时间」字段**:每次获取账号数据后,**更新「更新时间」字段**(格式 `YYYY-MM-DD HH:MM`)。再次获取前先检查该字段:若数据较新(如近 1 个月内)应提示用户判断是否仍需刷新,避免无谓重复抓取
- 根目录默认位于用户桌面 `{产出根目录}/`(实际产出路径以 `references-add/路径配置.md` 为准)
- 根目录默认位于用户桌面 `{产出根目录}/`(实际产出路径以 `references/路径配置.md` 为准)
@@ -19,4 +19,4 @@
### 数据保存规则
- 浏览器抓取数据保存为 **Excel 文件**(`短视频表格.xlsx`,13列标准格式:序号 | 视频ID | 视频标题 | 视频地址 | 点赞数 | 点赞(显示) | 评论数 | 分享数 | 收藏数 | 播放量 | 视频时长 | 发布时间 | 标签)
- 根目录默认位于用户桌面 `{产出根目录}/`(实际产出路径以 `references-add/路径配置.md` 为准)
- 根目录默认位于用户桌面 `{产出根目录}/`(实际产出路径以 `references/路径配置.md` 为准)
@@ -3,7 +3,7 @@
> 本文件是 MCNDouAnalysis 技能**功能三(提炼账号设定)**的完整执行流程。
> 独立文件设计目的:部署到用户电脑时,如不需要此功能,**删除本文件即可禁用**(同时可删除 `references/人设卡生成方法.md`、`references/知识库/账号设定/`、`references/解析结果格式规范.md`;**如功能四仍启用,解析结果格式规范需保留**,功能四目录结构以其为准)。
> 🔴 **执行前必读避坑**:`references-add/铁律避坑规则/账号设定执行避坑.md`(本功能执行中踩过的坑:本地接口调用超时、大文本序列化、analysis 简化格式、写库验证等,防止重复犯错)。
> 🔴 **执行前必读避坑**:`references/铁律避坑规则/账号设定执行避坑.md`(本功能执行中踩过的坑:本地接口调用超时、大文本序列化、analysis 简化格式、写库验证等,防止重复犯错)。
---
@@ -62,4 +62,4 @@
| `references/知识库/视频拆解/` | 功能四拆解知识库(23文件:开场/框架/情绪/钩子/植入/拆解,③用户环境独立运行) |
| `references/解析结果格式规范.md` | 目录结构权威源 |
| `references/接口调用/MCP_工具调用规范.md` | MCP 安装/登录/降级规范(Step 7 补解析 + 拆解降级) |
| `references-add/铁律避坑规则/账号数据分析执行避坑.md` | 功能四执行避坑(14个问题按工具/数据/流程/分析四类归档) |
| `references/铁律避坑规则/账号数据分析执行避坑.md` | 功能四执行避坑(14个问题按工具/数据/流程/分析四类归档) |
@@ -48,7 +48,7 @@ id = "{detailId}"
> - `python json_tool.py create-content --detail-id {detailId} --title "标题" --output-dir "{产出目录}/视频文件夹" --input-file _tmp.txt`
> - `python json_tool.py create-analysis --output-dir "{产出目录}/视频文件夹" --input-file _analysis_tmp.txt`
保存位置:`{产出根目录}/{达人昵称}/视频对标/{视频文件夹}/`(产出根目录以 `references-add/路径配置.md` 为准;视频文件夹命名按 SKILL.md 规则:`视频标题(去特殊符号)_标签1_标签2`)。
保存位置:`{产出根目录}/{达人昵称}/视频对标/{视频文件夹}/`(产出根目录以 `references/路径配置.md` 为准;视频文件夹命名按 SKILL.md 规则:`视频标题(去特殊符号)_标签1_标签2`)。
### ⑤ 写入数据库(可选,环境支持时)
@@ -130,3 +130,5 @@ MCP 工具可用后,调用任何 MCP 工具前须先检查飞书登录状态
| `upload_other_video` | 上传本地视频文件做 AI 内容解析入库 | `title` + `file_path` | 对标视频是本地文件时 |
| `short_video_detail` | 查询解析结果(文案+拆解),判断是否完成 | `id`(详情ID) | Step 4 轮询获取解析内容 |
| `current_user` | 获取当前登录用户完整资料 | 无 | 确认登录身份 |
> ⚠️ **工具边界(数据源红线)**:MCP 服务另暴露 `list_hot_accounts`(内部账号列表)、`hot_account_detail`(内部账号详情)等工具(工具命名 hot_accounts 有误导性,实为 **MCN 内部维护的达人账号库**,含人设/赛道/标签/代表作,非抖音页面实时数据)——**仅作内部账号库查询,禁止作为功能一「获取账号信息」的数据源**。功能一数据源 = 浏览器访问抖音账号主页(**浏览器优先,如无必要不用查 MCP 达人信息**;浏览器无法访问时才可兜底并注明来源)。
@@ -4,7 +4,7 @@
excel_tool.py — 统一Excel工具(筛选/查询/导出)
三种模式:
1. select-top6 筛选TOP视频(最近三个月 + ≤15分钟 + 点赞分享降序,默认取6条,可用 --count 指定)
1. select-top6 筛选TOP视频(最近三个月 + ≤15分钟 + 点赞分享降序,默认取6条,可用 --count 指定;默认数量为 SKILL.md「视频筛选标准」的执行镜像,调整该参数时须同步本处)
2. query 按标题关键词查询视频数据(含三比率计算)
3. export-selected 批量导出选中视频数据(含三比率计算)
@@ -18,7 +18,7 @@ Excel列结构(13列标准格式):
藏赞比 = 收藏数 / 点赞数 × 100% (基准 7.5%)
用法示例:
# 筛选TOP6(默认)
# 筛选TOP视频(默认6条,数量与 SKILL.md「视频筛选标准」同步)
python excel_tool.py select-top6 "C:/path/to/短视频表格.xlsx" [--output top6.json]
# 指定数量
python excel_tool.py select-top6 "C:/path/to/短视频表格.xlsx" --count 6 [--output top6.json]
@@ -153,7 +153,9 @@ def row_to_summary(row):
# ============================================================
def select_top6(excel_path, count=6):
"""筛选TOP视频(默认取6条,可用 count 指定数量)。"""
"""筛选TOP视频(默认取6条,可用 count 指定数量)。
默认数量为 SKILL.md「视频筛选标准」的执行镜像:调整 SKILL.md 该参数时必须同步本默认值。
"""
rows = load_excel_rows(excel_path)
# 时间过滤:最近三个月
@@ -274,7 +276,7 @@ def main():
subparsers = parser.add_subparsers(dest='action', help='操作模式')
# select-top6
p_top6 = subparsers.add_parser('select-top6', help='筛选TOP视频(默认取6条)')
p_top6 = subparsers.add_parser('select-top6', help='筛选TOP视频(默认取6条,与 SKILL.md「视频筛选标准」同步)')
p_top6.add_argument('excel_path', help='短视频表格.xlsx 路径')
p_top6.add_argument('--count', '-n', type=int, default=6, help='筛选数量(默认6条)')
p_top6.add_argument('--output', '-o', default=None, help='输出JSON路径')
@@ -1,7 +1,7 @@
#!/usr/bin/env python3
"""
筛选 TOP 视频 — 已整合到 excel_tool.py select-top6 子命令。
此文件保留向后兼容,实际调用 excel_tool.select_top6()(默认取6条)。
此文件保留向后兼容,实际调用 excel_tool.select_top6()(默认取6条,与 SKILL.md「视频筛选标准」同步)。
用法:
python select_top6.py <excel路径> [--count 6] [--output output.json]
@@ -41,7 +41,7 @@ def main():
if idx + 1 < len(sys.argv):
output = sys.argv[idx + 1]
# 解析 --count(默认6)
# 解析 --count(默认6,与 SKILL.md「视频筛选标准」同步)
count = 6
if '--count' in sys.argv:
idx = sys.argv.index('--count')