用途：twelvelabs-pp-cli 是封装 Twelve Labs 视频理解 API 的 Printing Press CLI，供智能体从长视频中提取信息，输出 JSON 或 Markdown 形式的编辑指引，无需完整观看视频。
主要能力：编辑器工作流命令，包括 upload-video（上传本地文件或注册公开 URL，并轮询索引状态至终态）、video-brief（生成含标题、话题、标签、章节、精彩片段和推荐剪辑的 JSON/Markdown 编辑方案）、embed（从本地文件或 URL 创建视频嵌入任务，可选等待结果）、clips（依据 video-brief JSON 方案用 ffmpeg 生成本地切片，时间戳不自行编造）。另有 analyze、assets、embed-v2、entity-collections、indexes、tasks、video-search 等端点镜像命令，以及 which 命令按自然语言能力描述匹配命令。
使用方式：先安装 CLI，macOS/Linux 默认装到 $HOME/.local/bin，Windows 装到 %LOCALAPPDATA%\Programs\PrintingPress\bin： npx -y @mvanhorn/printing-press-library install twelvelabs --cli-only 安装失败可回退（需 Go 1.26.6 或更新）： go install github.com/mvanhorn/printing-press-library/library/ai/twelvelabs/cmd/twelvelabs-pp-cli@latest 用 twelvelabs-pp-cli --version 验证，并确保安装目录在 $PATH 中。 鉴权：twelvelabs-pp-cli auth setup 给出获取密钥的 URL 与步骤，然后设置 TWELVELABS_X_API_KEY，或写入 ~/.config/twelvelabs-video-understanding-pp-cli/config.toml；用 twelvelabs-pp-cli doctor 验证。 智能体模式：任意命令加 --agent，等价于 --json --compact --no-input --no-color --yes；--select 可裁剪字段，--dry-run 预览请求，输出包裹在 meta/results 信封中。还支持 profile 保存、--deliver 输出到 stdout/file/webhook、feedback 本地记录，以及 0/2/3/4/5/7/10 等退出码。
适用场景：长视频编辑、精彩片段定位、索引与嵌入检索、按提示分析视频、需要非交互可管道化输出时。
限制：需先安装并配置 API 密钥；部分端点（如 gist、summarize 及部分 embed 接口）标注将弃用或下线；上传大小上限、价格与更多平台细节资料未提供。