# @cloudcruise/cli 中文文档 规范地址：https://npmcn.com/package/%40cloudcruise/cli/ 版本：1\.17\.0 npm 元数据更新时间：2026-11-10T03:23:05.147Z 中文译文更新时间：2026-11-10T03:29:12.593Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40cloudcruise/cli 原文对照：https://npmcn.com/package/%40cloudcruise/cli/?lang=original 项目主页：https://github.com/CloudCruise/cloudcruise-cli 源码仓库：https://github.com/CloudCruise/cloudcruise-cli ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1.1 MB，151 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=18 - 运行依赖：7 个 - 首次发布：2026-03-02T00:46:04.373Z - 最新版本发布：2026-11-10T03:23:04.642Z - 近 30 天下载量：5084（2026-10-10 至 2026-11-08，npm 官方下载统计） - 已发布版本数：60（近 12 个月 60 个） ## 中文简介 用于管理 CloudCruise 浏览器自动化工作流程并运行的 CLI ## 安装 ```sh npm install @cloudcruise/cli ``` 也可以使用：`pnpm add @cloudcruise/cli`、`yarn add @cloudcruise/cli`、`bun add @cloudcruise/cli` ## README # 云结晶 CLI [![MIT License](https://img.shields.io/badge/License-MIT-red.svg?style=flat-square)](https://opensource.org/licenses/MIT) ![NPM Downloads](https://img.shields.io/npm/dw/@cloudcruise/cli) [![GitHub Repo stars](https://img.shields.io/github/stars/CloudCruise/cloudcruise-cli?style=flat-square&logo=GitHub&label=cloudcruise-cli)](https://github.com/CloudCruise/cloudcruise-cli) [![Discord](https://img.shields.io/discord/1227480834945318933?style=flat-square&logo=Discord&logoColor=white&label=Discord&color=%23434EE4)](https://discord.com/invite/MHjbUqedZF) [![YC W24](https://img.shields.io/badge/Y%20Combinator-W24-orange?style=flat-square)](https://www.ycombinator.com/companies/cloudcruise) 用于管理的CLI [云纹](https://cloudcruise.com/) 浏览器自动化工作流程并运行. 为编码代理设计,用于修复并编辑CloudCruise工作流程. ## 安装 ```bash npm install -g @cloudcruise/cli ``` ## 设置 复制 [.env.实例](https://npmcn.com/package/%40cloudcruise/cli/.env.example) 改为 `.env`,然后运行 `cloudcruise login`。 。 。 . ## 编码代理集成 **克劳德代码** 从 repo 市场安装插件 : ``` /plugin marketplace add CloudCruise/cloudcruise-cli /plugin install cloudcruise@cloudcruise ``` 此记录所有六种技能( 工作流程构建、 测试、 调试、 CLI 和 DSL 引用) , 并用 `/plugin update cloudcruise`。 。 。 . **进取** —— org 管理员在显示于 **设置 资源 插件 配置**数字 : ```json { "requiredPlugins": ["CloudCruise/cloudcruise-cli"] } ``` 从下个会话开始安装整个块; 使用 `optionalPlugins` 而不是让它选择进入。 德文读取 `.claude-plugin/plugin.json` 直接显示。 需要在您的 Devin org 上访问插件( 目前关闭的β -) [支持@ cognition.ai](mailto:support@cognition.ai)) (中文(简体) ). **其他代理( 或没有插件的 Claude 代码)** ——直接安装技能文件: ```bash 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`数字 : ```json { "settings": { "skillsAutoUpdate": false } } ``` `CLOUDCRUISE_SKILLS_AUTO_UPDATE=0` 或者说 `=1` 覆盖设置 。 随着新鲜度的降低,CLI警告 过时的技能代替. ## 快速启动 ```bash # List all workflows in your workspace cloudcruise workflows list # Get a workflow cloudcruise workflows get > workflow.json # Start a run (returns { session_id } immediately; poll run get for completion) cloudcruise run start # Start a debug run with snapshots on every node cloudcruise run start --debug # Run the workflow but skip final submit/save actions (validates writes without submitting) cloudcruise run start --dry-run # Start a run without workspace notifications (Slack/email) for this run cloudcruise run start --no-notifications # Inspect a run (poll until the status is terminal) cloudcruise run get # Update a workflow cloudcruise workflows update --file workflow.json --version-note "Fixed login selector" ``` ## 用快照调试 之后a `--debug` 运行, 使用快照命令诊断失败 : ```bash # Download HTML snapshot, screenshots, and metadata for a node cloudcruise snapshot fetch # Suggest unique XPath selectors for interactive elements cloudcruise snapshot suggest # Test an XPath selector against a snapshot cloudcruise snapshot test '//button[@id="submit"]' # 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 ` | 设置活动配置文件 | | `auth profiles` | 列出所有配置 | | `auth workspace use ` | 为配置设置活动的工作空间 | | `workspaces list` | 列出活动认证的工作空间 | | `workspaces show` | 显示配置文件的活动工作空间 | | `workspaces use ` | 为配置设置活动的工作空间 | | `workspaces clear` | 清除当前工作空间用于配置文件 | | `workflows list` | 清单工作流程(`--full` 详细情况, `--folder ` 范围到文件夹) | | `workflows folders` | 列表工作流程文件夹( E)`--path` 范围, `--search`(中文(简体) ) | | `workflows get ` | 获得工作流程定义( E)`--version `, (中文(简体) ), `--branch `· ; `--version-number ` 是最新遗产 `n.x.x`(中文(简体) ) | | `workflows versions ` | 列表工作流程版本历史 | | `workflows update ` | 更新工作流程`--file`, (中文(简体) ), `--stdin`, (中文(简体) ), `--version-note`, (中文(简体) ), `--force`, (中文(简体) ), `--branch`, (中文(简体) ), `--release-version`, (中文(简体) ), `--bypass-protection`);13号出口,如果尸体是 `version_id` 不再是最新的 | | `workflows delete ` | 永久删除工作流程( 无确认); 打印每个 ID 的一个结果, 如果失败则退出非 0 | | `branches list` | 列出工作流程的分支; `is_default` 标记默认( e)`--workflow`(中文(简体) ) | | `branches create ` | 创建分支( E)`--workflow`, (中文(简体) ), `--from `, (中文(简体) ), `--from-version `(中文(简体) ) | | `branches delete ` | 删除一个非默认分支( E)`--workflow`, (中文(简体) ), `--close-open-prs`(中文(简体) ) | | `branches set-default ` | 使分支为默认值( N)`--workflow`(中文(简体) ) | | `prs list` | 列表拉动请求( E)`--workflow`, (中文(简体) ), `--state open|merged|closed|all`(中文(简体) ) | | `prs view ` | 显示拉动请求及其批准( E)`--workflow`(中文(简体) ) | | `prs create` | 打开拉动请求( E)`--workflow`, (中文(简体) ), `--head`, (中文(简体) ), `--base`, (中文(简体) ), `--title`(中文(简体) ) | | `prs diff ` | 合并预览:与密钥和摘要相冲突, `match_heads` (单位:千美元)`--merged`, (中文(简体) ), `--resolutions-template`(中文(简体) ) | | `prs approve ` | 批准拉动请求(不是你自己的) | | `prs close ` | 关闭拉动请求 | | `prs merge ` | 合并( E)`--resolve =source|target|delete`, (中文(简体) ), `--take`, (中文(简体) ), `--resolutions-file`, (中文(简体) ), `--match-heads`, (中文(简体) ), `--admin`(中文(简体) ) | | `components list` | 列表工作流程组件`--full`(中文(简体) ) | | `components get ` | 获取组件( E)`--version-number`(中文(简体) ) | | `components versions ` | 列表组件版本`--limit`(中文(简体) ) | | `components usage ` | 使用此组件列出工作流程 | | `components create` | 创建组件( E)`--name`, (中文(简体) ), `--file`, (中文(简体) ), `--stdin`(中文(简体) ) | | `components rename ` | 重命名组件( N)`--name`(中文(简体) ) | | `components update ` | 更新组件`--file`, (中文(简体) ), `--stdin`, (中文(简体) ), `--version-note`, (中文(简体) ), `--no-propagate`, (中文(简体) ), `--source-workflow-id`(中文(简体) ) | | `components delete ` | 删除一个组件 | | `error-codes list` | 列出工作空间错误代码( L)`--workflow-id`(中文(简体) ) | | `error-codes get ` | 由 id 获取一个工作空间错误代码 | | `error-codes create` | 按名称查找或创建出错代码( N)`--code`, (中文(简体) ), `--description`, (中文(简体) ), `--enriched-description`, (中文(简体) ), `--action`,或通过 `--file`编号 :`--stdin`(中文(简体) ) | | `error-codes update ` | 更新错误代码( 与创建时的旗帜相同) | | `run start ` | 立即启动运行, 返回会话 id (`--debug`, (中文(简体) ), `--input`, (中文(简体) ), `--version`, (中文(简体) ), `--branch `(中文(简体) ) | | `run get ` | 获取运行状态和结果( 翻到终端) | | `run list` | 列表运行( L)`--workflow`, (中文(简体) ), `--status`, (中文(简体) ), `--limit`, (中文(简体) ), `--since`(中文(简体) ) | | `run interrupt ` | 停止运行会话 | | `run decision ` | 显示恢复代理正在等待运行的决定( 需要的决定): 问题、 字段和选项, `answer_by`,在 `agent.decision_requested` 形状 | | `run answer-decision ` | 答复决定 要求回答回收代理在运行期间提出的问题(`--decision-id`, (中文(简体) ), `--value `, (中文(简体) ), `--text`, (中文(简体) ), `--directive`(中文(简体) ) | | `run respond ` | 将用户交互数据提交正在等待的运行 `USER_INTERACTION` 节点( e)`--data`, (中文(简体) ), `--file`, (中文(简体) ), `--stdin`(中文(简体) ) | | `run live-view ` | 为活动会话获取新的活视图连接( 查看器 URL + 一次性验证符) | | `run errors ` | 分析错误( E)`--since`, (中文(简体) ), `--limit`(中文(简体) ) | | `run snapshots ` | 获取调试快取元数据 | | `run network ` | 获取运行的全部记录网络流量( E)`--include-noise`, (中文(简体) ), `--output`(中文(简体) ) | | `snapshot fetch ` | 下载 HTML 、 截图、 元数据 (`--html`, (中文(简体) ), `--image`(中文(简体) ) | | `snapshot suggest [sid] [nid]` | 推荐 XPath 选择者 (`--file`, (中文(简体) ), `--filter`(中文(简体) ) | | `snapshot test [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 ` | 列出可见于秘密提供者连接的项目 | | `builder start` | 开始构建者对话( E)`--start-url`, (中文(简体) ), `--name`, (中文(简体) ), `--vault-user-id`(中文(简体) ) | | `builder send ` | 向构建者代理发送指令 | | `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 是什么？ 用于管理 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 和提交记录判断。