用途:tella-pp-cli 是驱动 Tella API 的命令行工具,适合批量剪辑、跨视频转写搜索、导出流水线和 Webhook 处理器开发等自动化场景;本地 SQLite 存储便于对同一工作区反复查询。
安装与验证:npx -y @mvanhorn/printing-press-library install tella --cli-only;验证 tella-pp-cli --version。若安装失败可用 go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/tella/cmd/tella-pp-cli@latest(需 Go 1.26.6+)。
鉴权:设置 TELLA_API_KEY(Account → Settings → API),以 Bearer 发送;用 tella-pp-cli doctor 验证。
主要能力:transcripts search 对缓存转写做 FTS5 搜索;videos viewed 汇总 Webhook 观看里程碑;workspace stats 输出本地统计;webhooks tail/replay 无需公网隧道即可调试;videos clips clean、videos clean、clips edit-pass 支持去填充词、去静音、修剪边缘等批量剪辑,默认预览,需 --apply 生效;exports wait 等待导出完成;transcripts 读取与 corrections、transcript-diff、captions 生成 SRT/VTT。
可用命令组:playlists、videos、webhooks,另有 which 用自然语言匹配命令。--agent 展开为 --json --compact --no-input --no-color --yes;支持 --select、--dry-run、--deliver file:webhook: 等。
限制:find-mistakes 属于非官方 API,需从浏览器复制会话 Cookie 到 TELLA_SESSION_COOKIE,可能随时失效;撤销检查为建议性而非原子;整体静音、videos apply-edits 创建剪辑等未在公开 schema 中提供,请勿臆造。部分信息暂未提供。