@cloudcruise/cli

中文文档
1.17.0发布于 2026/11/10MITES Module构建来源已验证近 30 天下载 5084

用于管理 CloudCruise 浏览器自动化工作流程并运行的 CLI

中文使用文档
文档目录8 节
  1. 安装
  2. 设置
  3. 编码代理集成
  4. 保持最新状态
  5. 快速启动
  6. 用快照调试
  7. 所有命令
  8. 许可证

云结晶 CLI

MIT License NPM Downloads GitHub Repo stars Discord YC W24

用于管理的CLI 云纹 浏览器自动化工作流程并运行. 为编码代理设计,用于修复并编辑CloudCruise工作流程.

安装

npm install -g @cloudcruise/cli

设置

复制 .env.实例 改为 .env,然后运行 cloudcruise login。 。 。 .

编码代理集成

克劳德代码 从 repo 市场安装插件 :

/plugin marketplace add CloudCruise/cloudcruise-cli
/plugin install cloudcruise@cloudcruise

此记录所有六种技能( 工作流程构建、 测试、 调试、 CLI 和 DSL 引用) , 并用 /plugin update cloudcruise。 。 。 .

进取 —— org 管理员在显示于 设置 资源 插件 配置数字 :

{
  "requiredPlugins": ["CloudCruise/cloudcruise-cli"]
}

从下个会话开始安装整个块; 使用 optionalPlugins 而不是让它选择进入。 德文读取 .claude-plugin/plugin.json 直接显示。 需要在您的 Devin org 上访问插件( 目前关闭的β -) 支持@ cognition.ai) (中文(简体) ).

其他代理( 或没有插件的 Claude 代码) ——直接安装技能文件:

cloudcruise install --skills                  # Claude Code + Cursor
cloudcruise install --skills --target claude   # Claude Code only
cloudcruise install --skills --target cursor   # Cursor only

保持最新状态

  • CLI: 爱丽丝 当新版本存在时, CLI 通知您和您的编码代理。 更新方式 npm i -g @cloudcruise/cli@latest。 。 。 . CI 财务报告和审定财务报表 NO_UPDATE_NOTIFIER 把支票关了.
  • 技能: cLI 升级后,下一个命令会刷新技能 cloudcruise install --skills 写入当前工程。 将您编辑的技能单独保存; cloudcruise install --skills 覆盖他们。 插件安装后的技能更新 .

关闭技能刷新,设置这个 ~/.cloudcruise/config.json数字 :

{ "settings": { "skillsAutoUpdate": false } }

CLOUDCRUISE_SKILLS_AUTO_UPDATE=0 或者说 =1 覆盖设置 。 随着新鲜度的降低,CLI警告 过时的技能代替.

快速启动

# List all workflows in your workspace
cloudcruise workflows list

# Get a workflow
cloudcruise workflows get <workflow_id> > workflow.json

# Start a run (returns { session_id } immediately; poll run get for completion)
cloudcruise run start <workflow_id>

# Start a debug run with snapshots on every node
cloudcruise run start <workflow_id> --debug

# Run the workflow but skip final submit/save actions (validates writes without submitting)
cloudcruise run start <workflow_id> --dry-run

# Start a run without workspace notifications (Slack/email) for this run
cloudcruise run start <workflow_id> --no-notifications

# Inspect a run (poll until the status is terminal)
cloudcruise run get <session_id>

# Update a workflow
cloudcruise workflows update <workflow_id> --file workflow.json --version-note "Fixed login selector"

用快照调试

之后a --debug 运行, 使用快照命令诊断失败 :

# Download HTML snapshot, screenshots, and metadata for a node
cloudcruise snapshot fetch <session_id> <node_id>

# Suggest unique XPath selectors for interactive elements
cloudcruise snapshot suggest <session_id> <node_id>

# Test an XPath selector against a snapshot
cloudcruise snapshot test '//button[@id="submit"]' <session_id> <node_id>

# Work with a local HTML file instead of fetching from the API
cloudcruise snapshot suggest --file ./snapshots/page.html
cloudcruise snapshot test '//input[@name="email"]' --file ./snapshots/page.html

所有命令

