# kb-raw · 原始知识源（只读参考）

本目录是用户交付的**原始知识库快照**（2026-10 整理，284 个文件 / 约 6.8MB），
按主题原样保留，未做删改（**唯一例外见下方"安全处理"**）。

## 用途

这是 `references/` 下提炼文档的**出处**。当需要：

- 照抄某段 SOP 原文、某个提示词的完整版
- 查看某个历史版本的完整脚本实现
- 查阅编剧理论原著（《故事》《救猫咪》Ⅰ/Ⅱ/Ⅲ）
- 核对即梦接口的原始参数说明

就到这里找。日常使用**优先看 `references/`**（已提炼、已按本仓实测校正）。

## 目录导航

| 目录 | 内容 |
|---|---|
| `04-SOP工作流/` | 视频脚本生成 / 变装视频生成两套完整 SOP（含 `flow/` 模板与 `scripts/`） |
| `05-剧本与叙事知识库/` | 麦基《故事》、《救猫咪》Ⅰ/Ⅱ/Ⅲ、创作技能包、dbskill 知识包 |
| `06-制作方法演进/` | 版本 1~6 制作方法演进全过程 + 多个真实案例（脚本/分镜/文案） |
| `07-即梦API工具箱/` | 即梦全部 API 脚本 + `参考文档/`（接口详解、资产生成记录） |
| `08-成品案例库/` | VOC 商业洞察分镜文案、AI 微纪录片制作文档、剧本过程稿 |
| `README.md` | 原知识库总说明与导航 |

## ⚠️ 这些脚本不能直接运行

`kb-raw/` 内的 `.js` 脚本是**历史原稿**，带有当时的工作环境特征：

- **硬编码了本机绝对路径**（如 `E:\公司\voc-workshop-promo\...`、`C:\Users\...`）
- **硬编码了 Windows 专用工具路径**（如 `imageio_ffmpeg` 的 exe）
- **依赖当时的上游字段**（部分接口参数在后续版本已变化）

要跑这些能力，请用本仓对应的 `fmode-mv` 命令 —— 已全部改为：
**运行时读取凭据** + **参数化路径** + **本地参数预检**。

## 安全处理

原稿中有 **98 处**写死的 sessionToken 字面量（`Bearer r:f03...`），
属于用户自己仓库的历史遗留。

**本次入库前已做替换**：全部 `r:f033…`
→ `<REDACTED-LEGACY-TOKEN-SEE-NOTICE>`，确保仓库内**不含任何明文凭据**。
替换只改了字面量，**未改动任何逻辑**。

> 本仓新增代码（`lib/`、`scripts/`、`bin/`）**从一开始就不含任何明文凭据**，
> 凭据一律从 `FMODE_SESSION_TOKEN` 环境变量或 `/opt/data/fmode-identity.json` 运行时读取。

## 许可

`kb-raw/` 内的《故事》《救猫咪》等书籍摘录**版权归原作者/出版方所有**，
此处仅作学习方法论之用，**不得对外分发或商用**。其余内容归用户所有。