feat: 实现模块1 - TUI基础框架 (bubbletea)

2026-04-06 05:07:36 +08:00
parent b71f76c8b3
commit 1787464f52
7 changed files with 312 additions and 17 deletions
--- a/changelog.md
+++ b/changelog.md
@@ -24,14 +24,50 @@
 - [ ] 翻译历史记录

 ## 当前正实现
- [ ] 项目基础架构搭建
- [ ] 核心类设计实现
+- [x] TUI界面模块拆分计划 ✅ 已制定
+- [x] 模块1: TUI框架搭建 ✅ 已完成
+
+## TUI界面实现计划 (v0.6.0)
+| 步骤 | 模块 | 内容 | 状态 |
+|------|------|------|------|
+| 1 | TUI框架搭建 | bubbletea基础App结构、运行循环 | ✅ 已完成 |
+| 2 | 输入组件 | 文本输入框、光标、基础编辑 | ⏳ 待实现 |
+| 3 | 翻译显示区 | 结果展示、格式化、滚动 | ⏳ 待实现 |
+| 4 | 状态栏/主题 | 底部状态栏、语言选择、主题配色 | ⏳ 待实现 |
+| 5 | 快捷键系统 | 退出、清空、切换语言等 | ⏳ 待实现 |
+| 6 | 集成翻译 | 对接现有Translator、加载动画 | ⏳ 待实现 |

 ## 待修复BUG
 - 无

 ## 版本历史

