maogeigei
f77735b206
1. 目录 mcn-work-shop -> mcn-workshop（空间分组名取会话 cwd 的目录名，只改字符串无效，必须真改名） 2. 全仓替换 mcn-work-shop -> mcn-workshop：37 文件 121 处；历史日志按沿革句规矩保留当时目录名 3. 任务进度可见：/api/run/status 产出 已运行时长/工具调用/最近动作/停滞判定（读会话日志尾部），前端新增右下角常驻面板，四处任务入口接入 4. 会话归属目录配置化：新增 config.sessionCwd（留空=工作台自身目录），现指向 D://AI技能//mcn-workshop，使任务显示为命名分组而非「未分组任务」 5. 修前端轮询静默缺陷：连续 3 次查询失败即提示服务断开（原逻辑静默空转到 15 分钟超时，用户零感知）
references/ — 默认引用文件地址（标准库）
本目录是技能的默认引用文件地址，存放出厂自带的标准制作流程、接口文档和知识库内容。
目录结构
references/
├── README.md ← 本文件
├── 制作流程/ ← 标准制作流程（分镜提示词制作流程/长视频分段制作流程/图生视频与分镜板制作流程/多镜头剪辑节奏流程/外部语料检索流程）
├── 功能/ ← 单功能执行细则（F1 图片反推细则等）
├── 规则/ ← 技能级强制规则（路径引用规范/提示词质量门禁）
└── 知识库/ ← 标准知识库（15 维度，按提示词组成要素分类）
├── 01_主体描述/ ← 人/物/场景，含外貌细节与微表情系统
├── 02_动作行为/ ← 主体动作、姿势、互动、物理连贯性
├── 03_场景描述/ ← 背景、环境、时间、天气、空间锚定
├── 04_镜头类型/ ← 景别（特写→远景）+ 四维编码 Z 轴
├── 05_运镜方式/ ← 摄像机运动方式与节奏 + 四维编码运动维度
├── 06_焦距视角/ ← 镜头焦段、拍摄角度 + 四维编码 Y/X/F 轴 + 焦段心理学
├── 07_光线时间/ ← 光源类型、方向、强弱 + 光影三层（光源层/光行为层/色调层）
├── 08_氛围天气/ ← 情绪氛围、天气条件
├── 09_色彩后期/ ← 调色、滤镜、电影质感 + 冷暖色调对比系统
├── 10_后期细节/ ← 磨皮、锐化、运动模糊、胶片颗粒 + 有机瑕疵
├── 11_特效渲染/ ← 光效、散景、粒子、GI/SSS/体积光 + 深度美学约束
├── 12_画质分辨率/ ← 输出规格 + 反塑料感宣言（平台 UI 设置，非提示词废话词）
├── 13_音效音频/ ← 空间声学、材质拟声、音色控制（视频提示词 `音效：` 行）
├── 14_构图布局/ ← 构图法则、版式、画面布局、极简先锋构图
└── 15_视觉风格/ ← 导演风格参数化映射（28+风格去名化）+ 艺术流派/渲染风格
维度分类说明
知识库按提示词组成要素（维度）分类，每个维度对应提示词中的一个组成部分。写提示词时按维度逐项组装，知识库文件提供该维度的词汇表、参数表、规则和示例。
| 编号 | 维度 | 说明 | 主要参考技能来源 |
|---|---|---|---|
| 01 | 主体描述 | 人/物/场景，含外貌细节与微表情系统 | PromptSkill4image subject + ShotDesign 六要素 + ShotDesign micro-expressions |
| 02 | 动作行为 | 主体动作、姿势、互动、物理连贯性 | PromptSkill4image action + ShotDesign 六要素 |
| 03 | 场景描述 | 背景、环境、时间、天气、空间锚定 | PromptSkill4image scene + ShotDesign 六要素 |
| 04 | 镜头类型 | 景别（特写→远景） | seedance2.0 四维编码 Z 轴 + ShotDesign cinematography |
| 05 | 运镜方式 | 摄像机运动方式与节奏 | seedance2.0 四维编码运动维度 + ShotDesign 三级运镜 |
| 06 | 焦距视角 | 镜头焦段、拍摄角度 | seedance2.0 四维编码 Y/X/F 轴 + ShotDesign 焦段心理学 |
| 07 | 光线时间 | 光源类型、方向、强弱 | PromptSkill4image lighting + ShotDesign 光影三层-光源层/光行为层 |
| 08 | 氛围天气 | 情绪氛围、天气条件 | PromptSkill4image mood |
| 09 | 色彩后期 | 调色、滤镜、电影质感 | PromptSkill4image color_scheme + ShotDesign 光影三层-色调层 + seedance2.0 冷暖色调 |
| 10 | 后期细节 | 磨皮、锐化、运动模糊、胶片颗粒 | ShotDesign 有机瑕疵 + 史诗结构收束句 + PromptSkill4image material |
| 11 | 特效渲染 | 光效、散景、粒子、GI/SSS/体积光 | seedance2.0 美学约束 + PromptSkill4image render_quality + ShotDesign 品质锚定 |
| 12 | 画质分辨率 | 输出规格 | ⚠️ 参考技能策略：分辨率/帧率在即梦平台 UI 设置，提示词中用物理材质词替代"4k/8k"等废话词（反塑料感宣言） |
| 13 | 音效音频 | 空间声学、材质拟声、音色控制 | ShotDesign audio-tags（视频提示词 音效： 行专用） |
| 14 | 构图布局 | 构图法则、版式、画面布局 | PromptSkill4image composition + ShotDesign 极简先锋构图法则 |
| 15 | 视觉风格 | 导演风格参数化映射 + 艺术流派/渲染风格 | ShotDesign director-styles（28+风格去名化）+ PromptSkill4image style |
词汇分布原则： 旧"07_词汇库"已取消独立分类，各维度词汇表归入对应维度文件夹内（如运镜词→05_运镜方式/，风格词→15_视觉风格/）。
三层引用架构
| 层级 | 目录 | 定位 | 读写 |
|---|---|---|---|
| 1 | 参考skills/ |
外部参考技能（方法论来源，已提炼落库至本目录） | 只读 |
| 2 | references/（本目录） |
默认引用文件地址（出厂自带标准库） | 开发环境可编辑；部署环境只读 |
| 3 | references-add/ |
用户部署后新增的流程/方法/知识库沉淀地 | 可读写，持续增长 |
部署环境检测
根据**一步判定模型（仓库特征判定）**判断当前环境（看技能是否处于源技能 git 检出内）：
| 环境 | 判定条件 | references/ 权限 | 新增内容写入位置 |
|---|---|---|---|
| ①开发机 | 技能处于源技能 git 检出内（git -C {技能目录} rev-parse --show-toplevel 返回仓库根） |
可直接编辑 | references/ 对应子目录 |
| ②用户环境 | 技能不在任何 git 检出内（技能无论装在哪、什么路径） | 只读 | references-add/ 对应子目录 |
冲突检测与运行时优先级
- 冲突检测：用户新增内容后，与
references/同类内容逐一比对；有冲突时以新增内容为主（写入references-add/），同时在references/对应文件加 ⚠️ 注释标注，不覆盖原始内容 - 运行时优先级：技能执行时同时加载
references/和references-add/，两者冲突以 references-add/ 为主
参考skills/（方法论源） → references/（默认标准库） → references-add/（用户增量，冲突时以此为准）
完整规则详见
SKILL.md「动态增量管理」节。
当前状态
标准库已填充完成（2026-07-28 从参考技能提炼落库；ShotDesign/seedance25 源文件已于 2026-08-21 移除，方法论已全部落库）：
制作流程/：5 个流程文件（分镜提示词制作流程 / 长视频分段制作流程 / 图生视频与分镜板制作流程 / 多镜头剪辑节奏流程 / 外部语料检索流程）功能/：1 个单功能细则（F1 图片反推细则）规则/：2 个强制规则（路径引用规范 / 提示词质量门禁）知识库/：15 个维度词库文件（01-15 各维度一个词库，含英文提示词可直接嵌入）
参考skills/ 仍保留为方法论源（只读，第一层），日常执行优先引用本目录文件；两者冲突时以本目录提炼版为准。
与 references-add/ 的关系
references/：默认标准库，出厂自带；开发环境可编辑，部署环境只读references-add/：用户增量库，仅在部署环境启用，在对话中积累，随使用持续增长- 两者按同一维度分类（制作流程 / 知识库 15 维度）
references-add/的子目录按需创建（不预置空目录）：新增内容时按上表归入，目录不存在则先建- 运行时同时加载，冲突时以 references-add/ 为主
- 发现冲突时在
references/对应文件加 ⚠️ 注释标注，不删除或覆盖原始内容