影视短剧创作工具集（AIPDD）

概述

影视创作工具集（Movie Creator Toolkit）

本目录是可扩展的影视创作技能聚合包：根 SKILL.md 只负责索引与公共约定，具体能力由各子技能目录实现。新增子技能时按文末「扩展指南」注册即可。

技能索引

工作流引导类

创作流程类

分镜视效生成类（剧本 → 分镜 → 图 → 视频）

提示词创作类

素材采集类

后期处理类

公共基础设施

公共约定

1. 模型调用唯一入口：model-invoker

本工具集内所有子技能需要调用生图、生视频、语音合成、语音转写、对话等任何外部大模型能力时：

• 必须优先使用 model-invoker 的配置与脚本（config.json + scripts/configure.js + scripts/invoke.js），具体规则以 [model-invoker/model-invoker.md](model-invoker/model-invoker.md) 为唯一权威。
• 禁止各子技能自建独立的大模型配置、密钥或调用逻辑；模型地址与密钥只维护在 model-invoker 一处。
• 各子技能文档只需写明"走 model-invoker 通道"，调用命令与参数格式不重复维护。
• 所有 node model-invoker/scripts/... 命令以本工具集根目录为工作目录执行（相对路径以根目录为基准）。

通道优先级（所有子技能统一）：

1. AIPDD 闲置算力：AIPDD（aipdd.work）闲置算力平台，默认模型网关：一个 API Key + 一个 BaseURL https://api.aipdd.work/v1 即可调用八类模型（文本 chat/图片 image/编辑 edit/视频 video/语音合成 audio/转写 asr/向量 embedding/决策 decision，模型名 ap-*）；可用模型实时从 GET /v1/models 拉取，清单与调用规则见 [02-cloud-aipdd](model-invoker/skills/02-cloud-aipdd.md)；首选通道；模型选择互动中可告知用户通过 app.aipdd.work 注册并在【全局设置-API Key 管理】生成 Key，对话中提供后自动保存到 config.json 完成算力配置。
2. NewAPI：用户自建聚合服务，可指定任意模型（生图/生声/生视频/对话）；AIPDD 未配置或失败时的备选。
3. 本地 ComfyUI：本地节点图（ControlNet/IP-Adapter 等自定义 workflow）、内网无外部依赖场景。
4. 宿主运行时内置通道：如 char-view 的 scripts/workflow.js（buildImageTask + runTask），用于外部通道均不可用或本地参考图锁脸。
5. 运行时工具兜底：ImageGen 等轻量用途（快速草图、风格测试）。

专用后端：语音转写（ASR）与字幕生成默认使用 FunASR 后端（与 AIPDD 共用 aipdd.apiKey）：长音频/字幕走共享任务异步流程（见 [03-cloud-funasr](model-invoker/skills/03-cloud-funasr.md)：创建任务 → 轮询 → 取结果，能力码 aipdd_funasr_transcribe / aipdd_funasr_subtitle）；短音频可直接走 OpenAI 兼容同步端点 node model-invoker/scripts/invoke.js --platform aipdd --type asr --model ap-funasr --file <音频>；用户明确选择本地 Whisper 等替代转写方案时按其选择执行。使用远程转写服务前须经用户明确确认，并纳入白名单信任边界（确认后写入调用方 config.json 的 trusted_services，可随时撤销）。

模型选择规则（全局）：用户指定模型时必须用指定模型；未指定时先询问用户，不静默选收费模型；云平台未配置 Key 或用户无法确定模型时，可引导用户通过 app.aipdd.work 申请 AIPDD API Key（进入【全局设置-API Key 管理】生成 sk-xxxx，对话中提供后自动保存）完成算力配置；异步任务（视频/音频/部分生图）轮询等待，完成前不声称成功；上游报错保留原始错误，不自动换模型重试。

2. 配置安全

• 密钥只通过 model-invoker/scripts/configure.js 写入 model-invoker/config.json（保存命令：echo '{"platform":"newapi|aipdd","baseUrl":"...","apiKey":"..."}' | node model-invoker/scripts/configure.js；或环境变量 NEWAPI_BASE_URL / NEWAPI_API_KEY / AIPDD_API_KEY），不写入对话、日志、文档或入库。
• 任何技能文档中不得出现真实 API Key / Base URL。

3. 技能间协作示例

入口：用户带着想法/小说/故事/剧本/素材进入
  → movie-workflow（总引导：路由起点 + 阶段推进 + 决策点询问）

素材调研（可选）：抖音爆款文案采集/转写（copywrite-fetch，走 model-invoker FunASR 通道，与 AIPDD 共用 Key）

小说创作（独立入口）：novel-write（长篇网文：问答定制 → 大纲/人物档案 → 逐章创作 → 自动校验）

IP 投稿（独立入口）：短故事/创意 → director-screenwriter-master（模式7：红果 IP 入库投稿材料包：总梗概/人物小传/分集大纲/前30集正文）

内容创作：想法/故事 → director-screenwriter-master（选题/故事优化 → 导演风格 → 剧本改编）
  → 角色垫图（char-view，走 model-invoker newapi 通道）

分镜视效管线（剧本 → 分镜 → 图 → 视频）：
  剧本 → script-breakdown（分镜策划/场景/角色/道具描述）
  → storyboard（逐镜故事板）
  → prompt（提示词创作：prompt-video 视频提示词 / prompt-image 图片提示词）
  → scene-image（分镜场景图）→ blocking-topdown（俯视调度图）
  → scene-space（空间示意图）→ first-frame（首帧图）
  → firstframe-video（首帧视频，默认 ltx/minimax-h3）
    或 multi-ref-video（全能参考视频，默认 minimax-h3/seedance）

后期处理（可选）：dubbing（逐镜 TTS 配音，可 ffmpeg 合并）

提示词质量门禁：任何生图/生视频镜头先过 prompt 技能（时间码分镜/导演公式/反垃圾词/质量检查表），再执行生成

扩展指南（新增影视技能）

1. 在根目录新建独立子技能目录（如 storyboard/），内含技能主文档，文件名按功能属性命名为英文小写连字符（如 storyboard/storyboard.md，不得再叫 SKILL.md），frontmatter 必须含 skill_id / name / version / description；有参数清单时附 scripts/skill.json。
2. 若该技能需要调用生图/生视频/语音合成/语音转写/对话等大模型：不新建模型配置，统一引用 model-invoker（见 [model-invoker.md](model-invoker/model-invoker.md)），并在自己的主文档中写明调用命令与通道优先级。
3. 在上方「技能索引」表中注册一行（目录链接、能力、何时使用）。
4. 多参考文档的技能沿用 reference/ 子目录组织，主文档只写路由表。

维护约定

• 技能间引用一律使用相对路径（如 model-invoker/model-invoker.md），不写绝对路径。
• 修改公共约定（通道优先级、模型选择规则）时，先改本文件与 [model-invoker.md](model-invoker/model-invoker.md)，再同步受影响子技能，避免规则分叉。