Lumina Terminal
简体中文 | English
一个基于 Tauri、React 和 Xterm.js 构建的现代跨平台终端模拟器，拥有精美的界面、命令面板和可自定义的配置文件。
## 安装
* Arch Linux（使用 `paru` 或 `yay` 等 AUR 助手）：
```shell
paru -S lumina-terminal-bin
# 或：yay -S lumina-terminal-bin
```
* Fedora（通过 COPR）：
```shell
dnf copr enable iewnfod/lumina-terminal
dnf install lumina-terminal
```
* 其他 Linux / macOS：使用脚本安装
```shell
curl -fsSL https://raw.githubusercontent.com/iewnfod/lumina-terminal/master/scripts/install.sh | bash
```
* Windows：从[发布页](https://github.com/iewnfod/lumina-terminal/releases)下载安装包
## 截图
### 终端
### 命令面板
### 设置
### 配置文件
## 功能特性
### 终端
* 基于 [portable-pty](https://docs.rs/portable-pty/latest/portable_pty/) 的多标签页终端 — 每个标签页运行一个真实的 Shell 进程
* **撕离标签页** — 将标签页移到独立窗口（`Ctrl+Shift+L` / `Cmd+Shift+L`），同时保留运行中的进程和滚动历史
* **终端内查找**（`Ctrl+F` / `Cmd+F`）— 支持区分大小写 / 全字匹配 / 正则，并显示实时结果计数，基于 [addon-search](https://github.com/xtermjs/xterm.js/tree/master/addons/addon-search)
* 每个配置文件可指定不同的 Shell — 支持 PowerShell、WSL、Git Bash 等任意可执行文件
* **将配置文件封装为应用** — 生成桌面启动器（`.desktop` / `.app` / 开始菜单快捷方式），在独立窗口中打开该配置：独立的标题、工作目录与侧边栏可见性，图标默认按启动命令自动推导（也可手动指定）。启动器在每次保存设置时重新生成，孤立的启动器会自动清理。在 设置 → 配置文件 中按配置开启。
* 可选的 [WebGL 渲染器](https://github.com/xtermjs/xterm.js/tree/master/addons/addon-webgl) — GPU 加速渲染
* [Unicode 11 宽度规则](https://github.com/xtermjs/xterm.js/tree/master/addons/addon-unicode11) + 可选的[字形簇](https://github.com/xtermjs/xterm.js/tree/master/addons/addon-unicode-graphemes)渲染，正确处理 emoji/符号宽度
* 可选的[编程连体字](https://github.com/princjef/font-ligatures) — 通过字体真实的 OpenType GSUB 表实现（Fira Code 的 `www`、`//`，JetBrains Mono 的 `==` 等）
* 分块批量输出 — 流畅处理大文本输出，不阻塞 UI
* 拖放文件到终端即可插入文件路径；窗口/容器变化时自动调整尺寸
* **MCP 服务器（实验性）** — 可选地通过只读回环端点向本地 AI 客户端暴露终端状态(打开的标签页、运行中的命令、当前目录、最近输出),基于 [rmcp](https://github.com/modelcontextprotocol/rust-sdk) 实现。在「设置 → 开发者」中开启。
* **Shell 补全弹窗** — 通过 shell 集成拦截 zsh/fish 标签页中的 TAB：把 shell 自身的补全候选（命令、文件、git 子命令、描述）发送给 Lumina，渲染为可键盘导航的悬浮建议弹窗（VSCode 风格），替代 shell 在缓冲区内打印的列表；选中一项即插入行编辑器。唯一匹配时静默补全。开启后仅对新终端生效；bash/nu/pwsh/SSH 标签页保持原生行为。在「设置 → 通用」中开关。 另有可选的**输入时自动补全模式**（实验性）：输入停顿后自动请求候选，无需按 TAB，弹窗随输入实时收窄（对已打开的 zsh/fish 终端即时生效；默认关闭，可能无法稳定工作）。
* **自动同步代理** — 检测系统代理变化（GNOME `gsettings` / KDE `kioslaverc` / macOS `scutil` / Windows 注册表），让正在运行的 bash/zsh/fish 标签页内的 `http_proxy` / `HTTPS_PROXY` / `all_proxy` / `no_proxy` 自动跟随——由 shell 集成的提示符钩子静默应用，无需重启、无可见按键。用户手动 export 的代理不受影响。在「设置 → 通用」中开关。
### 用户界面
* **命令面板**（`Ctrl+Shift+P` / `Cmd+Shift+P`）— 搜索并执行命令，支持键盘导航
* **标签栏** — 侧边栏显示标签列表，支持拖拽区域和悬停关闭，可通过标题栏或命令面板切换
* **命令图标** — 标签页图标跟随正在运行的命令（vim、neovim、opencode、Claude Code 等）。支持自定义规则：按命令名精确匹配，或用正则匹配整条命令行；可选用内置应用图标，也可导入自己的 SVG/PNG。在 设置 → 命令图标 中配置。
* **自定义标题栏** — Windows 和 Linux 上窗口控制按钮与终端主题颜色融为一体；双击任意拖动区域（标题栏、侧栏头部、空状态页）即可最大化/还原窗口
* **自动主题** — UI 明暗模式自动跟随终端背景色
* **颜色扩散** — 全屏 TUI 程序统一的边缘背景可铺满整个窗口边框，沉浸感更强（可在设置中开关）
### 键盘快捷键
* 完全可自定义的快捷键配置，保存在配置文件中。默认快捷键：
* `Ctrl/Cmd+T` 新建标签页 · `Ctrl/Cmd+W` 关闭标签页（空状态下关闭应用）
* `Ctrl/Cmd+Shift+L` 撕离标签页 · `Ctrl/Cmd+F` 查找
* `Ctrl/Cmd+Shift+C` 复制选中内容 · `Ctrl/Cmd+Shift+A` 全选
* `Ctrl/Cmd+Shift+V` 粘贴（原生 `Ctrl/Cmd+V` 粘贴同样可用）
* `Ctrl/Cmd+,` 打开设置 · `Ctrl/Cmd+Shift+P` 命令面板
* `Ctrl/Cmd+1–9` 按序号切换标签页
* 没有选区时复制动作会放行按键直达 shell，因此即使把 `Ctrl+C` 绑定为复制，空选区时仍发送 SIGINT
### 配置文件
* 多个命名配置文件，各自独立设置 Shell、尺寸、字体、主题和启动命令（如 `vim`、`opencode`，命令退出时标签页关闭；SSH 配置文件会传给远程主机）
* 自定义终端主题，通过 JSON 文件加载（xterm.js ITheme 格式），支持实时颜色预览
### 国际化
* 英语 · 简体中文
### 欢迎向导
* 首次启动引导：语言选择 → 创建配置文件 → 撒花完成
## 命令行参数
Lumina 支持类似 Alacritty 的启动参数（外加 Lumina 特有的 `--profile` 和 `--sidebar`）。传入任一**标签塑形**参数（`-e`、`--working-directory`、`-T`、`--hold`、`--profile`）时，会**只打开一个标签页**应用这些覆盖配置并跳过会话恢复；`--sidebar` 仅覆盖本次启动的侧边栏可见性，不影响标签页初始化。
| 参数 | 说明 |
|------|------|
| `-e, --command ...` | 启动时运行的命令及参数。通过配置文件的 shell 执行；除非给定 `--hold`，命令退出后标签页关闭。其后的参数属于命令，**但** Lumina 自己的参数（`-T/--title`、`--hold`、`--working-directory`、`--profile`）仍按参数解析 —— 因此 `-e nvim -T nvim` 会运行 nvim 并把窗口标题设为 "nvim"。使用 `--` 可让其后的所有内容原样传给命令（如 `-e -- ssh -T host`）。 |
| `--working-directory ` | 在此目录启动 shell。 |
| `-T, --title ` | 设置窗口标题。 |
| `--hold` | 命令退出后保持终端打开（冻结输出、只读）。 |
| `--profile <NAME>` | 按名称打开某个配置文件；其它参数在其基础上叠加。找不到时回退到默认配置文件。*（Lumina 特有）* |
| `--sidebar <SHOW\|HIDE>` | 仅本次启动显示/隐藏侧边栏，忽略设置但**不覆盖**它（首次显式切换后覆盖即失效）。*（Lumina 特有）* |
| `--version` / `--help` | 打印版本 / 用法并退出（不启动窗口）。 |
```shell
lumina-terminal -e nvim # 运行 nvim；:q 后关闭
lumina-terminal -e nvim -T nvim # 运行 nvim，窗口标题设为 "nvim"
lumina-terminal --hold -e ls -la # 运行 ls -la 并保留输出
lumina-terminal --working-directory ~/projects -e npm run dev
lumina-terminal --profile work # 打开 "work" 配置文件
lumina-terminal --hold --profile dev -e cargo build
lumina-terminal -T "build log" # 设置窗口标题
lumina-terminal --sidebar hide # 本次启动隐藏侧边栏（不改设置）
```
## 配置
用户配置存放在 `config.toml`（TOML 格式，支持手写注释）。全部可配置项 —— 包括没有设置界面的「仅配置文件」字段 —— 都在[配置参考](https://github.com/iewnfod/lumina-terminal/wiki/Configuration_zh)中说明。旧版本的 `config.json` 仍可解析，并会在首次启动时自动迁移；原文件保留为 `config.json.bak`。配置文件被实时监听：手动修改无需重启即可生效，应用自身的保存也以补丁方式写回，你的键序和注释不会被打乱。渲染选项（字体、主题、光标……）会热应用到正在运行的终端；`rows`/`cols` 与 webgl 开关仅对新终端生效。
## 性能
Lumina Terminal 的渲染管线针对高负载输出做了调优 —— 大文件 `cat`、ANSI 密集的 TUI、滚动、Unicode —— 同时通过读取背压保持内存占用可控。
以下基准测试使用 [vtebench](https://github.com/alacritty/vtebench)（Alacritty 使用的同一套测试工具），报告 **90 分位**（p90）采样延迟（越低越好）。Lumina 与以下三个同类对比：
- [Alacritty](https://alacritty.org/) — 原生 Rust + OpenGL，任何终端的性能天花板
- [Tabby](https://tabby.sh/) — Electron + xterm.js，流行的 Web 技术终端
- VS Code 内置终端 — Electron + xterm.js，使用最广泛的 Web 技术终端
| 测试 | Lumina | Alacritty | Tabby | VS Code |
|------|-------:|----------:|------:|--------:|
| cursor_motion | 58ms | 9ms | 89ms | 165ms |
| light_cells | 41ms | 8ms | 60ms | 138ms |
| medium_cells | 4ms | 8ms | 73ms | 320ms |
| dense_cells | 135ms | 25ms | 247ms | 473ms |
| scrolling_fullscreen | 6ms | 10ms | 74ms | 139ms |
| scrolling | 257ms | 158ms | 198ms | 730ms |
| scrolling_top_region | 176ms | 172ms | 191ms | 1296ms |
| scrolling_bottom_region | 263ms | 128ms | 198ms | 1250ms |
| scrolling_top_small_region | 277ms | 138ms | 175ms | 1391ms |
| scrolling_bottom_small_region | 248ms | 190ms | 181ms | 1364ms |
| sync_medium_cells | 4ms | 9ms | 72ms | 164ms |
| unicode | 4ms | 7ms | 73ms | 56ms |
Lumina 在多个测试中**追平甚至超越 Alacritty**（medium_cells、scrolling_fullscreen、sync_medium_cells、unicode），并**全面优于 Tabby 和 VS Code 内置终端** —— 而它们运行的是同样的底层 Web 渲染技术栈。
作为纯渲染压力测试，[DOOM Fire](https://github.com/const-void/DOOM-fire-node)（持续全屏 ANSI 动画）测量持续帧率（越高越好）：
| | Lumina | Alacritty | Tabby | VS Code |
|---|-------:|----------:|------:|--------:|
| fps | ~420 | ~1800 | ~175 | ~60 |
在持续重度重绘下，Lumina 保持着 **Tabby 和 VS Code 约 7 倍的帧率**。
> 测试平台：`AMD Ryzen™ AI 9 HX 370 w`, `NVIDIA GeForce RTX™ 5080 Laptop GPU`, Arch Linux
## 开发
```shell
git clone https://github.com/iewnfod/lumina-terminal.git
cd lumina-terminal
pnpm install
pnpm tauri dev
```
开发环境搭建、应用图标指南和代码规范请见 [**CONTRIBUTING.md**](./CONTRIBUTING.md)。完整的架构说明和贡献者规则在 [AGENTS.md](./AGENTS.md) 中。
## 使用的技术
<!-- lumina:tech-stack — anchor parsed by the About page; keep on its own line -->
### 核心
* [Tauri & Tauri Plugins](https://tauri.app/) — 跨平台桌面框架
* [Rust](https://rust-lang.org/) — 后端语言(PTY、MCP、文件系统)
* [portable-pty](https://docs.rs/portable-pty/latest/portable_pty/) — 伪终端创建与 I/O
### 后端
* [clap](https://docs.rs/clap/) — 命令行参数解析
* [rmcp](https://github.com/modelcontextprotocol/rust-sdk) — 模型上下文协议(Model Context Protocol)服务器
* [axum](https://github.com/tokio-rs/axum) — 模块化 Web 框架(MCP Streamable HTTP 端点)
* [tokio](https://tokio.rs/) — 异步运行时
* [log](https://docs.rs/log/latest/log/) — 结构化日志
* [base64](https://docs.rs/base64/) — 启动器图标 PNG 载荷解码
### 前端
* [TypeScript](https://www.typescriptlang.org/) — 类型化前端语言
* [React](https://zh-hans.react.dev/) — UI 组件框架
* [HeroUI](https://heroui.com/) — React UI 组件库
* [Xterm.js & Addons](https://xtermjs.org/) — 终端渲染器
* [Tailwind CSS](https://tailwindcss.com/) — 实用优先的样式方案
* [Lucide Icons](https://lucide.dev/) — 图标库
* [Framer Motion](https://www.framer.com/motion/) — 动画库
* [react-markdown](https://github.com/remarkjs/react-markdown) — Markdown 渲染
* [smol-toml](https://github.com/squirrelchat/smol-toml) — 配置文件的 TOML 解析/序列化
* [toml-patch](https://github.com/DecimalTurn/toml-patch/) — 配置文件写回时保留注释与排版的 TOML 补丁重写
### 工具链
* [pnpm](https://pnpm.io/) — 包管理器
* [Vite](https://cn.vite.dev/) — 打包与开发服务器
## 开源协议
[Mozilla Public License Version 2.0](./LICENSE)
## 宣发社区
* [LINUX DO](https://linux.do/)