workrally
WorkRally CLI (workrally) — 面向 AI Agent 的 AIGC 漫剧视频创作全流程工具集。支持 AI 生图、AI 生视频(含样片 draft)、视频提示词优化、画布生音频/音乐、混元 3D 模型生成、AI 生音频、项目/剧集/场次/分镜的完整 CRUD、资产库、媒资管理、企业知识库检索与写入、无限画布、文件上传下载等。Use when user asks to generate images, generate videos, generate audio, generate music, generate 3d, optimize video prompts, manage projects, series, shots, search or write a knowledge base, upload files, download assets, manage materials, or interact with WorkRally platform via command line.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/tencent--workrally)HTML
<a href="/listings/tencent--workrally"><img src="/api/listings/tencent--workrally/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 261 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: workrally
- slug: workrally
- displayName: WorkRally
- display_name: WorkRally
- display_name_en: WorkRally
- description: WorkRally CLI (workrally) — 面向 AI Agent 的 AIGC 漫剧视频创作全流程工具集。支持 AI 生图、AI 生视频(含样片 draft)、视频提示词优化、画布生音频/音乐、混元 3D 模型生成、AI 生音频、项目/剧集/场次/分镜的完整 CRUD、资产库、媒资管理、企业知识库检索与写入、无限画布、文件上传下载等。Use when user asks to generate images, generate videos, generate audio, generate music, generate 3d, optimize video prompts, manage projects, series, shots, search or write a knowledge base, upload files, download assets, manage materials, or interact with WorkRally platform via command line.
- description_zh: 面向 AI Agent 的 AIGC 漫剧视频创作全流程工具集,支持 AI 生图/生视频/生音频、项目剧集场次管理、资产库、企业知识库与无限画布。
- description_en: End-to-end AIGC comic-drama creation toolkit for AI Agents—image/video/audio generation, project/series/shot management, asset library, enterprise knowledge base, and infinite canvas.
- tags: [AIGC, CLI, 漫剧, 生图, 生视频, 生音频, 项目, 剧集, 场次, 画布, 资产库, 知识库]
- version: 2.12.0
- license: MIT-0
- author: WorkRally Team
- homepage: https://workrally.qq.com
- user-invocable: true
- metadata: {"openclaw":{"emoji":"🎬","requires":{"bins":["workrally"],"env":["WORKRALLY_API_KEY","WORKRALLY_ENDPOINT","WORKRALLY_CONFIG_DIR","WORKRALLY_NO_UPDATE_CHECK"]},"primaryEnv":"WORKRALLY_API_KEY","credentials":{"storage":"~/.workrally/config.json","configDirEnv":"WORKRALLY_CONFIG_DIR","description":"workrally auth login 写入的登录态:API Key,或 OAuth access/refresh token,以及 endpoint。非持久化容器中可通过 WORKRALLY_CONFIG_DIR 环境变量指定配置目录"},"install":[{"id":"npm","kind":"node","package":"workrally","bins":["workrally"],"label":"Install WorkRally CLI (npm)"}],"category":"AIGC","tags":["workrally","aigc","cli","video-generation","image-generation","ai-tools","story","shot","series"]}}
- ---
- # WorkRally CLI (workrally)
- 面向 AI Agent 的 AIGC 漫剧视频创作全流程命令行工具,封装 WorkRally 平台 30+ 核心能力,支持项目/剧集/场次的完整 CRUD、AI 生图/生视频、画布、资产库、媒资管理、文件上传等。
- ## 安装 & 配置
- ```bash
- npm install -g workrally
- # 配置登录。Agent / CI 只用 API Key,不要自己实现 OAuth,也不要请求 127.0.0.1 回调。
- workrally auth login --token <YOUR_API_KEY> # Agent / CI
- export WORKRALLY_API_KEY=<YOUR_API_KEY> # 环境变量优先于配置文件
- workrally auth login # 仅人在本机终端使用,CLI 自己打开浏览器
- # ↑ auth login 自动将 Token 写入配置文件:
- # 若 WORKRALLY_CONFIG_DIR 已设置 → $WORKRALLY_CONFIG_DIR/config.json
- # 否则 → ~/.workrally/config.json
- workrally auth status # 验证登录状态
- ```
- API Key 申请:[龙虾配置](https://workrally.qq.com/open-api)
- ## 命令速查
- ```bash
- # === 项目(project)— list / get / create / update / delete ===
- workrally project list [--search "关键词"] # 列出/搜索项目
- workrally project get <id> # 项目详情
- workrally project create "项目名" # 创建项目
- workrally project update <id> --name "新名称" # 更新项目
- workrally project delete <ids...> # 软删除(→回收站;恢复请到 Web)
- # === 剧集(series)— 全新命令组(CRUD 完整) ===
- workrally series list --project-id <id> # 剧集列表
- workrally series get <series_id> --project-id <id> # 剧集详情
- workrally series create --project-id <id> --name "第一集" # 创建剧集
- workrally series update <series_id> --project-id <id> --name "新名称" # 更新剧集
- workrally series delete <ids...> # 软删除(→回收站)
- # === 场次(shotlist)— 对齐 Web /shot 批量制作(含音频生成)===
- # --- CRUD ---
- workrally shotlist list --series-id <id> # 场次列表
- workrally shotlist get <story_id> # 场次详情
- workrally shotlist create --series-id <id> --json-list '[{"image_prompt":"..."}]' # 批量创建
- workrally shotlist update <story_id> --image-prompt "..." --animation-prompt "..." # 单条更新
- workrally shotlist update --batch '[{"story_id":"...","image_prompt":"..."}]' # 批量更新
- workrally shotlist delete <story_ids...> # 软删除(→回收站)
- workrally shotlist sort --series-id <id> --order id1,id2,id3 # 重排
- # --- 模型 & 配置(写入 extra.gen_config)---
- workrally shotlist models --category image,video,videoSmartEdit,upscale,audio # ⭐ 统一模型列表
- workrally shotlist set-model [--story-ids id1,id2] --image-model <id> --image-aspect-ratio 16:9 [--image-quality high] [--mj-params '{}']
- workrally shotlist set-model [--story-ids id1,id2] --video-mode SubjectToVideo --video-model <id> --duration 5 --video-aspect-ratio 16:9
- workrally shotlist set-model [--story-ids id1,id2] --extra-mode extendVideo --extend-source-id <asset_id> --duration 4 # 延长视频
- workrally shotlist set-model [--story-ids id1,id2] --audio-model <id> [--audio-config '{}'] # 配置音频
- workrally shotlist bind --story-id <id> --type audio --file ./voice.wav --project-id <id> # 本地素材:上传→入库→绑定
- workrally shotlist bind --story-id <id> --type image --assets '[{...}]' # 已入库素材绑定(audio→独立字段)
- workrally shotlist recognize --series-id <id> --project-id <id> [--scope both] [--match-rule symbol_text] # 识别(含音频路)
- # --- 生成(仅提交;查结果用 get-result [--watch])---
- workrally shotlist generate-image --project-id <id> --story-ids id1,id2 [--count N] # 生图 → get-result --type image
- workrally shotlist generate-video --project-id <id> --story-ids id1,id2 # 生视频 → get-result --type video
- workrally shotlist upscale-video --project-id <id> --story-ids id1,id2 --model <id> # 已选视频超分
- workrally shotlist generate-audio --project-id <id> --story-ids id1,id2 [--count N] # ⭐ 生音频 → get-result --type audio
- workrally shotlist get-result --story-id <id> --type image|video|audio [--watch] # 查进度与产物
- # === 企业知识库(仅企业账号;写入前必须让用户逐级确认,详见 references/knowledge-guide.md)===
- workrally kb list [--category project,personal] [--format json]
- workrally kb search --kb-id <id> --query "设定" # --os 默认按本机推断
- workrally kb card-list --kb-id <id> # 一次只查用户已选定的一个库
- workrally kb upload ./设定.pdf # 直传,不带 Content-Type。不要用 workrally upload
- workrally asset create --url <file_url> --status 3 --channel kb
- workrally kb raw-create --kb-id <id> --card-id <id> --directory /设定 --name 主角.md --content "..."
- # 现成文件用 --asset-id,不要把原文塞进 --content
- # === 上传 / 下载 ===
- workrally upload ./file.png -o json # 上传文件 (COS SDK 直传)
- workrally download <asset_id> [-d ./output/] # 下载素材 (自动处理访问凭证)
- # === AI 生图 ===
- workrally generate image-models # 查看可用模型(必须先调用!)
- workrally generate image --prompt "描述" --model <model_id> [--aspect-ratio 16:9] [--resolution 5] [--quality high] [--input-images "url"] --poll
- # --resolution 推荐用 image-models 的 resolution_options[].value(常见 4=1080P/5=1440P/6=2160P);旧档位 0/1/2 仍可用
- # --quality 仅当 image-models 该模型返回了 infer_quality_options 时才传(取值用其中的 value)
- # --extra-params '{"midjourney":{"stylize":100}}' 扩展参数 JSON 对象;CLI 传 extraParams,服务端写成 extra_params
- # === AI 生视频 (6 种驱动模式) ===
- workrally generate video-models # 查看可用模型(必须先调用!)
- workrally generate video --prompt "描述" --model <provider_id> --poll # 纯文生视频(默认 Text 模式)
- workrally generate video --prompt "描述" --model <provider_id> --single-image-url "url" --poll # 图生视频(Text 模式 + 参考图)
- workrally generate video --mode FirstLastFrame --prompt "描述" --model <provider_id> --first-frame-url "url" --poll # 首尾帧
- workrally generate video --mode VideoEdit --prompt "描述" --model <id> --origin-video <asset_id> \
- --reference-assets '[{"type":"image","asset_id":"<参考图>"}]' --poll # 视频编辑。参考图必须是 image,服务端写入 ref_images
- # 其他模式: SubjectToVideo(--reference-assets,可含 image/video/audio/file)
- workrally generate video --mode SmartEdit --model <id> --source-video <asset_id> --source-width 1920 --source-height 1080 --source-duration 5000 --poll
- # SmartEdit 选中 Rally-Video-Edit-2.0(6cdvjhqm6e)时,服务端改走 video_edit:源片→origin_video,--reference-assets 只能是图片并写入 ref_images。提示词必填。不要传视频/音频/文档参考
- workrally generate video --mode ExtendVideo --model <id> --source-video <asset_id> --duration 8 --poll
- # SubjectToVideo 的 --reference-assets 支持 file 文档(Wan 3.0):{"type":"file","asset_id":"...","name":"brief.pdf"}
- # --mode 默认 Text;通用选项: --aspect-ratio <比例> --resolution <枚举> --duration <秒> --count 1-4 --poll
- # 音效默认开启(与前端一致);关闭用 --no-enable-sound。旧 VideoEdit 模板不写 enable_sound;6cdvjhqm6e 由服务端写入,默认 true
- # --aspect-ratio 默认 16:9;--resolution 不传取模型首个可用(枚举见 video-models 的 resolution_options)
- # 样片:仅 support_draft=true。样片 --resolution 1 --draft '{"enable":true}';转正片同一模型 --resolution 4 --draft '{"draft_id":"<样片素材ID>"}'
- # 场次配模型把同一 JSON 交给 shotlist set-model --draft,写入 gen_config.video.draft
- # === 画布生音频 / 音乐(对齐 Web 画布音频生成器)===
- workrally generate audio-models # 查看 audio_models / music_models(必须先调用!)
- workrally generate audio --prompt "雨声和脚步" --model <id> --poll
- workrally generate music --prompt "摇滚吉他" --model <id> --lyrics-mode none --poll
- workrally generate music --prompt "流行" --model <id> --lyrics-mode input --lyrics "啦啦啦" --poll
- # MiniMax 音频模型不要传 --ref-audios;动态音色参数从模型 fields 获取后用 --audio-fields JSON 传入
- # === 混元 3D 模型(对齐 Web 关键帧混元3D,不是世界生成/贴图)===
- workrally generate 3d --asset-id <参考图asset_id> --poll
- # 须先 asset search / asset create 得到 asset_id;模型固定 hunyuan-3d-v3.0
- # ⚠️ --project-id 是短番项目ID,不是画布ID
- # === 视频提示词优化(gen_content,产物是文本不是视频)===
- workrally generate content-models # 查看可用模型(必须先调用!严禁硬编码 MiniMax H3 等 ID)
- workrally generate optimize-prompt --prompt "将视频从尾帧延长5秒" --model <model_id> \
- [--video-url <url>] [--first-frame-url <url>] [--last-frame-url <url>] \
- [--reference-image-urls "url1,url2"] [--audio-url <url>] [--audio-urls "a.mp3,b.mp3"] --poll
- # 图片语义写在 image_info.type:first_frame / last_frame / reference_image;音频写在 audio_info.url(type=3)
- # 成功后从 generate task 的 output_text 读取优化后的提示词(output_type="text"),不要找 output_assets
- # === 媒资库 (asset) — 项目级媒体文件池 ===
- workrally asset create --url <cdn_url> --project-id <id> -o json # 入库(返回可访问 URL)
- workrally asset search --project-id <id> [--type image] [--audit-status 5] [--auth-status 1]
- workrally asset get <asset_id> # 详情
- workrally asset update <asset_id> --name "新名称" # 更新素材 (目前仅支持改名)
- # === 资产库 (material) — 树形管理:人物/道具/场景/网盘 ===
- workrally material list role_person # 人物 | role_prop 道具 | role_scene 场景 | root 网盘文件夹
- workrally material add ... # 创建素材/文件夹(从媒资库挂载)
- workrally material get <material_id> # 素材详情
- workrally material delete <material_id> # 删除(不可恢复,须用户确认)
- workrally role get <role_id> # 角色详情(LoRA/提示词/版本)
- # === 画布 ===
- workrally canvas list # 列出画布
- workrally canvas create "名称" # 创建画布
- workrally canvas build-draft <canvas_id> --file nodes.json # 增量合并(默认保留已有节点)
- workrally canvas build-draft <canvas_id> --nodes '[...]' # 同上,直接传 JSON
- workrally canvas build-draft <canvas_id> -d "id1,id2" # 删除指定节点
- workrally canvas build-draft <canvas_id> -n '[...]' -d "old1" # 同时增删改
- workrally canvas build-draft <canvas_id> -n '[...]' --mode overwrite # 全量覆盖(清空后重建)
- # === 任务查询 ===
- workrally generate task <task_id> [--poll] # 查询/轮询生成任务状态
- # 生图/生视频成功:output_type="assets",产物在 output_assets
- # 提示词优化成功:output_type="text",产物在 output_text(不要找 output_assets / output_products)
- # === 通用(仅查看白名单,禁止透传调用)===
- workrally tools list # 列出核心白名单工具
- workrally tools describe <tool_name> # 查看参数 schema
- # 不要使用 tools call;未列出的 MCP 工具已禁止调用。关键帧/配音/动效请用 Web。
- # === URL / 升级 ===
- workrally url build "页面名" [--params '{}'] # 构建 WorkRally 前端链接
- workrally url parse <url> # 解析 URL
- workrally upgrade [--check] # 升级 / 仅检查
- ```
- 输出格式: `-o json`(默认, Agent 推荐) | `-o table`(人类阅读) | `-o text`(管道/脚本) | `workrally config set output_format <fmt>`
- ## 关键工作流:上传文件
- **概念**:媒资库(asset) = 项目级文件池;资产库(material) = 树形目录(人物/道具/场景/网盘文件夹)。资产库的素材只能从媒资库挂载。
- ```bash
- # 步骤 1: 上传 → CDN URL
- workrally upload ./character.png -o json
- # 步骤 2: 入媒资库(必须!返回 asset_id + asset_details)
- workrally asset create --url <cdn_url> --project-id <project_id> -o json
- # 步骤 3(按需): 挂载到资产库(必传 asset_id + 完整 asset_details)
- workrally material add --json-list '[{"material_id":"<asset_id>","material_name":"名称","material_type":2,"parent_id":"<target_id>","material_detail":<asset_details_json>}]' \
- --project-ids <project_id>
- ```
- > **步骤 1→2 强制绑定**,上传后必须入媒资库。视频/音频为私有读,需经媒资库才能正常访问。
- >
- > **步骤 3 由 Agent 判断**:"上传文件" → 两步 | "上传到角色/道具/场景/文件夹" → 三步 | "媒资素材添加到资产库" → 仅步骤 3
- ## 关键工作流:场次创作(`shotlist`,对齐 Web /shot)
- **概念层级**:项目 (project) → 剧集 (series) → 场次 (shot/story)。一个场次含 图片 / 视频 / **音频** 三条生成线,核心由提示词承载:`image_prompt`(图片)、`animation_prompt`(视频)、`extra.audio_prompt`(音频,音色用 `<音色名>` 引用)。生成配置聚合在 `extra.gen_config.{image,video,audio}`。
- ```bash
- # 1) 建剧集 + 批量创建场次(按用户意图填提示词)
- workrally series create --project-id <pid> --name "第一集" -o json
- workrally shotlist create --series-id <sid> --json-list '[{"image_prompt":"古风庭院","animation_prompt":"镜头缓推"}]'
- # 2) 识别角色资产(三路:image/animation/audio;音色用 <> 时加 --match-rule symbol_text)
- workrally shotlist recognize --series-id <sid> --project-id <pid>
- # 3) 选模型 → 写配置(模型 id 来自 shotlist models,勿硬编码)
- workrally shotlist models --category image,video,audio -o json
- workrally shotlist set-model --series-id <sid> --image-model <id> --image-aspect-ratio 16:9 \
- --video-mode SubjectToVideo --video-model <id> --duration 5 --video-aspect-ratio 16:9 --audio-model <id>
- # 4) 生成(多场次传 --story-ids id1,id2,id3;均需 --project-id)
- workrally shotlist generate-image --project-id <pid> --story-ids <ids>
- workrally shotlist generate-video --project-id <pid> --story-ids <ids>
- workrally shotlist generate-audio --project-id <pid> --story-ids <ids>
- # 5) 查结果(image/video/audio 三条独立进度,分别 watch)
- workrally shotlist get-result --story-id <sid> --type image --watch
- workrally shotlist get-result --story-id <sid> --type video --watch
- workrally shotlist get-result --story-id <sid> --type audio --watch
- ```
- > **生成前先确认配置**:用 `shotlist get <id>` 检查 `extra.gen_config` 是否已设对应模型;缺则回到步骤 3。生成只返回提交结果,不返回可轮询的画布 task_id,进度一律用 `shotlist get-result`。
- ## ⚠️ 重要规则
- 1. **前端链接必须用 `workrally url build` 生成**,严禁自行拼接 URL
- 2. **模型 ID 必须动态获取**:`image-models` / `video-models` / `audio-models` / `content-models`,严禁猜测或硬编码。场次批量制作使用 `shotlist models`;音频模型返回的 `capabilities/fields/restrictions` 也应一并用于配置。混元 3D 固定 hunyuan-3d-v3.0,只需 `--asset-id`
- 3. **`canvas` ≠ `project`**:画布用 `canvas`,项目用 `project`,两者 ID 不能互换
- 4. **`build-draft` 实时协同**:写入后所有在线用户立即看到变更,默认增量合并(只传变更节点),支持多人并发安全操作
- 5. **`build-draft` 节点校验**:8种节点类型各有必填字段,详见 [`canvas-guide.md`](references/canvas-guide.md)
- 6. **AI 生成自动占位**:`generate image/video` 传入 `--project-id`(画布ID)后自动在画布创建占位节点,**无需**再手动 `build-draft`
- 7. **素材命名**:`--name` 传入"画布名_素材特征"(画布场景)或 prompt 关键词(非画布场景)
- 8. **不确定参数时**用 `--help` 或 `tools describe` 自行探索
- 9. **URL 白名单**:所有 URL 类参数(生图/生视频的 `--*-url` / `--*-assets` / `--*-images`、`asset create --url` 等)仅接受 WorkRally 官方媒资 URL。合法来源:① `workrally upload` 返回值 ② `asset get/search` 返回值(可直接传入) ③ 用户已提供的官方 URL。本地文件或第三方 URL 必须先 `workrally upload`。如遇"非法或已过期"提示,通过 `asset get/search` 重新获取即可。
- ## 📚 深度指南 (references/)
- 本 Skill 附带详细参考文档,覆盖复杂工作流:
- | 文档 | 内容 |
- |------|------|
- | [`references/shotlist-guide.md`](references/shotlist-guide.md) | ⭐ **场次批量制作**(对齐 Web `/shot`)— CRUD、gen_config、生图/生视频/**生音频**、结果查询、符号识别 |
- | [`references/canvas-guide.md`](references/canvas-guide.md) | 无限画布操作 — 8种节点类型、画板嵌套、build-draft 增量/覆盖模式、协同编辑 |
- | [`references/upload-and-assets-guide.md`](references/upload-and-assets-guide.md) | 上传与素材管理 — 三步上传流程、媒资库 vs 资产库、树形目录操作 |
- | [`references/knowledge-guide.md`](references/knowledge-guide.md) | 企业知识库 — 检索、目录、资产,以及确认后的建库 / 建卡 / 写入 |
- | [`references/ai-generation-guide.md`](references/ai-generation-guide.md) | AI 生成 — Kontext 生图、4种视频驱动模式、画布音频/音乐、混元 3D 模型、提示词优化、模型动态获取、任务轮询 |
- | [`references/common-pitfalls.md`](references/common-pitfalls.md) | 常见易错点 — 项目/画布混淆、模型硬编码、上传缺步骤等典型错误 |
- > 遇到画布、上传、AI生成相关的复杂操作时,请优先查阅对应的参考文档。
- ## 环境变量
- - `WORKRALLY_API_KEY` — API Key (Bearer Token)。设置后优先于 `auth login` 保存的 OAuth 登录态
- - `WORKRALLY_ENDPOINT` — API 端点 (默认 `https://workrally.qq.com/zenstudio/api/mcp`)
- - `WORKRALLY_CONFIG_DIR` — 配置文件目录 (默认 `~/.workrally`,非持久化容器建议指向持久卷)
- - `WORKRALLY_NO_UPDATE_CHECK=1` — 禁用自动版本检查 (CI/CD 推荐)
README.md · README · 46 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # WorkRally CLI — Agent Skill
- 🎬 面向 AI Agent 的 AIGC 漫剧视频创作全流程工具集。
- 本目录是 WorkRally CLI 的 Agent Skill 定义。
- ## 目录结构
- ```
- skill/
- ├── SKILL.md ← Skill 入口(元数据 + 指令),ClawHub 解析此文件
- ├── LICENSE.txt ← 许可证
- └── references/ ← 深度参考文档,AI Agent 按需加载
- ├── ai-generation-guide.md AI 生成指南(含样片 draft)
- ├── canvas-guide.md 无限画布操作指南
- ├── common-pitfalls.md 常见易错点
- ├── knowledge-guide.md 企业知识库检索与写入指南
- ├── shotlist-guide.md 场次批量制作(对齐 Web /shot)
- └── upload-and-assets-guide.md 上传与素材管理指南
- ```
- ## 核心能力
- - **AI 生图** — Kontext 模型,支持多参考图、可选推理质量
- - **AI 生视频** — 4 种驱动模式(文本/首尾帧/参考主体/视频编辑),支持低成本样片(draft)生成与成片升级
- - **提示词优化** — gen_content 文本任务,产物为 `output_text`
- - **无限画布** — Yjs 协同编辑,8 种节点类型,实时同步
- - **项目 & 媒资管理** — 项目 CRUD、素材上传入库、资产库树形管理
- - **企业知识库** — 知识库/知识卡片检索、资产级与正文级知识写入
- - **通用透传** — 可调用 WorkRally MCP Server 全部工具
- ## 第三方商店
- - [SkillHub](https://skillhub.cn/skills/workrally)
- - [ClawHub](https://clawhub.ai/tencent-adm/workrally)
- - [Skills](https://skills.sh/tencent/workrally/workrally)
- ## 快速开始
- ```bash
- npm install -g workrally
- workrally auth login
- workrally auth status
- ```
- 详细用法、命令速查、工作流指南请参阅 **[SKILL.md](./SKILL.md)**。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.