TOPn动态规则+MCP首次检测+browser-harness依赖检测+环境检查系统分流(Windows/macOS)

project/短视频脚本创作/V1.0/SKILL.md

@@ -80,7 +80,7 @@ agent_created: true
 本技能的 API 功能（创意灵感/视频解析）依赖 MCN MCP 服务（`myai-mcp-production` 正式 / `myai-mcp-test` 测试）。
 
 - **配置文件**：`scripts/mcp-config.json`
-- **安装引导**：用户首次提问时自动检测 → 未安装则轻量提醒（可跳过）→ 同意则先检查 Node/Python 运行时（缺失先装）→ 自动写入 `~/.workbuddy/mcp.json` + 引导 Trust；用到 API 功能时再次提醒
+- **安装引导**：**首次触发检查（必做动作）**——本技能会话**首次交互**（用户询问功能/功能介绍/发起任何任务，无论问什么）时，**先检查 `myai-mcp-production` 是否可用**：查看当前会话可用 MCP 工具列表是否含该服务工具（如 `auth_status`/`upload_douyin_video`），或读 `~/.workbuddy/mcp.json`（Windows 为 `%USERPROFILE%\.workbuddy\mcp.json`）是否含该服务配置，两者任一存在即可用 → **未安装 → 按 MCP 规范 3 节「首次提问」轻量提醒**（可跳过、不打断创作，用户拒绝则告知后续用到 API 功能时会再次提醒）→ 同意则先检查 Node/Python 运行时（缺失先装）→ 自动写入 `~/.workbuddy/mcp.json`（Windows 同上路径）+ 引导 Trust；用到 API 功能时再次提醒
 - **登录检查**：调用前自动检查飞书登录状态（每天一次），未登录则自动触发 `feishu_login`
 - **降级**：MCP 不可用时不影响核心创作流程（步骤1-11），仅跳过 API 功能
 

project/短视频脚本创作/V1.0/references/接口调用/MCP_工具调用规范.md

@@ -26,7 +26,7 @@
 
 ## 3) 自动检测与安装引导流程
 
-**触发时机：用户首次提问（技能被触发）时即检测并提醒安装，不等到真正用到 API 功能才提示。**
+**触发时机：用户首次提问（技能被触发）时即检测并提醒安装，不等到真正用到 API 功能才提示。「首次提问」= 本技能会话的首次交互（用户询问功能/功能介绍/发起任何任务，无论问什么），由 SKILL.md「MCP 依赖（摘要）·安装引导」作为必做动作驱动。**
 
 | 触发点 | 行为 |
 |--------|------|
@@ -36,7 +36,7 @@
 
 按以下流程处理：
 
-1. **检测**：检查 `myai-mcp-production` 的 MCP 工具是否在可用列表中。可用 → 跳到 [4 登录检查]；不可用 → 进入步骤2
+1. **检测**：检查 `myai-mcp-production` 的 MCP 工具是否在可用列表中。**检测方法（任一即可判定）**：① 查看当前会话可用 MCP 工具列表是否含该服务工具（如 `auth_status`/`upload_douyin_video`/`short_video_detail`）；② 读 `~/.workbuddy/mcp.json`（Windows 为 `%USERPROFILE%\.workbuddy\mcp.json`）是否含 `myai-mcp-production` 服务配置。两者都无 → 未安装 → 进入步骤2
 2. **判定环境 + 提示**：
    - **首次提问（轻量提醒，不打断创作）**：
      > 本技能部分功能（对标视频解析 / 创意灵感 / 账号设定查询）依赖 MCN MCP 服务。是否现在安装？暂时不需要可跳过，不影响核心创作流程，用到时会再次提醒。
@@ -50,7 +50,7 @@
    - **部署预检（先做，按顺序）**：
      1. **运行时版本**：检查 Node.js（`node --version`）和 Python（`python --version`）是否已安装。缺失则先引导安装对应运行时再继续——`npx` 型 MCP 依赖 Node.js，`python` 型 MCP 依赖 Python，缺失会导致 MCP 安装/启动失败。
      2. **npm 缓存权限（macOS 高发坑，必须查）**：`npx` 型 MCP 首次运行需写入 npm 缓存（默认 `~/.npm` 的 `_npx`/`_cacache`）。若缓存目录里有 **root 权限文件**（常见于曾用 sudo 装过包、系统迁移/重装后遗留），npx 无权限写入 → MCP 启动静默失败。典型症状：包能正常下载（源没问题）、配置也写入了，但 MCP 一直连不上/不出现。
-        - **检查**：`npm config get cache` 确认缓存目录（默认 `~/.npm`）；`find ~/.npm -user root 2>/dev/null | head` 查看是否有 root 文件
+        - **检查**：`npm config get cache` 确认缓存目录（默认 `~/.npm`）；**macOS/Linux** 用 `find ~/.npm -user root 2>/dev/null | head` 查看是否有 root 文件；**Windows 无 root 权限文件问题，跳过此项检查**（只需确认缓存目录可写即可）
         - **处理**：缓存可重建，直接清理（目录本身归用户所有，**无需 sudo**）：`rm -rf ~/.npm/_npx ~/.npm/_cacache`，下次 npx 运行自动重建
         - **注意**：只清缓存目录，**不要**动 `~/.npmrc`（含 registry 配置）和全局已安装的包
      3. **（可选）npm 源**：国内网络确认 registry 已配镜像（`npm config get registry`，如 `https://registry.npmmirror.com`）避免拉包超时。但镜像**不是**启动失败的根因，排查顺序永远是 1 → 2 → 3。

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

