video-create/.claude/skills/video-from-script/references/account-system.md

账号系统规范

每个账号独立管理视觉风格、提示词策略和 CapCut 配置。 视觉风格直接内嵌在 prompts/*.md 中，无需单独的 styles/ 目录。

---

目录结构

accounts/                             # 项目根目录下
├── _template/                    # 新账号模板（含通用 prompt 模板）
│   ├── account.json
│   ├── prompts/                  # 通用提示词模板（生成账号 prompt 的基础）
│   │   ├── 通用分镜.md
│   │   ├── 通用图片.md
│   │   └── 通用视频.md
│   └── references/               # 参考图目录
│       └── .gitkeep
└── {account}/                    # 用户创建的账号（目录名 = account.json 的 id）
    ├── account.json
    ├── prompts/                  # 账号专属提示词（基于通用模板 + 风格注入生成）
    │   ├── 分镜.md               # 口播文案 → 分镜表
    │   ├── 图片提示词.md          # shotDesc → imagePrompt
    │   └── 视频提示词.md          # shotDesc → videoPrompt
    └── references/               # 参考图（生图时作为参考输入）
        ├── ref_001.png
        └── ref_002.png

---

account.json 字段说明

{
  "id": "tech-talk",
  "name": "科技解说",
  "description": "科技类短视频账号，深色背景，赛博朋克风格",
  "pipeline": "image-video",
  "defaultFormat": "9:16",
  "imageModel": "gemini",
  "videoModel": "veo3-fast",
  "batchSize": 30,
  "styles": {
    "赛博风格": {
      "references": [
        { "file": "cyber_ref.png", "url": "https://oss.../cyber_ref.png" }
      ]
    }
  },
  "ttsVoice": "cosyvoice-v3.5-plus-bailian-xxx",
  "ttsInstruction": "用冷静理性的男性声音朗读，语速适中",
  "storyboardPrompt": "prompts/分镜.md",
  "imageStylePrompt": "prompts/图片提示词.md",
  "videoStylePrompt": "prompts/视频提示词.md",
  "references": [],
  "capcut": {
    "effects": ["录制边框 III"],
    "filter": "质感暗调:30",
    "subtitleStyle": {
      "fontSize": 24,
      "color": "#FFFFFF",
      "highlightColor": "#FF6B35",
      "bold": true,
      "hasShadow": true,
      "shadowColor": "#000000",
      "shadowAlpha": 0.8,
      "transformY": -380,
      "alignment": 1,
      "inAnimation": "淡入",
      "outAnimation": "淡出"
    },
    "keywordStyle": {
      "textEffect": "简约白色黑边花字",
      "fontSize": 60,
      "color": "#FFFFFF",
      "bold": true,
      "transformY": 0,
      "inAnimation": "打字机效果",
      "outAnimation": "模糊淡出",
      "inAnimDuration": 300000,
      "outAnimDuration": 300000
    },
    "transitions": {
      "strategy": "rhythm",
      "default": { "name": "闪白", "duration": 150000 },
      "byPosition": {
        "hook":     { "name": "闪白", "duration": 100000 },
        "keypoint": { "name": "闪白", "duration": 120000 },
        "body":     { "name": "溶解", "duration": 300000 },
        "closing":  { "name": "闪黑", "duration": 200000 }
      }
    },
    "defaultBGM": ""
  }
}

字段	类型	说明
id	string	账号唯一标识（与目录名一致）
name	string	账号显示名
description	string	一句话描述
pipeline	string	流水线类型：image-video（默认）
defaultFormat	string	默认画幅（9:16 / 16:9 / 1:1 / 4:3）
imageModel	string	默认图片模型（gemini / mj）
videoModel	string	默认视频模型（veo3-fast / grok-video-3 / kling）
batchSize	number	默认批量生成数量
styles	object	命名风格预设，每项含 references 数组
ttsVoice	string	TTS 音色 ID，留空用 config.json 全局默认
ttsInstruction	string	TTS 语气指令（描述期望的语气、语速、情感）
storyboardPrompt	string	分镜提示词模板路径（相对于账号目录）
imageStylePrompt	string	图片提示词模板路径（相对于账号目录）
videoStylePrompt	string	视频提示词模板路径（相对于账号目录）
references	array	默认参考图列表（每项含 file 和 url），已被 styles 取代
capcut.effects	string[]	CapCut 特效名称列表
capcut.filter	string	CapCut 滤镜，格式 "名称:强度"（如 "质感电影:40"）
capcut.subtitleStyle	object	字幕样式（font/字体、fontSize、color、highlightColor、bold、transformY、inAnimation/outAnimation）
capcut.keywordStyle	object	关键字氛围词样式（textEffect 花字、fontSize、color、动画），留空或删除则关闭
capcut.transitions	object	转场配置（strategy + default + byPosition + byDirector）
capcut.kenBurns	object	Ken Burns 关键帧动画（消除图片幻灯片感），见下方
capcut.defaultBGM	string	默认背景音乐 URL

kenBurns 字段

Ken Burns 关键帧动画：为每张图片添加慢速连续缩放/平移，消除幻灯片感。速率驱动，自动适配片段时长（短片段缩放少，长片段缩放多）。

{
  "kenBurns": {
    "enabled": true,
    "default": { "startScale": 1.0, "scaleRate": 0.8, "panXRate": 0, "panYRate": 0 },
    "byDirector": {
      "tarantino": { "startScale": 1.0, "scaleRate": 0.9, "panXRate": 0, "panYRate": -0.3 },
      "kitano":    { "startScale": 1.03, "scaleRate": 0.5, "panXRate": 0.4, "panYRate": 0 },
      "fincher":   { "startScale": 1.0, "scaleRate": 0.4, "panXRate": 0, "panYRate": 0 }
    }
  }
}

参数	类型	说明
enabled	boolean	false 禁用 Ken Burns，默认 true
default	object	默认 Ken Burns 参数（无 directorRef 匹配时使用）
byDirector	object	按 directorRef 覆盖（key 为导演名小写）
startScale	number	起始缩放（1.0=原始，1.03=略微放大）
scaleRate	number	缩放速率（%/秒），如 0.8 = 每秒放大 0.8%。自动乘以片段时长计算 endScale，上限 1.20
panXRate	number	水平平移速率（单位/秒），正值右移。自动乘以片段时长
panYRate	number	垂直平移速率（单位/秒），正值下移。自动乘以片段时长

创建账号时 Agent 应询问：

• 是否需要 Ken Burns 镜头动画？（图片成片必开，视频模式自动跳过）
• 镜头风格偏好：微缩放 / 平移+缩放 / 仅缩放

---

提示词模板（prompts/）

每个账号在 prompts/ 目录下维护三个子 Agent 提示词模板：

文件	用途	Step
分镜.md	口播文案 → 分镜表（shotDesc/script/duration/directorRef）	Step 1
图片提示词.md	shotDesc + directorRef → imagePrompt	Step 2-A
视频提示词.md	shotDesc + directorRef → videoPrompt	Step 3-A

这些文件定义了子 Agent 的角色、入参、出参、词库和示例。路径在 account.json 中以相对路径引用，Agent 读取 account.json 后自动定位。

生成方式

账号的 prompts 基于 _template/prompts/通用*.md 生成：

• 通用模板提供方法论骨架（切割规则、导演词库、写法规范、输出格式、质量自检）
• 创建账号时通过 Q&A 收集风格信息，注入到骨架的固定位置
• 详细流程见 account-creation.md

---

参考图（references/）

参考图用于生图时的风格引导（Gemini 图生图 / MJ --sref）。

管理流程

1. 用户将参考图放入 accounts/{id}/references/ 目录
2. Agent 上传到 OSS：node scripts/oss-upload.js accounts/{id}/references/{图片文件}
3. 将返回的 URL 写入 account.json 的 references 数组

---

创建新账号

Q&A 创建（推荐）

用户说"创建账号"或"新账号"时，Agent 按 account-creation.md 的结构化问答流程执行：

1. 逐项询问：账号身份 → 内容 DNA → 视觉身份 → 技术配置
2. 基于通用模板 + 用户回答生成 3 个 prompt 文件 + account.json
3. 校验完整性

CLI 创建（辅助）

node scripts/pipeline.js create-account \
  --id military \
  --name "军事账号" \
  --desc "军事主题短视频，暗黑漫画风格" \
  --video-model veo3-fast-frames \
  --references ./ref1.png,./ref2.png

自动完成：创建目录 → 生成 account.json → 复制参考图 → 上传 OSS → 回写 URL。

注意：CLI 创建只生成目录结构和 account.json 骨架，prompt 文件仍需通过 Q&A 流程或手动创建。

校验账号

node scripts/pipeline.js validate-account --account military

检查：id 匹配、必填字段、prompts 模板存在、参考图完整性、OSS URL 有效。