gloomberb 0.9.9 → 0.10.0

package/README.md

@@ -11,6 +11,8 @@ Desktop app for macOS and Windows. Terminal UI for macOS, Linux, and Windows.
 <a href="https://gloomberb.com/download/desktop"><strong>Download desktop</strong></a>
 &nbsp;&middot;&nbsp;
 <a href="#install"><strong>Install the TUI</strong></a>
+&nbsp;&middot;&nbsp;
+<a href="README.zh-CN.md">简体中文</a>
 
 <br />
 <br />
@@ -62,9 +64,11 @@ This installs `gloomberb` to `~/.local/bin` by default. A Linux desktop package
 
 Install the desktop app:
 
-- [Download GloomberbSetup.exe for Windows x64](https://github.com/vincelwt/gloomberb/releases/latest/download/stable-win-x64-GloomberbSetup.exe)
+- [Download GloomberbSetup.exe for Windows](https://github.com/vincelwt/gloomberb/releases/latest/download/stable-win-x64-GloomberbSetup.exe)
+
+The installer supports Windows 11 on x64 and ARM64. On ARM64, the desktop app and its bundled `gloomberb` terminal command use Windows' built-in x64 emulation.
 
-The installer adds the app and a `gloomberb` terminal command. For a terminal-only setup, install Bun and use the package:
+For a terminal-only setup on x64, install Bun and use the package:
 
 ```powershell
 bun install -g gloomberb
@@ -88,6 +92,8 @@ On macOS and Windows, desktop updates replace the installed app in place and kee
 
 For the best terminal experience, use a [Kitty](https://sw.kovidgoyal.net/kitty/)-compatible terminal such as Ghostty, Kitty, or WezTerm.
 
+Live TV in the terminal also requires `mpv` with Kitty video output. Gloomberb resolves the stream in JavaScript and runs `mpv` with its `yt-dlp` integration disabled, so `yt-dlp` is not required.
+
 ## Start
 
 Open command mode with `Ctrl+P`, then type a command. Press `` ` `` to open ticker search directly.
@@ -96,6 +102,7 @@ Open command mode with `Ctrl+P`, then type a command. Press `` ` `` to open tick
 |-----|-------|
 | `DES AAPL` | Security details |
 | `GP NVDA` | Price chart |
+| `G AAPL:price, MSFT:revenue` | Mixed-series chart |
 | `TOP` | Ranked market stories |
 | `HM` | Market heatmap |
 | `MOST` | Market movers |
@@ -191,6 +198,7 @@ Use `HELP` inside Gloomberb for the live shortcut list. The common command-bar p
 |----------|----------|
 | `DES <ticker>` / `T <ticker>` | Security details for a ticker |
 | `FA <ticker>` | Financial statement view |
+| `G <series>` | Custom chart composer |
 | `GP <ticker>` | Price chart |
 | `GIP <ticker>` | Intraday price chart |
 | `HP <ticker>` | Historical OHLCV prices |
@@ -201,7 +209,7 @@ Use `HELP` inside Gloomberb for the live shortcut list. The common command-bar p
 | `EM [tickers]` | Earnings monitor |
 | `SRCH <query>` | Provider symbol search |
 | `QQ <tickers>` | Ticker quote monitor |
-| `CMP <tickers>` | Ticker charts |
+| `CMP <tickers>` | Normalized price comparison |
 | `CORR <tickers>` | Ticker return correlations |
 | `ANR <ticker>` | Analyst targets and ratings |
 | `SEC <ticker>` | SEC filings and company disclosures |
@@ -212,6 +220,18 @@ Use `HELP` inside Gloomberb for the live shortcut list. The common command-bar p
 | `EVT <ticker>` | Corporate actions, earnings, and estimates |
 | `RV <tickers>` | Relative valuation |
 
+### Chart Composer
+
+`G`, `GP`, `GIP`, `CMP`, `GF`, and `GE` all open the same chart composer with different starting presets. A custom expression can mix unrelated data sources on one synchronized timeline:
+
+```text
+G AAPL:price, MSFT:revenue, FRED:CPIAUCSL
+```
+
+Open **Series** to add, remove, reorder, or hide series and choose each series' field, chart style, transform, axis, panel, period, and panel scale. Price data supports candles, OHLC, HLC, line, and area; scalar data supports its compatible line, area, step, column, and point modes. Panels can use independent left/right axes and linear or logarithmic scales.
+
+The toolbar controls preset or exact date ranges, intervals from one minute through monthly, the primary chart mode, technical indicators, and pair formulas. Indicators include volume, SMA, EMA, Bollinger Bands, RSI, and MACD; formulas include ratio, spread, and rolling correlation. Mixed-frequency values use as-of alignment: fundamentals use filing dates when available, sparse series carry forward only after becoming available, and missing publication dates are called out in the chart status.
+
 ### Markets, News, and Macro
 
 | Shortcut | Function |
@@ -232,6 +252,7 @@ Use `HELP` inside Gloomberb for the live shortcut list. The common command-bar p
 | `ECON` | Economic events and releases |
 | `GC` | Yield curve |
 | `ERN` | Earnings calendar |
+| `TV` | Live Bloomberg, CNBC, and Yahoo Finance television |
 | `BI` / `SP` | S&P 500 sector performance |
 | `FXC` | Major FX cross rates |
 | `FNG` | Fear and greed market gauge |
@@ -245,6 +266,7 @@ Use `HELP` inside Gloomberb for the live shortcut list. The common command-bar p
 | `ALRT` | Price alerts |
 | `SA <symbol condition price>` | Create a price alert |
 | `AI <prompt>` | AI screener |
+| `AGENT` | Local AI research workspace |
 | `CHAT [channel]` | Gloom Cloud chat |
 | `DM @user [@user...]` | Open or start a direct or group chat |
 | `ACM` | Gloom Cloud account settings |
@@ -263,8 +285,24 @@ Use `HELP` inside Gloomberb for the live shortcut list. The common command-bar p
 | `VF` | Toggle quote value flashing |
 | `TH <theme>` | Change color theme |
 | `CR` | Cycle chart renderer |
+| `LANG <locale>` | Change interface language (`auto`, `en`, `zh-CN`, `zh-TW`, `ja`, or `ko`) |
 | `PL <plugin>` | Manage plugins |
 
+## Localized interface
+
+Gloomberb includes English, Simplified Chinese, Traditional Chinese, Japanese, and Korean UI support. English remains the default fallback language.
+
+- **Automatic detection:** supported `LANG` / `LC_ALL` and desktop system locales select the matching interface automatically.
+- **Command switching:** enter `LANG` in the command bar (Ctrl+P) to cycle languages, or use `LANG auto`, `LANG en`, `LANG zh-CN`, `LANG zh-TW`, `LANG ja`, or `LANG ko`. The choice is persisted in `config.json`.
+- **One-run override:** `GLOOMBERB_LANG=ja gloomberb` (or another supported locale) takes highest priority in environments that expose process locale variables.
+
+Implementation notes:
+
+- Locale dictionaries live in [src/i18n](src/i18n), keyed by the original English UI text. Missing entries safely fall back to English.
+- Shared render sinks call `t()` / `tf()` / `tc()` for pane titles, the command bar, menus, settings, tabs, help, and onboarding.
+- Finance abbreviations such as BID, ASK, and CHG% intentionally remain in English for terminal conventions and fixed-width alignment.
+- CJK wide characters and grapheme clusters are measured by [src/utils/format.ts](src/utils/format.ts) using terminal display-cell widths.
+
 ## License
 
 MIT

package/README.zh-CN.md

@@ -0,0 +1,294 @@
+<div align="center">
+
+<img src="https://gloomberb.com/gloomberb-logo-grayscale.svg" alt="Gloomberb logo" width="76" />
+
+# Gloomberb
+
+**开源金融终端。快速、键盘驱动、可扩展。**
+
+桌面应用支持 macOS 和 Windows。终端界面（TUI）支持 macOS、Linux 和 Windows。
+
+<a href="https://gloomberb.com/download/desktop"><strong>下载桌面版</strong></a>
+&nbsp;&middot;&nbsp;
+<a href="#安装">安装 TUI</a>
+&nbsp;&middot;&nbsp;
+<a href="README.md"><strong>English</strong></a>
+
+<br />
+<br />
+
+<img src="https://gloomberb.com/landing-terminal.png" alt="Gloomberb 终端界面，显示投资组合、自选列表、市场数据和图表面板。" width="720" />
+
+</div>
+
+> 本文档为社区维护的简体中文翻译。若与 [英文原版 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/vincelwt/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 <symbols>` | 获取实时行情 |
+| `gloomberb search <query>` / `provider-search <query>` | 搜索股票代码与数据源符号 |
+| `gloomberb ticker <symbol>` | 显示行情、持股结构与财务数据 |
+| `gloomberb history\|financials\|fundamentals\|options <symbol>` | 获取研究数据 |
+| `gloomberb news\|filings\|holders\|insider\|13f\|analyst\|events\|valuation <symbol>` | 获取公司研究信息流 |
+| `gloomberb movers\|indices\|sectors\|fx\|fear-greed\|earnings` | 获取市场概览数据 |
+| `gloomberb econ\|fred\|yield-curve` | 获取宏观数据 |
+| `gloomberb compare\|correlation\|relationship <symbols>` | 对比证券 |
+| `gloomberb portfolio [action]` | 管理手动投资组合 |
+| `gloomberb watchlist [action]` | 管理自选列表 |
+| `gloomberb notes\|alerts [action]` | 管理本地笔记与提醒 |
+| `gloomberb broker\|ibkr [action]` | 查看券商集成状态；交易操作需要显式指定账户/配置并加 `--yes` |
+| `gloomberb ai providers\|ask\|screen` | 使用已配置的 AI 服务商与选股器 |
+| `gloomberb rss fetch <url>` | 抓取 RSS 订阅源 |
+| `gloomberb buildout\|congress\|substack\|x-feed\|tweets` | 在已有会话可用时访问云端与社交数据源 |
+| `gloomberb provider status` | 查看已启用的数据源 |
+| `gloomberb config\|cache\|plugin\|layout\|pane\|debug\|doctor\|version\|changelog` | 查看和管理本地应用状态 |
+| `gloomberb fn [...]` | 运行基于面板的报告命令 |
+| `gloomberb shot [...]` | 捕获基于面板的截图 |
+| `gloomberb predictions [...]` | 启动预测市场 |
+| `gloomberb plugins` | 列出已安装插件 |
+| `gloomberb install <user/repo>` | 从 GitHub 安装插件 |
+| `gloomberb remove <name>` | 移除已安装插件 |
+| `gloomberb update [name]` | 更新插件 |
+
+需要已登录云端会话的命令可能返回 `auth_required`；登录、账户管理与聊天相关操作目前仍需在应用界面中完成。
+
+## 插件
+
+从投资组合列表到券商集成，一切皆为插件。插件可以添加面板、页签、列、命令栏命令、CLI 命令、状态栏组件与数据源。
+
+核心插件领域包括：
+
+- 投资组合、自选列表、手动录入与券商连接
+- 股票详情、行情、图表、期权、监管文件、股东、内部人交易与研究
+- 新闻、Substack 阅读订阅、市场异动、全球股指、板块、外汇、财报、宏观数据与收益率曲线
+- 预测市场、提醒、笔记、聊天、AI 选股器与外部插件
+
+插件 API 以及通过 `gloomberb/components` 提供的共享 UI 界面，详见 [PLUGINS.md](PLUGINS.md)。
+
+## 键盘快捷键
+
+| 按键 | 操作 |
+|-----|--------|
+| `Ctrl+P` | 打开命令模式 |
+| `` ` `` | 打开股票搜索 |
+| `Ctrl+,` | 打开聚焦面板的设置 |
+| `Ctrl+W` | 关闭聚焦面板 |
+| `Ctrl+Shift+M` | 移动聚焦窗口（`WIN resize` 进入缩放模式） |
+| `Ctrl+Shift+D` | 停靠或浮动聚焦面板 |
+| `Ctrl+Shift+L` | 布局操作 |
+| `Ctrl+Shift+G` | 所有窗口网格对齐 |
+| `Tab` | 切换面板 |
+| `j` / `k` | 列表导航 |
+| `h` / `l` | 切换页签 |
+| `m` | 循环切换图表模式 |
+| `q` | 退出 |
+
+桌面版还支持 `Cmd/Ctrl+K` 打开命令栏、macOS 上对应的 `Cmd` 快捷键、`Cmd/Ctrl+Shift+O` 弹出面板为独立窗口，以及 `Cmd/Ctrl+Shift+C` 复制聚焦面板截图。
+
+## 命令参考
+
+在 Gloomberb 内输入 `HELP` 可查看实时快捷键列表。以下列出常用命令栏前缀，方便快速查阅。
+
+### 公司研究
+
+| 快捷指令 | 功能 |
+|----------|----------|
+| `DES <ticker>` / `T <ticker>` | 股票的证券详情 |
+| `FA <ticker>` | 财务报表视图 |
+| `GP <ticker>` | 价格图表 |
+| `GIP <ticker>` | 盘中价格图表 |
+| `HP <ticker>` | 历史 OHLCV 价格 |
+| `GF <tickers>` | 基本面报表图表 |
+| `GE <tickers>` | 估值倍数图表 |
+| `GR <tickers>` | 证券关系图 |
+| `EE <ticker>` | 含 EPS 与营收预估的事件视图 |
+| `EM [tickers]` | 财报监控 |
+| `SRCH <query>` | 数据源符号搜索 |
+| `QQ <tickers>` | 股票行情监控 |
+| `CMP <tickers>` | 股票图表对比 |
+| `CORR <tickers>` | 股票收益率相关性 |
+| `ANR <ticker>` | 分析师目标价与评级 |
+| `SEC <ticker>` | SEC 申报文件与公司披露 |
+| `OMON <ticker>` | 期权监控 |
+| `HDS <ticker>` | 机构股东 |
+| `13F [fund/ticker/CIK]` | 13F 基金申报与持仓 |
+| `INS <ticker>` | 内部人交易动态 |
+| `EVT <ticker>` | 公司行动、财报与预估 |
+| `RV <tickers>` | 相对估值 |
+
+### 市场、新闻与宏观
+
+| 快捷指令 | 功能 |
+|----------|----------|
+| `TOP` | 排名市场头条 |
+| `HM` | 美股大盘股与 ETF 市场热力图 |
+| `MOST` | 涨幅榜、跌幅榜、成交活跃与热门股票 |
+| `PM <query>` | Polymarket 与 Kalshi 预测数据 |
+| `N` | 新闻源 |
+| `CN <ticker>` | 个股新闻 |
+| `NI` | 板块新闻 |
+| `SUB` | 已登录的 Substack 阅读订阅源 |
+| `FIRST` | 突发新闻 |
+| `TWIT <query>` | 与股票相关的市场动态帖子 |
+| `TBO` | TheBuildout 基础设施情报 |
+| `CG` | 国会交易披露 |
+| `WEI` | 全球股指 |
+| `ECON` | 经济事件与数据发布 |
+| `GC` | 收益率曲线 |
+| `ERN` | 财报日历 |
+| `BI` / `SP` | 标普 500 板块表现 |
+| `FXC` | 主要外汇交叉汇率 |
+| `FNG` | 恐惧与贪婪市场指数 |
+
+### 工作区与应用控制
+
+| 快捷指令 | 功能 |
+|----------|----------|
+| `PF` | 投资组合与自选列表工作区 |
+| `PORT` | 投资组合风险与板块敞口 |
+| `ALRT` | 价格提醒 |
+| `SA <symbol condition price>` | 创建价格提醒 |
+| `AI <prompt>` | AI 选股器 |
+| `CHAT [channel]` | Gloom Cloud 聊天 |
+| `DM @user [@user...]` | 打开或发起私信/群聊 |
+| `ACM` | Gloom Cloud 账户设置 |
+| `NOTE` | 笔记 |
+| `IBKR` | IBKR 交易面板 |
+| `BR` | 券商连接 |
+| `CHG` | 更新日志 |
+| `HELP` | 打开快捷键与布局帮助 |
+| `AW` / `AP <ticker>` | 将股票添加到活动自选列表或投资组合 |
+| `RW` / `RP <ticker>` | 从活动自选列表或投资组合中移除股票 |
+| `PS` | 打开聚焦面板的设置 |
+| `LAY <action>` | 打开布局操作 |
+| `WIN move\|resize` | 移动或缩放聚焦窗口 |
+| `GL` | 所有可见面板网格对齐 |
+| `SB` | 切换状态栏 |
+| `VF` | 切换行情数值闪烁 |
+| `TH <theme>` | 更换配色主题 |
+| `CR` | 切换图表渲染器 |
+| `LANG <locale>` | 切换界面语言（`auto`、`en`、`zh-CN`、`zh-TW`、`ja` 或 `ko`） |
+| `PL <plugin>` | 管理插件 |
+
+## 本地化界面
+
+Gloomberb 内置 English、简体中文、繁體中文、日本語和한국어界面支持；英文仍是默认回退语言。
+
+- **自动检测**：终端 `LANG` / `LC_ALL` 与桌面系统语言会自动选择受支持的界面语言。
+- **命令切换**：在命令栏（Ctrl+P）输入 `LANG` 可循环切换，也可直接输入 `LANG auto`、`LANG en`、`LANG zh-CN`、`LANG zh-TW`、`LANG ja` 或 `LANG ko`。选择会保存到 `config.json`。
+- **单次覆盖**：在可读取进程语言变量的环境中，可用 `GLOOMBERB_LANG=ja gloomberb`（或其他受支持的语言代码）进行最高优先级覆盖。
+
+实现说明：
+
+- 各语言词典位于 [src/i18n](src/i18n)，以英文原文为键；查不到的词条自动回退英文，因此可以增量补充翻译，不影响任何功能。
+- 渲染出口统一经过 `t()`（[src/i18n/index.ts](src/i18n/index.ts)），面板标题、命令栏、右键菜单、设置对话框、页签、帮助与引导页均已接入。
+- 表格列头（BID/ASK/CHG% 等金融缩写）刻意保留英文，符合行情终端惯例并保证定宽列对齐。
+- 中日韩宽字符和字素簇的截断与排版由 [src/utils/format.ts](src/utils/format.ts) 按终端单元格宽度处理。
+
+## 许可证
+
+MIT
+
+## 致谢
+
+- [OpenTUI](https://opentui.com/) 提供布局引擎

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gloomberb",
-  "version": "0.9.9",
+  "version": "0.10.0",
   "description": "Market research and portfolio tracker for the terminal",
   "module": "src/index.tsx",
   "type": "module",
@@ -22,6 +22,7 @@
     "desktop:build": "electrobun build",
     "desktop:release": "electrobun build --env=stable",
     "desktop:release:windows": "electrobun build --env=stable --targets=win-x64",
+    "i18n:audit": "bun run scripts/i18n-audit.ts",
     "test": "bun test",
     "release": "./scripts/release.sh"
   },
@@ -42,24 +43,29 @@
     "@types/react-dom": "^19.2.3",
     "electrobun": "^1.18.1",
     "png-to-ico": "^2.1.8",
-    "rcedit": "^4.0.1",
-    "react-dom": "19.2.7"
+    "rcedit": "^4.0.1"
   },
   "peerDependencies": {
     "typescript": "^5.9.2"
   },
   "dependencies": {
+    "@earendil-works/pi-agent-core": "0.81.1",
+    "@earendil-works/pi-ai": "0.81.1",
     "@opentui-ui/dialog": "^0.1.2",
     "@opentui-ui/toast": "^0.0.5",
     "@opentui/core": "^0.3.2",
     "@opentui/react": "^0.3.2",
     "@stoqey/ib": "^1.5.6",
     "@tanstack/react-virtual": "^3.14.2",
+    "hls.js": "1.6.13",
     "jimp": "1.6.1",
     "opentui-spinner": "^0.0.6",
     "react": "19.2.7",
+    "react-dom": "19.2.7",
     "rxjs": "^7.8.2",
-    "web-tree-sitter": "0.25.10"
+    "typebox": "1.1.38",
+    "web-tree-sitter": "0.25.10",
+    "youtubei.js": "17.0.1"
   },
   "patchedDependencies": {
     "@opentui/core@0.3.2": "patches/@opentui%2Fcore@0.3.2.patch",