From 5e6708d049a8aca7db127358561718597cf743db Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=BB=9D=E5=B0=98?= <237809796@qq.com>
Date: Mon, 18 May 2026 18:12:12 +0800
Subject: [PATCH] =?UTF-8?q?=E4=BC=98=E5=8C=96:=20README=20=E8=A1=A5?=
 =?UTF-8?q?=E5=85=85=E9=85=8D=E7=BD=AE=E8=AF=B4=E6=98=8E=E4=B8=8E=E5=B9=B3?=
 =?UTF-8?q?=E5=8F=B0=E5=AE=89=E8=A3=85=E6=8C=87=E5=BC=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 68 +++++++++++++++++++++++++++++++++++++++++++++++--------
 1 file changed, 58 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index 0beb237..2af6129 100644
--- a/README.md
+++ b/README.md
@@ -7,17 +7,28 @@ TUI 工作空间启动器 — 在终端快速选择项目，一键启动 Claude
 - YAML 配置驱动，分组管理工作空间
 - 左右布局：列表 + 详情面板
 - 一键启动 Windows Terminal + Claude Code
-- 多选批量启动、编号快捷跳转、复制启动命令
+- 多选批量启动、编号快捷跳转
+- HISTORY Tab：浏览历史会话，一键恢复
+- AI 摘要：自动为历史会话生成摘要
+- 自动更新：启动检查新版本，`u` 键一键自升级
+- 跨平台：Windows / Linux / macOS
 - Tokyo Night 主题，CJK 字符安全渲染
 
 ## 安装
 
 ```bash
+# 下载
+curl -LO https://c.1216.top/u-tabs/download/u-tabs-linux-amd64
+chmod +x u-tabs-linux-amd64 && mv u-tabs-linux-amd64 /usr/local/bin/u-tabs
+
+# 或从源码编译
 git clone https://gitea.1216.top/lxy/u-tabs.git
 cd u-tabs && go build .
 ```
 
-或下载 [Release](https://gitea.1216.top/lxy/u-tabs/releases) 中的 exe。
+Windows 用户下载 [u-tabs-windows-amd64.exe](https://c.1216.top/u-tabs/download/u-tabs-windows-amd64.exe)，重命名为 `u-tabs.exe` 使用。
+
+macOS 用户下载 [darwin-arm64](https://c.1216.top/u-tabs/download/u-tabs-darwin-arm64)（Apple Silicon）或 [darwin-amd64](https://c.1216.top/u-tabs/download/u-tabs-darwin-amd64)（Intel），重命名为 `u-tabs` 后 `chmod +x` 使用。
 
 ## 配置
 
@@ -27,6 +38,7 @@ cd u-tabs && go build .
 groups:
   - label: CORE
     desc: 核心业务
+    base: 10
     items:
       - title: my-project
         prompt: 项目描述
@@ -35,22 +47,58 @@ groups:
         dir: "E:\\projects\\my-project"
 ```
 
+### 字段说明
+
+**分组 (Group)**
+
+| 字段 | 必填 | 说明 |
+|------|------|------|
+| `label` | 是 | 分组标识，显示在 Tab 栏（如 CORE、LAB） |
+| `desc` | 否 | 分组描述 |
+| `base` | 是 | 编号起始值，组内项目编号 = base + 序号（如 base=10，第一个项目编号 10） |
+
+**工作空间 (Item)**
+
+| 字段 | 必填 | 说明 |
+|------|------|------|
+| `title` | 是 | 项目名称，显示在列表和启动标题 |
+| `prompt` | 否 | 项目描述，列表中 title 后显示 |
+| `tech` | 否 | 技术栈，详情面板展示 |
+| `deploy` | 否 | 部署信息，详情面板展示 |
+| `dir` | 是 | 项目目录路径，支持 `~` 展开 |
+
+**配置加载优先级**: `~/.u-tabs/config.yaml` > exe 同目录 `config.yaml`
+
 ## 快捷键
 
+### Workspace Tab
+
 | 按键 | 功能 |
 |------|------|
 | j/k | 上下选择 |
 | Tab | 切换分组 |
-| Enter | 启动 |
-| Space | 多选 |
-| c | 复制命令 |
-| 数字 | 按编号跳转 |
+| Enter | 启动选中项 |
+| Space | 多选标记 |
+| 0-9 | 编号输入 |
 | q | 退出 |
 
+### HISTORY Tab
+
+| 按键 | 功能 |
+|------|------|
+| j/k | 上下选择 |
+| Tab | 左右面板切换 |
+| Enter | 恢复会话 |
+| n | 新建会话 |
+| r/F5 | 刷新扫描 |
+| q | 退出 |
+
+**全局**: `u` 更新到新版本（任何 Tab 可用）
+
+## 自动更新
+
+启动时后台检查版本，发现新版本时底部提示 `v{new} available [u]update`。按 `u` 键下载替换并校验 SHA256，失败自动回滚旧版本。更新后重启生效。
+
 ## 技术栈
 
 Go 1.26 / Bubbletea v2 / Lipgloss v2
-
-## 文档
-
-- [架构设计](./docs/02-技术文档/架构设计.md)