@glasser-ai/cli

中文文档
0.1.135发布于 2026/11/13MITES Module零依赖近 30 天下载 4249

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

中文使用文档
文档目录8 节
  1. 安装
  2. 图标
  3. 登录
  4. 密钥
  5. 运行语义
  6. 流出代码
  7. 设计说明
  8. 发展

玻璃机 CLI

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

安装

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” 阅读,从来没有第二次指控.

发展

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 共发布 67 个版本,首次发布于 2026/09/01;过去 12 个月发布了 67 个版本。

版本发布日期距今
0.1.135latest2026/11/133 天前
0.1.1342026/11/115 天前
0.1.1332026/11/115 天前
0.1.1312026/11/106 天前
0.1.1302026/11/106 天前
0.1.1282026/11/106 天前

关于 @glasser-ai/cli 的常见问题

@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 和提交记录判断。