# Gloomberb
**开源金融终端。快速、键盘驱动、可扩展。**
桌面应用支持 macOS 和 Windows。终端界面（TUI）支持 macOS、Linux 和 Windows。
下载桌面版
·
安装 TUI
·
English
> 本文档为社区维护的简体中文翻译。若与 [英文原版 README](README.md) 有出入，以英文版为准。
## 桌面版还是 TUI？
Gloomberb 有两种使用方式：
| 形态 | 适合场景 | 运行方式 |
|---------|----------|-------------|
| 桌面应用 | 精美的应用窗口、可弹出面板、系统级快捷键、内置更新 | 发布支持 macOS 和 Windows，同时会安装 `gloomberb` 终端命令用于运行 TUI |
| 终端界面 (TUI) | 终端内的高速键盘操作、SSH/开发机、Linux 主机、脚本友好的场景 | 在 macOS、Linux、Windows 上通过 `gloomberb` 运行 |
两者共享同一套命令语言、插件系统、市场数据界面、投资组合、自选列表、提醒、笔记与 AI 工具。
## 安装
### macOS
安装桌面应用和 `gloomberb` 终端命令：
```bash
brew install --cask vincelwt/tap/gloomberb
# 或
curl -fsSL gloomberb.com/install | bash
```
两种方式都会安装 `Gloomberb.app`，以及一个通过应用内置运行时执行 TUI 的 `gloomberb` 命令，运行时只会存储一份。
想直接下载？
- [下载 Gloomberb（Mac 版）](https://gloomberb.com/download/desktop)
### Linux
安装独立的 TUI 可执行文件：
```bash
curl -fsSL gloomberb.com/install | bash
```
默认会将 `gloomberb` 安装到 `~/.local/bin`。Linux 桌面安装包暂未发布。
### Windows
安装桌面应用：
- [下载 GloomberbSetup.exe（Windows x64）](https://github.com/gloom-sh/gloomberb/releases/latest/download/stable-win-x64-GloomberbSetup.exe)
安装程序会添加应用本体和 `gloomberb` 终端命令。如果只需要终端版本，安装 Bun 后使用该包即可：
```powershell
bun install -g gloomberb
```
### 终端安装包
已经装好 Bun？在任意受支持的系统上执行：
```bash
bun install -g gloomberb
```
然后运行：
```bash
gloomberb
```
在 macOS 和 Windows 上，桌面版更新会原地替换已安装的应用，并让终端命令继续指向更新后的运行时。Homebrew 用户也可以通过 `brew upgrade --cask gloomberb` 更新。
为获得最佳终端体验，请使用兼容 [Kitty](https://sw.kovidgoyal.net/kitty/) 图形协议的终端，例如 Ghostty、Kitty 或 WezTerm。
## 开始使用
按 `Ctrl+P` 打开命令模式，然后输入命令。按 `` ` `` 可直接打开股票搜索。
| 试试 | 打开 |
|-----|-------|
| `DES AAPL` | 证券详情 |
| `GP NVDA` | 价格图表 |
| `TOP` | 排名市场头条 |
| `HM` | 市场热力图 |
| `MOST` | 市场异动 |
| `PF` | 投资组合与自选列表 |
| `KELLY AAPL` | 仓位计算 |
| `HELP` | 完整的应用内快捷键列表 |
## 功能概览
- **公司研究**：行情、图表、财务报表、监管文件、股东、内部人交易、期权、分析师评级、事件与相对估值。
- **市场追踪**：头条新闻、突发新闻、板块新闻、Substack 订阅、全球股指、外汇、宏观事件、收益率曲线、市场异动与恐惧贪婪指数。
- **组合管理**：跟踪投资组合与自选列表、连接券商、设置提醒、记笔记、运行 AI 选股、浏览预测市场，并使用 Gloom Cloud 聊天。
## 命令行 (CLI)
不带参数运行 `gloomberb` 会启动终端界面。普通命令走无界面（headless）的 CLI 路径；脚本若需要显式打开 UI，使用 `gloomberb launch-ui`。
默认输出为易读的人类可读格式。自动化场景可通过 `--json`、`--csv` 或 `--ndjson` 选择结构化输出。JSON 输出会使用能获取到的最丰富的数据模型，并在命令带有表格列时附带列元数据；CSV 和 NDJSON 则使用命令的表格行视图。常用全局参数包括 `--limit`、`--refresh`、`--quiet`、`--no-color`、`--dry-run` 和 `--yes`。
| 命令 | 用途 |
|---------|-----|
| `gloomberb` | 启动终端界面 |
| `gloomberb launch-ui` | 显式启动终端界面 |
| `gloomberb help` | 显示全部 CLI 命令 |
| `gloomberb api list\|get\|invoke\|subscribe` | 直接查看和调用插件能力 |
| `gloomberb quote