Files
mcn-short-video/project/短视频提示词生成/references-add/路径配置.md
T

75 lines
8.6 KiB
Markdown
Raw Normal View History

# 路径配置(运行时优先)
> 本文件是**产出路径的唯一权威配置**,运行时优先于 `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 环境产出不变。