命令说明
login浏览器 OAuth + PKCE 登录
logout删除活动配置文件的证书
whoami显示认证账户
auth login浏览器 OAuth + PKCE 登录
auth status检查认证( E)--profile(中文(简体) )
auth logout删除证书( E)--profile, (中文(简体) ), --all(中文(简体) )
auth switch <name>设置活动配置文件
auth profiles列出所有配置
auth workspace use <id>为配置设置活动的工作空间
workspaces list列出活动认证的工作空间
workspaces show显示配置文件的活动工作空间
workspaces use <id>为配置设置活动的工作空间
workspaces clear清除当前工作空间用于配置文件
workflows list清单工作流程(--full 详细情况, --folder <path> 范围到文件夹)
workflows folders列表工作流程文件夹( E)--path 范围, --search(中文(简体) )
workflows get <id>获得工作流程定义( E)--version <version|range>, (中文(简体) ), --branch <name|id>· ; --version-number <n> 是最新遗产 n.x.x(中文(简体) )
workflows versions <id>列表工作流程版本历史
workflows update <id>更新工作流程--file, (中文(简体) ), --stdin, (中文(简体) ), --version-note, (中文(简体) ), --force, (中文(简体) ), --branch, (中文(简体) ), --release-version, (中文(简体) ), --bypass-protection);13号出口,如果尸体是 version_id 不再是最新的
workflows delete <id...>永久删除工作流程( 无确认); 打印每个 ID 的一个结果, 如果失败则退出非 0
branches list列出工作流程的分支; is_default 标记默认( e)--workflow(中文(简体) )
branches create <name>创建分支( E)--workflow, (中文(简体) ), --from <branch>, (中文(简体) ), --from-version <version>(中文(简体) )
branches delete <branch>删除一个非默认分支( E)--workflow, (中文(简体) ), --close-open-prs(中文(简体) )
branches set-default <branch>使分支为默认值( N)--workflow(中文(简体) )
prs list列表拉动请求( E)--workflow, (中文(简体) ), --state open|merged|closed|all(中文(简体) )
prs view <pr>显示拉动请求及其批准( E)--workflow(中文(简体) )
prs create打开拉动请求( E)--workflow, (中文(简体) ), --head, (中文(简体) ), --base, (中文(简体) ), --title(中文(简体) )
prs diff <pr>合并预览:与密钥和摘要相冲突, match_heads (单位:千美元)--merged, (中文(简体) ), --resolutions-template(中文(简体) )
prs approve <pr>批准拉动请求(不是你自己的)
prs close <pr>关闭拉动请求
prs merge <pr>合并( E)--resolve <key>=source|target|delete, (中文(简体) ), --take, (中文(简体) ), --resolutions-file, (中文(简体) ), --match-heads, (中文(简体) ), --admin(中文(简体) )
components list列表工作流程组件--full(中文(简体) )
components get <id>获取组件( E)--version-number(中文(简体) )
components versions <id>列表组件版本--limit(中文(简体) )
components usage <id>使用此组件列出工作流程
components create创建组件( E)--name, (中文(简体) ), --file, (中文(简体) ), --stdin(中文(简体) )
components rename <id>重命名组件( N)--name(中文(简体) )
components update <id>更新组件--file, (中文(简体) ), --stdin, (中文(简体) ), --version-note, (中文(简体) ), --no-propagate, (中文(简体) ), --source-workflow-id(中文(简体) )
components delete <id>删除一个组件
error-codes list列出工作空间错误代码( L)--workflow-id(中文(简体) )
error-codes get <id>由 id 获取一个工作空间错误代码
error-codes create按名称查找或创建出错代码( N)--code, (中文(简体) ), --description, (中文(简体) ), --enriched-description, (中文(简体) ), --action,或通过 --file编号 :--stdin(中文(简体) )
error-codes update <id>更新错误代码( 与创建时的旗帜相同)
run start <id>立即启动运行, 返回会话 id (--debug, (中文(简体) ), --input, (中文(简体) ), --version, (中文(简体) ), --branch <name|id>(中文(简体) )
run get <id>获取运行状态和结果( 翻到终端)
run list列表运行( L)--workflow, (中文(简体) ), --status, (中文(简体) ), --limit, (中文(简体) ), --since(中文(简体) )
run interrupt <id>停止运行会话
run decision <id>显示恢复代理正在等待运行的决定( 需要的决定): 问题、 字段和选项, answer_by,在 agent.decision_requested 形状
run answer-decision <id>答复决定 要求回答回收代理在运行期间提出的问题(--decision-id, (中文(简体) ), --value <field=value>, (中文(简体) ), --text, (中文(简体) ), --directive(中文(简体) )
run respond <id>将用户交互数据提交正在等待的运行 USER_INTERACTION 节点( e)--data, (中文(简体) ), --file, (中文(简体) ), --stdin(中文(简体) )
run live-view <id>为活动会话获取新的活视图连接( 查看器 URL + 一次性验证符)
run errors <id>分析错误( E)--since, (中文(简体) ), --limit(中文(简体) )
run snapshots <id> <node_id>获取调试快取元数据
run network <id>获取运行的全部记录网络流量( E)--include-noise, (中文(简体) ), --output(中文(简体) )
snapshot fetch <sid> <nid>下载 HTML 、 截图、 元数据 (--html, (中文(简体) ), --image(中文(简体) )
snapshot suggest [sid] [nid]推荐 XPath 选择者 (--file, (中文(简体) ), --filter(中文(简体) )
snapshot test <xpath> [sid] [nid]测试 XPath 与快照相对应 (--file, (中文(简体) ), --count(中文(简体) )
vault list列表金库条目( R)--full(中文(简体) )
vault get获取金库条目( E)--user-id, (中文(简体) ), --domain, (中文(简体) ), --decrypt; 额外的字段作为名称和类型,除非 --decrypt
vault create创建金库条目( E)--user-id, (中文(简体) ), --domain, (中文(简体) ), --user-name, (中文(简体) ), --password, (中文(简体) ), --tfa-method (可重复), --additional-fields-file, (中文(简体) ), --security-questions-file, (中文(简体) ), --secret-provider-id, (中文(简体) ), --secret-ref(中文(简体) )
vault update更新金库条目字段,包括供应商支持的绑定; --no-tfa-method 删除每个 TFA 方法
vault tfa-code目前一个条目的2FA代码(--user-id, (中文(简体) ), --domain, (中文(简体) ), --method, (中文(简体) ), --field(中文(简体) )
vault clear-state清除证书的浏览器状态
vault encrypt 编号 : decrypt本地加密或解密值
secret-providers list列出秘密提供者连接
secret-providers items <provider-id>列出可见于秘密提供者连接的项目
builder start开始构建者对话( E)--start-url, (中文(简体) ), --name, (中文(简体) ), --vault-user-id(中文(简体) )
builder send <message>向构建者代理发送指令
builder respond对代理输入请求的答复(--message-id, (中文(简体) ), --value-stdin(中文(简体) )
builder status检查对话状态( N)/status 分类学 + 保存; 退出代码编码状态 0/7/8/9
builder conversations list列出工作空间的活构建者对话
builder conversations get [id]获取存档谈话记录, 直播或结束( L)--limit 尾声, 0 仅限元数据; --snapshot, (中文(简体) ), --include-system, (中文(简体) ), --output(中文(简体) )
builder workflow获取当前工作流程定义
builder messages获取对话历史( E)--limit, (中文(简体) ), --offset, (中文(简体) ), --no-tail(中文(简体) )
builder save数据库的长期工作流程(-m/--message 设置版本注释)
builder interrupt停止代理处理
builder end结束谈话和清理
utils uuid生成节点ID的 UUID ()--count(中文(简体) )
install --skills为编码代理安装技能文件( E)--target(中文(简体) )

CLI 使用回转方向 http://127.0.0.1 在登录和在OS键链中存储可重复使用的证书时. run list 默认为最近24小时 --since 省略。 使用诸如 24h, (中文(简体) ), 7d,或 30m 以调整时间窗口.

许可证

麻省理工学院

版本与发布记录

@cloudcruise/cli 共发布 60 个版本,首次发布于 2026/03/02;过去 12 个月发布了 60 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.17.0latest2026/11/10今天
1.16.12026/10/2714 天前
1.16.02026/10/2615 天前
1.15.22026/10/2615 天前
1.15.12026/10/1625 天前
1.15.02026/10/1229 天前

其他发布通道:test → 1.11.0-test.0。

关于 @cloudcruise/cli 的常见问题

@cloudcruise/cli 是什么?

用于管理 CloudCruise 浏览器自动化工作流程并运行的 CLI

如何安装 @cloudcruise/cli?

在项目目录运行 npm install @cloudcruise/cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 cloudcruise,可以用 npx cloudcruise 直接运行。

@cloudcruise/cli 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/cloudcruise__cli 是否存在。

@cloudcruise/cli 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@cloudcruise/cli 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@cloudcruise/cli 可以商用吗?

@cloudcruise/cli 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@cloudcruise/cli 的下载量有多少?

根据 npm 官方下载统计,@cloudcruise/cli 在 2026/10/10 – 2026/11/08 这 30 天内被下载 5,084 次,日均约 169 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@cloudcruise/cli 还在维护吗?

最新版本 1.17.0 发布于 2026/11/10(今天);至今共发布 60 个版本,其中过去 12 个月发布了 60 个;首次发布于 2026/03/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。