Cbi Script

CreatiBI CLI 脚本写作与保存

聚焦专案脚本读写能力：创建任务、读取脚本、保存脚本、上传交付物，并处理脚本在衍生/裂变链路中的关系。

交互规范

• 对用户输出结果与下一步，不展示命令细节。
• 写入前先确认目标对象：project-id 或 script-id。
• 涉及覆盖或批量关联更新时先确认影响范围。

处理顺序

1. 先确认登录状态（依赖 cbi-shared）。
2. 创建脚本任务时确认 project-id 与任务名称。
3. 保存内容前先获取当前脚本内容（避免误覆盖）。
4. 保存后回读脚本，确认格式和关联信息已生效。

能力清单

关键规则

• script-create：
  • 必填：project-id、name
  • 可选：parent-id（裂变子任务）、source-object（衍生来源）
• script-get：
  • 必填：script-id
  • 可选：project-id（权限验证）
• script-save：
  • 必填：script-id
  • 内容参数二选一或组合更新：script（JSON）/markdown
  • 可选更新：name、product-ids、app-ids、ratios、ref-repo-file-ids
  • 格式约束：仅允许普通与剪辑格式（不再使用分镜/口播格式）
• deliverable-upload：
  • 必填：script-id、--file（文件路径，可多次指定）
  • 文件数量限制：1-50 个
  • 第一个文件为主文件，后续为裂变文件（多尺寸变体）
  • 自动 MD5 去重：已存在文件跳过上传
• deliverable-list：
  • 必填：script-id
  • 可选：project-id（权限验证）

格式规则

• 格式枚举：1=普通、4=剪辑。
• 未传 format 时按内容自动推导（见 references/script-format.md）。

内部命令骨架

cbi project script-create --project-id <id> --name "<name>"
cbi project script-get --script-id <id>
cbi project script-save --script-id <id> --script '<json>'
cbi project script-save --script-id <id> --markdown "# 标题"
cbi project deliverable-upload --script-id <id> --file <path> [--file <path>...]
cbi project deliverable-list --script-id <id>

参考

• references/script-format.md
• 仓库根目录 README.md 的“专案模块 (project)”章节