命令參考 | Stitch 繁體中文文件

@google/stitch CLI 提供資源動詞（find、get、create、edit、delete、generate、open、url），以及畫布、擷取與設定相關指令。

標記為 工作區 的指令與資源需要先在你的電腦上執行一次 stitch enable loop。

指令	類別	適用範圍
`stitch create`	資源	預設
`stitch delete`	資源	預設
`stitch edit`	資源	預設
`stitch find`	資源	預設
`stitch generate`	資源	預設
`stitch get`	資源	預設
`stitch capture`	操作與畫布	預設
`stitch connect`	操作與畫布	工作區
`stitch open`	操作與畫布	預設
`stitch serve`	操作與畫布	預設
`stitch upload`	操作與畫布	預設
`stitch url`	操作與畫布	預設
`stitch config`	驗證與設定	預設
`stitch disable`	驗證與設定	預設
`stitch enable`	驗證與設定	預設
`stitch github`	驗證與設定	工作區
`stitch login`	驗證與設定	預設
`stitch logout`	驗證與設定	預設
`stitch privacy`	驗證與設定	工作區
`stitch status`	驗證與設定	預設
`stitch agent-skills`	進階	預設
`stitch api`	進階	工作區
`stitch mcp`	進階	預設

全域旗標

這些旗標適用於任何 stitch 指令：

旗標	型別	說明
`--access-token`	`string`	OAuth 2.0 存取權杖（環境變數：STITCH_ACCESS_TOKEN）
`--api-key`	`string`	為這次指令執行傳入 API 金鑰（旗標：—api-key，環境變數：STITCH_API_KEY）
`--base-url`	`string`	API 基礎 URL（環境變數：STITCH_BASE_URL）
`--debug`	`boolean`	顯示偵錯資訊，包括堆疊追蹤
`--expand`	`boolean`	在詳細檢視中顯示完整內容（例如 context get、solutions get）
`--fields`	`string`	以逗號分隔的欄位遮罩
`--format`	`enum`	輸出格式（預設：自動偵測）
`--json`	`boolean`	輸出 JSON
`--no-cache`	`boolean`	略過本機快取，一律從網路擷取
`--quiet`, `-q`	`boolean`	抑制非必要的輸出與橫幅
`--schema`	`boolean`	檢視內部結構：顯示結構定義（寫入）或欄位清單（讀取）
`--trace`	`boolean`	將原始 HTTP 網路追蹤與 cURL 重現輸出至 stderr
`--workspace`, `-w`	`string`	工作區 ID（執行「stitch find workspaces」以列出；環境變數：STITCH_WORKSPACE）

`stitch create`

建立 Stitch 資源

stitch create [resource] [flags]

位置引數

引數	必填	說明
`resource`	`false`	要建立的資源型別

指令旗標

也接受所有全域旗標。

旗標	型別	說明
`--autonomy-level`	`string`	自主層級：CREATE_SUGGESTIONS、CREATE_ASSETS 或 SUBMIT_ASSETS（僅限 priority 資源）
`--description`	`string`	優先事項說明（僅限 priority 資源）
`--dry-run`	`boolean`	驗證承載內容並預覽變更，而不發出 API 呼叫
`--interactive`, `-i`	`boolean`	從推薦的入門範本中選擇（僅限 priority 資源）
`--objective`	`string`	優先事項目標陳述（僅限 priority 資源）
`--project`, `-p`	`string`	Stitch 專案 ID（執行「stitch find projects」以列出；環境變數：STITCH_PROJECT_ID）
`--template`, `-t`	`string`	用於建立的範本 ID、標題或從 1 開始的索引（僅限 priority 資源）
`--templates`	`boolean`	列出推薦的入門範本，而不建立任何項目（僅限 priority 資源）
`--title`	`string`	專案標題（僅限 project 資源）

支援的資源