@@ -40,12 +40,13 @@ description: "MCN 达人爆款视频解析与人设卡生成技能：达人账
 | 达人账号表.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` 默认值（执行镜像）。 |
+| 视频筛选标准 | 先按发布时间过滤**最近三个月**，排除**视频时长>15分钟**的视频，再按点赞+分享总量降序排列，取 TOP 6（不再设30W互动量门槛）。**实际满足条件的视频不足 6 条时，按实际条数取（TOPn 的 n=实际解析条数，如王微斯 4 条→TOP4）**，产出文件（设定 md/卡片）的「TOPn」均按实际条数写，不写 6。**本参数为唯一权威参数**：只在 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 依赖（红线） | 功能一/二（浏览器抓取）执行前**必须先检测 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）全绿。技能本体 `~/.dsh/skills/browser-harness/` 随 dsh_MCNProject 仓库分发（换机器自带）。检测与安装细节见 `references/浏览器搜索抖音账号操作规范.md` 第五节。 |
 | 账号信息数据源（红线） | 获取达人账号信息（功能一）**必须浏览器优先**：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`。 |

project/短视频脚本创作/V1.0/subskill/mcn-dou-analysis/references/feature/03_提炼账号设定.md

@@ -95,4 +95,4 @@ id = "{detailId}"
   - **改设定**（内容/模块/命名）→ 卡片同步更新：内容级改动走功能六「方式」重新生成；单点改动（改文案/换底色）直接改 SVG 对应元素
   - **改卡片**（单点微调：换底色/微调布局）→ 设定 md 中对应内容同步（底色映射见 06 文档「配色适配」，内容以设定为源）
   - **术语/模块改名** → 两边一起改（历史案例：「内容路线」→「叙事结构」、「核心气质」→「内容标签」均同步改设定 md + 卡片 SVG）
-- **一致性校验**：交付前用 grep 核对两文件关键术语一致（模块名「叙事结构」「内容标签」「内容基因·TOP6」等），零残留后再交付
+- **一致性校验**：交付前用 grep 核对两文件关键术语一致（模块名「叙事结构」「内容标签」「内容基因·TOPn」等，n=实际解析条数），零残留后再交付

project/短视频脚本创作/V1.0/subskill/mcn-dou-analysis/references/feature/06_生成账号设定卡片.md

@@ -53,8 +53,8 @@
 - 设定 md 与设定卡 = **同一账号信息的两种载体**，任一边修改，另一边必须同步：
   - **改设定**（内容/模块/命名）→ 卡片同步：内容级改动走下方「方式」重新生成；单点改动（改文案/换底色）直接改 SVG 对应元素
   - **改卡片**（单点微调：换底色/微调布局）→ 设定 md 对应内容同步（底色映射见上方「配色适配」，内容以设定为源）
-  - **术语/模块改名** → 两边一起改（历史案例：「内容路线」→「叙事结构」、「核心气质」→「内容标签」、「六大内容基因」→「内容基因·TOP6」，均同步改设定 md + 卡片 SVG）
-- **一致性校验**：交付前用 grep 核对关键术语两文件一致（模块名「叙事结构」「内容标签」「内容基因·TOP6」等），零残留后再交付
+  - **术语/模块改名** → 两边一起改（历史案例：「内容路线」→「叙事结构」、「核心气质」→「内容标签」、「六大内容基因」→「内容基因·TOPn」，均同步改设定 md + 卡片 SVG）
+- **一致性校验**：交付前用 grep 核对关键术语两文件一致（模块名「叙事结构」「内容标签」「内容基因·TOPn」等，n 按实际解析条数），零残留后再交付
 
 ---
 
@@ -75,7 +75,7 @@
 | 1 | 账号核心定位（赛道/类型/定位语） | 顶部标题区（账号名 + 「账号设定卡」副题 + 定位语） | 浅米色大框 520×170，居中 |
 | 2 | 内容打法中的路线/流程（如有六步闭环） | 叙事结构（流程条） | 6 卡横排，箭头串联 |
 | 3 | 内容标签/核心标签 | 内容标签（chips） | 胶囊 86×32，两行 |
-| 4 | 内容基因（功能三基于 TOP6 视频提炼的结论） | 内容基因·TOP6 | 3 列 × 2 行，卡 186×130 |
+| 4 | 内容基因（功能三基于 TOPn 视频提炼的结论，n=实际解析条数） | 内容基因·TOPn | 3 列 × 2 行，卡 186×130 |
 | 5 | 视听风格/色彩体系 | 色彩体系 | 5 色卡横排（色块 + 标签） |
 | 6 | 类型库/角色类型 | 角色类型库 | 3 列 × 2 行，卡 186×130 |
 | 7 | 情绪结构（六段式） | 情绪图（柱状条） | 7 条条形，底边对齐 |
