Files
mcn-short-video/project/短视频脚本创作/V1.0/subskills/mcn-video-prompt/references-add/路径配置.md
T
maogeigei c48902f063 09-10 工作台:配置收敛、复盘字段契约修复、原创选题分镜支持、榜单期号区间显示
配置收敛:
- 端口/DB名/产出根/榜单目录单源化到 mcn-work-shop/config.json,代码层统一经 load-config.js 读取
- 新增 get-port.js 供 start.bat 读端口(bat 内嵌 node -e 会被 cmd 截断,读到的是兜底值)
- start.bat 修复失效的 managed node 路径(原写死 22.22.2 已不存在),改为遍历 versions 自动探测

复盘诊断页(真 bug 修复):
- 问题清单严重度全部显示成绿色 + 修改建议不显示:模型输出 {sev:'high',fix} 与前端读取 {severity:'高',suggestion} 字段名与取值均不匹配
- 前端新增 normIssue 归一化,兼容 sev/severity/level 与中英取值,并回补所属维度显示
- 在 submit-review-tasks 与诊断/复盘 prompt 中固化 issues_json 字段契约,从源头防 schema 漂移

分镜提示词:
- 原创选题(video_id 为空)原本无生成入口(分镜按 video_id 查询)
- listStoryboards 支持按 rewrite_id 查询,前端放开入口、切版本重查,并补落库指令(此前入库靠模型自由发挥)

榜单展示:
- 期号改为显示区间「08/31 ~ 09/06」,避免被误读为单日(期号=该周周一)
- 后端新增 collectRanges,从落盘文件读真实 dateStart/dateEnd 随 API 返回(日榜 start=end 不显区间)

其他:
- 清理 dsh 环境废弃后的历史叙述类废话(16 文件约 18 处),文末变更记录区保留
- 新增 docs/工作台UI规范.md(设计 token / 布局 / 8 页面路由 / 12 类组件 / 9 条已知坑)
2026-09-10 18:28:42 +08:00

9.3 KiB
Raw Blame History

路径配置(运行时优先)

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

一、默认路径(用户未自定义时生效)

先判定运行环境(一步 · 仓库特征判定:看技能是否处于源技能 git 检出内),再按运行系统解析桌面路径:

判定 条件 环境 默认产出根目录
一步判定 技能处于源技能 git 检出内(git -C {技能目录} rev-parse --show-toplevel 返回仓库根) ① 开发机(源技能) 用户桌面 MCNSkill项目/(账号层直挂:{账号名}/提示词{编号}/,与脚本创作「脚本{编号}」同构)
一步判定 技能不在任何 git 检出内(技能无论装在哪、什么路径) ② 用户环境 用户桌面 MCNSkill项目/(账号层直挂:{账号名}/提示词{编号}/,与脚本创作「脚本{编号}」同构)

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

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

AI 执行规则:

  1. 先按一步判定运行环境(仓库特征判定)——看技能是否处于源技能 git 检出内(git -C "{技能目录}" rev-parse --show-toplevel 返回仓库根 = ①开发机,命令失败 = ②用户环境;无 git 环境时兜底为从技能目录向上逐级查找 .git)。再按上表确定产出根目录(开发机/用户环境同构 → 桌面 MCNSkill项目/,账号层直挂({账号名}/提示词{编号}/,与脚本创作同构))
    • ⚠️ 禁止按 .dsh 路径段或 D:\dshworkspace 做任何分支判断(该部署环境已不存在)
  2. 再判断当前运行系统(Windows / macOS),拼接桌面路径
  3. 目录不存在则自动创建
  4. 产出结构:{产出根目录}/{账号名}/提示词{编号}/…(内部文件结构不变,仅根目录可变)
  5. 账号名判定:取当前创作所属账号——从上游脚本创作上下文(人设卡片/账号名)继承;独立使用且上下文无账号信息时,询问用户确认账号名后再建目录
  6. 提示词编号判定:默认从上游脚本编号继承(脚本01 → 提示词01,一一对应);独立使用(无上游脚本)时,按账号目录下已有「提示词{编号}」最大值递增

产出结构示例(6步流程产物):

桌面 MCNSkill项目/                     ← 唯一产出根目录(开发机 / 用户环境同构;Windows/macOS 自动适配)
└── {账号名}/                            ← 对应账号(从上游脚本创作上下文继承,与脚本创作同口径)
    └── 提示词{编号}/                    ← 与「脚本{编号}」平级(编号默认继承上游脚本编号)
        ├── 00_剧本分析.md      ← Step 1 剧本分析(5维度)
        ├── 01_需求分析与路径.md ← Step 2-3
        ├── 02_段1提示词.md      ← Step 4(多段时 02/03/04… 递增)
        ├── …
        └── 分镜提示词_终版.md   ← 最终交付物(命名可带模板版本,如 _11字段版)

二、用户自定义路径(最高优先级)

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

出现自定义需求时,在此追加记录(保留用户原话,便于追溯):

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

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

三、解析规则(优先级从高到低)

  1. 本文件「用户自定义路径」记录 → 用自定义路径(最新一条生效)
  2. 本文件默认路径 → 先按一步判定运行环境(看技能是否处于源技能 git 检出内:在 = ①开发机、不在 = ②用户环境),再按上表确定产出根目录(开发机/用户环境同构 → 桌面 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 环境产出不变。
  • 2026-09-10(第七次修订,判定锚点重构 v2 · 仓库特征判定):环境判定锚点由「本机是否存在 D:\AgentSkill」改为仓库特征判定——第一步查技能路径是否含 .dsh 路径段(含 = dsh 部署环境),第二步用 git -C {技能目录} rev-parse --show-toplevel 判断技能是否处于源技能 git 检出内(在 = 开发机,不在 = 用户环境;无 git 时兜底为向上逐级查找 .git)。产出根目录三环境结果完全不变,仅判定依据改变。根因:仓库本地路径迁移导致写死盘符锚点失效 → 开发机被误判为「用户环境」,会重演第五次修订修复过的「误直接编辑 references/」漏洞。(用户确认:"改为仓库特征判定";与脚本创作技能同源定稿)
  • 2026-09-10(第八次修订,环境模型精简 v3 · 三环境 → 两环境):dsh 部署环境整体废弃(用户确认:"第一步 技能路径含 .dsh 路径段 ② dsh 部署环境 没有这个环境了")。实测依据:~/.dsh/skills/ 不存在、~/.dsh/mcn-plugin.db 不存在、~/.dsh 下仅剩 profiles/、D:\dshworkspace 整个目录不存在。故删除 .dsh 判定步骤与 D:\dshworkspace\创作任务\ 产出路径,判定简化为一步。剩余两环境产出本就同构(桌面 MCNSkill项目/{账号名}/提示词{编号}/),产出结果不变。(与脚本创作技能同源定稿)