mcn-short-video/project/短视频脚本创作/V1.0/subskills/mcn-video-prompt/references-add/路径配置.md

路径配置（运行时优先）

本文件是产出路径的唯一权威配置，运行时优先于 SKILL.md「文件目录结构 - 过程产物目录」中的默认声明。 只要本文件存在（含默认配置），AI 执行分镜创作前必须先读本文件；如有「用户自定义路径」记录，一律以用户指定为准。

一、默认路径（用户未自定义时生效）

先判定运行环境（两步：第一步查本机 D:\AgentSkill 是否存在——无 = 用户环境；有 → 第二步看技能自身路径），再按运行系统解析桌面路径：

判定步骤	条件	环境	默认产出根目录
第一步	本机无 D:\AgentSkill（源技能仓库目录，只存在于开发机）	③ 用户环境（技能无论装在哪、什么路径）	用户桌面 MCNSkill项目/（账号层直挂：{账号名}/提示词{编号}/，与脚本创作「脚本{编号}」同构）
第二步	本机有 D:\AgentSkill，且技能路径在 D:\AgentSkill\ 下	① 开发机（源技能）	用户桌面 MCNSkill项目/（账号层直挂：{账号名}/提示词{编号}/，与脚本创作「脚本{编号}」同构）
第二步	本机有 D:\AgentSkill，且技能路径含 .dsh（如 C:\Users\{用户名}\.dsh\skills\storyboard-prompt）	② dsh 部署环境	优先 D:\dshworkspace\创作任务\（主工作区「创作任务」目录）；主工作区不存在时用用户桌面 DSHSkill项目/

桌面路径按运行系统自动解析：

系统	桌面路径
Windows	C:\Users\{用户名}\Desktop\
macOS	~/Desktop/（即 /Users/{用户名}/Desktop/）

AI 执行规则：

1. 先按两步判定运行环境——第一步查本机 D:\AgentSkill 是否存在（无 = ③用户环境，技能无论装在哪、什么路径）；有 → 第二步看技能自身路径（在 D:\AgentSkill\ 下 = ①开发机；含 .dsh = ②dsh 环境）。再按上表确定产出根目录（dsh 环境 → 优先操作 D:\dshworkspace\创作任务\，主工作区 D:\dshworkspace 存在即用（「创作任务」子目录不存在则创建）；主工作区不存在时用桌面 DSHSkill项目/；开发机/用户环境 → 桌面 MCNSkill项目/，账号层直挂（{账号名}/提示词{编号}/，与脚本创作同构））
2. 再判断当前运行系统（Windows / macOS），拼接桌面路径
3. 目录不存在则自动创建
4. 产出结构：{产出根目录}/{账号名}/提示词{编号}/…（内部文件结构不变，仅根目录可变）
5. 账号名判定：取当前创作所属账号——从上游脚本创作上下文（人设卡片/账号名）继承；独立使用且上下文无账号信息时，询问用户确认账号名后再建目录
6. 提示词编号判定：默认从上游脚本编号继承（脚本01 → 提示词01，一一对应）；独立使用（无上游脚本）时，按账号目录下已有「提示词{编号}」最大值递增

产出结构示例（6步流程产物）：

D:\dshworkspace\创作任务\              ← dsh 环境优先根目录（主工作区「创作任务」，与脚本创作同根；无主工作区时兜底桌面 DSHSkill项目/）
└── {账号名}/                            ← 对应账号（从上游脚本创作上下文继承，与脚本创作同口径）
    └── 提示词{编号}/                    ← 与「脚本{编号}」平级（编号默认继承上游脚本编号；开发机/用户环境为 桌面 MCNSkill项目/{账号名}/提示词{编号}/，账号层直挂）
        ├── 00_剧本分析.md      ← Step 1 剧本分析（5维度）
        ├── 01_需求分析与路径.md ← Step 2-3
        ├── 02_段1提示词.md      ← Step 4（多段时 02/03/04… 递增）
        ├── …
        └── 分镜提示词_终版.md   ← 最终交付物（命名可带模板版本，如 _11字段版）

二、用户自定义路径（最高优先级）

如果用户明确要求修改产出位置，一律以用户指定为准，不要沿用默认桌面路径，也不要自作主张改回桌面。

出现自定义需求时，在此追加记录（保留用户原话，便于追溯）：

> 用户指定：{用户原话}
> 解析后路径：{绝对路径}
> 记录时间：{日期}