@@ -83,7 +83,7 @@
 | 9 | 差异化壁垒/其他亮点 | 可并入基因/类型卡描述行 | — |
 | — | 底部版权 | 数据来源 + 版本注记 | 居中两行小字 |
 
-> **注**：内容基因条目由**功能三基于 TOP6 视频**（筛选权威参数见 SKILL.md「视频筛选标准」）提炼得出——TOP6 视频是分析依据（输入），内容基因是结论（输出），卡片上全量呈现、不裁剪。后续生成卡片统一以「内容基因·TOP6」描述该模块。
+> **注**：内容基因条目由**功能三基于 TOPn 视频**（n=实际解析条数；筛选上限见 SKILL.md「视频筛选标准」）提炼得出——TOPn 视频是分析依据（输入），内容基因是结论（输出），卡片上全量呈现、不裁剪。**模块名「内容基因·TOPn」的 n 按实际解析条数写（几个视频就是 TOP 几，如王微斯 4 条→「内容基因·TOP4」），不是固定 6**；n 与设定 md「解析视频：最近三个月TOPn」保持一致。
 
 ### ③ 排版绘制（SVG 手写）
 逐模块写 SVG（无模板文件，直接手写 `<rect>`/`<text>`），坐标自上而下递增，模块间留白 ≥30px。
@@ -104,7 +104,7 @@
 |------------|---------|------|
 | 有叙事结构/六步闭环/流程 | 保留「叙事结构」 | 流程条按实际步骤数画（4/5/6 步皆可，等宽均分 600px 宽） |
 | 无流程类内容 | **删除**「叙事结构」模块 | 后续模块上移，不留空白 |
-| 有内容基因（≥3 条） | 保留「内容基因·TOP6」 | 按实际条数画 2 列或 3 列（卡宽 = 600px/列数 - 间距） |
+| 有内容基因（≥3 条） | 保留「内容基因·TOPn」（n=实际解析条数） | 按实际条数画 2 列或 3 列（卡宽 = 600px/列数 - 间距） |
 | 有角色类型/角色库 | 保留「角色类型库」 | 按实际条数画 2 列或 3 列 |
 | 无角色库 | **删除**「角色类型库」 | — |
 | 有情绪结构/情绪曲线 | 保留「情绪图」 | 条形按实际段数画（4-7 段），底边对齐 |

project/短视频脚本创作/V1.0/subskill/mcn-dou-analysis/references/浏览器搜索抖音账号操作规范.md

@@ -141,30 +141,53 @@
 
 ## 五、browser-harness 调用方式（环境 SOP）
 
-> **环境说明（2026-08 实测）**：browser-harness 由 uv 工具安装，可执行文件在 `~/.local/bin/browser-harness.exe`；技能本体在 `~/.dsh/skills/browser-harness/`（随 dsh_MCNProject 仓库分发，换机器自带）。
+> **环境说明（2026-08 实测）**：browser-harness 由 uv 工具安装，可执行文件位置**按系统区分**——Windows：`~/.local/bin/browser-harness.exe`；macOS/Linux：`~/.local/bin/browser-harness`；技能本体在 `~/.dsh/skills/browser-harness/`（随 dsh_MCNProject 仓库分发，换机器自带）。
+
+### 5.0 环境检查与安装（每次浏览器任务前【必做】）
+
+**① 检测是否已安装（任一方法即可判定）：**
+
+| 方法 | 操作 | 判定 |
+|------|------|------|
+| ① 可执行文件 | 检查 `~/.local/bin/browser-harness.exe`（Windows）/ `~/.local/bin/browser-harness`（macOS/Linux）是否存在 | 存在 = 已安装 |
+| ② 命令探测 | `command -v browser-harness`（macOS/Linux）/ `where browser-harness`（Windows）是否有输出 | 有输出 = 已安装 |
+| ③ doctor 验证（可选） | `browser-harness doctor`（确认工具/daemon/Chrome 三要素） | 三要素就绪 = 可用 |
+
+**② 未安装 → 提醒用户安装**（由 SKILL.md「browser-harness 依赖（红线）」驱动）：
+
+- **可跳过**：改用三方数据 API / MCP 兜底数据源，但功能一/二浏览器抓取无法执行
+- **同意安装**：`uv tool install --python 3.12 --upgrade --force browser-harness`（`--python 3.12` 防止选中过旧版本；`--upgrade --force` 覆盖旧安装）
+- **技能本体** `~/.dsh/skills/browser-harness/` 随 dsh_MCNProject 仓库分发（换机器自带；如缺失可从 browser-harness 仓库的 `browser-harness skill` 命令重新生成）
+- **安装后验证**：`command -v browser-harness`（macOS/Linux）/ `where browser-harness`（Windows）有输出 + `browser-harness doctor` 三要素全绿，再进入下方 5.1 环境准备
 
 ### 5.1 环境准备（每次浏览器任务前【必做】）
 
-**① 清除代理环境变量（最重要，漏掉必踩坑）**：本机 Shadowsocks 的 Privoxy 组件监听 10800，会劫持 127.0.0.1 的 CDP 请求（报 "Internal Privoxy Error" 或连接失败）。
+**① 清除代理环境变量（最重要，漏掉必踩坑）**：本机代理软件（如 Shadowsocks 的 Privoxy 组件监听 10800）会劫持 127.0.0.1 的 CDP 请求（报 "Internal Privoxy Error" 或连接失败）。**按系统清除**：
 
