CLI 用戶使用指南

NadouPro CLI 是什麼？

✈️ 讓 AI 進入創作流程的中轉站

從一句創意、幾張參考圖到分鏡和影片節點，你只需用自然語言說明目標。AI 助手透過 NadouPro CLI 呼叫已開放的創作能力，並在關鍵步驟向你確認。NadouPro 提供自由畫布、工作臺和智慧代理等創作入口；CLI 的實際範圍以當前版本為準。

把一次影視創作想像成片場協作：你負責提出創作意圖和做關鍵判斷，AI 助手負責拆解任務、呼叫工具和跟進結果，NadouPro 負責模型、素材、空間與自由畫布。NadouPro CLI 就是三者之間的工作通道。

它的價值不在於讓用戶學習命令，而在於讓 AI 助手能夠真正執行：選擇當前可用模型、讀取參考素材、提交圖片或影片生成、等待結果，並把結果交付到個人空間、團隊空間或指定自由畫布。

誰適合使用？

• 影視與內容創作者： 希望把角色設定、分鏡、鏡頭生成和素材整理交給 AI 助手執行。

• 創作團隊： 需要把結果放入團隊空間或自由畫布，繼續審閱、協作和迭代。

• 使用 Claude Code、Cursor 等 AI 工具的用戶： 希望直接在對話中呼叫 NadouPro，而不是反覆切換頁面和複製素材。

1. 📦快速安裝

方式一：AI 助手一鍵安裝

把下面這段話發給 AI 助手：

請幫我安裝 NadouPro CLI：npm install -g @iqiyi-intl-nadoupro/nadou-cli。 安裝完成後可執行 nadou version --json 驗證（需要 Node.js 16 或更高版本）

安裝器會完成三件事：

1. 安裝適配當前作業系統和 CPU 架構的 Nadou CLI。

2. 驗證 CLI 可以正常啟動，並輸出版本、commit 和建置時間。

3. 把同版本官方 Nadou Skill 同步到當前機器支援的全域 Agent。

安裝成功標準

nadou version --json 能正常回傳版本資訊，且 nadou skill read --json 中的 Skill 版本與 CLI 版本一致。

方式二：手動安裝

手動安裝教學

如果你希望自己在終端機中操作，執行：

npm exec --yes --registry=https://registry.npmjs.org/ --package=@iqiyi-intl-nadoupro/nadou-cli@latest -- nadou-install
nadou version --json
nadou skill install --json
nadou skill read --json

確認機器從未安裝過 Nadou CLI 舊版本時，也可以直接安裝 npm 套件：

npm install -g @iqiyi-intl-nadoupro/nadou-cli
nadou version --json
nadou skill install --json
nadou skill status --json

目前安裝器支援 Windows x64、Linux x64/arm64、macOS x64/arm64。Windows arm64 暫無預編譯套件。

首次授權登入

Agent 在執行需要帳號的操作前，應先檢查登入狀態，避免重複開啟瀏覽器：

nadou auth status --no-interactive --json

如果尚未登入，再執行：

nadou auth login --timeout 10m --json

1. CLI 嘗試開啟系統預設瀏覽器；如果當前環境不能自動開啟，會在輸出中提供同一個授權地址。

2. 在開啟的國際版登入頁點擊「Continue to international sign in」，再按登入視窗提示完成國際站帳號登入。

3. 授權成功後，CLI 自動驗證登入狀態；Agent 可以繼續原來的任務，不需要你再執行一條登入命令。

本指南使用國際公網版 CLI，預設連線國際站正式環境。該發行版僅支援正式環境。

伺服器或容器環境登入

如果 CLI 執行於伺服器、Docker/Claw 容器或無圖形介面的環境中，無法使用系統瀏覽器或系統憑證庫，可執行：

nadou auth login --server

CLI 會顯示登入網址和驗證碼，並等待授權結果。請在任意裝置的瀏覽器中開啟該網址，輸入驗證碼，完成登入並確認用於 CLI 的帳號；如需更換帳號，請選擇「切換帳號」。

登入成功後，憑證會儲存在目前 CLI 狀態目錄的私有檔案中，同一容器或使用同一狀態目錄的後續 CLI 指令可以直接重複使用。容器銷毀且未持久保存該目錄時，需要重新登入。

預設的 nadou auth login 仍使用原有的瀏覽器授權和系統憑證庫。

2. 📹為什麼它適合影視創作