+### 0.6.0 (2026-04-06) - TUI交互界面 (开发中)
+**类型**: 功能版本  
+**状态**: 开发中  
+
+**变更内容**:
+- ✅ 模块1: TUI框架搭建 - 添加bubbletea依赖，实现基础App结构
+- ⏳ 模块2: 输入组件 - 待实现
+- ⏳ 模块3: 翻译显示区 - 待实现
+- ⏳ 模块4: 状态栏/主题 - 待实现
+- ⏳ 模块5: 快捷键系统 - 待实现
+- ⏳ 模块6: 集成翻译 - 待实现
+
+**技术实现**:
+- 使用 `github.com/charmbracelet/bubbletea` v1.3.10
+- 使用 `github.com/charmbracelet/bubbles` (textinput组件)
+- 使用 `github.com/charmbracelet/lipgloss` v1.1.0
+- 基础model结构: config、translator字段
+
+**讨论记录**:
+- [TUI界面模块拆分计划](taolun.md#2026-04-06-1000-版本-060---tui界面模块拆分计划)
+
+**下一步**:
+- 实现模块2: 输入组件
+
+---
+
 ### 0.5.0 (2026-03-29) - 本地缓存功能
 **类型**: 功能版本  
 **状态**: 已发布  
--- a/configs/config.yaml
+++ b/configs/config.yaml
@@ -4,34 +4,34 @@
 default_provider: "siliconflow"
 default_model: "gpt-3.5-turbo"
 timeout: 30
-default_source_lang: "auto"    # 默认源语言（auto为自动检测）
-default_target_lang: "zh-CN"   # 默认目标语言（简体中文）
+default_source_lang: "auto" # 默认源语言（auto为自动检测）
+default_target_lang: "zh-CN" # 默认目标语言（简体中文）

 providers:
  siliconflow:
    api_host: "https://api.siliconflow.cn/v1"
    api_key: "${SILICONFLOW_API_KEY}"
-    model: "siliconflow-base"
+    model: "${SILICONFLOW_MODEL}"
    enabled: true
-    
+
  volcano:
    api_host: "https://api.volcengine.com/v1"
    api_key: "${VOLCANO_API_KEY}"
    model: "volcano-chat"
    enabled: true
-    
+
  national:
    api_host: "https://api.nsc.gov.cn/v1"
    api_key: "${NATIONAL_API_KEY}"
    model: "nsc-base"
    enabled: false
-    
+
  qwen:
    api_host: "https://dashscope.aliyuncs.com/compatible-mode/v1"
    api_key: "${QWEN_API_KEY}"
    model: "qwen-turbo"
    enabled: true
-    
+
  openai:
    api_host: "https://api.openai.com/v1"
    api_key: "${OPENAI_API_KEY}"
@@ -46,7 +46,7 @@ prompts:

 # 缓存配置
 cache:
-  enabled: true           # 是否启用缓存
-  max_records: 10000      # 最大缓存记录数
-  expire_days: 30         # 缓存过期天数
-  db_path: "~/.config/yoyo/cache.db"  # 缓存数据库文件路径
+  enabled: true # 是否启用缓存
+  max_records: 10000 # 最大缓存记录数
+  expire_days: 30 # 缓存过期天数
+  db_path: "~/.config/yoyo/cache.db" # 缓存数据库文件路径
--- a/go.mod
+++ b/go.mod
@@ -4,15 +4,36 @@ go 1.26.1

 require (
 	github.com/AlecAivazis/survey/v2 v2.3.7 // indirect
+	github.com/atotto/clipboard v0.1.4 // indirect
+	github.com/aymanbagabas/go-osc52/v2 v2.0.1 // indirect
+	github.com/charmbracelet/bubbles v1.0.0 // indirect
+	github.com/charmbracelet/bubbletea v1.3.10 // indirect
+	github.com/charmbracelet/colorprofile v0.4.1 // indirect
+	github.com/charmbracelet/lipgloss v1.1.0 // indirect
+	github.com/charmbracelet/x/ansi v0.11.6 // indirect
+	github.com/charmbracelet/x/cellbuf v0.0.15 // indirect
+	github.com/charmbracelet/x/term v0.2.2 // indirect
+	github.com/clipperhouse/displaywidth v0.9.0 // indirect
+	github.com/clipperhouse/stringish v0.1.1 // indirect
+	github.com/clipperhouse/uax29/v2 v2.5.0 // indirect
+	github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f // indirect
 	github.com/go-enry/go-enry/v2 v2.9.5 // indirect
 	github.com/go-enry/go-oniguruma v1.2.1 // indirect
 	github.com/joho/godotenv v1.5.1 // indirect
 	github.com/kballard/go-shellquote v0.0.0-20180428030007-95032a82bc51 // indirect
+	github.com/lucasb-eyer/go-colorful v1.3.0 // indirect
 	github.com/mattn/go-colorable v0.1.2 // indirect
-	github.com/mattn/go-isatty v0.0.8 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
+	github.com/mattn/go-localereader v0.0.1 // indirect
+	github.com/mattn/go-runewidth v0.0.19 // indirect
 	github.com/mattn/go-sqlite3 v1.14.37 // indirect
 	github.com/mgutz/ansi v0.0.0-20170206155736-9520e82c474b // indirect
-	golang.org/x/sys v0.0.0-20220722155257-8c9f86f7a55f // indirect
+	github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 // indirect
+	github.com/muesli/cancelreader v0.2.2 // indirect
+	github.com/muesli/termenv v0.16.0 // indirect
+	github.com/rivo/uniseg v0.4.7 // indirect
+	github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirect
+	golang.org/x/sys v0.38.0 // indirect
 	golang.org/x/term v0.0.0-20210927222741-03fcf44c2211 // indirect
 	golang.org/x/text v0.4.0 // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect
--- a/go.sum
+++ b/go.sum
@@ -1,9 +1,43 @@
 github.com/AlecAivazis/survey/v2 v2.3.7 h1:6I/u8FvytdGsgonrYsVn2t8t4QiRnh6QSTqkkhIiSjQ=
 github.com/AlecAivazis/survey/v2 v2.3.7/go.mod h1:xUTIdE4KCOIjsBAE1JYsUPoCqYdZ1reCfTwbto0Fduo=
 github.com/Netflix/go-expect v0.0.0-20220104043353-73e0943537d2/go.mod h1:HBCaDeC1lPdgDeDbhX8XFpy1jqjK0IBG8W5K+xYqA0w=
+github.com/atotto/clipboard v0.1.4 h1:EH0zSVneZPSuFR11BlR9YppQTVDbh5+16AmcJi4g1z4=
+github.com/atotto/clipboard v0.1.4/go.mod h1:ZY9tmq7sm5xIbd9bOK4onWV4S6X0u6GY7Vn0Yu86PYI=
+github.com/aymanbagabas/go-osc52/v2 v2.0.1 h1:HwpRHbFMcZLEVr42D4p7XBqjyuxQH5SMiErDT4WkJ2k=
+github.com/aymanbagabas/go-osc52/v2 v2.0.1/go.mod h1:uYgXzlJ7ZpABp8OJ+exZzJJhRNQ2ASbcXHWsFqH8hp8=
+github.com/charmbracelet/bubbles v1.0.0 h1:12J8/ak/uCZEMQ6KU7pcfwceyjLlWsDLAxB5fXonfvc=
+github.com/charmbracelet/bubbles v1.0.0/go.mod h1:9d/Zd5GdnauMI5ivUIVisuEm3ave1XwXtD1ckyV6r3E=
+github.com/charmbracelet/bubbletea v1.3.10 h1:otUDHWMMzQSB0Pkc87rm691KZ3SWa4KUlvF9nRvCICw=
+github.com/charmbracelet/bubbletea v1.3.10/go.mod h1:ORQfo0fk8U+po9VaNvnV95UPWA1BitP1E0N6xJPlHr4=
+github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc h1:4pZI35227imm7yK2bGPcfpFEmuY1gc2YSTShr4iJBfs=
+github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc/go.mod h1:X4/0JoqgTIPSFcRA/P6INZzIuyqdFY5rm8tb41s9okk=
+github.com/charmbracelet/colorprofile v0.4.1 h1:a1lO03qTrSIRaK8c3JRxJDZOvhvIeSco3ej+ngLk1kk=
+github.com/charmbracelet/colorprofile v0.4.1/go.mod h1:U1d9Dljmdf9DLegaJ0nGZNJvoXAhayhmidOdcBwAvKk=
+github.com/charmbracelet/lipgloss v1.1.0 h1:vYXsiLHVkK7fp74RkV7b2kq9+zDLoEU4MZoFqR/noCY=
+github.com/charmbracelet/lipgloss v1.1.0/go.mod h1:/6Q8FR2o+kj8rz4Dq0zQc3vYf7X+B0binUUBwA0aL30=
+github.com/charmbracelet/x/ansi v0.10.1 h1:rL3Koar5XvX0pHGfovN03f5cxLbCF2YvLeyz7D2jVDQ=
+github.com/charmbracelet/x/ansi v0.10.1/go.mod h1:3RQDQ6lDnROptfpWuUVIUG64bD2g2BgntdxH0Ya5TeE=
+github.com/charmbracelet/x/ansi v0.11.6 h1:GhV21SiDz/45W9AnV2R61xZMRri5NlLnl6CVF7ihZW8=
+github.com/charmbracelet/x/ansi v0.11.6/go.mod h1:2JNYLgQUsyqaiLovhU2Rv/pb8r6ydXKS3NIttu3VGZQ=
+github.com/charmbracelet/x/cellbuf v0.0.13-0.20250311204145-2c3ea96c31dd h1:vy0GVL4jeHEwG5YOXDmi86oYw2yuYUGqz6a8sLwg0X8=
+github.com/charmbracelet/x/cellbuf v0.0.13-0.20250311204145-2c3ea96c31dd/go.mod h1:xe0nKWGd3eJgtqZRaN9RjMtK7xUYchjzPr7q6kcvCCs=
+github.com/charmbracelet/x/cellbuf v0.0.15 h1:ur3pZy0o6z/R7EylET877CBxaiE1Sp1GMxoFPAIztPI=
+github.com/charmbracelet/x/cellbuf v0.0.15/go.mod h1:J1YVbR7MUuEGIFPCaaZ96KDl5NoS0DAWkskup+mOY+Q=
+github.com/charmbracelet/x/term v0.2.1 h1:AQeHeLZ1OqSXhrAWpYUtZyX1T3zVxfpZuEQMIQaGIAQ=
+github.com/charmbracelet/x/term v0.2.1/go.mod h1:oQ4enTYFV7QN4m0i9mzHrViD7TQKvNEEkHUMCmsxdUg=
+github.com/charmbracelet/x/term v0.2.2 h1:xVRT/S2ZcKdhhOuSP4t5cLi5o+JxklsoEObBSgfgZRk=
+github.com/charmbracelet/x/term v0.2.2/go.mod h1:kF8CY5RddLWrsgVwpw4kAa6TESp6EB5y3uxGLeCqzAI=
+github.com/clipperhouse/displaywidth v0.9.0 h1:Qb4KOhYwRiN3viMv1v/3cTBlz3AcAZX3+y9OLhMtAtA=
+github.com/clipperhouse/displaywidth v0.9.0/go.mod h1:aCAAqTlh4GIVkhQnJpbL0T/WfcrJXHcj8C0yjYcjOZA=
+github.com/clipperhouse/stringish v0.1.1 h1:+NSqMOr3GR6k1FdRhhnXrLfztGzuG+VuFDfatpWHKCs=
+github.com/clipperhouse/stringish v0.1.1/go.mod h1:v/WhFtE1q0ovMta2+m+UbpZ+2/HEXNWYXQgCt4hdOzA=
+github.com/clipperhouse/uax29/v2 v2.5.0 h1:x7T0T4eTHDONxFJsL94uKNKPHrclyFI0lm7+w94cO8U=
+github.com/clipperhouse/uax29/v2 v2.5.0/go.mod h1:Wn1g7MK6OoeDT0vL+Q0SQLDz/KpfsVRgg6W7ihQeh4g=
 github.com/creack/pty v1.1.17/go.mod h1:MOBLtS5ELjhRRrroQr9kyvTxUAFNvYEK993ew/Vr4O4=
 github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f h1:Y/CXytFA4m6baUTXGLOoWe4PQhGxaX0KpnayAqC48p4=
+github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f/go.mod h1:vw97MGsxSvLiUE2X8qFplwetxpGLQrlU1Q9AUEIzCaM=
 github.com/go-enry/go-enry/v2 v2.9.5 h1:HPhAQQHYwJgihL2PxBZiUMFWiROsGwOBdB6/D8zCUhY=
 github.com/go-enry/go-enry/v2 v2.9.5/go.mod h1:9yrj4ES1YrbNb1Wb7/PWYr2bpaCXUGRt0uafN0ISyG8=
 github.com/go-enry/go-oniguruma v1.2.1 h1:k8aAMuJfMrqm/56SG2lV9Cfti6tC4x8673aHCcBk+eo=
@@ -13,15 +47,36 @@ github.com/joho/godotenv v1.5.1 h1:7eLL/+HRGLY0ldzfGMeQkb7vMd0as4CfYvUVzLqw0N0=
 github.com/joho/godotenv v1.5.1/go.mod h1:f4LDr5Voq0i2e/R5DDNOoa2zzDfwtkZa6DnEwAbqwq4=
 github.com/kballard/go-shellquote v0.0.0-20180428030007-95032a82bc51 h1:Z9n2FFNUXsshfwJMBgNA0RU6/i7WVaAegv3PtuIHPMs=
 github.com/kballard/go-shellquote v0.0.0-20180428030007-95032a82bc51/go.mod h1:CzGEWj7cYgsdH8dAjBGEr58BoE7ScuLd+fwFZ44+/x8=
+github.com/lucasb-eyer/go-colorful v1.2.0 h1:1nnpGOrhyZZuNyfu1QjKiUICQ74+3FNCN69Aj6K7nkY=
+github.com/lucasb-eyer/go-colorful v1.2.0/go.mod h1:R4dSotOR9KMtayYi1e77YzuveK+i7ruzyGqttikkLy0=
+github.com/lucasb-eyer/go-colorful v1.3.0 h1:2/yBRLdWBZKrf7gB40FoiKfAWYQ0lqNcbuQwVHXptag=
+github.com/lucasb-eyer/go-colorful v1.3.0/go.mod h1:R4dSotOR9KMtayYi1e77YzuveK+i7ruzyGqttikkLy0=
 github.com/mattn/go-colorable v0.1.2 h1:/bC9yWikZXAL9uJdulbSfyVNIR3n3trXl+v8+1sx8mU=
 github.com/mattn/go-colorable v0.1.2/go.mod h1:U0ppj6V5qS13XJ6of8GYAs25YV2eR4EVcfRqFIhoBtE=
 github.com/mattn/go-isatty v0.0.8 h1:HLtExJ+uU2HOZ+wI0Tt5DtUDrx8yhUqDcp7fYERX4CE=
 github.com/mattn/go-isatty v0.0.8/go.mod h1:Iq45c/XA43vh69/j3iqttzPXn0bhXyGjM0Hdxcsrc5s=
+github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
+github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/mattn/go-localereader v0.0.1 h1:ygSAOl7ZXTx4RdPYinUpg6W99U8jWvWi9Ye2JC/oIi4=
+github.com/mattn/go-localereader v0.0.1/go.mod h1:8fBrzywKY7BI3czFoHkuzRoWE9C+EiG4R1k4Cjx5p88=
+github.com/mattn/go-runewidth v0.0.16 h1:E5ScNMtiwvlvB5paMFdw9p4kSQzbXFikJ5SQO6TULQc=
+github.com/mattn/go-runewidth v0.0.16/go.mod h1:Jdepj2loyihRzMpdS35Xk/zdY8IAYHsh153qUoGf23w=
+github.com/mattn/go-runewidth v0.0.19 h1:v++JhqYnZuu5jSKrk9RbgF5v4CGUjqRfBm05byFGLdw=
+github.com/mattn/go-runewidth v0.0.19/go.mod h1:XBkDxAl56ILZc9knddidhrOlY5R/pDhgLpndooCuJAs=
 github.com/mattn/go-sqlite3 v1.14.37 h1:3DOZp4cXis1cUIpCfXLtmlGolNLp2VEqhiB/PARNBIg=
 github.com/mattn/go-sqlite3 v1.14.37/go.mod h1:Uh1q+B4BYcTPb+yiD3kU8Ct7aC0hY9fxUwlHK0RXw+Y=
 github.com/mgutz/ansi v0.0.0-20170206155736-9520e82c474b h1:j7+1HpAFS1zy5+Q4qx1fWh90gTKwiN4QCGoY9TWyyO4=
 github.com/mgutz/ansi v0.0.0-20170206155736-9520e82c474b/go.mod h1:01TrycV0kFyexm33Z7vhZRXopbI8J3TDReVlkTgMUxE=
+github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 h1:ZK8zHtRHOkbHy6Mmr5D264iyp3TiX5OmNcI5cIARiQI=
+github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6/go.mod h1:CJlz5H+gyd6CUWT45Oy4q24RdLyn7Md9Vj2/ldJBSIo=
+github.com/muesli/cancelreader v0.2.2 h1:3I4Kt4BQjOR54NavqnDogx/MIoWBFa0StPA8ELUXHmA=
+github.com/muesli/cancelreader v0.2.2/go.mod h1:3XuTXfFS2VjM+HTLZY9Ak0l6eUKfijIfMUZ4EgX0QYo=
+github.com/muesli/termenv v0.16.0 h1:S5AlUN9dENB57rsbnkPyfdGuWIlkmzJjbFf0Tf5FWUc=
+github.com/muesli/termenv v0.16.0/go.mod h1:ZRfOIKPFDYQoDFF4Olj7/QJbW60Ol/kL1pU3VfY/Cnk=
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/rivo/uniseg v0.2.0/go.mod h1:J6wj4VEh+S6ZtnVlnTBMWIodfgj8LQOQFoIToxlJtxc=
+github.com/rivo/uniseg v0.4.7 h1:WUdvkW8uEhrYfLC4ZzdpI2ztxP1I582+49Oc5Mq64VQ=
+github.com/rivo/uniseg v0.4.7/go.mod h1:FN3SvrM+Zdj16jyLfmOkMNblXMcoc8DfTHruCPUcx88=
 github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
 github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
 github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo=
@@ -29,6 +84,8 @@ github.com/stretchr/testify v1.6.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/
 github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
 github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
 github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
+github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e h1:JVG44RsyaB9T2KIHavMF/ppJZNG9ZpyihvCd0w101no=
+github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e/go.mod h1:RbqR21r5mrJuqunuUZ/Dhy/avygyECGrLceyNeo4LiM=
 github.com/yuin/goldmark v1.4.13/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY=
 golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
 golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc=
@@ -42,9 +99,15 @@ golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5h
 golang.org/x/sys v0.0.0-20190222072716-a9d3bda3a223/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
 golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
 golang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.0.0-20210809222454-d867a43fc93e/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.0.0-20220520151302-bc2c85ada10a/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.0.0-20220722155257-8c9f86f7a55f h1:v4INt8xihDGvnrfjMDVXGxw9wrfxYyCjk0KbXjhR55s=
 golang.org/x/sys v0.0.0-20220722155257-8c9f86f7a55f/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.36.0 h1:KVRy2GtZBrk1cBYA7MKu5bEZFxQk4NIDV6RLVcC8o0k=
+golang.org/x/sys v0.36.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
+golang.org/x/sys v0.38.0 h1:3yZWxaJjBmCWXqhN1qh02AkOnCQ1poK6oF+a7xWL6Gc=
+golang.org/x/sys v0.38.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
 golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
 golang.org/x/term v0.0.0-20210927222741-03fcf44c2211 h1:JGgROgKl9N8DuW20oFS5gxc+lE67/N3FcwmBPMe7ArY=
 golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8=
--- a/internal/tui/app.go
+++ b/internal/tui/app.go
@@ -0,0 +1,31 @@
+package tui
+
+import (
+	"github.com/charmbracelet/bubbletea"
+	"github.com/titor/fanyi/internal/config"
+	"github.com/titor/fanyi/internal/translator"
+)
+
+type model struct {
+	config     *config.Config
+	translator *translator.Translator
+}
+
+func NewApp(cfg *config.Config, t *translator.Translator) *tea.Program {
+	return tea.NewProgram(model{
+		config:     cfg,
+		translator: t,
+	})
+}
+
+func (m model) Init() tea.Cmd {
+	return nil
+}
+
+func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
+	return m, nil
+}
+
+func (m model) View() string {
+	return "YOYO翻译 TUI\n\n(基础框架搭建中...)\n"
+}
--- a/memory.md
+++ b/memory.md
@@ -505,4 +505,85 @@ db.SetMaxIdleConns(1)
 1. 测试缓存与Translator的集成
 2. 测试配置文件的正确加载
 3. 测试缓存命令的正确执行
-4. 测试错误情况的正确处理
+4. 测试错误情况的正确处理
+
+---
+
+## TUI界面开发策略
+
+### 分模块实现策略
+**决策**: TUI界面分6个小模块逐步实现，每次只做一个模块
+**原因**: 
+1. 减少Token消耗和上下文负担
+2. 便于逐步测试和验证
+3. 适应free模式的限流约束
+
+**模块列表**:
+1. TUI框架搭建 - bubbletea基础App结构
+2. 输入组件 - 文本输入框
+3. 翻译显示区 - 结果展示、滚动
+4. 状态栏/主题 - 底部状态栏、配色
+5. 快捷键系统 - 操作快捷键
+6. 集成翻译 - 对接Translator、加载动画
+
+### 技术选型
+**决策**: 使用charmbracelet生态
+- `bubbletea` - Elm架构的TUI框架
+- `lipgloss` - 样式和主题
+- `bubbles/textinput` - 输入框组件
+
+**原因**:
+1. Go生态最流行的TUI框架
+2. Elm架构清晰，易于分模块实现
+3. 组件化设计，便于复用
+
+### 文档管理规范
+**决策**: 不再创建新的md文件
+**原因**: 保持项目文档简洁，避免碎片化
+**规则**:
+- 讨论内容 → `taolun.md`
+- 版本更新 → `changelog.md`
+- 经验教训 → `memory.md`
+- 项目初衷 → `why.md` (仅用户编辑)
+
+---
+
+## Bubble Tea TUI框架经验
+
+### 版本信息
+**当前版本**: v1.3.10
+**API风格**: v1版本风格（Init返回tea.Cmd）
+
+### 基础结构
+```go
+type model struct {
+    // 状态字段
+}
+
+func (m model) Init() tea.Cmd {
+    return nil // 初始化命令
+}
+
+func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
+    return m, nil // 更新逻辑
+}
+
+func (m model) View() string {
+    return "视图内容" // 返回渲染内容
+}
+
+func NewApp(cfg, translator) *tea.Program {
+    return tea.NewProgram(model{...})
+}
+```
+
+### 关键点
+- `tea.NewProgram()` 创建程序实例
+- `program.Run()` 返回 `(model, error)`
+- model的字段可以是config、translator等依赖
+- View方法返回string，使用lipgloss样式
+
+### main.go集成注意
+- 版本检查(--version)需要在interactive模式检查之前
+- 避免interactive模式在非TTY环境启动
+- Run()需要两个返回值: `_, err := app.Run()`
--- a/taolun.md
+++ b/taolun.md
@@ -379,4 +379,67 @@ if oldestStr.Valid {

 **关联文档**: 
 - [changelog.md#0.5.1](changelog.md#051)
- [memory.md#本地缓存实现经验](memory.md#本地缓存实现经验)
+- [memory.md#本地缓存实现经验](memory.md#本地缓存实现经验)
+
+---
+
+### [2026-04-06 10:00] 版本 0.6.0 - TUI界面模块拆分计划
+**原因**: 当前TUI目录(tui/components、tui/theme)已创建但完全为空，需要从零实现终端交互界面
+**分析**: 
+- 采用分模块逐步实现策略，减少Token消耗和上下文负担
+- 每次只实现一个模块，完成后再进入下一个
+- 讨论内容仅保存到taolun.md/changelog.md/memory.md，不新增md文件
+
+**解决方案 - TUI模块拆分**:
+
+| 步骤 | 模块 | 内容 | 预计工作量 |
+|------|------|------|-----------|
+| 1 | TUI框架搭建 | 选择库(bubbletea)、基础App结构、运行循环 | 小 |
+| 2 | 输入组件 | 文本输入框、光标、基础编辑 | 中 |
+| 3 | 翻译显示区 | 结果展示、格式化、滚动 | 中 |
+| 4 | 状态栏/主题 | 底部状态栏、语言选择、主题配色 | 小 |
+| 5 | 快捷键系统 | 退出、清空、切换语言等 | 小 |
+| 6 | 集成翻译 | 对接现有Translator、加载动画 | 中 |
+
+**技术选型**: 
+- 优先使用 `charmbracelet/bubbletea` (Elm架构、Go生态最流行)
+- 配合 `charmbracelet/lipgloss` 实现样式和主题
+- 配合 `charmbracelet/bubbles/textinput` 实现输入框
+
+**当前状态**: ✅ 模块1已完成，模块2待实现
+
+**关联文档**: 
+- [changelog.md#0.6.0](changelog.md#060)
+
+---
+
+### [2026-04-06 10:30] 版本 0.6.0 - 模块1: TUI框架搭建 (已完成)
+**原因**: 实现TUI界面的第一步，建立基础框架结构
+**分析**: 
+- 需要创建基本的App结构和model
+- 需要支持config和translator的注入
+- 需要修复main.go中版本检查顺序问题
+
+**解决方案**:
+1. 创建 `internal/tui/app.go` 基础文件
+2. 定义model结构体，包含config和translator字段
+3. 实现Init/Update/View三个基本方法
+4. 添加bubbletea、bubbles、lipgloss依赖
+5. 修复main.go中--version在interactive之前检查
+
+**技术实现**:
+```go
+type model struct {
+    config      *config.Config
+    translator  *translator.Translator
+}
+
+func NewApp(cfg *config.Config, t *translator.Translator) *tea.Program {
+    return tea.NewProgram(model{...})
+}
+```
+
+**下一步**: 实现模块2: 输入组件
+
+**关联文档**: 
+- [changelog.md#0.6.0](changelog.md#060)