資源	適用範圍	說明
`project`	預設	存放已產生螢幕的 Stitch 畫布。
`screen`	預設	Stitch 畫布上的單一已產生設計。
`design-system`	預設	套用至已產生螢幕的共用視覺語言。
`workspace`	工作區	與 Stitch 配對的儲存庫，容納其優先事項、洞察與脈絡。
`context`	工作區	附加至工作區的外部素材，讓 Stitch 能推論程式碼以外的更多資訊。
`skill`	工作區	形塑 Stitch 代理程式如何讀取工作區的指示。與「stitch agent-skills」不同，後者會寫入本機 SKILL.md 檔案。
`priority`	工作區	常設指令：一個目標加上 Stitch 持續依循處理的自主層級。
`webhook`	工作區	工作區事件發生時觸發的 HTTP 回呼。
`connection`	工作區	將工作區連結至 GitHub 或 Slack 等外部工具的整合。

範例

stitch create project --title "Checkout Redesign"
stitch create design-system --project <project-id> --from-file DESIGN.md
stitch create priority --workspace <workspace-id> --title "Audit mobile nav"
stitch create context --workspace <workspace-id> --title "Q3 Metrics" --body-file metrics.md

`stitch delete`

依 ID 刪除 Stitch 資源

stitch delete [resource] [flags]

位置引數

引數	必填	說明
`resource`	`false`	要刪除的資源型別

指令旗標

也接受所有全域旗標。

旗標	型別	說明
`--dry-run`	`boolean`	驗證承載內容並預覽刪除，而不發出 API 呼叫
`--force`	`boolean`	強制刪除，無需確認
`--id`	`string`	要刪除的資源 ID
`--project`, `-p`	`string`	Stitch 專案 ID（執行「stitch find projects」以列出；環境變數：STITCH_PROJECT_ID）
`--yes`, `-y`	`boolean`	略過確認提示

支援的資源

資源	適用範圍	說明
`project`	預設	存放已產生螢幕的 Stitch 畫布。
`workspace`	工作區	與 Stitch 配對的儲存庫，容納其優先事項、洞察與脈絡。
`context`	工作區	附加至工作區的外部素材，讓 Stitch 能推論程式碼以外的更多資訊。
`file`	工作區	上傳至工作區的個別檔案。
`skill`	工作區	形塑 Stitch 代理程式如何讀取工作區的指示。與「stitch agent-skills」不同，後者會寫入本機 SKILL.md 檔案。
`priority`	工作區	常設指令：一個目標加上 Stitch 持續依循處理的自主層級。
`webhook`	工作區	工作區事件發生時觸發的 HTTP 回呼。
`connection`	工作區	將工作區連結至 GitHub 或 Slack 等外部工具的整合。

範例

stitch delete screen <screen-id> --project <project-id> --force
stitch delete priority <priority-id> --workspace <workspace-id> --force
stitch delete context <context-id> --workspace <workspace-id> --force

`stitch edit`

更新 Stitch 資源的可變更欄位

stitch edit [resource] [id] [flags]

位置引數

引數	必填	說明
`resource`	`false`	要編輯的目標資源型別
`id`	`false`	目標資源 ID（或可重複的 —id <id>）

指令旗標

也接受所有全域旗標。

旗標	型別	說明
`--add-repo`	`string`	將儲存庫新增至工作區（URL、owner/repo 簡寫或 ID）
`--design-system`	`string`	要套用至目標螢幕的設計系統資產 ID
`--device`	`string`	目標螢幕的裝置型別（DESKTOP 或 MOBILE）
`--dry-run`	`boolean`	驗證承載內容並預覽變更，而不發出 API 呼叫
`--model`	`string`	用於 Stitch 螢幕編輯的模型（GEMINI_3_8_FLASH 或 GEMINI_3_5_FLASH_LITE）
`--project`, `-p`	`string`	Stitch 專案 ID（執行「stitch find projects」以列出；環境變數：STITCH_PROJECT_ID）
`--prompt`	`string`	用於 Stitch 螢幕編輯的藝術指導提示詞
`--remove-repo`	`string`	從工作區移除儲存庫（URL、owner/repo 簡寫或 ID）

支援的資源

資源	適用範圍	說明
`screen`	預設	Stitch 畫布上的單一已產生設計。
`design-system`	預設	套用至已產生螢幕的共用視覺語言。
`workspace`	工作區	與 Stitch 配對的儲存庫，容納其優先事項、洞察與脈絡。
`context`	工作區	附加至工作區的外部素材，讓 Stitch 能推論程式碼以外的更多資訊。
`file`	工作區	上傳至工作區的個別檔案。
`skill`	工作區	形塑 Stitch 代理程式如何讀取工作區的指示。與「stitch agent-skills」不同，後者會寫入本機 SKILL.md 檔案。
`priority`	工作區	常設指令：一個目標加上 Stitch 持續依循處理的自主層級。
`webhook`	工作區	工作區事件發生時觸發的 HTTP 回呼。

