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 + 失误与规避记录
2026-08-27 10:25:00 +08:00
1 parent b05e74bbbc
commit f025ad3b86
@@ -328,3 +328,9 @@
 - 用户问「诊断&评分是什么功能」→ 核对发现帮助文档失实：四维度写成「内容力/情绪力/制作力/传播力」、分制写「28分制」——S11 实际四维度=爆款要素命中率(35)/人设匹配度(25)/可拍摄性(20)/合规性(20)，**100分制**，通过线总分≥75且合规≥14/20
 - 修正两副本诊断块 3 行描述；「28分制」「内容力/情绪力/制作力/传播力」零残留
 - 教训：帮助文档描述必须对照 S11/知识库实际内容写，不能凭印象编维度名和分制（早期遗留失实）
+
+### 17:38 帮助文档改动同步仓库
+
+- 提交 943ba9f：帮助文档功能重组（5大功能块）+ 诊断块失实修正（V1.0/dsh/Lite1.0 三副本+SKILL.md 标签+记忆）
+- `git add -A` 再次把 browser-harness gitlink 带入（提交 2bea606 二次移除）→ 治本：.gitignore 加 `browser-harness/` 条目（提交 b05e74b），此后不再误入
+- 终态：origin/main = 本地 HEAD = b05e74b，工作区 0 改动；跟踪引用 push 后丢失照旧手动重建
@@ -0,0 +1,49 @@
+# 2026-08-27 工作日志
+
+## mcn-dou-analysis 定为主版本 + 源/dsh 差异判断（09:40-09:59）
+- 用户宣布 `project/短视频脚本创作/V1.0/subskill/mcn-dou-analysis/` 为抖音账号分析技能**主版本**（源技能），已写入 MEMORY.md
+- **差异判断结论**：dsh 副本（`C:\Users\maidou\.dsh\skills\mcn-dou-analysis\`）无独有新方法论内容需回流，全部差异四类：①环境路径特化（账号表→`D:\dshworkspace\达人账号表.xlsx`、路径配置/铁律避坑从 references-add 并入 references/、README 标注 dsh 状态）②位置互换内容一致（路径配置.md/铁律避坑 2 文件完全一致）③纯换行符差异（mcp-config.json、账号数据分析执行避坑.md）④注释补充
+- 源 `references-add/创作流程/`、`知识库/01_账号设定`、`知识库/12_拆解评估` 为**空目录**（无文件）
+
+## 脚本注释回流（以 dsh 为准，09:55）
+- **背景**：TOP6 定义分散是之前特意要治的问题，dsh 版脚本补充了「执行镜像」注释强化，用户指示以 dsh 为准回流
+- **修改**（源技能 2 文件 6 处，代码逻辑零改动）：
+  - `scripts/excel_tool.py` 4 处：docstring 模式说明、用法示例注释、select_top6 函数 docstring、argparse help —— 均补「默认数量为 SKILL.md『视频筛选标准』的执行镜像，调整时须同步本处」
+  - `scripts/select_top6.py` 2 处：顶部 docstring、`# 解析 --count` 注释
+- **验证**：`tr -d '\r'` 后 diff 与 dsh **完全一致** ✅
+
+## 待办/未决
+- references-add/README.md 两边差异已展示（dsh 版含「当前状态：②dsh环境」blockquote + ③用户环境启用流程；源版含「①开发机/②dsh环境」合并行）——用户要求"两边应该相同"，统一方案待确认（建议通用中性版）
+
+## README 统一版（10:06 完成）
+- 用户指示：环境判断参考 SKILL.md 两步判定模型，两边应一致
+- 重写 `references-add/README.md` 为**通用中性版**，源 + dsh 同步（diff 验证 ✅ 完全一致）：
+  - 顶部「当前状态」blockquote → **三环境两步判定**（与 SKILL.md 第 51 行完全一致：无 D:\AgentSkill=③用户环境；在 D:\AgentSkill\ 下=①开发机；含 .dsh=②dsh）+ references-add 机制只服务③的说明
+  - 修改规则表格恢复**三行齐全**（①开发机/②dsh环境/③用户环境），①行补「开发机直接改标准库，不使用增量库机制」
+  - 保留 dsh 版机制增强：②dsh「增量并入标准库」、③用户环境启用流程、标题「机制说明」
+  - 措辞取 dsh 版：「获取视频列表」「（机制文档）」「③ 用户环境中」
+- **新发现（未处理）**：SKILL.md 第 75 行「当前机器源技能路径 `D:/AgentSkill/mcn-video-script/project/V1.0`」为**过时路径**——实际脚本创作技能在 `project/短视频脚本创作/V1.0/`（08-26 重构后），`project/V1.0` 是重构前旧结构；dsh 副本同样存在，需两边一起改，待用户确认
+
+## SKILL.md 源技能路径修正（10:08 完成，用户确认）
+- 修正 SKILL.md 第 75 行「脚本创作技能（权威源）」路径：`D:/AgentSkill/mcn-video-script/project/V1.0` → `D:/AgentSkill/mcn-video-script/project/短视频脚本创作/V1.0`
+- 源 + dsh 两边同步修改；验证：新路径两边各 1 处 ✅、全技能范围旧路径 `mcn-video-script/project/V1.0` **零残留** ✅
+- 剩余 17 行 SKILL.md 差异均为原有 dsh 环境特化（账号表位置/路径配置位置/增量库状态说明），非本次引入，符合 .dsh 单向只读保留
+
+## 「源精简=dsh」方案执行完成（10:10-10:30）
+- 用户选定：source references-add 只留 README.md（对齐 dsh 现状）
+- **移动结果**：`references/路径配置.md` + `references/铁律避坑规则/`（账号设定执行避坑.md + 账号数据分析执行避坑.md）已从 references-add 并入源 references/ 标准库（时间戳 15:20/16:07 与 dsh 一致=真实 mv 保留时间戳；期间 mv/rmdir 报 "No such file" 为沙箱视图误报，真实磁盘已到位）
+- **引用更新**（8 处，全部按 dsh 版对齐）：SKILL.md ×3（行 40 引用+加粗、行 52 三环境括号说明、2.2 表补「产出路径配置」行 + 更新「增量库」行含「当前①开发机/②dsh环境状态」）+ feature ×5（01/02/05 路径配置、03/04 铁律避坑）+ 行 51 微小表述「③用户环境独立使用」
+- **验证**：
+  - references-add 两侧均只剩 README.md 且 diff 完全一致 ✅
+  - references/ 全目录归一化 diff：仅剩 3 文件 4 处环境特化（feature/01、02 账号表路径 `D:\dshworkspace\` ×3、feature/03 12段基准说明 ×1），按单向只读保留 ✅
+  - SKILL.md 归一化 diff：17 处 → **5 处**（账号表位置 ×2 处、账号类型判定行序互换 ×1、增量库状态视角 ×1——源=①开发机/dsh=②dsh），全部合理 ✅
+  - references-add 残留引用：源仅剩 `本地接口调用规范.md:4` 历史来源说明（与 dsh 一致）✅
+- **铁律避坑规则 diff 经验**：`diff -r` 直接对比中文 md 会因 CRLF/LF 误报整文件差异，必须 `tr -d '\r'` 归一化后对比；文件名含空格需用 `find -print0` + `while read -d ''`，for 循环按空格切分会把文件名拆断
+
+## 账号信息数据源红线（10:16-10:25，用户环境反馈）
+- **反馈**：昨天用户环境「分析账号/获取数据」时 AI 优先查 MCP 达人信息（`list_hot_accounts`/`hot_account_detail`），而非浏览器访问账号页面
+- **根因**：文档默认流程虽是浏览器优先，但无显式红线；MCP 服务暴露带 account 工具且未标边界，AI 按工具名误用
+- **固化**（源 + dsh 双副本同步 6 处编辑）：SKILL.md 规则表「账号信息数据源（红线）」行（浏览器优先、如无必要不用 MCP、hot_account 非功能一数据源、浏览器访问不了才兜底+注明来源）、feature/01「数据源优先级（红线）」块、MCP_工具调用规范.md 工具清单「工具边界（数据源红线）」备注
+- **名称纠正（10:19 用户反馈）**：`list_hot_accounts`/`hot_account_detail` **不是热门账号/榜单**，是 **MCN 内部账号库**（内部维护的达人账号，含人设/赛道/标签/代表作，非抖音页面实时数据；工具命名 hot_accounts 有误导性）——6 处文案已改「内部账号库查询」，验证「热门账号榜单/列表/详情」零残留 ✅、源/dsh 一致 ✅
+- **验证**：三处新增源/dsh diff 一致 ✅（MCP 规范两侧完全一致）
+- **三层化沉淀**：失误与规避记录 #013（已含内部账号库纠正）+ 本日志
@@ -11,7 +11,7 @@
 ## 核心技能清单
 - **短视频脚本创作** (`project/短视频脚本创作/V1.0/` + `Lite1.0/`)：11步流程+知识库12分类（66文件）；V1.0 完整版含 MCP/Dify 接口，Lite1.0 去全部接口、搜索用模型自带 WebSearch。扁平化定式=去「技能名」层、留「项目名」层（`project/项目名/{版本}/`）；08-26 曾误去项目名层已回改
  - **同步策略（08-26 17:34 用户定）**：后续所有改动只改 V1.0 源技能 + dsh 副本两处；**Lite1.0 默认不动**（有需要再单独处理，其特化差异=去MCP/拆解贴文案/无工具接口块）
- **短视频账号分析** (`project/短视频账号分析/case_1/1_账号分析方法/`)：全维度账号诊断；三模式🚀快速诊断(调 douyin-account-diagnosis 脚本)/⚡快速/🤝共创；8步流程+12维度框架+6类风险+4确认门；快速诊断六维度100分制(画像10/生产力15/互动30/质量20/趋势15/粉丝10)；产出 `account_analysis/{账号名}_{账号ID}/`
+- **抖音账号分析 mcn-dou-analysis（主版本，08-27 用户宣布）**：源技能=`project/短视频脚本创作/V1.0/subskill/mcn-dou-analysis/`（SKILL.md 19KB）；dsh 副本=`C:\Users\maidou\.dsh\skills\mcn-dou-analysis\`；**旧路径 `project/短视频账号分析/case_1/1_账号分析方法/` 已废弃**（08-26 迁移整合，旧三模式/12维度框架已被五大功能体系取代）。五大功能：F1获取账号信息/F2获取视频列表(13列Excel)/F3提炼账号设定(人设卡统一12段)/F4分析视频数据(逐条拆解→汇总两段式)/F5解析视频(单视频MCP)；红线要点：达人账号表15列(仅用户要求才增改)、TOP6筛选(点赞+分享降序,唯一权威参数在SKILL.md)、≥60条停止滚动、29赛道枚举、源技能只读单向同步、技能边界(脚本必须切换脚本创作技能S1-S11)、浏览器操作规范(9223调试实例+标签页复用)。后续所有改动以本主版本为准
 - **短视频分镜脚本** (`project/短视频提示词生成/V1.0/`，08-20 由"短视频分镜创作"改名，08-26 路径精简为现结构) — 提示词工程
  - 4功能：F1反推图片/F2反推视频/F3生成图片/F4生成分镜；参考 skills：seedance2.0/ShotDesign + seedance25 单文件
  - 三层引用架构：参考skills→references/→references-add/（运行时优先）；**开发机不启用 references-add/**（直接编辑 references/），dsh/用户环境启用（references/ 只读）
@@ -64,3 +64,4 @@
 - 08-17 三态创作模式定稿(三态互斥)；08-20 分镜标准库落库+审计P0/P1+seedance25提炼+剧本分析前置+模板泛化
 - 08-21 Lite1.0 新增(去接口)；08-22 .dsh 单向只读确立；08-25 仓库更名 mcn-short-video→mcn-video-script
 - 08-26 路径重构(project/短视频脚本创作/{V1.0,Lite1.0}/、project/短视频提示词生成/V1.0/)+环境判定两步模型+三技能统一产出结构定稿
+- 08-27 用户宣布 mcn-dou-analysis 为抖音账号分析技能**主版本**：源=`project/短视频脚本创作/V1.0/subskill/mcn-dou-analysis/`（08-26 16:40 SKILL.md），dsh 副本=`C:\Users\maidou\.dsh\skills\mcn-dou-analysis\`（08-26 17:29 SKILL.md，**比源新 49 分钟，待核对是否需回流**）
@@ -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')
@@ -96,3 +96,14 @@ S1-S11 重跑生成脚本时，脚本正文出现 4 处输出模板未定义内
 1. **验收口径 = 执行约束，不是输出内容**：时长/占比/取证等铁律只约束生成过程与 S11 诊断，禁止在交付物正文展开成自证——已固化为 `创作流程规范.md`「交付物输出边界（通用铁律）」+ S9 输出模板「输出边界」块（V1.0/Lite1.0/.dsh 三副本同步）。
 2. **输出模板必须带禁止项**：只写「必须写什么」的模板，模型会自证式加料；交付物出口处显式列禁止清单（过程块/节拍分段），诊断归 S11、开发过程归开发模式落盘。
 3. **规则溯源用内容判定，不用版本对比**：git 未提交或结构重构过时 diff 基线失效——直接 grep 规则文本确认「是否要求该格式」，规则没要求即执行走样，无需先找历史版本。
+
+---
+
+## #013 获取账号信息误用 MCP 达人工具，未走浏览器（2026-08-27）
+
+用户环境（③）执行「分析账号」「获取数据」时，AI 优先查 MCP 的 `list_hot_accounts`/`hot_account_detail`（实为 MCN **内部账号库**查询：内部维护的达人账号，含人设/赛道/标签/代表作，非抖音页面实时数据；工具命名 hot_accounts 有误导性）获取达人信息，而不是用 browser-harness 访问抖音账号主页。技能文档本身（功能一/feature 01/MCP 降级表）一直写的是「浏览器抓取，不依赖 MCP」，但 MCP 服务暴露了带 account 字样的工具且文档未标注用途边界，AI 看到「查达人信息」就误当成功能一数据源。根因：**数据源优先级只存在于文档默认流程里，没有显式红线；工具清单未给非本职工具标注边界**。
+
+**规避与铁律：**
+1. **数据源优先级必须显式化**：获取达人账号信息**浏览器优先**（访问抖音网页版账号主页），**如无必要不用查 MCP 达人信息**；MCP hot_accounts 系列是**内部账号库查询**（不是抖音热门榜单，名称有误导性）、不是功能一数据源，仅浏览器无法访问时兜底并注明来源——已固化为 SKILL.md 规则表「账号信息数据源（红线）」行 + `feature/01_获取账号信息.md`「数据源优先级（红线）」块 + `MCP_工具调用规范.md` 工具清单「工具边界（数据源红线）」备注（源 + dsh 双副本同步）。
+2. **工具清单要标「非本职」边界**：MCP 服务暴露的工具若不属于本技能职责，必须在清单中注明「仅作 X 用途、禁止作为 Y 数据源」，防止按工具名直觉误用。
+3. **行为偏差反馈 → 三层化沉淀**：用户环境实操反馈的 AI 行为偏差，先落技能红线（治本）→ 追加失误记录（#013）→ 写工作日志（记忆层）。