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

2026-08-31 16:30:51 +08:00
1 parent 268ce29aae
commit 9b878eccc3
@@ -335,3 +335,72 @@
  - `subskill/mcn-video-prompt/references/制作流程/长视频分段制作流程.md`（4 处）：一致性锁定表（②设定-视觉风格→②画面质感等）、简单段/复杂段输出模板重排为 6 层
 - 验证：全局 grep 旧层号零残留（"4层"仅剩 last_change 变更描述+L189 F2"4层退化策略"无关概念）；6层落位 SKILL.md×8/分镜提示词制作流程×7/长视频分段×3
 - 注：dsh 副本（storyboard-prompt）未同步，按 .dsh 单向只读约定待用户授权
+
+## 关闭工作台服务 + 项目同步仓库（15:01-15:05）
+- 用户需求：「关闭工作台服务，项目同步到仓库 已本地文件为准」（中断后重发「同步项目到 仓库」）
+- **关停服务**：8899 工作台 node 服务双 PID（20604/29924）用 PowerShell `Stop-Process -Id -Force` 终止（Git Bash `taskkill //PID` 参数转义报错不可用）；残留 LISTENING PID 33216 查证为系统无关进程 MiPCAudio.exe，保留不动
+- **.gitignore 追加**：`**/mcn-work-shop/server.log`、`**/mcn-work-shop/shot-*.png`、`tmp/`、`.workbuddy/tmp/`、`generated-images/`（运行日志/自检截图/临时目录不入库；cdp-*.mjs 验证脚本保留入库）
+- **git 同步**：`git fetch` 无分叉（HEAD=origin/main=ab97842）→ `git add -A`（35 项）→ commit 268ce29 → `git push origin main` 成功（ab97842..268ce29），推送后工作区干净
+- 经验固化：Windows 下关停后台 node 服务用 PowerShell Stop-Process；推送前先 fetch 确认无分叉，避免非 fast-forward
+
+## mcn-video-prompt「④主体设定」→「④设定」改名（15:35）
+- 用户指令：「把主体设定 改为设定」——6 层结构第④层去「主体」前缀（6 层现为：①主体列表→②画面质感→③色调光影→④设定→⑤镜头叙事→⑥负面提示词）
+- **20 处全量替换**（replace_all 精确串「主体设定」→「设定」，不触碰「主体」「人物设定」等词）：
+  - `SKILL.md` 6 处（F4 L275/模板节 L410/自检⑧ L483/F2·F4 方法论引用 L205/L292 + frontmatter last_change 重写）
+  - `分镜提示词制作流程.md` 10 处（3.2 改造原则/3.2.1 思考清单 4 行/3.2.2 输出格式块/6层×5类型适配表表头/Step5 校验/示例D/对比表）
+  - `长视频分段制作流程.md` 4 处（一致性锁定表/简单段·复杂段模板）
+- frontmatter last_change 更新：「④主体设定→④设定 改名（20处全量替换）…站位归⑤镜头叙事（画面坐标）、构图归④设定-构图（08-31 边界确认）」
+- 验证：grep「主体设定」全目录仅剩 last_change 历史描述 1 处（有意保留）；「④设定」落位 18 处（SKILL.md 4 行+制作流程 10+长视频 4）；L142「③人物设定」为思考清单字段名正确保留；L205/L292 无④前缀引用同步为「设定」
+- 待办：dsh 副本（storyboard-prompt）未同步，按 .dsh 单向只读约定待用户授权；站位/构图边界固化到文档未做（用户仅确认改名，固化待确认）
+
+## mcn-video-prompt 6层+改名 同步到 dsh 副本（15:37）
+- 用户授权：「同步到 dsh 对应技能」→ 同步 `C:\Users\maidou\.dsh\skills\storyboard-prompt\`
+- **同步前确认**：dsh 副本停在 **4层结构旧版**（L42/L87/L129/L165 等 4层+②设定），需连同 14:29 的 4→6 层重排一起同步；三个文件差异全部为 4→6 层+改名，无独有内容需保护
+- **同步方式**：cp 源 3 文件覆盖副本（SKILL.md/分镜提示词制作流程.md/长视频分段制作流程.md）→ 恢复 dsh SKILL.md frontmatter 专有字段（name: storyboard-prompt / deployment: dsh / deployed_at: "2026-08-31"；updated_at/last_change 采用源最新值）
+- **验证**：制作流程 2 文件 diff=0；SKILL.md 仅剩 frontmatter 4 对预期环境差异；副本「主体设定/4层结构」零残留（仅 last_change 历史描述）；6层落位 SKILL.md×8/制作流程×7/长视频×3、④设定落位 4/10/4 与源完全一致 ✓
+- 经验固化：diff 全文件不匹配（1,414c1,408）时先查换行符（本次均 LF，系普通 diff 对整体替换块的误读），用 `diff --strip-trailing-cr` 得到真实差异量；dsh 副本因停在旧结构版本，同步=cp 覆盖+恢复 dsh frontmatter，比逐行改更可靠
+
+## mcn-video-prompt 站位/构图边界固化（15:40）
+- 用户确认「需要」→ 把站位/构图边界（前序已确认）固化进技能文档，源+dsh 同步
+- **固化内容**：构图=画面布局归**④设定-构图**（景别+前中后景层次+构图法则+视觉重心/留白，词库14_构图布局）；站位=画面坐标归**⑤镜头叙事**（如"男主位于画面右侧、四分之三侧朝镜头"，逐镜头变化随镜头写，词库03_场景描述·演员调度三要素）；一句话=「④设定写静态属性（整段框架级），⑤镜头写动态调度（逐镜头）」
+- **固化 3 处**（源+dsh 各 3 处）：
+  - 分镜提示词制作流程.md 3.2.2 输出格式块（④设定与⑤镜头之间加边界注释行 L181）
+  - 分镜提示词制作流程.md 6层×5类型适配表后（L218 边界写入位置注记）
+  - SKILL.md F4 提示词内部结构（L275 6层定义末尾补「站位/构图边界」句）
+- frontmatter last_change 两边同步更新（补「站位/构图边界固化（08-31）…注记入 3.2.2 输出格式块+适配表+SKILL.md F4 结构定义」）
+- **验证**：制作流程 diff=0；SKILL.md 仅剩 frontmatter 4 对预期环境差异；边界落位源+dsh 各 3 处一致 ✓
+
+## 内容基因·TOPn 动态规则 + 王微斯修正 TOP6→TOP4（16:05-16:12）
+- 用户规则：「内容基因·TOPn 的 n = **实际解析视频数**（几个视频就是 TOP 几），不是固定 6；看设定中内容基因有几个板块即可判定」（王微斯设定「四个内容基因标记」→ 4 条 → TOP4，此前误写 TOP6）
+- **王微斯产出修正 3 文件**：`王微斯账号设定卡.svg` 3 处（desc/模块标题/底部版权 TOP6→TOP4）；`王微斯账号设定.md` 与 `_参考.md` 各 5 处（头部「解析视频：最近三个月TOP6」→TOP4、人设底线「基于6条视频…已通过6条视频验证…基于6条视频的归纳」→4条、梗元素「当前6条视频」→4条）；备份 `_浅粉紫底.bak.svg` 与 `账号数据分析.md`（排名描述 TOP1/2 等）不在本次范围不动
+- **技能固化（源+dsh diff 一致）**：SKILL.md 视频筛选标准行补「实际满足条件视频不足 6 条时按实际条数取（TOPn 的 n=实际解析条数），产出文件 TOPn 按实际条数写」；06 文档 5 处 TOP6→TOPn（双向联动历史案例/一致性校验/模块映射表/注/裁剪适配表）；03 文档 grep 校验 TOP6→TOPn
+- **验证**：源=dsh 三文件 diff 全空；王微斯产出零「TOP6/6条视频」残留（排除 bak/数据分析排名描述）；技能文件零「内容基因·TOP6」残留；卡片 TOP4 3 处 ✓
+- 经验固化：TOPn 是**动态值非固定 6**——筛选上限 6 与产出显示值（实际解析条数）分离；判定口径=设定 md「内容基因」板块数（与视频解析条数一致）
+
+## MCP 检测触发时机补「首次提问/功能介绍」（16:14-16:20）
+- 用户反馈：**安装到用户环境时，询问技能有什么功能、生成相关内容后，没有检查用户是否安装 MCP 服务，也没有提示需要安装**
+- **根因**：mcn-dou-analysis 的 MCP 检测触发时机只有「执行工作流前（视频解析前）」（MCP_工具调用规范.md 3 节），首次提问/功能介绍场景不触发；创作技能 V1.0 源+dsh 已有「用户首次提问（无论问什么）即检测」无此缺口
+- **修复（源+dsh diff 一致）**：MCP_工具调用规范.md 3 节触发时机扩为「① 首次提问/功能介绍时 + ② 执行工作流前」，新增触发点行=回答功能介绍后检测 `myai-mcp-production` 可用性 → 未安装主动提示「功能五（视频解析）依赖 MCN MCP 服务，当前未安装」+ 询问是否自动配置；SKILL.md MCP 章节安装引导行同步补「首次提问/功能介绍时 + 执行工作流前」
+- **验证**：源=dsh 两文件 diff 全空；创作技能 short-video-script 副本 L63/L29/L33 与源一致（已有首次提问检测）✓
+- 经验固化：部署类技能（含 MCP 依赖）的检测触发时机要覆盖**首次接触场景**（问功能/初次使用），不能只挂在执行工作流前；用户环境部署后用户第一件事就是问功能，此时不提醒 → 后续用到才发现没装 MCP
+
+## 方向修正：MCP 首次检测只改创作技能，账号分析回滚（16:20-16:28）
+- 用户纠正：**问题在脚本创作**——规则写了「首次提问自动检测」但用户环境实测没提醒；**账号分析应保持之前状态**（加到那里没用）
+- **账号分析回滚**（源+dsh，SKILL.md 安装引导行 + MCP 规范 3 节触发时机恢复原文本「执行工作流前（视频解析前）检测」）→ diff 验证源=dsh 一致 ✓
+- **创作技能根因**：SKILL.md「MCP 依赖（摘要）·安装引导」只有**描述性声明**（「用户首次提问时自动检测」），不是强制开场动作——模型触发技能读 SKILL.md 时只当背景信息，不会主动执行检测；且「检测」具体方法未明确
+- **创作技能修复（源+dsh=short-video-script，内容 diff 一致；SKILL.md 差异仅 frontmatter 环境标签/工作台章节/dsh 独有 script-review 行等预期项）**：
+  - SKILL.md 安装引导行升级为**必做动作**：「首次触发检查」——会话首次交互（问功能/功能介绍/发起任何任务，无论问什么）先检查 `myai-mcp-production` 可用性（查当前会话可用工具列表含 auth_status/upload_douyin_video 等，或读 `~/.workbuddy/mcp.json` 含该服务配置，任一即可）→ 未安装 → 按 MCP 规范 3 节首次提问轻量提醒（可跳过不打断创作）
+  - MCP_工具调用规范.md 3 节：触发时机补「首次提问」定义（=本技能会话首次交互，由 SKILL.md 安装引导作为必做动作驱动）+ 检测方法明确化（①②任一判定）
+  - 帮助文档.md：MCP 授权步骤前补「MCP 服务说明」——首次使用会检测并提示安装（可跳过）
+- **经验固化（重要）**：技能规则「写了」≠「会执行」——**描述性声明必须升级为动作指令**（明确"你（模型）现在就要做、怎么做、什么时机做"）才可执行；SKILL.md 是每次触发必读，references 是按需读，**强制动作要挂 SKILL.md 主路径**，references 只放细节
+
+## browser-harness 环境检查与安装 + 系统分流（16:30-16:50）
+- 用户要求：**browser harness 的环境检查和安装也应该一并处理**；随后补充：**检查环境和安装依赖要区分 Windows 和 Mac 系统**
+- **browser-harness 检测（mcn-dou-analysis，源+dsh diff 一致）**：
+  - SKILL.md 关键规则表新增「browser-harness 依赖（红线）」行：功能一/二（浏览器抓取）执行前必检——检测方法（任一即可）① 可执行文件存在性（Win `~/.local/bin/browser-harness.exe` / macOS `~/.local/bin/browser-harness`）② 命令探测（Win `where` / macOS `command -v`）→ 未装提醒（可跳过，换三方API/MCP兜底，但浏览器抓取无法执行）→ 同意则 `uv tool install --python 3.12 --upgrade --force browser-harness` → `browser-harness doctor` 验三要素（工具/daemon/Chrome）
+  - 浏览器搜索抖音账号操作规范.md 第五节新增 5.0「环境检查与安装（每次浏览器任务前必做）」：检测方法表 + 安装引导 + 安装后验证；技能体 `~/.dsh/skills/browser-harness/` 随 dsh_MCNProject 分发（换机器自带）
+- **系统分流（Windows/macOS）落点（源+dsh 全部同步）**：
+  - 浏览器规范：环境说明（可执行文件路径分系统）、5.0 命令探测补 `where`、5.1 代理清理分（Win PowerShell Remove-Item / mac bash unset）、连接方式 B 定向分（$env:BU_CDP_URL / export）、方式 C Chrome 启动分（chrome.exe / /Applications/Google Chrome.app/Contents/MacOS/Google Chrome）、5.2 端口探测分（Invoke-WebRequest / curl）
+  - MCP 检测（创作技能 V1.0 + short-video-script 副本）：SKILL.md 安装引导行 + MCP 规范 3 节步骤1 的 mcp.json 路径分系统（Win `%USERPROFILE%\.workbuddy\mcp.json` / mac `~/.workbuddy/mcp.json`）；部署预检 npm 缓存权限检查标注「macOS 高发坑，Windows 跳过」（find -user root 仅 mac/Linux）
+- **验证**：mcn-dou-analysis SKILL.md/浏览器规范 源=dsh 一致；short-video-script MCP 规范 源=dsh diff 全空；SKILL.md 差异仅预期环境差异（源独有工作台/外部技能依赖章节 + frontmatter deployment 标签 + dsh 独有 script-review 行），安装引导行源 L83=dsh L63 完全一致
+- 经验固化：环境检查/安装依赖类命令必须**按系统给双命令**（Win PowerShell / mac bash），路径用 `~`（mac）/ `%USERPROFILE%`（Win）双写法；macOS 高发坑（npm root 缓存、代理劫持 CDP）与 Windows 差异（无 root 文件问题、where 代替 command -v）要显式标注
@@ -11,7 +11,7 @@
 ## 核心技能
 - **短视频脚本创作** `project/短视频脚本创作/{V1.0,Lite1.0}/`：11步流程+知识库12分类（66文件）；V1.0 含 MCP/Dify 接口，Lite1.0 去全部接口、模型自带 WebSearch。**同步策略（08-26 用户定）**：只改 V1.0 源技能+dsh 副本两处；Lite1.0 默认不动
 - **MCN工作台（08-27，仅 V1.0）** `project/短视频脚本创作/V1.0/mcn-work-shop/`（server.js+public/，零依赖 Node，端口8899自动避让）；触发「打开工作台」→ 启动服务+内置浏览器打开。hash 路由：首页+📈账号周榜/👥热门账号/账号详情/视频详情/AI写脚本/AI写作复盘（读自有 mcn-plugin.db 副本+dshworkspace 榜单 JSON）+📁产出浏览（桌面 MCNSkill项目/ 账号层直挂）+❓帮助页。**首页顶部数据预览条（08-31，参考 dsh-plugin-mcn 首页 stats 移植）**：`/api/dsh/stats` 5 项=热门账号(accounts)/视频解析(analyses)/AI写脚本(rewrites)/AI写作复盘(reviews type='ai')/AI写作评分(writingScore=最新20条AI复盘平均分)，条带=7%品牌蓝底+数值26px粗体+右分隔线（样式在 style.css .home-stats）；**AI 任务触发（08-27 定版；归 mcn-workshop 空间）**：数据页按钮→`confirmRun()` 确认弹窗→`executeTask()` `POST /api/run` 写 `~/.workbuddy/workbuddy.db` automations（once+now，cwds=`D:\AgentSkill\mcn-workshop`）→WorkBuddy 自动执行创建会话→左侧会话栏 mcn-workshop 空间可见；轮询 `GET /api/run/status?id=`（读 automations/automation_runs/automation_runtime_state：running=IN_PROGRESS/running、done=DONE/COMPLETED/SUCCESS、error=ERROR/CANCELLED；5s 间隔 30min 上限）→done/error 恢复按钮（.btn-busy「执行中…」）；**用户明确不同步 dsh/Lite**（刻意 divergence）；AI脚本选题（08-28）：关注账号「创作」→「AI脚本」`confirmAiScript` 选题 textarea→`POST /api/ai/topics`（查库带账号摘要→S5 方法论 prompt→Dify chat-messages recall 即时返回约50s）；Dify key 内置 `scripts/MCN_CYLG_API.py` 的 `DEFAULT_CYLG_KEY`（env `DIFY_MCN_CYLG_KEY` 优先；key=app-0vRaxPhvVOqzFQIa5eFzFdjD），`DIFY_URL` 默认 mydify.youmanvideo.com/v1、model 默认 gemini、curl 中文被 CDN 拦推荐 Python、search 易超时用 recall
- **抖音账号分析 mcn-dou-analysis（主版本 08-27）**：源=`project/短视频脚本创作/V1.0/subskill/mcn-dou-analysis/`；dsh 副本=`C:\Users\maidou\.dsh\skills\mcn-dou-analysis\`；旧路径 `project/短视频账号分析/case_1/` 已废弃。**六大功能（08-31 加 F6）**：F1账号信息/F2视频列表(13列Excel)/F3提炼账号设定(人设卡12段)/F4分析视频数据(逐条→汇总两段式)/F5解析视频(单视频MCP)/**F6生成账号设定卡片**（SVG 长图 680×~1716，模板=旧梦留声机样例）。红线：达人账号表15列(仅用户要求增改)、TOP6筛选(点赞+分享降序，权威参数在SKILL.md)、≥60条停止滚动、29赛道枚举、源技能只读单向同步、技能边界(脚本必须切脚本创作技能)、浏览器9223调试实例+标签页复用。**F6 卡片配色分两系（08-31 定型）**：**深色系（深色长图风，深沉/浓郁调性，如旧梦留声机）**=深棕红渐变底 #2B0F0A→#1A0805 + 浅米卡 #FAEEDA + 深色字 + 珊瑚红强调；**浅色系（浅色甜宠风，明快/甜美/治愈调性，如王微斯·定稿玫瑰金）**=玫瑰金渐变底 #D6A3A9→#9A5563 + 白卡 #FFFFFF + 粉边 #E8C9DC + 深粉字 #7B2D5E + 粉强调 #C0457F→#E876A9；背景上直接书写的文字随背景深浅提亮（玫瑰金底：模块标题 #FDE8EC/注释 #EAC6CE/版权 #DDBCC4）；更浅可回退浅粉紫 #F8EDF6→#F1E0EE；底色决定色系，**同一账号必须固定色系**，跨账号可不同；禁跨系混用。模块名统一为「叙事结构」「内容标签」「**内容基因·TOP6**」。F6 触发场景处理（07情况表+三问判定链）在 06 文档。**功能三→功能六自动联动（08-31 固化）**：功能三产出 `{账号名}账号设定.md` 后**自动生成设定卡**（无需用户开口，删除 06 文件即禁用自动）；**设定 md ↔ 卡片 SVG 双向联动维护**——改设定→卡片同步（内容级重生成/单点改 SVG）、改卡片→设定同步、术语改名→两边一起改（历史案例：内容路线→叙事结构、核心气质→内容标签），交付前 grep 校验关键术语两文件一致；规则固化于 SKILL.md（功能三 Step7/功能六自动触发）+ 03 文档 Step7 + 06 文档触发场景/双向联动维护
+- **抖音账号分析 mcn-dou-analysis（主版本 08-27）**：源=`project/短视频脚本创作/V1.0/subskill/mcn-dou-analysis/`；dsh 副本=`C:\Users\maidou\.dsh\skills\mcn-dou-analysis\`；旧路径 `project/短视频账号分析/case_1/` 已废弃。**六大功能（08-31 加 F6）**：F1账号信息/F2视频列表(13列Excel)/F3提炼账号设定(人设卡12段)/F4分析视频数据(逐条→汇总两段式)/F5解析视频(单视频MCP)/**F6生成账号设定卡片**（SVG 长图 680×~1716，模板=旧梦留声机样例）。红线：达人账号表15列(仅用户要求增改)、TOP6筛选(点赞+分享降序，权威参数在SKILL.md)、≥60条停止滚动、29赛道枚举、源技能只读单向同步、技能边界(脚本必须切脚本创作技能)、浏览器9223调试实例+标签页复用。**F6 卡片配色分两系（08-31 定型）**：**深色系（深色长图风，深沉/浓郁调性，如旧梦留声机）**=深棕红渐变底 #2B0F0A→#1A0805 + 浅米卡 #FAEEDA + 深色字 + 珊瑚红强调；**浅色系（浅色甜宠风，明快/甜美/治愈调性，如王微斯·定稿玫瑰金）**=玫瑰金渐变底 #D6A3A9→#9A5563 + 白卡 #FFFFFF + 粉边 #E8C9DC + 深粉字 #7B2D5E + 粉强调 #C0457F→#E876A9；背景上直接书写的文字随背景深浅提亮（玫瑰金底：模块标题 #FDE8EC/注释 #EAC6CE/版权 #DDBCC4）；更浅可回退浅粉紫 #F8EDF6→#F1E0EE；底色决定色系，**同一账号必须固定色系**，跨账号可不同；禁跨系混用。模块名统一为「叙事结构」「内容标签」「**内容基因·TOPn（n=实际解析条数，几个视频就是TOP几，如王微斯4条→TOP4；不足6条按实际条数，非固定6）**」。**F6 触发场景处理（07情况表+三问判定链）在 06 文档。**MCP 安装检测触发时机（08-31 定稿）：**账号分析保持「执行工作流前（视频解析前）检测」原状**（不随创作技能扩）；**创作技能 V1.0 = 首次触发必做动作**——会话首次交互（问功能/发起任务无论问什么）先检查 `myai-mcp-production` 可用性（查可用工具列表或读 `~/.workbuddy/mcp.json`），未安装轻量提醒（可跳过不打断创作）；规则落点=SKILL.md MCP 依赖章节安装引导行 + MCP 规范 3 节触发时机/检测方法 + 帮助文档 MCP 服务说明。**browser-harness 依赖检测（08-31 加）**：功能一/二（浏览器抓取）执行前必检——检测可执行文件（Windows `~/.local/bin/browser-harness.exe` / macOS/Linux `~/.local/bin/browser-harness`）或命令探测（Windows `where` / macOS `command -v`）→ 未装提醒（可跳过，换三方API/MCP兜底）→ 同意则 `uv tool install --python 3.12 --upgrade --force browser-harness` → `browser-harness doctor` 验三要素（工具/daemon/Chrome）；技能体 `~/.dsh/skills/browser-harness/` 随 dsh_MCNProject 分发。规则落点=SKILL.md 红线行「browser-harness 依赖」+ 浏览器规范 5.0（检测/安装）。**环境检查系统分流（08-31 用户要求）**：browser-harness 代理清理（Win PowerShell Remove-Item / mac unset）、Chrome 启动（Win `chrome.exe` / mac `/Applications/Google Chrome.app/...`）、端口探测（Win Invoke-WebRequest / mac curl）、MCP mcp.json 路径（Win `%USERPROFILE%\.workbuddy\mcp.json` / mac `~/.workbuddy/mcp.json`）、npm 缓存权限检查仅 macOS 高发（Windows 跳过）。**功能三→功能六自动联动（08-31 固化）**：功能三产出 `{账号名}账号设定.md` 后**自动生成设定卡**（无需用户开口，删除 06 文件即禁用自动）；**设定 md ↔ 卡片 SVG 双向联动维护**——改设定→卡片同步（内容级重生成/单点改 SVG）、改卡片→设定同步、术语改名→两边一起改（历史案例：内容路线→叙事结构、核心气质→内容标签），交付前 grep 校验关键术语两文件一致；规则固化于 SKILL.md（功能三 Step7/功能六自动触发）+ 03 文档 Step7 + 06 文档触发场景/双向联动维护
 - **短视频分镜脚本** `project/短视频提示词生成/`（08-27 去 V1.0 层）：4功能 F1反推图片/F2反推视频/F3生成图片/F4生成分镜；三层引用架构 参考skills→references/→references-add/（运行时优先；开发机不启用 references-add/，dsh/用户环境启用）；知识库15维度（01-12用户+13音效+14构图+15风格）；F4输出=主题+导演阐述+代码块（>5s时间戳分段/≤5s单段）；提示词模板类型分档（A剧情/B单人Vlog/C旁白知识/D产品展示/E纯氛围）+4层×5类型适配表；公式只留时间预算表等内部环节，提示词正文只写时长结论；seedance25 时间测算体系（语速6公式+动作14+运镜7+帧级换算+超调6级）；dsh 副本无独有内容需回流（唯一独有项 `name: storyboard-prompt` 环境保留）

 ## 创作技能关键规则（权威源：SKILL.md 关键规则 + references/创作流程规范.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 功能

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

@@ -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 类型适配表）

 **通用：**
 - [ ] 提示词有清晰主体
@@ -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字 |
@@ -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标准模板）
 ```
@@ -76,6 +76,8 @@
 | "解析这个本地视频文件 C:/Videos/demo.mp4" | 通过MCP上传本地文件→AI解析→获取拆解与脚本 |
 | "查一下「XX账号」的设定和代表作" | 通过MCP拉取账号设定+代表作拆解+互动数据 |

+> **MCP 服务说明**：上表中「通过MCP…」的功能依赖 MCN MCP 服务（`myai-mcp-production`）。**首次使用本技能（问功能/发起任务）时会自动检测并提示安装**（可跳过，不影响核心创作流程），同意后自动配置，按下方步骤 Trust 启用即可。
+>
 > **MCP 安装后授权步骤**：
 > 1. 点击左上导航栏：**专家 → 技能 → 连接器**
 > 2. 在新窗口左上方点击 **连接器**，在右边点击 **自定义连接器**