# @gloom-sh/terminal 中文文档

规范地址：https://npmcn.com/package/%40gloom-sh/terminal/

版本：0\.20\.17
npm 元数据更新时间：2026-11-16T06:13:56.253Z
中文译文更新时间：2026-11-16T16:18:11.139Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：32.5 MB，3419 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：9 个
- 首次发布：2026-10-26T09:11:08.393Z
- 最新版本发布：2026-11-16T06:13:55.904Z
- 近 30 天下载量：4816（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：26（近 12 个月 26 个）

## 中文简介

终端的市场研究和组合跟踪器

## 安装

```sh
npm install @gloom-sh/terminal
```

也可以使用：`pnpm add @gloom-sh/terminal`、`yarn add @gloom-sh/terminal`、`bun add @gloom-sh/terminal`

## README

![Gloom 标志](https://npmcn.com/package/%40gloom-sh/terminal/src/assets/gloomberb-logo.svg)

# Gloom

**开源金融终端。快速、键盘驱动、可扩展。**

[**安装**](https://npmcn.com/package/%40gloom-sh/terminal/#readme-%E5%AE%89%E8%A3%85)  ·  [**桌面版**](https://gloom.sh/download/desktop)  ·  [**在浏览器中试用**](https://term.gloom.sh/)  ·  [Discord](https://gloom.sh/discord)  ·  [English](https://npmcn.com/package/%40gloom-sh/terminal/README.md)  ·  [日本語](https://npmcn.com/package/%40gloom-sh/terminal/README.ja.md)

  
  
![Gloom 界面，显示 NVDA 的图表、期权链、公司详情与分析师评级。](https://npmcn.com/package/%40gloom-sh/terminal/docs/assets/gloom-desktop.webp)

由 [![](https://npmcn.com/package/%40gloom-sh/terminal/docs/assets/adjacent.svg) Adjacent](https://adjacent.markets/?ref=gloomberb) 赞助支持

> 本文档为社区维护的简体中文翻译。若与 [英文原版 README](https://npmcn.com/package/%40gloom-sh/terminal/README.md) 有出入，以英文版为准。

行情、图表、财务报表、监管文件、期权、新闻和你的投资组合，都在一个用键盘操作的工作区里。输入 `DES AAPL` 查看公司详情，输入 `GP NVDA` 查看价格图表。Gloom 可在终端（macOS、Linux、Windows）、桌面应用（macOS、Windows）和浏览器中运行。

## 安装

macOS 或 Linux：

```bash
curl -fsSL gloom.sh/install | bash
```

Windows，在 PowerShell 中：

```powershell
irm https://gloom.sh/install.ps1 | iex
```

也可在上述任一系统上通过 [Bun](https://bun.sh/) 安装：

```bash
bun install -g @gloom-sh/terminal
```

然后运行 `gloom`（旧名称 `gloomberb` 仍可使用）。在 Apple Silicon Mac 上，脚本还会安装桌面应用 Gloom.app。Homebrew、Windows 桌面安装程序与手动下载详见[安装指南（英文）](https://npmcn.com/package/%40gloom-sh/terminal/docs/installation.md)。

在兼容 Kitty 图形协议的终端（如 Ghostty、Kitty、WezTerm）中，图表以图像显示；在其他终端中以文本显示。

## 开始使用

按 `Ctrl+P` 打开命令栏，或按 `` ` `` 搜索股票代码。输入 `HELP` 查看所有命令与快捷键，[功能目录（英文）](https://gloom.sh/docs/functions)列出了全部功能。

在 shell 中运行 `gloom quote AAPL` 即可查看报价；脚本可加 `--json`。[使用指南（英文）](https://npmcn.com/package/%40gloom-sh/terminal/docs/usage.md)介绍图表、券商、快捷键与 CLI。

## 数据与隐私

免费行情为延迟数据：报价延迟 15 分钟，新闻延迟 12 小时。Pro 提供实时数据。行情与 Ask Gloom 来自托管服务 [Gloom Cloud](https://gloom.sh/cloud)，该服务不开源；应用本身采用 MIT 许可证。详见[哪些开源、哪些不开源（英文）](https://npmcn.com/package/%40gloom-sh/terminal/docs/open-source.md)。

崩溃报告与使用统计可以关闭：[发送了哪些内容（英文）](https://npmcn.com/package/%40gloom-sh/terminal/docs/telemetry.md)。

## 插件与贡献

插件可添加面板、数据源、券商连接与命令。用 `gloom install gloom-sh/gloom-tv` 从 GitHub 安装插件，或参考[插件开发指南（英文）](https://npmcn.com/package/%40gloom-sh/terminal/PLUGINS.md#your-first-pane)自己编写。参与 Gloom 开发，请用 `git clone --filter=blob:none https://github.com/gloom-sh/gloomberb.git` 克隆源码，并阅读[贡献指南（英文）](https://npmcn.com/package/%40gloom-sh/terminal/CONTRIBUTING.md)。

采用 [MIT 许可证](https://npmcn.com/package/%40gloom-sh/terminal/LICENSE)。基于 [OpenTUI](https://opentui.com/) 构建。[赞助 Gloom](https://gloom.sh/sponsor)。

## 常见问题

### @gloom-sh/terminal 是什么？

终端的市场研究和组合跟踪器

### 如何安装 @gloom-sh/terminal？

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

### @gloom-sh/terminal 支持 TypeScript 吗？

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

### @gloom-sh/terminal 支持 ESM 还是 CommonJS？

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

### @gloom-sh/terminal 可以商用吗？

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

### @gloom-sh/terminal 的下载量有多少？

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

### @gloom-sh/terminal 还在维护吗？

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

