maogeigei
c48902f063
配置收敛：
- 端口/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 条已知坑）
124 lines
7.1 KiB
Markdown
124 lines
7.1 KiB
Markdown
# references-add
|
||
|
||
## 用途
|
||
|
||
当 Skill 被部署到**非原始开发路径**时（即 Skill 根目录路径与原始项目路径不同），
|
||
所有用户在对话过程中新增的**流程定义、接口文档、创作知识、避坑规则、素材内容**统一整理到此文件夹。
|
||
|
||
## 知识分类体系（V2.0）
|
||
|
||
基于短视频产品规划图的 **27 赛道 × 8 叙事形态**三级分类体系：
|
||
|
||
| 层级 | 维度 | 枚举值 |
|
||
|:---|:---|:---|
|
||
| L1 赛道 | 讲什么 | 个人才艺 / 生活vlog / 财富理财 / 二次元 / 居家装修 / 学习教育 / 小剧场 / 数码科技 / 旅行 / 美食 / 美妆 / 动物 / 亲子 / 汽车 / 情感 / 三农 / 健康医学 / 潮流风尚 / 舞蹈才艺 / 颜值造型 / 人文 / 音乐 / 影视 / 身体锻炼 / 体育 / 明星娱乐 / 游戏 |
|
||
| L2 内容形式（叙事形态） | 怎么拍 | F01剧情演绎 / F02Vlog纪实 / F03干货口播 / F04测评种草 / F05教程教学 / F06盘点解说 / F07纯视觉短片 / F08人物采访 |
|
||
| L3 细分垂类 | 具体方向 | 各赛道 × 形态下的细化分类（如：小剧场×F01 → 都市情感/逆袭爽剧/温情正能量等） |
|
||
|
||
## 结构
|
||
|
||
```
|
||
references-add/
|
||
├── README.md ← 本说明
|
||
├── 路径配置.md ← 🔴 产出路径唯一权威配置（运行时优先，用户自定义路径在此记录）
|
||
│
|
||
├── 创作流程/ ← 新增的创作流程文件（步骤变更、新步骤等）
|
||
├── 接口调用/ ← 新增的 API 接口定义与调用文档
|
||
│
|
||
├── 通用知识/ ← 🔵 不限赛道和内容形式的通用创作方法论
|
||
│
|
||
├── 素材库/ ← 🟡 新增素材内容（与 references/素材库/ 同结构）
|
||
│ ├── 01_美食库_*.md ← 新增美食素材（按细分命名）
|
||
│ ├── 03_生活仪式库_*.md
|
||
│ ├── 05_装修布局库_*.md
|
||
│ ├── 06_生活服务库_*.md
|
||
│ ├── 07_穿搭库_*.md
|
||
│ ├── 08_妆容库_*.md
|
||
│ └── 11_造型库_*.md
|
||
│
|
||
├── 分赛道知识/ ← 🟢 限定赛道 + 内容形式的知识
|
||
│ ├── 小剧场/
|
||
│ │ ├── F01_剧情演绎/
|
||
│ │ ├── F02_Vlog纪实/
|
||
│ │ ├── F03_干货口播/
|
||
│ │ └── ... (8种叙事形态)
|
||
│ ├── 生活vlog/
|
||
│ ├── 美妆/
|
||
│ ├── 学习教育/
|
||
│ ├── 身体锻炼/
|
||
│ ├── 汽车/
|
||
│ ├── 游戏/
|
||
│ └── ... (共27赛道)
|
||
│
|
||
└── 铁律避坑规则/ ← 🔴 创作中必须遵守的铁律和避坑指南
|
||
├── 通用/ ← 不限赛道和内容形式的通用铁律
|
||
└── 分赛道/ ← 限定赛道 + 内容形式的铁律
|
||
├── 小剧场/
|
||
│ ├── F01_剧情演绎/
|
||
│ └── ...
|
||
└── ...
|
||
```
|
||
|
||
## 通用知识 vs 分赛道知识 — 判定标准
|
||
|
||
| 判定维度 | 通用知识 | 分赛道知识 |
|
||
|:---|:---|:---|
|
||
| 适用赛道 | 不限，所有赛道通用 | 限定 1 个赛道 |
|
||
| 适用内容形式 | 不限，所有叙事形态通用 | 限定 1 种叙事形态 |
|
||
| 案例来源 | 跨赛道/跨形态的共性提炼 | 单一赛道 × 形态的专属案例 |
|
||
| 反例 | 四柱子框架、SCQA叙事结构、完播率优化 | 「小剧场×F01 情感短剧的情绪曲线设计」 |
|
||
| 归入目录 | `通用知识/` | `分赛道知识/{赛道}/{内容形式}/` |
|
||
|
||
## 铁律避坑规则
|
||
|
||
铁律 = 在创作流程中**必须执行**的强制规则（违反即召回），避坑 = 经验积累的**常见错误和应对**。
|
||
|
||
| 分类 | 归入 | 示例 |
|
||
|:---|:---|:---|
|
||
| 通用铁律 | `铁律避坑规则/通用/` | "第一句OS必须点题+带人" |
|
||
| 赛道级铁律 | `铁律避坑规则/分赛道/{赛道}/{内容形式}/` | "两性情感短剧不得使用对话流水账式OS" |
|
||
|
||
## 素材库
|
||
|
||
用户在部署环境中新增的**可复用素材内容**（非账号专属），与 `references/素材库/` 同结构同字段。
|
||
|
||
| 规则 | 说明 |
|
||
|:---|:---|
|
||
| 文件命名 | `{编号}_{类型名}_{细分}.md`（如 `01_美食库_川菜.md`） |
|
||
| 字段结构 | 与 `references/素材库/` 同类型文件保持一致（四维标签：极致维度×适用场景×镜头维度×画面维度） |
|
||
| 04_对话库 | 账号专属，不设通用增量，仍在产出根目录 `{账号名}/`（开发机与用户环境同构：桌面 `MCNSkill项目/`，或用户自定义路径）下管理 |
|
||
| 分块定义 | 不设增量，统一使用 `references/素材库/分块定义/` |
|
||
|
||
## 与 references/ 的关系
|
||
|
||
| 目录 | 定位 | 内容来源 | 修改策略 |
|
||
|:---:|------|------|------|
|
||
| `references/` | 原始标准库（内置） | Skill 开发时固化 | 不随部署变更 |
|
||
| `references-add/` | 动态增量库 | 用户对话中积累 | 随使用持续增长 |
|
||
|
||
## 引用优先级
|
||
|
||
创作流程执行时，按以下顺序**同时检索**：
|
||
|
||
```
|
||
references/（标准） + references-add/（增量） → 合并结果
|
||
```
|
||
|
||
两个目录的内容**取并集**：标准库内容优先，增量库作为补充。两处都存在时以 `references/` 为准（增量不覆盖标准）。
|
||
|
||
> ⚠️ **唯一例外：路径配置**。`路径配置.md` 中用户自定义的产出路径**覆盖**标准库默认路径（用户要求优先于内置默认）。
|
||
|
||
## 运行时加载规则（六大维度）
|
||
|
||
当 `references-add/` 目录存在且有内容时，以下六个维度均须**同时加载两个目录**：
|
||
|
||
| 维度 | 加载规则 |
|
||
|:---|:---|
|
||
| **创作流程** | 执行每个步骤前，同时检查 `references/创作流程/` 和 `references-add/创作流程/`。增量中的同名文件**补充合并**到标准流程（取并集） |
|
||
| **通用知识** | 检索时同时搜索 `references/知识库/` 和 `references-add/通用知识/`。通用知识不限赛道，作为基础方法论补充 |
|
||
| **分赛道知识** | 创作前先确定赛道+叙事形态，然后检索 `references-add/分赛道知识/{赛道}/{内容形式}/` 获取赛道专属方法论。与 `references/知识库/` 的通用方法论合并使用 |
|
||
| **素材库** | 调取素材时同时检索 `references/素材库/` 和 `references-add/素材库/`。取并集，标准库优先，增量作为补充 |
|
||
| **接口调用** | 需要调用外部接口时，同时查阅 `references/接口调用/` 和 `references-add/接口调用/`。两个目录的接口定义**均可用** |
|
||
| **铁律避坑** | 创作完成前，**必须**检索 `铁律避坑规则/通用/` + `铁律避坑规则/分赛道/{当前赛道}/{当前内容形式}/`，逐条检查是否违反铁律 |
|
||
| **路径配置** | 每次执行创作流程前，**先查** `路径配置.md`。有「用户自定义路径」记录 → 以用户指定为准（**覆盖标准库默认桌面路径**）；无记录 → 按两环境判定（技能处于源技能 git 检出内 → 开发机 → 桌面 `MCNSkill项目/`；不在任何 git 检出内 → 用户环境 → 桌面 `MCNSkill项目/`。**两环境产出同构**），再按系统解析桌面路径。此维度为增量优先特例 |
|