NadouPro CLI 目前重點覆蓋文字、圖片、影片、空間與自由畫布。它既可以完成一次獨立生成，也可以圍繞同一專案組織多素材、多階段的創作鏈路。

能力	適合完成的工作
文字	創意發散、劇本提綱、分鏡描述、提示詞和文案；文字結果直接回傳。
圖片	文生圖、參考圖生圖、局部重繪、全景圖和主體三視圖。
影片	文生影片、多參考影片、首尾幀生成、影片語意編輯與動作控制。
自由畫布	建立或讀取畫布，組織文字、圖片、影片節點與連線，並在指定節點上生成。
空間與交付	把生成結果儲存到個人空間或指定團隊空間，繼續協作和管理。
本機影片處理	檢查影片資訊、燒錄字幕，以及對相容片段進行無轉碼拼接。

創作優勢

1. 從單個素材，擴展到完整創作鏈路

2. 普通生成工具更擅長完成一次請求。影視創作則需要在創意、角色、場景、分鏡和鏡頭之間反覆傳遞資訊。NadouPro CLI 可以讓 AI 助手沿著同一創作目標繼續工作，並把不同階段的結果放回明確的位置。

3. 參考素材的角色更清楚

4. 人物、服裝、場景、風格、首幀、尾幀和動作參考承擔不同職責。只要在自然語言中說明每份素材的用途，AI 助手就能選擇對應的生成方式，減少把普通參考圖誤當首幀等問題。

5. 創作過程可以分階段確認

6. 圖片和影片生成會產生積分消耗。AI 助手可以在提交前展示模型、規格、預計積分和儲存位置，讓創作者先判斷方向，再決定是否生成。對於分鏡、關鍵視覺等階段性結果，也可以先審閱再繼續。

7. 自由畫布保留上下游關係

8. 當任務涉及多張分鏡、多個鏡頭或多輪修改時，自由畫布可以用節點和連線表達依賴關係。AI 助手在明確的畫布和節點中工作，結果回到對應節點，便於繼續調整和協作。

3. 🫧開始使用

直接用自然語言告訴 Agent

安裝和登入完成後，不必記住 CLI 參數，可以直接說：

• 「幫我生成一張雨夜霓虹街頭的電影感海報。」

• 「用這張參考圖生成一個 5 秒影片，先告訴我模型、參數和預計消耗。」

• 「把本機這張圖片上傳，再放到我指定的畫布裡。」

• 「讀取這張畫布的當前結構，在右側增加一個文字節點並連接到圖片節點。」

• 「剛才的影片還沒完成，繼續等待原來的 task ID，不要重新提交。」

Agent 應先確認有歧義且不能猜測的資訊，例如帳號、空間、畫布、目標節點、首尾幀角色或高消耗批次範圍；確認後再呼叫 NadouPro CLI。

4. ✏️典型創作場景

場景一：從一句創意到鏡頭草案

創作初期往往只有一句概念。可以先讓 AI 助手整理人物、場景和情緒，再生成角色設定圖、氛圍圖或分鏡草案。確認視覺方向後，再進入影片階段。

可以這樣說：

I want to make a cinematic Latin dance short set in a rainy night. First, I'll organize a brief creative overview, character, and scene settings, and then generate 4 storyboard drafts in 16:9. The overall vibe is high-contrast neon lighting, with character outfits matching the rainy night street. Let me know the model, quantity, and estimated points before generating.

場景二：用參考圖保持角色與美術一致

當創作需要穩定人物形象和視覺風格時，可以同時上傳多張參考圖，並明確每張圖片的用途。AI 助手會根據人物、服裝和場景等不同參考職責選擇可用模型，生成結果不會自動進入自由畫布。

可以這樣說：

請使用我隨訊息上傳的 3 張參考圖，獨立生成 3 張連續的電影分鏡：圖 1 只參考女主角的五官和髮型，圖 2 只參考紅色流蘇舞裙的款式與材質，圖 3 只參考雨夜街道的霓虹光線和色彩。三張分鏡均為 16:9，保持同一人物、服裝和場景，不新增角色。生成前請告訴我使用的模型、參考圖分工、生成數量和預計積分；結果儲存到我的個人空間，不建立自由畫布。

場景三：把分鏡圖變成影片鏡頭

已經有明確分鏡圖時，可以將其指定為影片的首幀，並補充人物動作、鏡頭運動、時長和畫面規格。AI 助手會根據首幀職責選擇相應的影片生成方式，不會把分鏡圖誤作普通風格參考。

