docs: document optional TUI dashboard

Author: Xiang Li

README.md

@@ -1,23 +1,35 @@
 <h1 align="center">
-  🐧 Clash for Linux</a>
+  🐧 Clash for Linux TUI
   <br>
 </h1>
 
 <p align="center">
-  💬 社区交流：<a href="https://t.me/+NsYaX9kzqERlNzZl">Telegram 群</a>
+  基于 <a href="https://github.com/wnlen/clash-for-linux">wnlen/clash-for-linux</a> 改进，新增交互式 TUI 仪表盘
 </p>
 
 <h3 align="center">
 一个更完整、更优雅的 Linux Clash / <a href="https://github.com/MetaCubeX/mihomo">Mihomo</a> 运行平台。
 </h3>
+
 <p align="center">
   <img src="resources/shell.png" width="100%">
 </p>
 
+## 🔀 Fork 说明
+
+本项目 Fork 自 [wnlen/clash-for-linux](https://github.com/wnlen/clash-for-linux)，在原项目基础上新增了以下改进：
+
+- **交互式 TUI 仪表盘** — 基于 [gum](https://github.com/charmbracelet/gum) 构建的终端控制台，一条命令 `clashctl tui` 即可进入全功能可视化管理界面
+- **节点延迟测速** — 支持并发测速所有节点，实时显示延迟数据并按延迟排序
+- **节点名称 Unicode 兼容** — 修复了含 emoji / 中文的策略组和节点名在 API 调用中的编码问题
 
+> 上游仓库的所有功能均完整保留，TUI 为增量功能，不影响原有命令行操作方式。
+
+------
 
 # ✨ 核心特性
 
+- 🖥️ **TUI 仪表盘**：终端内全功能可视化控制台（`clashctl tui`）
 - 🚀 **自动识别系统架构**：自动下载并使用对应 Clash 内核
 - 🧪 **端口自动检测与分配**：避免冲突
 - 🔄 **多订阅管理**：可以保存多个订阅，通过 `clashctl use` 切换当前主订阅。
@@ -26,7 +38,7 @@
 - 🧠 **Mixin 机制**：可按需追加/覆盖 Clash 配置
 - 👤 **不同权限**：兼容 `root` 与普通用户环境。
 - 🔐 **安全默认配置**：自动生成或自定义 Secret
-- 🩺 **内置诊断工具（`doctor`）**：快速排障 
+- 🩺 **内置诊断工具（`doctor`）**：快速排障
 
 ### 适用场景
 
@@ -36,13 +48,155 @@
 - 需要稳定访问 GitHub、Go / Node / Docker 生态的开发者
 - 不希望手动维护 Clash 运行状态的用户
 
+------
+
+# 🖥️ TUI 仪表盘
+
+通过 `clashctl tui` 进入交互式终端控制台，无需记忆命令即可管理所有功能。
+
+### 启动方式
+
+```bash
+clashctl tui
+```
+
+### 主界面
+
+TUI 启动后会显示状态面板和功能菜单：
+
+<!-- TODO: 替换为真实截图 -->
+<!-- <p align="center"><img src="resources/tui-main.png" width="80%"></p> -->
+
+```
+╔══════════════════════════════════════╗
+║       🐱 Clash TUI 控制台            ║
+╚══════════════════════════════════════╝
+
+╭──────────────────────────────────────╮
+│ ✅ 代理状态：已运行                    │
+│ 📡 当前订阅：my-sub                   │
+│ 🚀 当前节点：香港 IPLC 01             │
+│ 🌐 可用性  ：google.com ✓            │
+│ 🗺  代理模式：rule                    │
+│ 🟢 风险等级：low                      │
+│ 🔧 运行内核：mihomo                   │
+│ ⚙️  运行后端：systemd                 │
+│ 🌐 代理端口：7890                     │
+│ 📜 系统代理：已设置                    │
+│ 🚦 开机接管：已开启                    │
+╰──────────────────────────────────────╯
+
+> ⛔  关闭代理
+  💫  切换节点
+  💱  切换订阅
+  🌐  代理模式
+  🔌  活跃连接
+  📡  订阅管理
+  📋  订阅列表
+  🔍  状态详情
+  🩺  系统诊断
+  📜  查看日志
+  🧩  配置管理
+  🧪  Tun 管理
+  🚦  开机接管
+  🔑  密钥管理
+  🔄  刷新状态
+  ❌  退出
+```
+
+### 功能详解
+
+| 功能 | 说明 |
+|------|------|
+| **切换节点** | 浏览所有策略组，搜索过滤节点，查看延迟，支持一键并发测速所有节点 |
+| **切换订阅** | 快速切换当前激活的订阅源 |
+| **代理模式** | 在 Rule / Global / Direct 模式之间一键切换 |
+| **活跃连接** | 查看当前活跃连接列表，分页浏览，支持一键关闭所有连接 |
+| **订阅管理** | 添加 / 启用 / 禁用 / 重命名 / 删除订阅 |
+| **订阅列表** | 查看所有已保存订阅的状态 |
+| **状态详情** | 展示运行内核版本、端口、配置路径等详细信息 |
+| **系统诊断** | 调用 `doctor` 诊断面板，快速排查问题 |
+| **查看日志** | 实时查看 Clash 运行日志，支持级别过滤 |
+| **配置管理** | 查看 / 编辑 / 重新生成运行配置 |
+| **Tun 管理** | 启用 / 关闭 Tun 模式，查看 Tun 诊断 |
+| **开机接管** | 管理开机自启和系统代理持久化 |
+| **密钥管理** | 查看和修改 Web 控制台访问密钥 |
+
+### 节点切换与测速
+
+<!-- TODO: 替换为真实截图 -->
+<!-- <p align="center"><img src="resources/tui-node-select.png" width="80%"></p> -->
+
+```
+╔══════════════════════════════════════╗
+║          💫 切换节点                  ║
+╚══════════════════════════════════════╝
+
+选择策略组（ESC / 🔙 返回主菜单）
+> 🔍 搜索策略组...
+
+  节点选择       │  Selector  │  香港 IPLC 01
+  自动选择       │  URLTest   │  日本 NTT 03
+  故障转移       │  Fallback  │  新加坡 BGP 02
+
+────────────────────────────────────────
+
+  ⚡  测速所有节点
+  🔙  返回策略组
+
+  🇭🇰  香港 IPLC 01       ⚡ 58ms    ← 当前
+  🇭🇰  香港 IPLC 02       ⚡ 72ms
+  🇯🇵  日本 NTT 03        ⚡ 89ms
+  🇸🇬  新加坡 BGP 02      ⚡ 112ms
+  🇺🇸  美国 San Jose 01   ⚡ 186ms
+  🇰🇷  韩国 首尔 01       ⏱ 超时
+```
+
+- 支持 **模糊搜索**：输入关键字快速定位策略组和节点
+- 支持 **并发测速**：对所有节点同时发起测速请求（约 3 秒完成），结果按延迟排序显示
+- 测速结果会被缓存，在当前选择会话中复用，切换节点无需重复测速
+
+### 可选依赖
+
+TUI 依赖 [gum](https://github.com/charmbracelet/gum)（Charm 出品的终端 UI 工具）。gum 不是主安装依赖；未安装时仅 `clashctl tui` 不可用，`clashon`、`clashoff`、`clashctl select`、`status`、`doctor` 等命令不受影响。
+
+```bash
+# macOS
+brew install gum
+
+# Arch Linux
+pacman -S gum
+
+# Ubuntu/Debian
+sudo mkdir -p /etc/apt/keyrings
+curl -fsSL https://repo.charm.sh/apt/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/charm.gpg
+echo "deb [signed-by=/etc/apt/keyrings/charm.gpg] https://repo.charm.sh/apt/ * *" | sudo tee /etc/apt/sources.list.d/charm.list
+sudo apt update && sudo apt install gum
+
+# Fedora/RHEL
+echo '[charm]
+name=Charm
+baseurl=https://repo.charm.sh/yum/
+enabled=1
+gpgcheck=1
+gpgkey=https://repo.charm.sh/yum/gpg.key' | sudo tee /etc/yum.repos.d/charm.repo
+sudo yum install gum
+
+# Go
+go install github.com/charmbracelet/gum@latest
+```
+
+> 如果未安装 gum，其他所有命令行功能仍然完全可用，仅 `clashctl tui` 不可用。
+
+------
+
 # 🚀 一键安装（推荐）
 
 在终端中执行以下命令即可完成安装：
 
 ```
-git clone --branch master --depth 1 https://ghfast.top/https://github.com/wnlen/clash-for-linux.git
-cd clash-for-linux
+git clone --branch master --depth 1 https://ghfast.top/https://github.com/Babylonehy/clash-for-linux-tui.git
+cd clash-for-linux-tui
 bash install.sh
 ```
 
@@ -57,6 +211,7 @@ bash install.sh
 〽️ 常用命令
   clashon              🚀 开启代理
   clashoff             ⛔ 关闭代理
+  clashctl tui         🖥️  TUI 控制台（新增）
   clashctl select      💫 选择节点
 🕹️  控制台
   clashui              🕹️  查看 Web 控制台
@@ -187,8 +342,8 @@ clashctl boot proxy on|off|status
 
 ```bash
 cd /root
-git clone --branch master --depth 1 https://ghfast.top/https://github.com/wnlen/clash-for-linux.git
-cd clash-for-linux
+git clone --branch master --depth 1 https://ghfast.top/https://github.com/Babylonehy/clash-for-linux-tui.git
+cd clash-for-linux-tui
 ```
 
 安装依赖：
@@ -224,6 +379,7 @@ OpenWrt 下 root/system 安装会把 `clashctl`、`clashon`、`clashoff` 等命
 - `doctor`
 - `ui`
 - `select`
+- `tui`（新增）
 
 Control 层负责把常用动作收口成可理解的命令和反馈。
 
@@ -244,7 +400,7 @@ Control 层负责把常用动作收口成可理解的命令和反馈。
 
 `runtime/` 是运行时目录，不是配置目录。
 
-它的作用是作为“唯一运行容器”，用于存放：
+它的作用是作为"唯一运行容器"，用于存放：
 
 \- 运行内核（mihomo / clash）
 \- 运行配置（config.yaml）
@@ -490,6 +646,8 @@ chmod +x /etc/rc.local
 
 ## 🔗 引用
 
+- [clash-for-linux](https://github.com/wnlen/clash-for-linux) — 上游项目
+- [gum](https://github.com/charmbracelet/gum) — TUI 组件库
 - [clash](https://clash.wiki/)
 - [mihomo](https://github.com/MetaCubeX/mihomo)
 - [subconverter](https://github.com/tindy2013/subconverter)
@@ -504,9 +662,6 @@ chmod +x /etc/rc.local
    目前此项目已集成自动识别和转换clash配置文件的功能。如果依然无法使用，则需要通过自建或者第三方平台（不推荐，有泄露风险）对订阅地址转换。
    
 3. 程序日志中出现`error: unsupported rule type RULE-SET`报错，解决方法查看官方[WIKI](https://github.com/Dreamacro/clash/wiki/FAQ#error-unsupported-rule-type-rule-set)
-## ⭐ Star History
-
-[![Star History Chart](https://api.star-history.com/svg?repos=wnlen/clash-for-linux&type=Date)](https://star-history.com/#wnlen/clash-for-linux&Date)
 
 ## ⚠️ 特别声明