技能介绍

为何需要 WorkRally CLI

在利用 AIGC 技术进行漫画或动画剧集创作时，开发者和 AI Agent 面临着一个复杂的流水线：需要管理项目结构、上传和组织海量素材、利用多种 AI 模型生成图像、动画和语音，并将它们组装到无限画布中。手动调用底层 API 或依赖 Web 界面进行批量操作，既难以自动化，也容易因参数错误或步骤缺失导致生成失败。WorkRally CLI 正是为解决这一痛点而设计，它将平台的 30 余项核心 API 能力封装成一套连贯、可组合的命令行工具，专为 AI Agent 的程序化调用而优化。

核心能力与工作流

该 CLI 的核心在于将复杂的创作流程分解为确定的命令与步骤。其工作流程通常围绕“资产先行”和“生成后置”的原则展开。

资产管理是创作的基石。它严格区分了两种资产容器：

媒资库 (asset)：是项目级的原始文件池。所有本地或外部文件都必须通过 workrally upload 命令先上传至此，获得一个平台官方 URL。这是后续一切操作（如 AI 生成引用素材）的唯一合法资产来源。
资产库 (material)：提供了一个树形目录结构（如人物、道具、场景文件夹），用于逻辑化管理资产。其素材只能从媒资库中“挂载”，而非直接上传。

AI 生成与场次创作是流程的核心。创建场次后，通过向其写入 image_prompt、animation_prompt 和 audio_prompt 来定义生成内容。关键步骤包括：

动态获取模型 ID：使用 image-models、video-models 等命令实时查询可用模型，严禁硬编码。
检查生成配置：在调用生成命令前，务必用 shotlist get 确认场次的 extra.gen_config 中已正确配置了对应的模型。
执行生成与状态查询：生成命令仅提交任务，不直接返回结果。必须使用 shotlist get-result 来轮询和获取最终生成的画布节点信息。

适用边界与关键注意事项

WorkRally CLI 是一个面向 AI Agent 的深度集成工具，而非面向终端创作者的桌面应用。其有效使用建立在以下认知之上：

强依赖 API 体系与资产逻辑：工具深度绑定 WorkRally 平台的概念（项目、画布、媒资库、资产库）。不遵循“上传->入媒资库->挂载”的资产流水线，或混淆画布 (canvas) 与项目 (project) 的 ID，是导致操作失败的最常见原因。
所有操作围绕“可复现”与“自动化”设计：默认输出格式为 JSON (-o json)，便于 Agent 解析；关键操作如 build-draft 支持增量合并与多人并发，旨在保障自动化流程的可靠性。
严格遵守链接与命名规范：任何需要 URL 的地方（如生图、生视频的素材参数），只能接受通过 workrally upload 或 asset get/search 返回的官方 URL。此外，素材命名 (--name) 应遵循“画布名_特征”或“prompt关键词”的约定，以利于资产检索。

总而言之，WorkRally CLI 将漫剧视频创作的全流程“代码化”，是构建自动化、可编程 AIGC 内容生产线的基础设施。

截图预览

使用场景

当需要为项目批量上传数百张角色设定图，并统一挂载到资产库的“角色”目录下时，使用 `workrally upload` 和 `asset create` 命令实现自动化管理。
在策划动画短片时，需要为30个分镜场次（shot）批量配置不同的图像生成模型和视频生成模型，可通过 `shotlist update` 结合 `image-models` 动态获取的模型ID完成。
在无限画布上组装最终视频时，需要根据剧本将多个生成的图片、视频和音频节点，通过 `canvas build-draft` 命令精确添加到指定画板位置并建立关联。
当拿到外部配音演员的音频文件，需要将其设为特定角色的标准音色，并后续在场次音频生成中通过 `audio_prompt` 中的 `@音色名` 引用时，需完成从上传到资产库的全流程。

适合人员

内容工作室的AI研发工程师：需要构建自动化流水线，将剧本文本批量转化为可直接导入剪辑软件的音视频素材序列。
动画/漫剧团队的技术美术（TA）：需要将WorkRally的AI生成与资产管能力，无缝集成到团队现有的Maya、Premiere或内部管线中。
AI应用开发者：正在开发一款剧情生成或分镜预览工具，需要通过CLI为后端AI Agent提供强大、稳定的底层创作引擎API。
独立的AIGC内容创作者：希望超越简单的单图生成，通过脚本自动化管理整个短剧项目，实现从分镜到成片的半自动流水线。

WorkRally 命令行工具