-- ============================================================
-- V16 多角色出镜支持
--   每个分镜可携带多个角色变体（如：陆长生-白衣 / 陆长生-黑衣）
--
-- 兼容性约定：
--   - 保留 ai_tasks.character_image_key、storyboards 的旧字段不变
--   - 新增 character_image_keys（JSON 数组），新版结构化任务优先使用
--   - 旧任务字段保留只读，新写入只走数组列
-- ============================================================

ALTER TABLE ai_tasks
    ADD COLUMN character_image_keys TEXT DEFAULT NULL
        COMMENT '出镜角色图 TOS keys（JSON 数组字符串，@图1..@图N，按顺序排列）';

ALTER TABLE storyboards
    ADD COLUMN character_image_keys TEXT DEFAULT NULL
        COMMENT '该分镜的出镜角色图 TOS keys（JSON 数组字符串）',
    ADD COLUMN scene_image_key      VARCHAR(512) DEFAULT NULL
        COMMENT '该分镜选中的场景图 TOS key',
    ADD COLUMN prop_image_keys      TEXT DEFAULT NULL
        COMMENT '该分镜选中的道具图 TOS keys（JSON 数组字符串）',
    ADD COLUMN style_image_key      VARCHAR(512) DEFAULT NULL
        COMMENT '该分镜选中的风格图 TOS key';
