核心功能
ZenStudio CLI（zencli）是腾讯推出的 AI 内容创作全流程命令行工具，封装 ZenStudio 平台 19+ 核心能力，面向开发者和自动化工作流场景设计。
主要能力覆盖：
- AI 生成：文生图、图生视频、文生视频、首尾帧驱动等多模态生成能力，支持 4 种视频驱动模式
- 项目管理：项目创建、搜索、详情查询与更新
- 媒资与资产：COS 直传文件、素材入库、树形资产库管理（人物/道具/场景/网盘）
- 无限画布：画布创建、节点增量/全量编辑、多人实时协同
- 任务追踪：生成任务状态轮询查询
- MCP 透传：可调用任意底层 MCP 工具
交互设计：支持 JSON/表格/文本三种输出格式，配置持久化存储于 ~/.zencli/config.json，适配 CI/CD 与容器环境。
显著优点
- 官方背书：腾讯 ZenStudio 团队维护，API 稳定性与功能更新有保障
- 功能完整：覆盖从文件上传、AI 生成到资产管理的完整内容生产链路
- 自动化友好：CLI 设计原生支持脚本化、管道化集成
- 输出灵活：JSON 输出便于 Agent 解析，table 输出便于人工审阅
- 协同安全：画布
build-draft采用增量合并策略，支持多用户并发编辑不覆盖
潜在局限
- 品牌弃用风险：已于 2024 年底官方公告升级至 WorkRally，当前 Skill 进入维护模式，新功能不再发布
- 迁移成本：命令行从
zencli变更为workrally，npm 包名、环境变量、配置文件路径均需调整 - 配置依赖：需妥善管理
ZENSTUDIO_API_KEY及配置文件持久化，容器场景需额外配置ZENCLI_CONFIG_DIR - 学习曲线：19+ 条子命令及 canvas 节点数据校验规则需要一定熟悉时间
适合人群
- 需批量自动化 AI 生成图片/视频的开发者与运维团队
- 构建内容生产 pipeline 的 MLE/SDE 工程师
- 已有 ZenStudio 平台账号、希望 CLI 化工作流的高级用户
- 计划迁移至 WorkRally、需评估兼容性的存量用户
常规风险
- API Key 泄露：Token 存储于本地 JSON 文件，共享环境或容器镜像需严格管控权限
- 误操作覆盖：
build-draft --mode overwrite会清空画布，需确认后再执行 - 模型 ID 过期：
image-models/video-models需动态获取，硬编码可能导致任务失败 - 版本停滞：官方明确不再更新，长期使用建议迁移 WorkRally
- 私有读签名：视频/音频素材必须通过
asset create入库获取签名 URL，直接访问 CDN 会失败
---
> 迁移建议：新项目请直接使用 npm install -g workrally 及对应 Skill，本 Skill 仅用于存量系统过渡维护。