+- **Windows（PowerShell）**：
 ```powershell
 Remove-Item Env:HTTP_PROXY, Env:HTTPS_PROXY, Env:http_proxy, Env:https_proxy -ErrorAction SilentlyContinue
 $env:NO_PROXY = "127.0.0.1,localhost,::1"
 ```
+- **macOS/Linux（bash/zsh）**：
+```bash
+unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY
+export NO_PROXY="127.0.0.1,localhost,::1"
+```
 
 **② 连接方式（按顺序尝试）**：
 
 | 方式 | 操作 | 说明 |
 |---|---|---|
 | A. 自动（推荐） | 直接运行 browser-harness（daemon 自动启动并连接浏览器） | 最简单；可能触发 Chrome 授权弹窗（见 5.2） |
-| B. 定向连接 | `$env:BU_CDP_URL="http://127.0.0.1:<端口>"` 后运行 | 端口：先探测 9222（用户 Chrome 隐式调试端口）/ 9223（独立实例），取有效者 |
-| C. 独立实例 | `chrome.exe --remote-debugging-port=9223 --user-data-dir=<固定目录> about:blank` | 与用户浏览器隔离；Chrome 151+ 首次连接同样可能弹授权 |
+| B. 定向连接 | 设置 BU_CDP_URL 后运行：Windows `$env:BU_CDP_URL="http://127.0.0.1:<端口>"` / macOS `export BU_CDP_URL="http://127.0.0.1:<端口>"` | 端口：先探测 9222（用户 Chrome 隐式调试端口）/ 9223（独立实例），取有效者 |
+| C. 独立实例 | Windows：`chrome.exe --remote-debugging-port=9223 --user-data-dir=<固定目录> about:blank`；macOS：`"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --remote-debugging-port=9223 --user-data-dir=<固定目录> about:blank` | 与用户浏览器隔离；Chrome 151+ 首次连接同样可能弹授权 |
 
 ### 5.2 Chrome 151+ 远程调试授权（关键机制）
 
 - Chrome 151+ 无论隐式（9222）还是显式（--remote-debugging-port）启动，**CDP 端点默认 404，首次连接会弹「Allow remote debugging?」授权框**；点击「允许」后端点才可用（Chrome 会记住，后续不再弹）
 - 弹窗可能出现在**后台窗口**：看不到时打开 `chrome://inspect/#remote-debugging` 页面启用（勾选后同样生效）
-- 连接前探测授权状态：`Invoke-WebRequest http://127.0.0.1:<端口>/json/version` —— **返回含 "Browser" 的 JSON = 可用**；404/超时 = 未授权或非 CDP
+- 连接前探测授权状态：Windows（PowerShell）`Invoke-WebRequest http://127.0.0.1:<端口>/json/version` / macOS/Linux（bash/zsh）`curl -s http://127.0.0.1:<端口>/json/version` —— **返回含 "Browser" 的 JSON = 可用**；404/超时 = 未授权或非 CDP
 
 ### 5.3 失败排查顺序（按此执行，不跳步）
 

project/短视频脚本创作/V1.0/subskill/mcn-video-prompt/SKILL.md

@@ -9,7 +9,7 @@ description: >
 version: "1.0"
 agent_created: true
 updated_at: "2026-08-31"
-last_change: "提示词输出结构 4层→6层重排（用户定稿）：①主体列表→②画面质感（视觉风格+摄影质感前置）→③色调光影→④主体设定（人物/场景/构图）→⑤镜头叙事→⑥负面提示词；原「设定」层拆为画面质感/色调光影/主体设定三层，视觉基调前置（模型对提示词开头权重最高）；同步 3.2.2 输出格式+3.2.1 思考清单+6层×5类型适配表+Step5 校验②结构完整性+SKILL.md F4/工作流/自检⑧引用（分镜提示词制作流程.md 同步修订）"
+last_change: "④主体设定→④设定 改名（20处全量替换：SKILL.md 6 + 分镜提示词制作流程.md 10 + 长视频分段制作流程.md 4）；6层结构定稿：①主体列表→②画面质感→③色调光影→④设定（人物/场景/构图，每项1句）→⑤镜头叙事→⑥负面提示词；视觉基调前置（模型对提示词开头权重最高）；站位/构图边界固化（08-31）：构图=画面布局归④设定-构图，站位=画面坐标归⑤镜头叙事（逐镜头写），注记入 3.2.2 输出格式块+适配表+SKILL.md F4 结构定义"
 deployment: source
 created_at: "2026-08-20"
 ---
@@ -202,7 +202,7 @@ F2 在 5 步工作流框架内执行，其中步骤 2-3 包含两轮用户交互
 > **⚠️ 字符限制冲突说明：** seedance2.0-prompt-skill 实测平台接受上限 2000 字符；Seedance2.0-ShotDesign v2.0 官方规范建议 ≤500 字符（中文）/ ≤1000 词（英文），品质最优区间 60-100 词（中文约 120-200 字符）。**以 500 字符为品质基准，2000 字符为硬性上限。**
 
 **详细方法论：**
