# @glasser-ai/cli 中文文档

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

版本：0\.1\.135
npm 元数据更新时间：2026-11-13T04:10:23.633Z
中文译文更新时间：2026-11-16T15:32:54.953Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40glasser-ai/cli
原文对照：https://npmcn.com/package/%40glasser-ai/cli/?lang=original
项目主页：https://glasser.ai/docs/cli

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

- 包体积（解压后）：2.6 MB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：0 个
- 首次发布：2026-09-01T06:54:56.554Z
- 最新版本发布：2026-11-13T04:10:23.441Z
- 近 30 天下载量：4249（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：67（近 12 个月 67 个）

## 中文简介

搜索、检查和运行一个键的付费API端点——玻璃机CLI

## 安装

```sh
npm install @glasser-ai/cli
```

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

## README

# 玻璃机 CLI

搜索、检查和运行一个键的付费API端点——第一当事方 glasser 数据平面的客户端 (`/v1`) (中文(简体) ).

## 安装

```bash
curl -fsSL https://glasser.ai/install.sh | sh    # no npm needed (Node >= 22)
# or, with npm:
npm install -g @glasser-ai/cli
```

重运行任一命令升级. 然后说: `glasser login`。 。 。 .

## 图标

```
glasser search  ["<query>"] --use-case "<ask>" [--limit N] [--cursor C]  # no query lists the catalog; --use-case is always required
                 # -q/--query takes the same value; --query=<q> for a leading dash
glasser inspect -p <provider> -e <endpoint> [--endpoint-version N]
glasser run     -p <provider> -e <endpoint> [-i '<json>'|@file | -f <path>]
                 [--endpoint-version N] [--idempotency-key K]
                 [--wait] [--wait-timeout s] [-o file]
glasser runs list [--limit --cursor --status --provider --endpoint]
glasser runs get  -r <runId> [--wait] [--wait-timeout s] [-o file]
glasser runs stop -r <runId>
glasser balance
glasser balance history [--limit --cursor --kind]
glasser keys add --label <l> --key <k> | list | activate --label <l>
             | remove --label <l> [--force]
glasser skill install [--target <agent>]
```

全球: `-j/--json`, (中文(简体) ), `--help`, (中文(简体) ), `--version`。 。 。 .

## 登录

`glasser login [--no-browser]` ——浏览器流:终端打印 a 匹配代码,控制台 `/cli/authorize` 页面打开,点击一次批准, 和关键在本地商店(在工作空间喷出后贴上标签, 已启动)。 仅在页面上的代码与终端匹配时批准 然后打印它输入的工作空间——读取该行。 拒绝或 已过期审批出站1号出站 带有再运行提示. `login --json` 是使用错误 : 非交互路径正在计算控制台中的密钥 + `glasser keys add`。 。 。 .

## 密钥

优先发言: `GLASSER_API_KEY` (已验证;一个错误的值是一个错误,它 永不悄悄倒回) > 活动存储密钥 > 指向错误 `glasser keys add`。 。 。 .

当地商店是 `$XDG_CONFIG_HOME/glasser/keys.json` (默认) `~/.config`文件模式 0600。 标签是独特的;第一个密钥自动激活; 删除激活的密钥使其失效; `keys remove` 只碰这个 它不撤销密钥。 只有被蒙上面罩的标志`gl_1bba****`已经 曾经印刷.

## 运行语义

-   `status` 是运行的周期; `Response: HTTP n` 是供货商的判决. `COMPLETED` + 键 `HTTP 404` 是正常结果(由NO RESULT收费) ,而不是错误.
-   这个 `Idempotency-Key` 在发送前打印为 stderr。 之后 模糊失败( 运输出错、 超时、, `service_unavailable` - 那个 API在回答503之前可能已经接受了一次运行 重放是读数,从不收费两次。 错误消息带有 确切的重试命令.
-   `--wait` 民意调查(0.5s-×2-上限10s)至终点站; `--wait-timeout` (默认300s)要求 `--wait`。同步端点在一个中解答 来回旅行,从不投票.
-   `-o <file>` 写“运行” `output` 操作 非正负输出。 人类模式在不重复保存的情况下打印运行摘要 体质; `--json` 保持整个运行在 stdout。 失败和提供方错误依然存在 可见.
-   钱田是精确的美元十进制字符串,印刷的逐字记录。 算起来 与小数算术,永不浮出.

## 流出代码

人模式: stdout上的数据; stderr上的进展,提示,提示和出错. JSON 模式 (`--json`: stdout只携带原始的成功体;每一个错误—— 包含使用错误 —— 是像 API 形状的 Stderr 上的单个 JSON 对象 信封( e)`{"error":{"code",...},"request_id"?}`) (中文(简体) ). `keys remove --json` 需求 `--force` 因此,一个提示永远不会 破坏机器输出.

| 代码 | 含义 |
| --- | --- |
| 0 个 | 圆满. 完整运行( 任何提供者状态); 成功 `runs stop`。 。 。 . |
| 1个 | API 错误, 运输失败, `--wait` 暂停,或 `run`编号 :`runs get` 结束故障/停止. |
| 2个 | 用法:坏旗或输入 JSON,无效的嵌入值,没有配置密钥. |
| 130个 | 被打断了. |

## 设计说明

-   `search` 匹配 `POST /v1/endpoints/search` ——CLI动词为API动词.
-   `--wait` 财务报告和审定财务报表 `--wait-timeout <seconds>` 是不同的旗帜.
-   `-f/--input-file <path>` 与 `-i` (互为专有.
-   每个 `run` 带有一个“同上”的键——用同样的键重试是“a” 阅读,从来没有第二次指控.

## 发展

```bash
pnpm --filter @glasser-ai/cli dev -- search -q "web search" --use-case "find a web search API"   # tsx, no build
pnpm --filter @glasser-ai/cli build                            # esbuild → dist/glasser.js
node apps/cli/dist/glasser.js --help
cd apps/cli && pnpm link --global                  # a PATH `glasser` shim

pnpm --filter @glasser-ai/cli test:p0                          # unit
GLASSER_API_KEY=gl_… pnpm --filter @glasser-ai/cli test:integration   # needs seeded :3101
```

信封 : `GLASSER_API_BASE_URL` (默认) `https://api.glasser.ai`, (中文(简体) ), `GLASSER_API_KEY`, (中文(简体) ), `XDG_CONFIG_HOME`, (中文(简体) ), `NO_COLOR` (颜色在 框架的帮助和版本文本).

## 常见问题

### @glasser-ai/cli 是什么？

搜索、检查和运行一个键的付费API端点——玻璃机CLI

### 如何安装 @glasser-ai/cli？

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

### @glasser-ai/cli 支持 TypeScript 吗？

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

### @glasser-ai/cli 支持 ESM 还是 CommonJS？

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

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

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

### @glasser-ai/cli 可以商用吗？

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

### @glasser-ai/cli 的下载量有多少？

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

### @glasser-ai/cli 还在维护吗？

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