範例

stitch edit screen <screen-id> --project <project-id> --prompt "Switch to a compact header"
stitch edit design-system <asset-id> --project <project-id> --from-file DESIGN.md
stitch edit priority <priority-id> --workspace <workspace-id> --state ACTIVE

`stitch find`

尋找符合篩選條件的 Stitch 資源

stitch find [resource] [flags]

位置引數

引數	必填	說明
`resource`	`false`	要尋找的資源型別

指令旗標

也接受所有全域旗標。

旗標	型別	說明
`--filter`	`string`	篩選運算式
`--insight`	`string`	依洞察 ID 篩選（或以逗號分隔的洞察 ID）
`--limit`	`string`	結果數量上限
`--page-size`	`string`	向 API 要求的每頁項目數量上限
`--page-token`	`string`	用於擷取下一頁結果的權杖
`--priority`	`string`	依優先事項 ID 篩選（或以逗號分隔的優先事項 ID）
`--project`, `-p`	`string`	Stitch 專案 ID（執行「stitch find projects」以列出；環境變數：STITCH_PROJECT_ID）

支援的資源

資源	適用範圍	說明
`project`	預設	存放已產生螢幕的 Stitch 畫布。
`screen`	預設	Stitch 畫布上的單一已產生設計。
`design-system`	預設	套用至已產生螢幕的共用視覺語言。
`workspace`	工作區	與 Stitch 配對的儲存庫，容納其優先事項、洞察與脈絡。
`context`	工作區	附加至工作區的外部素材，讓 Stitch 能推論程式碼以外的更多資訊。
`file`	工作區	上傳至工作區的個別檔案。
`skill`	工作區	形塑 Stitch 代理程式如何讀取工作區的指示。與「stitch agent-skills」不同，後者會寫入本機 SKILL.md 檔案。
`priority`	工作區	常設指令：一個目標加上 Stitch 持續依循處理的自主層級。
`webhook`	工作區	工作區事件發生時觸發的 HTTP 回呼。
`insight`	工作區	Stitch 依據優先事項挖掘你的程式碼庫時，所發現的特定且錨定於路由的最佳化機會。
`solution`	工作區	回應某項洞察的建議變更。
`connection`	工作區	將工作區連結至 GitHub 或 Slack 等外部工具的整合。
`organization`	工作區	你的組織設定與 GitHub App 安裝。

範例

stitch find projects
stitch find screens --project <project-id>
stitch find design-systems
stitch find priorities --workspace <workspace-id>

`stitch generate`

觸發 Stitch 螢幕、變體、洞察或解決方案的生成式建立

stitch generate [resource] [flags]

位置引數

引數	必填	說明
`resource`	`false`	要產生的資源型別（screen、variants、insights、solutions）

指令旗標

也接受所有全域旗標。

旗標	型別	說明
`--aspects`	`string`	要以逗號分隔的變化層面（LAYOUT、COLOR_SCHEME、IMAGES、TEXT_FONT、TEXT_CONTENT）
`--count`	`string`	要產生的變體數量（1-5）
`--creative-range`	`string`	變體偏離來源的程度（REFINE、EXPLORE、REIMAGINE）
`--delay`	`boolean`	延後執行洞察產生
`--device`, `-d`	`string`	目標螢幕的裝置型別（DESKTOP 或 MOBILE）
`--dry-run`	`boolean`	驗證承載內容並預覽動作，而不呼叫後端
`--insight`	`string`	用於產生解決方案的洞察 ID 或以逗號分隔的洞察 ID
`--interval`	`string`	搭配 —watch 時，輪詢間隔的毫秒數（預設：2000，佇列等待期間最高可達 60000）
`--model`	`string`	產生用模型 ID（GEMINI_3_8_FLASH 或 GEMINI_3_5_FLASH_LITE）
`--new-project`	`string`	建立可選標題的新 Stitch 專案
`--notify`	`boolean`	搭配 —watch 時，在結束時傳送桌面通知
`--priority`	`string`	用於產生洞察的優先事項 ID 或以逗號分隔的優先事項 ID
`--project`, `-p`	`string`	Stitch 專案 ID（執行「stitch find projects」以列出；環境變數：STITCH_PROJECT_ID）
`--prompt`	`string`	用於螢幕或變體產生的藝術指導提示詞
`--replace-existing`	`boolean`	產生解決方案時，取代現有未指派的解決方案
`--screen`	`string`	用於變體產生的來源螢幕 ID
`--timeout`	`string`	搭配 —watch 時，放棄前等待的秒數（預設：3600）
`--title`	`string`	選用的螢幕標題
`--watch`	`boolean`	等待洞察產生完成。結束代碼：0 已完成、1 失敗、124 逾時

