命令列與開放能力

打開 /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，輸出直接餵給下一個程式。