# @glitchtip/cli 中文文档

规范地址：https://npmcn.com/package/%40glitchtip/cli/

版本：1\.0\.0
npm 元数据更新时间：2026-05-22T17:44:48.095Z
中文译文更新时间：2026-11-16T15:59:38.525Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：7.8 kB，4 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-05-22T17:44:47.603Z
- 最新版本发布：2026-05-22T17:44:47.904Z
- 近 30 天下载量：14215（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 1 个）

## 中文简介

GlitchTip 的开源 CLI

## 安装

```sh
npm install @glitchtip/cli
```

也可以使用：`pnpm add @glitchtip/cli`、`yarn add @glitchtip/cli`、`bun add @glitchtip/cli`

## README

# GlitchTip CLI (英语)

开源 CLI 用于 [滑块](https://glitchtip.com/)。 。 。 .

## 安装

从中下载二进制 [页 次](https://gitlab.com/glitchtip/glitchtip-cli/-/releases) 或从源建置:

```sh
cargo install --path .
```

此安装 `glitchtip-cli` 二进制.

## 使用量

```sh
# Configure
glitchtip-cli --url https://your-glitchtip-instance.com login

# Upload sourcemaps
glitchtip-cli sourcemaps upload --release 1.0.0 ./dist

# Manage releases
glitchtip-cli releases list
glitchtip-cli releases new 1.0.0
glitchtip-cli releases finalize 1.0.0
glitchtip-cli releases set-commits 1.0.0 --auto

# Create deploys
glitchtip-cli deploys --release 1.0.0 new -e production

# Send a test event (uses SENTRY_DSN)
glitchtip-cli send-event -m "deploy verification" -l info -E production
```

## 配置

配置按此顺序加载( 先是最高优先级):

1.  CLI 旗帜(`--url`, (中文(简体) ), `--auth-token`, (中文(简体) ), `--org`, (中文(简体) ), `--project`(中文(简体) )
2.  环境变量`SENTRY_URL`, (中文(简体) ), `SENTRY_AUTH_TOKEN`, (中文(简体) ), `SENTRY_ORG`, (中文(简体) ), `SENTRY_PROJECT`, (中文(简体) ), `SENTRY_DSN`(中文(简体) )
3.  本地配置文件( N)`.sentryclirc` 或者说 `.glitchtip-cli.rc`,从 cwd 向上搜索)
4.  全球配置`~/.config/glitchtip-cli/config`, (中文(简体) ), `~/.config/sentry/sentrycli.ini`,或 `~/.sentryclirc`(中文(简体) )

使用 INI 格式配置文件 :

```ini
[auth]
token=sntrys_xxx
dsn=https://key@your-glitchtip-instance.com/1

[defaults]
url=https://your-glitchtip-instance.com
org=my-org
project=my-project
```

## 支持的命令

| 命令 | 状态 | 页:1 |
| --- | --- | --- |
| `login` | 支助 | 交互式符号设置 |
| `info` | 支助 | 配置和认证状态显示 |
| `releases new` | 支助 |  |
| `releases finalize` | 支助 |  |
| `releases list` | 支助 |  |
| `releases delete` | 支助 |  |
| `releases set-commits` | 支助 | `--auto` 用于发现 |
| `sourcemaps upload` | 支助 | 用 gzip 截断上传 |
| `sourcemaps inject` | 支助 | 将ID输入源文件和源图 |
| `sourcemaps resolve` | 支助 | 解析给定行/列位置的源图 |
| `deploys new` | 支助 |  |
| `deploys list` | 支助 |  |
| `send-event` | 支助 | DSN 认证, 信封协议 |
| `organizations list` | 支助 |  |
| `projects list` | 支助 |  |
| `repos list` | 支助 |  |
| `releases propose-version` | 支助 |  |
| `releases info` | 支助 | 版本、日期、项目、承诺 |
| `releases archive` | 支助 |  |
| `releases restore` | 支助 |  |
| `issues list` | 支助 |  |
| `issues resolve` | 支助 | 以 ID、 状态或全部进行散装解析 |
| `issues mute` | 支助 | 哑巴(无知)问题 |
| `issues unresolve` | 支助 | 大量未解决的问题 |
| `send-envelope` | 支助 | 发送一个预建的信封文件 |
| `events list` | 支助 | 与 `--show-user` 财务报告和审定财务报表 `--show-tags` |
| `monitors list` | 支助 | 列出运行时显示器 |
| `monitors create` | 支助 | 创建升时监视器 |
| `monitors delete` | 支助 | 删除升起时显示器 |
| `monitors run` | 支助 | 运行命令并发送成功的心跳 |
| `logs list` | 支助 | 列出并过滤 OpenTelection 日志条目 |
| `debug-files check` | 支助 | 检查调试信息文件是否可用 |
| `debug-files upload` | 支助 | 上传调试信息文件(ELF/dSYM/PDB/etc |
| `debug-files find` | 支助 | 通过调试ID定位调试文件 |
| `debug-files print-sources` | 支助 | 在调试文件中打印源引用 |
| `debug-files bundle-sources` | 支助 | 从调试信息文件中创建源捆 |
| `debug-files bundle-jvm` | 支助 | 从 Java/ Kotlin 源创建源包 |
| `dart-symbol-map upload` | 支助 | 上传 Dart/ Flutter 符号图以进行去污 |

### 尚未支持

这些命令尚未执行,按优先顺序大致列出.

| 命令 | 页:1 |
| --- | --- |
| `react-native gradle` | 从Android gradle上传源图 |

### 未计划

这些命令超出了范围,要么是因为它们具有特殊性,被贬低,要么涉及特定平台的工具链.

| 命令 | 原因 |
| --- | --- |
| `react-native xcode` | 仅使用 macOS |
| `react-native appcenter` | 折旧 |
| `bash-hook` | Shell 错误钩; 实践中很少使用 |
| `send-metric` | 折旧 |
| `update` 编号 : `uninstall` | 软件包管理区域 |
| `sourcemaps explain` | 折旧 |
| `files` | 折旧; 使用 `sourcemaps upload` |
| `upload-dif` 编号 : `upload-dsym` 编号 : `upload-proguard` | 隐藏别名 `debug-files upload` |
| `build upload` | 尼什建筑文物管理 |

### Gliitch Tip 特性

我们计划增加CLI支持的 GlitchTip 独有的特点 .

| 特性 | 页:1 |
| --- | --- |
| `logs list --live` (流线) | 基于 WebSocket 的实时日志流 |

## 许可证

麻省理工学院

## 常见问题

### @glitchtip/cli 是什么？

GlitchTip 的开源 CLI

### 如何安装 @glitchtip/cli？

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

### @glitchtip/cli 支持 TypeScript 吗？

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

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

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

### @glitchtip/cli 可以商用吗？

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

### @glitchtip/cli 的下载量有多少？

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

### @glitchtip/cli 还在维护吗？

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