支援的資源

資源	適用範圍	說明
`screen`	預設	Stitch 畫布上的單一已產生設計。
`variant`	預設	從現有 Stitch 螢幕產生的設計變體。
`insight`	工作區	Stitch 依據優先事項挖掘你的程式碼庫時，所發現的特定且錨定於路由的最佳化機會。
`solution`	工作區	回應某項洞察的建議變更。

範例

stitch generate screen --project <project-id> --prompt "Minimalist vinyl music player"
stitch generate variants <screen-id> --project <project-id> --count 2 --range EXPLORE --prompt "Try warm editorial typography"
stitch generate design-system --project <project-id>
stitch generate insights --workspace <workspace-id>

`stitch get`

依 ID 取得 Stitch 資源，或評估診斷狀態 FSM（流程：stitch status —flow）

stitch get [resource] [id] [flags]

位置引數

引數	必填	說明
`resource`	`false`	資源型別（或診斷 FSM 用的「status」）
`id`	`false`	資源 ID

指令旗標

也接受所有全域旗標。

旗標	型別	說明
`--project`, `-p`	`string`	Stitch 專案 ID（執行「stitch find projects」以列出；環境變數：STITCH_PROJECT_ID）

支援的資源

資源	適用範圍	說明
`project`	預設	存放已產生螢幕的 Stitch 畫布。
`screen`	預設	Stitch 畫布上的單一已產生設計。
`design-system`	預設	套用至已產生螢幕的共用視覺語言。
`status`	預設	工作區的 11 種狀態導入與診斷狀態機。
`workspace`	工作區	與 Stitch 配對的儲存庫，容納其優先事項、洞察與脈絡。
`context`	工作區	附加至工作區的外部素材，讓 Stitch 能推論程式碼以外的更多資訊。
`file`	工作區	上傳至工作區的個別檔案。
`skill`	工作區	形塑 Stitch 代理程式如何讀取工作區的指示。與「stitch agent-skills」不同，後者會寫入本機 SKILL.md 檔案。
`priority`	工作區	常設指令：一個目標加上 Stitch 持續依循處理的自主層級。
`webhook`	工作區	工作區事件發生時觸發的 HTTP 回呼。
`insight`	工作區	Stitch 依據優先事項挖掘你的程式碼庫時，所發現的特定且錨定於路由的最佳化機會。
`solution`	工作區	回應某項洞察的建議變更。
`connection`	工作區	將工作區連結至 GitHub 或 Slack 等外部工具的整合。
`organization`	工作區	你的組織設定與 GitHub App 安裝。

範例

stitch get project <project-id>
stitch get screen <screen-id> --project <project-id>
stitch get design-system <asset-id>
stitch get priority <priority-id> --workspace <workspace-id>

`stitch capture`

擷取無頭瀏覽器 DOM、執行中的開發伺服器連接埠、本機 HTML 檔案或探索到的路由

stitch capture [flags]

子指令

子指令	適用範圍	說明
`capture browser`	預設	使用無頭 Chrome 或已開啟的 DevTools 分頁擷取經過評估的 DOM（支援用戶端渲染的 SPA）
`capture port`	預設	從執行中的本機開發伺服器連接埠透過 HTTP 擷取 HTML
`capture file`	預設	擷取並正規化已預先渲染的本機 HTML 檔案或標準輸入
`capture routes`	預設	掃描程式碼庫並列出偵測到的應用程式路由