-- 6步总流程+路径分流+6层结构（主体/画面质感/色调光影/主体设定/镜头叙事/负面词，视觉基调前置，11字段降为内部思考清单）+时长速查：`references/制作流程/分镜提示词制作流程.md`
+- 6步总流程+路径分流+6层结构（主体/画面质感/色调光影/设定/镜头叙事/负面词，视觉基调前置，11字段降为内部思考清单）+时长速查：`references/制作流程/分镜提示词制作流程.md`
 
 **详细方法论：**
 - 路径C双范式（反应/凝视）+11条核心原则+版权审查SOP：`references/制作流程/图生视频与分镜板制作流程.md`
@@ -272,7 +272,7 @@ F4 输出 = 主题 + 导演阐述 + 完整提示词（代码块包裹）。多
 
 **单段（路径 A，≤15s）：** 主题 + 导演阐述 + 单块代码块提示词
 
-提示词内部结构（6层结构，按类型适配）：`①主体列表（置顶，按类别分行：人物/场景/道具，@图片引用优先）→ ②画面质感（视觉风格+摄影质感参数，视觉基调前置）→ ③色调光影（光源+主光方向+亮暗区+色调/色温，1句）→ ④主体设定（人物逐人必写不可遗漏/场景/构图，每项1句，按类型取舍）→ ⑤镜头叙事（每镜头1段流畅描述：机位/景别/朝向+动作/变化+运镜嵌在动作中+有台词时带语气）→ ⑥负面提示词（放最后，3.3标准模板）`
+提示词内部结构（6层结构，按类型适配）：`①主体列表（置顶，按类别分行：人物/场景/道具，@图片引用优先）→ ②画面质感（视觉风格+摄影质感参数，视觉基调前置）→ ③色调光影（光源+主光方向+亮暗区+色调/色温，1句）→ ④设定（人物逐人必写不可遗漏/场景/构图，每项1句，按类型取舍）→ ⑤镜头叙事（每镜头1段流畅描述：机位/景别/朝向+动作/变化+运镜嵌在动作中+有台词时带语气）→ ⑥负面提示词（放最后，3.3标准模板）`；**站位/构图边界**：构图=画面布局归④设定-构图，站位=画面坐标归⑤镜头叙事（逐镜头写，词库03_场景描述·演员调度）
 
 > 11字段（一致性锚定/类型质感/人物设定/场景/景深对焦/摄影质感/表演幅度/背景动态/镜头空间/表演指令/负面词）降为**构建时内部思考清单**，不作为输出字段标签。详见制作流程第三节 3.2。
 
@@ -289,7 +289,7 @@ F4 输出 = 主题 + 导演阐述 + 完整提示词（代码块包裹）。多
 **剪辑节奏公式（>15秒必选）：** 呼吸式 / 心跳式 / 海浪式 / 子弹时间 / 脉冲式 / 静默锤击
 
 **详细方法论：**
-- 创意策略+6步总流程+路径分流+6层结构（主体/画面质感/色调光影/主体设定/镜头叙事/负面词，视觉基调前置，11字段降为内部思考清单）+标准负面词：`references/制作流程/分镜提示词制作流程.md`
+- 创意策略+6步总流程+路径分流+6层结构（主体/画面质感/色调光影/设定/镜头叙事/负面词，视觉基调前置，11字段降为内部思考清单）+标准负面词：`references/制作流程/分镜提示词制作流程.md`
 - 长视频策略+生产流水线（25格聚合矩阵+节奏曲线+景别曲线+P0/P1/P2优先级）：`references/制作流程/长视频分段制作流程.md`
 - 分镜板驱动（路径D格间关系三分类+三层动作分级）：`references/制作流程/图生视频与分镜板制作流程.md`
 - 剪辑节奏（六大节奏公式+AI素材专属5对策+9步工作流）：`references/制作流程/多镜头剪辑节奏流程.md`
@@ -407,7 +407,7 @@ F4 输出 = 主题 + 导演阐述 + 完整提示词（代码块包裹）。多
 
 > 详见 `references/制作流程/分镜提示词制作流程.md` 第三节：3.1 基础六要素（构建思考参考）+ 3.2 6层结构（输出格式，含11字段内部思考清单 3.2.1 + 6层式输出 3.2.2含类型适配表，负面词放最后）+ 3.3 标准负面词模板。
 
-6层结构按Step 1类型判定适配：①主体列表（置顶，按类别分行：人物/场景/道具，@图片引用优先）+ ②画面质感（视觉风格+摄影质感参数，视觉基调前置）+ ③色调光影（光源+主光方向+亮暗区+色调/色温，1句）+ ④主体设定（人物/场景/构图，每项1句，按类型取舍）+ ⑤镜头叙事（每镜头1段流畅描述，朝向必须写明，连续动作不拆，有台词时带语气）+ ⑥负面提示词（放最后，3.3标准模板）。构建时用11字段思考清单内部过目确保不遗漏（一致性锚定/类型质感/人物设定/场景/景深对焦/摄影质感/表演幅度/背景动态/镜头空间/表演指令/负面词），但最终输出不出现字段标签。
+6层结构按Step 1类型判定适配：①主体列表（置顶，按类别分行：人物/场景/道具，@图片引用优先）+ ②画面质感（视觉风格+摄影质感参数，视觉基调前置）+ ③色调光影（光源+主光方向+亮暗区+色调/色温，1句）+ ④设定（人物/场景/构图，每项1句，按类型取舍）+ ⑤镜头叙事（每镜头1段流畅描述，朝向必须写明，连续动作不拆，有台词时带语气）+ ⑥负面提示词（放最后，3.3标准模板）。构建时用11字段思考清单内部过目确保不遗漏（一致性锚定/类型质感/人物设定/场景/景深对焦/摄影质感/表演幅度/背景动态/镜头空间/表演指令/负面词），但最终输出不出现字段标签。
 
 ### 光影三层结构
 
