Mglc Project

灵创项目管理 Skill

本 Skill 提供完整的创作工作流管理能力，涵盖项目、剧集、剧本、分镜和(角色/场景/道具)设定的全生命周期操作。

项目管理

project list - 列出项目

分页列出当前用户有权限访问的项目。

命令：

mglc project list

参数：

project show - 查看项目详情

查看项目详细信息。

命令：

mglc project show <project_id>

project create - 创建项目

创建新项目。

命令：

# 基本创建
mglc project create --name "项目名称"

# 带描述和封面
mglc project create --name "项目名称" --description "项目描述" --cover /path/to/cover.jpg

参数：

project update - 更新项目

修改项目基础信息。

命令：

mglc project update <project_id> --name "新名称"
mglc project update <project_id> --description "新描述"

project delete - 删除项目

删除项目。

命令：

mglc project delete <project_id> --yes

剧集管理

episode list - 列出剧集

列出项目下的剧集。

命令：

mglc episode list --project-id <project_id>

参数：

episode create - 创建剧集

创建新剧集。

命令：

# 创建第1集
mglc episode create --project-id <project_id> --episode 1 --name "第一集"

# 带描述
mglc episode create --project-id <project_id> --episode 1 --name "第一集" --description "剧集描述"

参数：

episode update - 更新剧集

修改剧集信息。

命令：

mglc episode update <episode_id> --project-id <project_id> --name "新名称"

episode delete - 删除剧集

删除剧集。

命令：

mglc episode delete <episode_id> --project-id <project_id> --yes

剧本管理

script show - 查看剧本

查看项目下的剧本详情。

命令：

mglc script show --project-id <project_id>

script create - 创建剧本

创建新剧本。

命令：

# 直接传入内容
mglc script create --project-id <project_id> --content "剧本内容..."

# 从文件读取
mglc script create --project-id <project_id> --content ./script.txt

参数：

分镜管理

storyboard list - 列出分镜

分页列出剧集分镜。

命令：

mglc storyboard list --project-id <project_id> --episode 1

参数：

storyboard show - 查看分镜详情

查看分镜详细信息。

命令：

mglc storyboard show <shot_id> --project-id <project_id>

storyboard add - 添加分镜

创建新分镜。

命令：

# 基本创建
mglc storyboard add --project-id <project_id> --episode 1 --scene-order 1 --shot-name "场景1"

# 带画面描述
mglc storyboard add --project-id <project_id> --episode 1 --scene-order 1 --shot-name "场景1" --prompt "画面描述"

# 指定插入位置
mglc storyboard add --project-id <project_id> --episode 1 --prev-shot-id <id> --scene-order 2 --shot-name "新分镜"

# 批量创建
mglc storyboard add --project-id <project_id> --episode 1 --scene-order 3 --shot-name "分镜" --number 5

参数：

storyboard update - 更新分镜

修改分镜信息。

命令：

# 修改名称
mglc storyboard update <shot_id> --project-id <project_id> --shot-name "新名称"

# 修改画面描述
mglc storyboard update <shot_id> --project-id <project_id> --prompt "新的画面描述"

# 修改时长
mglc storyboard update <shot_id> --project-id <project_id> --duration 10

storyboard delete - 删除分镜

删除分镜。

命令：

mglc storyboard delete <shot_id> --project-id <project_id> --yes

storyboard views - 查看剧集视图

查看剧集视图列表。

命令：

mglc storyboard views --project-id <project_id> --episode-id <episode_id>

设定管理

项目(角色/场景/道具)设定的创建、查询、更新和删除。

subject list - 列出(角色/场景/道具)设定

列出当前可见范围内的项目或剧本设定。

命令：

# 列出项目下的所有设定
mglc subject list --project-id <project_id>

# 按类型筛选
mglc subject list --project-id <project_id> --type role

# 按名称搜索
mglc subject list --keyword "角色名"

# 分页查询
mglc subject list --project-id <project_id> --page 1 --page-size 20

参数：

subject create - 创建(角色/场景/道具)设定

创建角色、场景或道具设定。

命令：

# 创建角色设定（带图片）
mglc subject create --project-id <project_id> --type role --name "男主角" --image /path/to/avatar.png

# 创建角色设定（带图片和音频）
mglc subject create --project-id <project_id> --type role --name "女主角" --image /path/to/avatar.png --voice /path/to/voice.mp3

# 创建场景设定
mglc subject create --project-id <project_id> --type scene --name "咖啡馆" --description "温馨的咖啡馆内景"

# 创建道具设定
mglc subject create --project-id <project_id> --type prop --name "神秘宝箱" --description "发光的古老宝箱"

参数：

subject update - 更新设定

更新设定信息。

命令：

# 修改名称
mglc subject update <subject_id> --project-id <project_id> --name "新名称"

# 修改描述和图片
mglc subject update <subject_id> --project-id <project_id> --description "新描述" --image /path/to/new.png

参数：

subject delete - 删除(角色/场景/道具)设定

删除设定。

命令：

mglc subject delete <subject_id> --project-id <project_id> --type role --yes

参数：

会话管理

项目生成会话的创建、查询、更新和删除，用于管理 AI 生成的会话上下文。配合video、image技能使用。

session list - 列出会话

列出项目下的生成会话。

命令：

# 列出项目下的所有会话
mglc session list --project-id <project_id>

# 按剧集筛选
mglc session list --project-id <project_id> --episode 1

参数：

session create - 创建会话

创建新的生成会话。

命令：

# 基本创建
mglc session create --project-id <project_id> --name "会话名称"

# 指定剧集和剧本
mglc session create --project-id <project_id> --episode-id <episode_id> --script-id <script_id> --name "第1集会话"

参数：

session update - 更新会话

修改会话名称。

命令：

mglc session update <session_id> --project-id <project_id> --name "新名称"

参数：

session delete - 删除会话

删除生成会话，可选择迁移记录到其他会话。

命令：

# 直接删除
mglc session delete <session_id> --project-id <project_id> --yes

# 删除前迁移记录到目标会话
mglc session delete <session_id> --project-id <project_id> --dst-session-id <target_session_id> --yes

参数：

使用建议

1. 工作流：创建项目 → 添加剧集 → 编写剧本 → 创建设定（角色/场景/道具） → 创建分镜 → 创建会话 → AI 生成
2. 项目隔离：建议为每个创作任务创建独立项目
3. 剧集组织：按集号顺序创建，便于管理
4. 剧本格式：建议使用标准剧本格式，包含场景、对白、动作描述
5. 设定分类：角色（role）、场景（scene）、道具（prop）三类
6. 分镜创建：按场次序号（scene-order）顺序创建，用 --number 批量创建空分镜
7. 本地文件：图片和音频支持本地路径，CLI 会自动上传处理
8. 会话管理：会话用于保存 AI 生成上下文，删除时可迁移记录到其他会话