`stitch connect`

透過提供者 OAuth 流程將工具或整合連線至工作區

需要先透過 stitch enable loop 啟用工作區功能。

stitch connect [toolId] [flags]

位置引數

引數	必填	說明
`toolId`	`false`	工具或提供者 ID（例如 github、slack）。省略，或傳入 —list 以查看可用選項。

指令旗標

也接受所有全域旗標。

旗標	型別	說明
`--all`	`boolean`	列出所有可用的整合，不限制於前 25 個熱門項目
`--connected`	`boolean`	僅顯示已連線的整合
`--list`, `-l`	`boolean`	列出可連線的可用工具與提供者 ID
`--no-browser`	`boolean`	不要自動啟動瀏覽器
`--search`, `-s`	`string`	依 ID、顯示名稱或說明篩選整合
`--timeout`	`string`	等待連線的逾時秒數（預設：120）

`stitch open`

在瀏覽器中開啟 Stitch 專案或螢幕（僅限 project | screen）

stitch open [resource] [id] [flags]

位置引數

引數	必填	說明
`resource`	`false`	目標資源型別（「project」
`id`	`false`	專案或螢幕 ID、projects/<p>/screens/<s> 名稱或畫布 URL（預設：此目錄的專案或參考螢幕）

指令旗標

也接受所有全域旗標。

旗標	型別	說明
`--project`, `-p`	`string`	Stitch 專案 ID（執行「stitch find projects」以列出；環境變數：STITCH_PROJECT_ID）
`--url`, `-print`	`boolean`	印出 URL 而不開啟（環境變數：STITCH_NO_BROWSER、BROWSER）

支援的資源

資源	適用範圍	說明
`project`	預設	存放已產生螢幕的 Stitch 畫布。
`screen`	預設	Stitch 畫布上的單一已產生設計。

範例

stitch open project <project-id>
stitch open screen <screen-id> --project <project-id>

`stitch serve`

為 Stitch 專案螢幕啟動本機預覽開發伺服器

stitch serve [flags]

指令旗標

也接受所有全域旗標。

旗標	型別	說明
`--dry-run`	`boolean`	驗證伺服器設定而不進入封鎖等待
`--port`	`string`	要接聽的本機連接埠（預設：3000）
`--project`, `-p`	`string`	要預覽的 Stitch 專案 ID

`stitch upload`

上傳檔案、程式碼庫封存檔或設計資產

stitch upload [flags]

子指令

子指令	適用範圍	說明
`upload code`	工作區	上傳程式碼庫封存檔（.zip 或目錄）
`upload design`	預設	將 DESIGN.md 檔案上傳至 Stitch 畫布專案
`upload file`	工作區	將檔案上傳至工作區
`upload screen`	預設	將 HTML 或圖片檔案上傳為 Stitch 畫布上的螢幕

`stitch url`

印出專案或螢幕的標準 Stitch 畫布網頁 URL（切勿猜測 URL）

stitch url [resource] [id] [flags]

位置引數

引數	必填	說明
`resource`	`false`	目標資源型別（「project」
`id`	`false`	專案或螢幕 ID、projects/<p>/screens/<s> 名稱或畫布 URL（預設：此目錄的專案或參考螢幕）

指令旗標

也接受所有全域旗標。

旗標	型別	說明
`--project`, `-p`	`string`	Stitch 專案 ID（執行「stitch find projects」以列出；環境變數：STITCH_PROJECT_ID）

支援的資源

資源	適用範圍	說明
`project`	預設	存放已產生螢幕的 Stitch 畫布。
`screen`	預設	Stitch 畫布上的單一已產生設計。

範例

stitch url project <project-id>
stitch url screen <screen-id> --project <project-id>

`stitch config`

讀取及寫入 Stitch CLI 設定

stitch config [flags]

子指令

子指令	適用範圍	說明
`config list`	預設	顯示沿完整優先順序鏈解析後的設定
`config get`	預設	依索引鍵取得單一設定值
`config set`	預設	設定某個設定值（寫入 .stitch.json）
`config unset`	預設	移除設定索引鍵

`stitch disable`