@@ -480,7 +480,7 @@ F4 输出 = 主题 + 导演阐述 + 完整提示词（代码块包裹）。多
 - [ ] ⑤ 资产引用限制：图片≤9、视频≤3、音频≤3、混合≤12
 - [ ] ⑥ 冲突检测：运动冲突（快速+慢动作）、光学冲突（超广角+浅景深）、风格冲突（IMAX vs VHS 等）
 - [ ] ⑦ 裸英文运镜词检测：Dolly/Aerial/Crane/Pan/Arc/Dutch/Steadicam → 中文或完整短语
-- [ ] ⑧ 结构完整性：核心层（主体+负面词+镜头叙事）必须存在，②画面质感/③色调光影全类型必用，④主体设定按类型取舍（A/B全用/C人物可选/D/E人物省略，详见制作流程第三节 3.2.2 类型适配表）
+- [ ] ⑧ 结构完整性：核心层（主体+负面词+镜头叙事）必须存在，②画面质感/③色调光影全类型必用，④设定按类型取舍（A/B全用/C人物可选/D/E人物省略，详见制作流程第三节 3.2.2 类型适配表）
 
 **通用：**
 - [ ] 提示词有清晰主体

project/短视频脚本创作/V1.0/subskill/mcn-video-prompt/references/制作流程/分镜提示词制作流程.md

@@ -61,7 +61,7 @@
 > - 类型=D → 只做①，②-⑤跳过
 > - ①节奏=视觉流：产品亮相→质地特写→涂抹过程→效果呈现 / 线性 / 铺陈(亮相)→蓄力(特写)→爆发(涂抹)→余韵(效果) → **路径A + 单段8秒**
 > - 台词风格=N/A（无对白，可选旁白）
-> - 驱动6层格式：①主体=护肤品（列道具行） ④主体设定-人物省略 ⑤镜头=产品展示流程（非角色动作）
+> - 驱动6层格式：①主体=护肤品（列道具行） ④设定-人物省略 ⑤镜头=产品展示流程（非角色动作）
 
 ### Step 2 需求分析
 - 明确：时长、画幅（9:16 竖屏 / 16:9 横屏）、单镜头还是多镜头、有无参考素材
@@ -84,7 +84,7 @@
 
 ### Step 5 强制校验（8项）
 1. **字符数**：Python `len()` 实测，禁止估算；品质基准 ≤500 字符，硬性上限 ≤2000 字符（实测）
-2. **结构完整性**：输出必须包含核心层（①主体 + ⑥负面词 + ⑤镜头叙事），②画面质感/③色调光影全类型必用，④主体设定层按类型适配（A全用/B全用/C人物可选/D人物省略/E人物省略）；顺序固定主体→画面质感→色调光影→主体设定→镜头→负面词
+2. **结构完整性**：输出必须包含核心层（①主体 + ⑥负面词 + ⑤镜头叙事），②画面质感/③色调光影全类型必用，④设定层按类型适配（A全用/B全用/C人物可选/D人物省略/E人物省略）；顺序固定主体→画面质感→色调光影→设定→镜头→负面词
 3. **版权扫描**：品牌词/风格借喻/涉灰场景词/夜场BGM词 四类扫描（详见《图生视频与分镜板制作流程》版权审查）
 4. **导演去名化**：提示词中不得出现导演名/工作室名/IP名，只用参数化描述
 5. **动作物理合理性**：三层动作分级检查（大动作禁止）
@@ -129,7 +129,7 @@
 ### 3.2 输出格式（6层结构）
 
 > **实战验证**（2026-08-20）：编导手写提示词（~350字，叙事驱动）生成效果优于结构化11字段模板（~700字，技术参数驱动）。**模型吃故事，不吃参数表。**
-> **改造原则**：11字段降为构建时**内部思考清单**（确保不遗漏），最终输出只写**6层结构**——主体置顶按类别分行、画面质感与色调光影紧跟主体前置（全局视觉基调前置，模型对提示词开头权重最高）、主体设定按类型分项、镜头叙事流畅、负面词放最后。技术参数溶解进②画面质感/③色调光影/④主体设定各分项，表演靠动作暗示而非禁令。按Step 1类型判定结果选择6层的适用层。
+> **改造原则**：11字段降为构建时**内部思考清单**（确保不遗漏），最终输出只写**6层结构**——主体置顶按类别分行、画面质感与色调光影紧跟主体前置（全局视觉基调前置，模型对提示词开头权重最高）、设定按类型分项、镜头叙事流畅、负面词放最后。技术参数溶解进②画面质感/③色调光影/④设定各分项，表演靠动作暗示而非禁令。按Step 1类型判定结果选择6层的适用层。
 
 #### 3.2.1 构建思考清单（内部，不落盘）
 
