核心用法
ZenStudio CLI (zencli) 是腾讯视频智能（TVI）旗下 AI 内容创作平台的官方命令行工具，封装了 19+ 项核心能力，覆盖 AI 生成、项目管理、媒资库、资产库、无限画布等完整工作流。
主要功能模块：
- AI 生成：支持多模型生图（
generate image）与四种视频驱动模式（Text/FirstLastFrame/FrameSequence/SubjectToVideo） - 项目管理：创建、查询、更新短番项目
- 媒资与资产：文件上传下载（COS 直传）、媒资库入库、树形资产库挂载（人物/道具/场景）
- 无限画布：创建画布、增量/全量节点编辑、实时多人协同（
build-draft实时生效） - 通用透传：
tools call可调用任意 MCP 工具，保持向前兼容
关键工作流：上传文件需「上传→入媒资库→（可选）挂载资产库」三步，视频/音频私有读需入库后才带签名 URL。
输出格式：支持 JSON（Agent 推荐）、table（人类阅读）、text（管道脚本）。
显著优点
1. 官方出品，生态完整：腾讯官方维护，与 ZenStudio 平台深度集成，功能覆盖 AIGC 全流程
2. 实时协同能力：画布编辑实时同步，CLI 与浏览器用户可安全并发操作同一画布
3. 增量更新设计：build-draft 默认增量合并，仅传变更节点，降低带宽与冲突风险
4. 灵活的透传机制：tools 子命令可调用任意 MCP 工具，避免 CLI 版本滞后于平台能力
5. 多环境配置支持：支持交互式登录、环境变量、配置文件持久化，适配本地开发与 CI/CD
潜在局限
1. 模型 ID 需动态获取：必须先调用 image-models/video-models 获取可用模型，无法硬编码，增加脚本复杂度
2. 强制媒资入库：上传后必须入媒资库才能使用，多一步操作，对纯文件上传场景不够直观
3. 资产库挂载复杂：素材添加到资产库需同时传入 asset_id 与完整 asset_details JSON，参数冗余
4. 画布节点校验严格：关键字段（如 asset.id、text.content、freehand.points）缺失时无法自动修正
5. 依赖腾讯云服务：COS 上传、签名 URL 等强绑定腾讯生态，跨云迁移成本较高
适合人群
- AIGC 内容团队：需要批量生成、管理 AI 图像/视频的制片、运营团队
- 自动化工作流开发者：希望将 ZenStudio 能力集成到 CI/CD、批处理脚本的技术人员
- 短番/短视频创作者：使用 ZenStudio 画布进行协作创作，需 CLI 辅助批量操作的用户
常规风险
- API Key 泄露风险：
auth login持久化存储于~/.zencli/config.json，共享环境或持久化卷配置不当可能导致密钥泄露 - 实时协同冲突：虽然支持并发，但
--mode overwrite全量覆盖可能误删其他用户节点 - 模型可用性变动：动态获取模型 ID 意味着模型下线/变更可能导致脚本失效，需增加错误处理
- 私有读 URL 过期：媒资库签名 URL 有时效性，长期引用需重新获取