记录后，AI 每次执行分镜创作都以「解析后路径」为产出根目录；用户再次修改时直接更新本记录即可（旧记录保留，标注新记录生效）。

三、解析规则（优先级从高到低）

1. 本文件「用户自定义路径」记录 → 用自定义路径（最新一条生效）
2. 本文件默认路径 → 先按两步判定运行环境（第一步查本机 D:\AgentSkill 是否存在：无 = ③用户环境；有 → 第二步看技能路径：在 D:\AgentSkill\ 下 = ①开发机、含 .dsh = ②dsh 环境），再按上表确定产出根目录（dsh 环境 → 优先 D:\dshworkspace\创作任务\、主工作区不存在时用桌面 DSHSkill项目/；开发机/用户环境 → 桌面 MCNSkill项目/，账号层直挂 {账号名}/提示词{编号}/），再按系统拼接桌面路径
3. 路径含 ~ 时自动展开为用户主目录
4. 路径含 {用户名} 时替换为当前系统用户名
5. 目录不存在时自动创建

变更记录

• 2026-08-20：初始创建。默认路径由技能目录内 output/ 改为用户桌面 分镜提示词/（用户指定："改为默认保存到用户 桌面 分镜提示词 文件夹"）。
• 2026-08-26：新增运行环境判断——技能不在 .dsh 路径下（本地/源技能环境）时，默认产出根目录改为用户桌面 MCNSkill输出/；dsh 部署环境维持桌面 分镜提示词/ 不变（用户指定："技能的输出不在dsh路径下时，默认放在桌面 MCNSkill输出 中"）。
• 2026-08-26（修订）：非 dsh 环境默认产出根目录由桌面 MCNSkill输出/ 调整为桌面 MCNSkill项目/分镜提示词/——统一项目文件夹中的本技能对应文件夹（用户指定："改为默认放在 桌面 MCNSkill项目 中对应文件夹中"）。
• 2026-08-26（再修订）：产出结构新增账号层——{产出根目录}/{账号名}/{视频标题}/，与脚本创作技能按账号归档同口径；dsh 与非 dsh 环境均在对应文件夹下按账号建子目录（用户指定："分镜提示词 也应该放在对应账号下"）。
• 2026-08-26（第三次修订）：dsh 部署环境默认产出根目录由桌面 分镜提示词/ 改为桌面 DSHSkill项目/（用户指定："在 dsh环境下 生成的文件放到 桌面DSHSkill项目 文件夹下"），账号层结构不变：DSHSkill项目/{账号名}/{视频标题}/。
• 2026-08-26（第四次修订，与脚本创作两级规则对齐）：dsh 部署环境改为优先操作 D:\dshworkspace\创作任务\（主工作区「创作任务」目录，与脚本创作技能同根；用户指定："dsh 环境下 分镜提示词也应该在 工作区 D:\dshworkspace\创作任务{账号名}\提示词{编号}"）；主工作区不存在时兜底桌面 DSHSkill项目/。产出结构由 {账号名}/{视频标题}/ 改为 {账号名}/提示词{编号}/——与脚本创作「脚本{编号}」平级，编号默认继承上游脚本编号，独立使用时按已有最大值递增。
• 2026-08-26（第五次修订，环境判定模型修正）：判定锚点由「技能路径是否含 .dsh」单一判断改为两步判定——第一步查本机 D:\AgentSkill 是否存在（无 = ③用户环境，技能无论装在哪、什么路径）；有 → 第二步看技能路径（在 D:\AgentSkill\ 下 = ①开发机；含 .dsh = ②dsh 环境）。修复用户环境技能装在非 .dsh 路径（如 ~/.workbuddy/skills/）时被误判为开发机、可能错误直接编辑 references/ 的漏洞（用户指定：用户环境判定锚点是「本机没有 D:\AgentSkill」，与技能装在什么路径无关）。
• 2026-08-26（第六次修订，产出结构定稿）：①开发机与③用户环境产出根目录由 桌面 MCNSkill项目/分镜提示词/ 改为 桌面 MCNSkill项目/（账号层直挂：{账号名}/提示词{编号}/，去掉「分镜提示词」技能文件夹层，与脚本创作「脚本{编号}」同构；用户指定："定稿产出结构：桌面\MCNSkill项目{账号名}{脚本文件夹}\（①开发机与③用户环境同构，账号层直挂）；② dsh 部署环境不变 D:\dshworkspace\创作任务{账号名}\脚本{编号}"）。dsh 环境产出不变。