@@ -137,11 +137,11 @@
 
 | 思考项 | 构建时想什么 | 输出时去哪 |
 |--------|-------------|-----------|
-| ①一致性锚定 | 角色服装/道具是否需文字锁定？ | ①主体列表@图片引用锁定；无图才在④主体设定-人物补1句 |
+| ①一致性锚定 | 角色服装/道具是否需文字锁定？ | ①主体列表@图片引用锁定；无图才在④设定-人物补1句 |
 | ②类型质感 | 画质/风格/光影基调？ | ②画面质感-视觉风格（1句） |
-| ③人物设定 | 逐角色外貌/着装/气质？ | ①主体列表@图片锁定；无图在④主体设定-人物补1句（**主体中每个人物必写，不可遗漏**） |
-| ④场景 | 空间布局/道具？ | ④主体设定-场景（1句空间描述） |
-| ⑤景深对焦 | 是否需非默认景深？ | **默认不写**；特写需浅景深时加进④主体设定-构图 |
+| ③人物设定 | 逐角色外貌/着装/气质？ | ①主体列表@图片锁定；无图在④设定-人物补1句（**主体中每个人物必写，不可遗漏**） |
+| ④场景 | 空间布局/道具？ | ④设定-场景（1句空间描述） |
+| ⑤景深对焦 | 是否需非默认景深？ | **默认不写**；特写需浅景深时加进④设定-构图 |
 | ⑥摄影质感 | 机型/镜头/光圈/快门/ISO/色彩/光影/质感/动态范围？ | 按维度自动生成英文摄影参数（从知识库/10_后期细节·摄影质感维度表取值，判断适用维度组合），排除画幅/帧率 |
 | ⑦表演幅度 | 需禁某种表演？ | **默认不写**；用动作暗示替代（"鬼鬼祟祟地说"比"禁夸张表情"有效） |
 | ⑧背景动态 | 需环境微动？ | **默认不写**；仅在画面可能静止时加进⑤镜头动作描述 |
@@ -171,13 +171,14 @@
 色调光影：[光源来源+主光方向+亮暗区+色调/色温1句]
 > 光影三层（光源层/光行为层/色调层）见知识库/07_光线时间
 
-④主体设定（分项，每项1句，按类型取舍）
+④设定（分项，每项1句，按类型取舍）
 人物：[角色]——[气质/状态1句]；[角色]——[气质/状态1句]
 > **主体中出现的每个人物，此处必须有对应设定，不可遗漏**——逐人写，用分号分隔
 > @图片已锁定的不重复写外貌，只补气质/状态；无图时按知识库/01_主体描述外貌原则写（宁少写不错写）；D/E类省略此行
 场景：[空间布局+前中后景层次1句]
 构图：[景别+前中后景层次+构图法则+视觉重心/留白1句]
 > 场景见知识库/03_场景描述（空间锚定三层）；构图见知识库/14_构图布局（五法则+构图几何+雷区规避）；朝向见知识库/06_焦距视角X轴
+> **站位/构图边界**：④设定=静态属性（人物是谁/场景框架/构图法则，整段框架级）；⑤镜头=动态调度（站位/朝向/动作，逐镜头变化）——**构图=画面布局归④设定-构图**（景别+前中后景层次+法则+视觉重心/留白），**站位=人物空间位置归⑤镜头叙事**（画面坐标，逐镜头写，见下）
 
 ⑤镜头（每镜头1段流畅叙事）
 镜头N：[机位/景别/朝向] + [动作/变化流程] + [运镜变化嵌在动作里] + [有台词时：（人物，语气）：内容]
@@ -206,7 +207,7 @@
 
 > **6层×5类型适配表（按Step 1类型判定结果选层）：**
 
-| 类型 | ①主体 | ②画面质感 | ③色调光影 | ④主体设定-人物 | ④主体设定-场景/构图 | ⑤镜头-台词 | ⑤镜头-动作 |
+| 类型 | ①主体 | ②画面质感 | ③色调光影 | ④设定-人物 | ④设定-场景/构图 | ⑤镜头-台词 | ⑤镜头-动作 |
 |------|-------|-----------|-----------|----------------|--------------------|-----------|-----------|
 | A 叙事剧情 | 人物 | 全用 | 全用 | 全用 | 全用 | 对白格式 | 角色动作 |
 | B 单人Vlog | 人物 | 全用 | 全用 | 全用 | 全用 | 口播（非对白） | 人物动作 |
@@ -214,12 +215,14 @@
 | D 产品展示 | 产品 | 全用 | 全用 | 省略 | 全用 | 无（可选旁白） | 产品展示流程 |
 | E 纯氛围 | 场景 | 全用 | 全用 | 省略 | 全用 | 无 | 氛围流变 |
 