全域停用實驗性功能（例如「stitch disable loop」）

stitch disable [feature] [flags]

位置引數

引數	必填	說明
`feature`	`false`	要全域停用的實驗性功能（例如 loop）

指令旗標

也接受所有全域旗標。

旗標	型別	說明
`--dry-run`	`boolean`	預覽變更而不實際執行

`stitch enable`

全域啟用實驗性功能（例如「stitch enable loop」）

stitch enable [feature] [flags]

位置引數

引數	必填	說明
`feature`	`false`	要全域啟用的實驗性功能（例如 loop）

指令旗標

也接受所有全域旗標。

旗標	型別	說明
`--dry-run`	`boolean`	預覽變更而不實際執行

`stitch github`

管理 GitHub 帳戶連線、OAuth 授權，以及 GitHub App 組織安裝

需要先透過 stitch enable loop 啟用工作區功能。

stitch github [flags]

子指令

子指令	適用範圍	說明
`github auth`	工作區	向 GitHub 驗證身分（開啟瀏覽器 OAuth 授權頁面）
`github configure`	工作區	設定 GitHub App 組織安裝與儲存庫存取權限
`github status`	工作區	檢查 GitHub 整合狀態、已連結的組織與可存取的儲存庫

`stitch login`

使用 Google OAuth 2.0 PKCE 驗證，或儲存永久 API 金鑰

stitch login [flags]

指令旗標

也接受所有全域旗標。

旗標	型別	說明
`--port`	`string`	本機回送回呼連接埠（預設：8085）

`stitch logout`

登出並移除本機 OAuth 憑證與已儲存的 API 金鑰

stitch logout [flags]

`stitch privacy`

管理及檢視 Stitch 隱私權公告與服務條款確認狀態

需要先透過 stitch enable loop 啟用工作區功能。

stitch privacy [flags]

子指令

子指令	適用範圍	說明
`privacy status`	工作區	檢查伺服器上目前的隱私權公告確認狀態
`privacy accept`	工作區	在網頁上開啟 Stitch 服務條款，並等待接受
`privacy show`	預設	顯示 Stitch 隱私權公告與服務條款的網頁 URL

`stitch status`

顯示驗證、畫布憑證與 GitHub 狀態，或以 —flow 評估導入流程

stitch status [flowArg] [flags]

位置引數

引數	必填	說明
`flowArg`	`false`	要評估的選用流程（design

指令旗標

也接受所有全域旗標。

旗標	型別	說明
`--cwd`	`string`	評估流程時使用的工作目錄
`--flow`	`string`	評估導入流程並傳回其目前步驟（design
`--token`	`boolean`	印出有效的 OAuth Bearer 存取權杖（過期時會自動重新整理）

`stitch agent-skills`

安裝及更新本機 Stitch 代理程式技能。工作區技能請使用「stitch find skills」

stitch agent-skills [flags]

子指令

子指令	適用範圍	說明
`agent-skills add`	預設	為目前模式安裝 Stitch 代理程式技能
`agent-skills list`	預設	顯示目前模式，以及 Stitch 技能的安裝位置
`agent-skills update`	預設	將已安裝的 Stitch 技能重新同步至目前模式與 CLI 版本

`stitch api`

對 Stitch 端點執行直接 REST API 呼叫，或檢視 OpenAPI/Discovery 結構定義

需要先透過 stitch enable loop 啟用工作區功能。

stitch api [path] [flags]

位置引數

引數	必填	說明
`path`	`false`	API 端點路徑（例如 workspaces 或 /v2alpha/workspaces）

指令旗標

也接受所有全域旗標。

旗標	型別	說明
`--filter`	`string`	依關鍵字或條件篩選項目
`--force`	`boolean`	強制執行，無需確認
`--method`, `-X`	`string`	HTTP 方法（GET、POST、PATCH、PUT、DELETE）
`--yes`, `-y`	`boolean`	略過確認提示

`stitch mcp`

管理及執行 Stitch MCP 伺服器

stitch mcp [flags]

子指令

子指令	適用範圍	說明
`mcp start`	預設	透過 stdio 啟動 Stitch MCP 伺服器
`mcp install`	預設	在你的 AI 編輯器中註冊 Stitch MCP 伺服器