命令行与开放能力

打开 /cli 这一页（左栏导航里那项命令行去的就是它，会另开一页），两种装法二选一：

• 通过 AI Agent 安装（默认那一栏）—— 把卡片里那一句提示词复制给你的 AI 助手（Claude Code、Cursor、Codex 都行），它自己会把 skill 装好。
• 手动安装 —— 两步：先跑卡片上那行 npm 命令，再按下一节登录。

它是个 npm 包，所以两步里的第一步全平台同一条命令，只要机器上有 Node.js 20 或更高版本：

npm i -g @dotv/cli

手动这条路只装了命令本身。再跑一条，把讲这些命令的手册也装上 —— 它写进 ~/.claude/skills，你的 AI 助手就是从那儿认这套命令的（只想装进当前项目就加 --dir .claude/skills）：

dotv skill install

同一条命令也是「更新手册」：已经是最新的那一份就一个字节都不写。升级 CLI 不会顺带更新它 —— 手上这份旧了的时候，dotv 会在下一条命令的输出里提醒你一行。装完记得重启你的 AI 助手，它才会读到新装的 skill。

命令行里没有浏览器，也不该让你把密码敲给它，所以走的是设备码那条路 —— 但你要敲的只有一句：

dotv login

它会打印一个带短码的网址，并试着帮你打开浏览器。核对屏幕上的码与终端里的是不是同一串，然后确认。那个网址可以在任意一台有浏览器的机器上打开 —— 这正是这条流程存在的理由：跑在服务器上的命令行压根没有浏览器。

确认之后不用再做任何事：它会自己把会话令牌换成一把长期密钥，存进 ~/.dotv/（权限 0600），之后的每条命令都走这把密钥。（agent 或 CI 想自己驱动设备码流程的话，四步与四种轮询结局在 auth.md 里。）

dotv login 发的那把密钥只存在你自己机器的 ~/.dotv/ 里，我们库里存的是它的哈希。

• 它不会因为你在网页上退出登录而失效，也不会自己过期。
• dotv api-key list 列出你发过的（只有前缀，看不到原文），dotv api-key delete --id <id> 单独吊销一把 —— 吊销立刻生效，没有缓冲期，也没有撤销。
• dotv whoami 告诉你这台机器现在连的是哪个站点、用的是哪把密钥，并当场去服务端验一次它还算不算数。
• dotv logout 只把本机存的那把从 ~/.dotv/ 里删掉，密钥本身还有效 —— 真要作废它得用上面那条 api-key delete。
• 换一台机器就再跑一次 dotv login；CI 里没有浏览器，走不了设备码，用 DOTV_API_KEY 环境变量直接给它一把建好的密钥。

密钥永远只属于你本人，团队里的其他人看不到。网页端没有创建密钥的入口，这件事只能在命令行里做。

除了装成 skill 让 AI 助手照着手册敲命令，dotv 自己也能当一个 MCP 服务器跑起来：Claude Code、Codex、Claude Desktop、Cursor 这类支持 MCP 的应用直接把它当工具用，不必再经过终端。

dotv mcp --print-config
claude mcp add "dotv" -- npx -y @dotv/cli mcp

第一条打印出可以粘进各家配置文件的那一段；第二条是 Claude Code 的一步到位。接上之后助手拿到三件工具：dotv（跑一条与命令行里一模一样的命令）、dotv_help（查手册）、dotv_wait（等一批节点生成完再回来），手册本身也作为资源挂在里面，不用另装 skill。用的还是 dotv login 存下的那把密钥，没有别的要配。

桌面端开着时，助手新建的节点、切换的项目就在你眼前的画布上发生，与你自己点的没有区别。 花积分的操作按你在 Agent 设置里定的规则确认 —— 由助手那头问你一句，不弹在最小化的窗口里。每个客户端第一次连上来，桌面端会问你是否允许，答过一次就记住；Agent 设置里列着所有连过的客户端，随时能关掉某一个。

助手做的每一件事也会进入这张画布的 Agent 时间线：它做了什么、动了哪个节点、生成是否完成，都能回到画布查看；你登录着的其他设备也会收到提示。没开桌面端时结果同样保存在云端项目里，回到画布就能看到。

给助手用的钥匙建议单独发一把、设上限，花到上限就停：

dotv api-key post --name "claude-code" --budget-credits 500

dotv <分组> <动作>

分组表示这条命令处理的东西，动作是它要做的事情，比如 dotv canvas list、dotv generate post-image、dotv model。选项名就是字段名，驼峰改成连字符：canvasId → --canvas-id。

完整手册就在 /cli 那一页的下半截：每条命令收哪些选项、什么类型、必填与否、返回什么，全在里面（也能直接打开 命令手册原文）。这一节不重复它 —— 命令手册会跟着 CLI 一起更新，永远以那边为准。

写批量脚本之前先查两眼的命令：

• dotv model（或 dotv model list）—— 现在能用的型号清单：key、规范名、挂在哪种节点上。加 --node-type video 只看一类，加 --keyword kling 按名字筛。
• dotv model --key <key> —— 这一个型号收哪些参数：每个参数的类型、可选值 / 取值范围、默认值、是否必填，照着写进 sync 的 data、或 post-generate 的 --params（单次覆盖）。

清单与网页端输入栏那颗型号下拉是同一份（型号与计价见 14.8）：界面上挑不到的型号，这里也查不到。

命令行看到的东西同样分空间（见 14.2）：

• 不带空间参数 = 个人空间；
• 带上 --x-team-id <团队 id> = 那个团队的空间（团队 ID 在团队管理抬头右端那颗「⋯」里，点一下就能复制）。

命令行跑生成花的是同一个钱包，计价与网页端是同一份口径（见 14.8）。三条命令帮你对账：

• dotv credits wallet —— 余额与流水。余额是三桶之和，返回里另有通用积分那一桶单独的数（两桶的区别见 14.3）；
• dotv credits estimate —— 先问价再决定要不要跑，一次能问一批（一份分镜表几十个镜头一起问是正常用法）；
• dotv membership —— 这个空间现在是什么档、到什么时候、每月多少积分、能同时跑几个任务。

每条命令都收 --json，输出直接喂给下一个程序。