+> **站位/构图边界（写入位置）**：④设定-构图=画面布局框架（景别+前中后景层次+构图法则+视觉重心/留白，词库14_构图布局）；人物站位/调度=⑤镜头叙事（画面坐标如"男主位于画面右侧、四分之三侧朝镜头"，**逐镜头变化随镜头写**，词库03_场景描述·演员调度三要素）。构图整段一条管全段，站位每镜头精确。
+
 > **编导式 vs 旧11字段版对比：**
 >
 > | 对比项 | 编导式（新） | 11字段版（旧） |
 > |--------|-------------|---------------|
 > | 字段标签 | 无，信息溶解进叙事 | 【一致性锚定】【景深对焦】等11个标签 |
-> | 技术参数 | 溶进②画面质感/③色调光影/④主体设定各分项 | 独立字段罗列（机型/f值/快门等） |
+> | 技术参数 | 溶进②画面质感/③色调光影/④设定各分项 | 独立字段罗列（机型/f值/快门等） |
 > | 表演控制 | 动作暗示（"鬼鬼祟祟地说"） | 禁令约束（"禁夸张喜剧化表情"） |
 > | 镜头组织 | 每镜头1段流畅叙事 | 时间戳逐beat分段罗列 |
 > | 字符量 | ~350字 | ~700字 |

project/短视频脚本创作/V1.0/subskill/mcn-video-prompt/references/制作流程/长视频分段制作流程.md

@@ -56,13 +56,13 @@ Z8→Z5→Z5↔Z4→Z4→Z3→Z2→Z1→Z3→Z7→Z8→Z9（远景开场→中
 
 ## 四、一致性锁定（每段必须执行）
 
-> 6层结构中，一致性靠@图片引用+②画面质感/③色调光影/④主体设定统一实现，不需要额外写锁定语句。
+> 6层结构中，一致性靠@图片引用+②画面质感/③色调光影/④设定统一实现，不需要额外写锁定语句。
 
 | 类型 | 执行方式 | 在6层结构中去哪 |
 |------|---------|----------------|
 | 风格锁定 | 视觉风格跨段统一（首段定调后续段重复或引用） | ②画面质感-视觉风格 |
 | 角色锁定 | @图片引用在每段①主体列表重复出现 | ①主体列表 |
-| 场景锁定 | 场景延续时④主体设定-场景写"延续上一段场景"，新场景写新描述 | ④主体设定-场景 |
+| 场景锁定 | 场景延续时④设定-场景写"延续上一段场景"，新场景写新描述 | ④设定-场景 |
 
 ## 五、分段规则
 
@@ -109,7 +109,7 @@ Z8→Z5→Z5↔Z4→Z4→Z3→Z2→Z1→Z3→Z7→Z8→Z9（远景开场→中
 ①主体列表（置顶，按类别分行：人物/场景/道具，@图片引用优先；D类主体=产品，E类主体=场景）
 ②画面质感（视觉风格1句+摄影质感默认生成参考值·[]框起）
 ③色调光影（光源+主光方向+亮暗区+色调/色温，1句）
-④主体设定（人物逐人必写不可遗漏/场景/构图，每项1句，按类型取舍：D/E类省略人物）
+④设定（人物逐人必写不可遗漏/场景/构图，每项1句，按类型取舍：D/E类省略人物）
 ⑤镜头叙事（1段流畅描述：机位/景别/朝向+动作/变化+运镜+有台词时带语气）
 ⑥负面提示词（放最后，3.3标准模板）
 ```
@@ -120,7 +120,7 @@ Z8→Z5→Z5↔Z4→Z4→Z3→Z2→Z1→Z3→Z7→Z8→Z9（远景开场→中
 ①主体列表（置顶，按类别分行：人物/场景/道具，@图片引用优先，跨段每段重复出现）
 ②画面质感（视觉风格1句+摄影质感默认生成参考值·[]框起；跨段统一项不重复）
 ③色调光影（光源+主光方向+亮暗区+色调/色温，1句；跨段统一项不重复）
-④主体设定（人物逐人必写不可遗漏/场景/构图，每项1句；场景变化时写新场景，跨段统一项不重复）
+④设定（人物逐人必写不可遗漏/场景/构图，每项1句；场景变化时写新场景，跨段统一项不重复）
 ⑤镜头叙事（每镜头1段，多角色互动按动作流叙述，运镜嵌在动作中，朝向必须写明，连续动作不拆，有台词时带语气）
 ⑥负面提示词（放最后，3.3标准模板）
 ```

project/短视频脚本创作/V1.0/帮助文档.md

@@ -76,6 +76,8 @@
 | "解析这个本地视频文件 C:/Videos/demo.mp4" | 通过MCP上传本地文件→AI解析→获取拆解与脚本 |
 | "查一下「XX账号」的设定和代表作" | 通过MCP拉取账号设定+代表作拆解+互动数据 |
 
+> **MCP 服务说明**：上表中「通过MCP…」的功能依赖 MCN MCP 服务（`myai-mcp-production`）。**首次使用本技能（问功能/发起任务）时会自动检测并提示安装**（可跳过，不影响核心创作流程），同意后自动配置，按下方步骤 Trust 启用即可。
+>
 > **MCP 安装后授权步骤**：
 > 1. 点击左上导航栏：**专家 → 技能 → 连接器**
 > 2. 在新窗口左上方点击 **连接器**，在右边点击 **自定义连接器**