可以這樣說：

請使用我隨訊息上傳的分鏡圖作為首幀，獨立生成一段 5 秒、16:9、720p 的影片。畫面中的兩名舞者完成一次拉丁舞旋轉，鏡頭從全景緩慢推近至中景；保持首幀中的人物長相、服裝、雨夜街道和霓虹色調，不新增人物。生成前請告訴我使用的模型、影片參數和預計積分；結果儲存到我的個人空間，不建立自由畫布。

場景四：在自由畫布中組織一支短片

當創作包含簡報、人物設定、場景、分鏡和多個影片鏡頭時，可以使用自由畫布集中組織素材及其上下游關係。AI 助手會先確認儲存位置和畫布結構，再執行節點建立與生成。

可以這樣說：

我要在自由畫布中策劃一支「海邊公路追逐」短片。請先讀取我的個人空間目錄，讓我確認畫布的儲存位置；確認後新建同名自由畫布，並規劃創作簡報、男女主角設定、海邊公路場景、4 個分鏡圖片節點和對應的影片節點，同時連接各節點的上下游關係。先只展示畫布結構和節點生成計畫，不要立即生成；我確認後再逐個提交，每次提交前告訴我模型、參數和預計積分。

場景五：把結果交付到正確的位置

團隊專案可以在創作開始時直接指定團隊空間和目標目錄。AI 助手會先核對真實空間與目錄，再生成並交付結果，避免素材儲存到錯誤位置。

可以這樣說：

請獨立生成 3 張「秋季戶外品牌廣告」分鏡圖，畫面為金色草原、戶外模特和暖色電影光影，規格為 16:9。生成結果交付到「品牌視覺」團隊空間的「2026 秋季活動」目錄，不建立自由畫布。如果存在多個同名空間或目錄，請先列出候選項讓我選擇，不要自行切換。確認目標位置後，再告訴我使用的模型、生成數量和預計積分；得到確認後再提交生成。

5. 💗最佳實踐

• 先說創作目標，不必先找命令 直接描述你要完成的畫面、鏡頭或專案。AI 助手會根據當前版本發現可用能力。

• 讓參考素材各司其職 上傳多份素材時，分別說明人物、服裝、場景、構圖、風格、首幀、尾幀或動作參考的職責。不要只說「參考這些圖」。

• 把輸出規格和儲存位置一起說清楚 圖片數量與比例、影片時長與清晰度、是否需要聲音，以及個人空間、團隊空間或自由畫布，都應在提交前確定。

• 生成前先看積分和動作計畫 圖片和影片生成前，建議讓 AI 助手展示模型、關鍵參數、預計積分、當前餘額、儲存位置，以及是否需要上傳本機素材或下載結果。估價不鎖價，最終扣費以提交結果為準。

• 長任務繼續等待，不要重複提交 影片生成或節點回填可能需要時間。等待逾時或頁面沒有重新整理不代表失敗，應繼續檢查原任務；重新提交可能重複消耗積分並產生重複結果。

• 自由畫布按「讀取—修改—回讀」工作 在已有畫布中修改節點或連線時，AI 助手應先讀取當前結構，按確認後的計畫完成一次修改，再回讀核對。這樣可以減少覆蓋他人工作或在錯誤節點上生成。

6. 🙋必要說明與常見問題

當前 CLI 沒有開放哪些能力

當前不把獨立音訊生成、複雜專業剪輯、跨專案複製和未確認的平台時間軸算繪匯出寫成可直接使用的 CLI 能力。網頁端存在相應入口時，也應以 CLI 當前回傳的能力為準。

登入後瀏覽器是空白或深色頁面

回到原來的 AI 助手對話檢查登入狀態；若已登入，可關閉頁面繼續使用。若尚未登入，檢查國際登入頁是否仍等待點擊「Continue to international sign in」，或是否顯示初始化錯誤。保持原登入命令執行，按頁面提示完成登入；不要僅憑頁面顏色判斷授權成功，也不要重複啟動登入命令。

畫布中已經有節點，但沒有生成結果

這通常表示只建立了畫布結構。讓 AI 助手檢查節點的提示詞、模型和必要參數，展示預計積分並獲得確認後，再提交節點生成。

提示無權限或找不到目標目錄

先確認當前帳號，再核對目標是個人空間還是某個團隊空間，並確認帳號對目標目錄具有寫入權限。不要讓 AI 助手按名稱猜測目錄或未經確認切換團隊空間。