From 1787464f525d185541c9735ffd57134cae5a1868 Mon Sep 17 00:00:00 2001 From: titor Date: Mon, 6 Apr 2026 05:07:36 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E5=AE=9E=E7=8E=B0=E6=A8=A1=E5=9D=971?= =?UTF-8?q?=20-=20TUI=E5=9F=BA=E7=A1=80=E6=A1=86=E6=9E=B6=20(bubbletea)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- changelog.md | 40 ++++++++++++++++++++-- configs/config.yaml | 22 ++++++------ go.mod | 25 ++++++++++++-- go.sum | 63 ++++++++++++++++++++++++++++++++++ internal/tui/app.go | 31 +++++++++++++++++ memory.md | 83 ++++++++++++++++++++++++++++++++++++++++++++- taolun.md | 65 ++++++++++++++++++++++++++++++++++- 7 files changed, 312 insertions(+), 17 deletions(-) create mode 100644 internal/tui/app.go diff --git a/changelog.md b/changelog.md index f4792c4..831d94e 100644 --- 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) - 本地缓存功能 **类型**: 功能版本 **状态**: 已发布 diff --git a/configs/config.yaml b/configs/config.yaml index a4defac..9cfc3f9 100644 --- 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" # 缓存数据库文件路径 \ No newline at end of file + enabled: true # 是否启用缓存 + max_records: 10000 # 最大缓存记录数 + expire_days: 30 # 缓存过期天数 + db_path: "~/.config/yoyo/cache.db" # 缓存数据库文件路径 diff --git a/go.mod b/go.mod index e4a23a6..7177348 100644 --- 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 diff --git a/go.sum b/go.sum index 87691cf..0e1d5ce 100644 --- 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= diff --git a/internal/tui/app.go b/internal/tui/app.go new file mode 100644 index 0000000..cbd94ec --- /dev/null +++ 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" +} diff --git a/memory.md b/memory.md index 26ba94a..3721772 100644 --- a/memory.md +++ b/memory.md @@ -505,4 +505,85 @@ db.SetMaxIdleConns(1) 1. 测试缓存与Translator的集成 2. 测试配置文件的正确加载 3. 测试缓存命令的正确执行 -4. 测试错误情况的正确处理 \ No newline at end of file +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()` \ No newline at end of file diff --git a/taolun.md b/taolun.md index 4413775..39c821f 100644 --- 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#本地缓存实现经验) \ No newline at end of file +- [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) \ No newline at end of file