命令参考 | Stitch 中文文档

@google/stitch CLI 提供一组资源动词（find、get、create、edit、delete、generate、open、url），以及 Canvas、捕获和配置命令。

标记为工作区的命令和资源需要先在本机运行一次 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`	自省：显示 schema（写操作）或字段列表（读操作）
`--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 资源，或评估诊断状态机（流程：stitch status —flow）

stitch get [resource] [id] [flags]

位置参数

参数	必需	描述
`resource`	`false`	资源类型（诊断状态机请填 “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 Canvas 项目
`upload file`	工作区	将文件上传到工作区
`upload screen`	默认	将 HTML 或图片文件作为屏幕上传到 Stitch Canvas

`stitch url`

打印项目或屏幕的规范 Stitch Canvas 网页 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`

显示认证、Canvas 凭据和 GitHub 状态，或使用 —flow 评估引导流程

stitch status [flowArg] [flags]

位置参数

参数	必需	描述
`flowArg`	`false`	要评估的可选流程（design

命令参数

同时接受所有全局参数。

参数	类型	描述
`--cwd`	`string`	评估流程时使用的工作目录
`--flow`	`string`	评估引导流程并返回其当前步骤（design
`--token`	`boolean`	打印有效的 OAuth 持有者访问令牌（过期时自动刷新）

`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 schema

需要通过 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 服务器