# @cloudgrid-io/cli 中文文档

规范地址：https://npmcn.com/package/%40cloudgrid-io/cli/

版本：0\.25\.1
npm 元数据更新时间：2026-11-03T17:15:54.598Z
中文译文更新时间：2026-11-10T05:16:47.726Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cloudgrid-io/cli
原文对照：https://npmcn.com/package/%40cloudgrid-io/cli/?lang=original
项目主页：https://github.com/cloudgrid-io/cloudgrid#readme
源码仓库：https://github.com/cloudgrid-io/cloudgrid

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3.5 MB，40 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.13\.0
- 运行依赖：9 个
- 首次发布：2026-04-04T21:55:20.608Z
- 最新版本发布：2026-11-03T17:15:54.424Z
- 近 30 天下载量：1953（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：122（近 12 个月 122 个）

## 中文简介

CloudGrid CLI——将你的应用程序和特工放在网格上.

## 安装

```sh
npm install @cloudgrid-io/cli
```

也可以使用：`pnpm add @cloudgrid-io/cli`、`yarn add @cloudgrid-io/cli`、`bun add @cloudgrid-io/cli`

## README

# 云纹 CLI

[![npm](https://img.shields.io/npm/v/@cloudgrid-io/cli)](https://www.npmjs.com/package/@cloudgrid-io/cli) [![license](https://img.shields.io/badge/license-MIT-green)](https://npmcn.com/package/%40cloudgrid-io/cli/LICENSE)

在CloudGrid上建造、运送和运行应用程序和特工 目录或目录 URL在大约30秒内成为一个活的,可地址的事物——部署,尾端日志,共享, 阅读反馈,所有不离开你的外壳.

命令是 `grid`。 。 。 .

## 目录

-   [安装](https://npmcn.com/package/%40cloudgrid-io/cli/#readme-install)
-   [快速启动](https://npmcn.com/package/%40cloudgrid-io/cli/#readme-quickstart)
-   [实例](https://npmcn.com/package/%40cloudgrid-io/cli/#readme-examples)
-   [图标](https://npmcn.com/package/%40cloudgrid-io/cli/#readme-commands)
-   [旗帜](https://npmcn.com/package/%40cloudgrid-io/cli/#readme-flags)
-   [环境](https://npmcn.com/package/%40cloudgrid-io/cli/#readme-environment)
-   [遥测](https://npmcn.com/package/%40cloudgrid-io/cli/#readme-telemetry)
-   [更新](https://npmcn.com/package/%40cloudgrid-io/cli/#readme-updating)
-   [卸载](https://npmcn.com/package/%40cloudgrid-io/cli/#readme-uninstall)
-   [解决问题](https://npmcn.com/package/%40cloudgrid-io/cli/#readme-troubleshooting)
-   [支助](https://npmcn.com/package/%40cloudgrid-io/cli/#readme-support)
-   [许可证](https://npmcn.com/package/%40cloudgrid-io/cli/#readme-license)

## 安装

**macOS / Linux — 卷曲**

```
curl -fsSL https://raw.githubusercontent.com/cloudgrid-io/cli/main/install.sh | sh
```

**macOS / Linux – 本地人**

```
brew install cloudgrid-io/tap/grid
```

**跨平台(包括Windows)——npm**

```
npm install -g @cloudgrid-io/cli
```

需要节点.js 22+.

22号节点是CloudGrid构建和测试的东西——月台上的每个多克文件 实值 `node:22`,每个CI工作运行 `node-version: 22`。该楼层名称 而不是坐在它的下边。 18号节点于2025年4月离开维修,20号节点 2026年4月;没有获得安全补丁.

在更古老的节点上, `npm install -g @cloudgrid-io/cli` 打印一个 `EBADENGINE` 警告和安装 — npm 仅在您设定时拒绝 `engine-strict=true`。似乎成功的安装不是CLI的信号 会跑的 安装节点 22 或以后安装 .

校验 : `grid --version` 财务报告和审定财务报表 `grid doctor`。 。 。 .

软件包安装一个单一命令, `grid`老年人 `cloudgrid`, (中文(简体) ), `gridctl` 财务报告和审定财务报表 `cg` 名称已退役而未安装 .

## 快速启动

```
grid login          # Google OAuth in the browser
grid whoami         # confirm user + active grid
grid plug           # build + deploy the current directory, prints the live URL
grid open           # open it in the browser
```

不需要账户来尝试一次性分享 : `grid plug ./index.html` 放弃公共链接.

## 实例

```
# Scaffold and deploy a Node app
grid new app my-api --type node
cd my-api && grid plug

# Deploy the current directory and tail its logs
grid plug
grid logs --since 10m

# Publish beyond the grid as an unlisted link, then read feedback
grid visibility set my-api --inside grid --outside link
grid feedback

# Switch grid, list what's on it
grid use atomic
grid get entities
```

## 图标

可见是两轴—— `--inside` 谁是网格上的观众 (单位:千美元)`private | spaces | grid`, (中文(简体) ), `--outside` 超越它的范围`none | link | public`) (中文(简体) ).

| 命令 | 目的 |
| --- | --- |
| `login` 编号 : `logout` 编号 : `whoami` | 签名( Google OAuth), 签名, 显示用户 + 活动网格 |
| `use [slug]` | 设置或显示活动网格 |
| `new [name]` | 设置要构建的文件夹( 在您插入或 dev 之前没有服务器实体) |
| `plug [target]` | 构建 + 部署( 或重新部署); 打印活的 URL |
| `dev` | 用网格输入资源在本地运行链接的实体 |
| `status [name]` | 网格仪表板、实体细节或部署快照 |
| `follow` | 在完成之前, 重新跟踪和流出进度 |
| `logs [name]` | 从实体库流出日志 |
| `open [name]` | 在浏览器中打开实体输出 URL |
| `info [name]` | 显示详细的实体元数据 |
| `rollback` 编号 : `versions` | 滚回先前的部署; 列表、 标签和平针薄荷版本 |
| `visibility set` | 设置两个能见度轴( S)`--inside` 编号 : `--outside`(中文(简体) ) |
| `env` 编号 : `secrets` | 管理 runtime env vars 和 secret( 秘密值永远不会返回) |
| `vault` | 管理网格的金库项目( 只写; 从未打印) |
| `get` 编号 : `describe` 编号 : `create` 编号 : `delete` | 列出、检查、创建和去除网格、实体和空格 |
| `rename` 编号 : `unplug` | 重命名显示名称; 从网格取出节点 |
| `pull` | 下载实体的源并链接文件夹 `plug` 更新它 |
| `pickup` | 将您可以看到的应用程序复制到您自己的上行 |
| `collab` | 获得或批准进入实体 |
| `callers` 编号 : `calls` | 谁可以叫你自己的应用程序; 你的应用程序叫什么 |
| `link` 编号 : `wire` | 将此文件夹、 repo 或 Webhook 绑入实体 |
| `domains` | 在您自己的域中服务应用程序 |
| `space` | 管理空格 |
| `hooks` | 管理网钩 |
| `agent` | 将代理指令(AGENTS.md + CLAUDE.md)写入此目录 |
| `scaffold` | 已声明的脚手架服务文件夹 `cloudgrid.yaml` |
| `ssh` | 在运行的吊舱中打开交互 shell |
| `recipes` | 打印运行时间 SDK 配方 |
| `feedback [message]` | 向CloudGrid团队发送反馈 |
| `doctor` | 诊断检查(节点、道克、API可达性、认证) |
| `completion <shell>` | Shell 完成脚本 |

运行 `grid <command> --help` 用于任何命令的全旗集,以及 `grid --help` 为完整的列表.

## 旗帜

全球:

-   `-V, --version` ——打印CLI版本
-   `-v, --verbose` 详细产出
-   `-h, --help` - 帮助任何命令

每个命令常见 :

-   `--grid <slug>` 取出/覆盖电网
-   `--json` 编号 : `-o <format>` ——机器可读出的产出(`table | json | yaml | wide`(中文(简体) )
-   `--no-clipboard` 编号 : `--no-notify` - 停止剪贴板复制/操作系统通知 `plug`
-   `--since <dur>` 编号 : `--tail <n>` —— 说 `logs` 窗口

## 环境

-   `CLOUDGRID_GRID` 只有这个外壳的有效网格。 接受一击或一击 网格 id 和 覆盖 `~/.cloudgrid/config.yaml` 没有改变它.
-   `CLOUDGRID_HOME` 配置和证书所在的地方(默认) `~/.cloudgrid`) (中文(简体) ).
-   `CLOUDGRID_TOKEN` ——以非互动方式进行认证,而不是 `grid login`。 。 。 .
-   `CLOUDGRID_TELEMETRY` 看到了吗 [遥测](https://npmcn.com/package/%40cloudgrid-io/cli/#readme-telemetry)。 。 。 .

`grid use` 写入您家目录中的一个文件, 因此适用于每个文件 机器上的 shell - 包括其它终端和任何代理会话运行 平行进行。 当两个贝壳需要不同的网格时, 设定 `CLOUDGRID_GRID` 相当 而非运行 `grid use` 在每个

```bash
# This shell targets acme; every other shell keeps whatever `grid use` set.
export CLOUDGRID_GRID=acme
grid plug

# Or for a single command, without exporting anything:
CLOUDGRID_GRID=acme grid plug
```

优先,最高第一: `--grid` → `CLOUDGRID_GRID` → `grid use`。 。 。 .

需要特定网格的脚本 `CLOUDGRID_GRID` 或者说 `--grid`A级 调用脚本 `grid use` 重新点出您拥有的一切的网格 打开,不要放回去.

## 遥测

CLI向CloudGrid API发送了三种事件类型,而平台则在预发:

-   **`error`** 当动词失败时。 抓取 v2 错误代码, HTTP 状态, 请求 id, 和赤动词( 无旗帜, 无位置 args) .
-   **`success`** - 开始 `new`, (中文(简体) ), `plug`, (中文(简体) ), `dev`, (中文(简体) ), `login` 完成干净之后 抓住动词和时间。 没有源树的有效载荷.
-   **`feedback`** - 当你跑的时候 `grid feedback "<message>"`。 。 。 .

每个事件都是 JWT 绑定的(你的用户代号), 以250 ms 的分数出局, 并且从不屏蔽动词 。 文件路径,命令旗,env-var值,JWT,和证书没有被收集. 这个 `feedback` 动词 `--include-log` 旗帜是唯一的自由形式路径——它运送了被擦拭的最后200行 `~/.cloudgrid/logs/cli.log`。 。 。 .

### 无法进行遥测

```
# One-shot, env var (highest priority — overrides config):
CLOUDGRID_TELEMETRY=0 grid plug

# Persistent, written to ~/.cloudgrid/config.yaml:
grid login --no-telemetry
```

与 `CLOUDGRID_TELEMETRY=1` 或通过删除 `telemetry: false` 从您的配置文件.

## 更新

```
npm update -g @cloudgrid-io/cli      # npm
brew upgrade grid                    # homebrew
```

`grid doctor` 当更新版本可用时警告.

## 卸载

```
npm uninstall -g @cloudgrid-io/cli   # npm
brew uninstall grid                  # homebrew
rm -rf ~/.cloudgrid                  # remove stored credentials + config
```

## 解决问题

-   **`grid: command not found`** 确保 npm 全球 bin(或 Homebrew bin) 打开 `$PATH`; 重新运行安装器.
-   **认证错误 / 401** —— 说 `grid login` 再次; 检查 `grid whoami` 显示预期网格,切换到 `grid use <slug>`。 。 。 .
-   **部署失败** - 运行 `grid doctor`; 检查 `grid logs` 财务报告和审定财务报表 `grid status <name>` 为追踪.

## 支助

-   技能+MCP: [云网-io/技能](https://github.com/cloudgrid-io/skills)
-   问题: [云网-io/cli/问题](https://github.com/cloudgrid-io/cli/issues)

## 许可证

麻省理工学院. 见 [自由主义](https://npmcn.com/package/%40cloudgrid-io/cli/LICENSE)。 。 。 .

## 常见问题

### @cloudgrid-io/cli 是什么？

CloudGrid CLI——将你的应用程序和特工放在网格上\.

### 如何安装 @cloudgrid-io/cli？

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

### @cloudgrid-io/cli 支持 TypeScript 吗？

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

### @cloudgrid-io/cli 支持 ESM 还是 CommonJS？

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

### @cloudgrid-io/cli 需要什么版本的 Node\.js？

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

### @cloudgrid-io/cli 可以商用吗？

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

### @cloudgrid-io/cli 的下载量有多少？

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

### @cloudgrid-io/cli 还在维护吗？

最新版本 0\.25\.1 发布于 2026/11/04（6 天前）；至今共发布 122 个版本，其中过去 12 个月发布了 122 个；首次发布于 2026/04/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。