TRAI 第6期: 国际化系统落地, 登录注册视觉重构, 客户端动画体系升级

0 阅读16分钟

本期一句话: TRAI - AI 智能助手平台  TRAI 网站上线  全面落地 i18n 国际化系统,支持中英双语切换;登录注册页面重构为左右对称全屏布局,引入动态光晕、品牌核心与全方位交互反馈;客户端动画系统升级至 Google Material Design 风格,聊天输入框增强快速命令建议与自适应高度;后端新增翻译管理、图片生成配置、飞书通知、IP地理服务等基础设施。

时间锚点 md/issue_05/[index.md](http://index.md/) 最后入库: 3bc882c · 2026-04-17 17:30:38 +0800 · 本期范围 git log 3bc882c..HEAD

这次更新做了什么

国际化架构

登录页面 (亮色)

登录页面 (暗色)

注册页面 (动画)

工具 JSON 检测

组织架构

国际化 · i18n 体系全面落地

新增完整的国际化系统,支持 Admin 管理后台、AI 助手、忘记密码页面的中英双语切换;构建翻译管理后台,允许运营人员动态维护多语言文案;后端新增翻译数据模型、仓储层与公开接口。

客户端 · 登录注册视觉重构

将登录注册页面重构为左右对称全屏布局,左侧为精简品牌区(动态光晕+品牌核心),右侧为悬浮表单卡片;新增 logo 随机旋转动画、密码可见切换、强度指示器等全方位交互反馈。

动画系统 · Material Design 风格升级

增强 global.css 全局动画系统,采用 Google Material Design 风格;侧边栏导航添加活跃指示器条与错落下沉入场动画;标题栏按钮增加上浮与阴影过渡效果。

后端 · 基础设施与服务能力扩展

新增翻译数据持久化与仓储层、图片生成配置管理、飞书 AI 通知服务、IP 地理定位服务等后端能力,为前端提供稳定的服务支撑。


1. 国际化系统 (i18n) 全面落地

核心目标: 让 TRAI 具备多语言能力,支持中英双语切换,为海外部署奠定基础。

1.1 前端国际化架构设计

  • • 构建 frontend_next/src/i18n/ 国际化模块,包含 i18n_context.tsxconfig.ts

  • • 新增 AdminI18nContext 管理后台专属国际化上下文,支持运行时语言切换

  • • 创建 LanguageSwitcher 语言切换组件,嵌入 Navbar 和登录页面

  • • 新增 admin_i18n_context.tsxadmin_toast_context.tsx 提供后台专用上下文

1.2 翻译管理后台

  • • 新增 Admin 管理后台翻译管理页面 (/admin/i18n)

  • • 支持翻译 Key-Value 的增删改查

  • • 翻译数据持久化到数据库,支持动态更新无需重启服务

1.3 多页面全面接入

  • 管理后台: Dashboard、Feedback、Media、UnderDevelopment 等页面全面接入 i18n

  • AI 助手: 对话界面支持双语展示

  • 忘记密码: 全新双语页面 (/forgot_password)

  • 客户端: Electron 客户端同步接入国际化 (client_electron/src/renderer/i18n.ts)

1.4 后端翻译服务支撑

  • • 新增 backend/src/infrastructure/database/i18n_[model.py](http://model.py/) 翻译数据模型

  • • 新增 backend/src/infrastructure/repositories/i18n_[repository.py](http://repository.py/) 翻译仓储层

  • • 新增 backend/src/api/routers/admin/[i18n.py](http://i18n.py/) 管理后台翻译接口

  • • 新增 backend/src/api/routers/i18n_[public.py](http://public.py/) 公开翻译查询接口

  • • 新增 backend/seed_[i18n.py](http://i18n.py/) 翻译数据初始化脚本


2. 登录注册页面视觉重构

设计理念: 左右对称全屏布局,左侧精简品牌区传达核心价值,右侧悬浮表单卡片聚焦用户任务。

2.1 左侧品牌区

  • 动态光晕效果: 品牌 Logo 周围添加呼吸光晕动画,增强视觉吸引力

  • 功能特性卡片: 展示 6 大核心功能,每个功能配图标和描述,hover 时有动效反馈

  • 国际化支持: 品牌区文案支持中英双语

2.2 右侧表单区

  • 悬浮卡片设计: 表单区域采用白色悬浮卡片,有阴影和视觉重量

  • 全方位交互反馈:

  • • 点击缩放效果

  • • Focus 阴影过渡

  • • Hover 状态变化

  • 响应式布局: 右侧面板宽度放大至 1.4 倍,最大 480px

2.3 动画增强

  • Logo 随机旋转: 点击空白区域可触发 Logo 随机顺时针/逆时针旋转

  • 密码错误抖动: 登录失败时表单区域有抖动反馈

  • 页面过渡: 登录与注册页面切换有平滑过渡动画

2.4 注册页面增强

  • 密码可见切换: 点击眼睛图标切换密码显示/隐藏

  • 强度指示器: 三色条实时显示密码强度(弱/中/强)

  • 确认密码验证: 实时验证两次密码是否一致

登录页面重构


3. 聊天输入框增强

体验优化: 增强聊天输入框的功能性和交互性,让对话更加高效流畅。

3.1 快速命令建议

  • • 输入框获取焦点时显示常用命令建议

  • • 点击建议项自动填入输入框

  • • 支持自定义快捷命令

3.2 字符统计与自适应高度

  • • 实时显示当前字符数

  • • 输入框高度根据内容自动扩展

  • • 最大高度限制后出现滚动条

3.3 AgentChat 组件重构

  • • 将 1362 行的 monolithic 组件拆分为 5 个子组件

  • • 修复 JSX 嵌套错误

  • • 提升代码可维护性

3.4 空状态引导卡片

  • • 美化空状态引导卡片

  • • 添加品牌图标与快捷按钮引导

  • • 让新用户快速上手


4. 动画系统升级

Google Material Design 风格

采用 Google Material Design 3 动画规范,增强交互反馈的一致性和流畅度。

4.1 侧边栏导航动画

  • 活跃指示器条: 当前页面有醒目的左侧指示条

  • 错落下沉入场: 导航项有依次错开的入场动画

  • Hover 上浮效果: 导航项 hover 时有轻微上浮和阴影

4.2 标题栏按钮动效

  • 上浮与阴影: 按钮 hover 时有上浮位移和阴影过渡

  • 平滑过渡: 所有状态变化使用 cubic-bezier 缓动函数

4.3 加载页优化

  • • 用进度条动画替代原来的圆点指示器

  • • 更清晰的加载状态反馈


5. 后端基础设施扩展

服务能力建设: 为前端提供稳定的后端服务支撑,扩展多项基础设施能力。

5.1 翻译服务

  • • 数据库模型: i18n_[model.py](http://model.py/) - 翻译数据持久化

  • • 仓储层: i18n_[repository.py](http://repository.py/) - 翻译数据的 CRUD 操作

  • • 管理接口: /api/routers/admin/[i18n.py](http://i18n.py/) - 翻译管理 API

  • • 公开接口: /api/routers/i18n_[public.py](http://public.py/) - 前端查询 API

5.2 图片生成配置

  • • 新增 backend/src/api/routers/admin/image_gen_[config.py](http://config.py/) 图片生成配置管理

  • • 支持配置文生图、图生图等模型参数

5.3 飞书通知服务

  • • 新增 backend/src/infrastructure/notify/feishu_ai_[notify.py](http://notify.py/)

  • • 支持 AI 能力调用的飞书富文本卡片通知

5.4 IP 地理服务

  • • 新增 backend/src/infrastructure/services/ip_[geolocation.py](http://geolocation.py/)

  • • 支持根据 IP 地址获取地理位置信息

5.5 系统设置

  • • 新增 backend/src/api/routers/admin/system_[settings.py](http://settings.py/) 系统设置管理

  • • 新增 backend/src/api/routers/settings_[public.py](http://public.py/) 公开设置查询

5.6 文档管理

  • • 新增 backend/src/api/routers/admin/schema_[doc.py](http://doc.py/) 文档管理接口

6. 布局修复与优化

稳定性提升: 修复多个布局相关的边缘问题,提升客户端稳定性。

6.1 窗口最大化问题修复

  • • 修复窗口最大化后内容消失的根本原因

  • • 解决 Flex 布局链传递问题

  • • ThreePanelLayout 内容区域溢出修复

6.2 媒体控制栏修复

  • • 修复最大化后控制栏显示问题

  • • 优化控制栏在各种窗口状态下的表现

6.3 ThreePanelLayout 面板增强

  • • 增强面板展开收起动画 - cubic-bezier 过渡

  • • Hover 上浮效果

  • • 面板状态持久化


本期 Git 更新 (按域归纳)

本期覆盖范围: git log 3bc882c..HEAD --oneline --no-merges

重点内容代表提交
客户端(client_electron)登录注册重构、动画系统、布局修复74d86eb3 e759c8d9 24b366f9 46995b5a
前端后台(frontend_next)i18n 国际化、翻译管理、页面美化3828b8d7 c3074598 541141ea
后端(backend)翻译服务、飞书通知、IP地理、图片配置5bb3d974 94cdf158
规范与工具(skills, md)SKILL 代码审查、README 更新88afb1c0

关键提交清单

主题代表提交
i18n 国际化系统(前端)3828b8d7 c3074598
i18n 国际化系统(后端)5bb3d974 94cdf158
登录注册重构5ff8d046 fd618d76 74d86eb3 e759c8d9
聊天增强24b366f9 541141ea
动画系统46995b5a c3074598
布局修复49a8ab3b 3ffb6883 c0f6074b
飞书通知5bb3d974
IP 地理服务5bb3d974
图片生成配置94cdf158

完整提交列表 (按时间倒序)

a2bc5b2a docs: 更新 issue_06 内容 - 国际化系统、登录注册重构、动画升级
3828b8d7 feat(i18n): 新增国际化系统 — Admin 多语言支持、翻译管理、AI助手、忘记密码页面
5ff8d046 feat(login+register): 合并 origin/main 旋转动画 — 登录注册页 logo 随机顺时针/逆时针旋转
fd618d76 feat(login+register): enhance UX — global click toggles random CW/CCW rotation
74d86eb3 feat(login+register): 重构登录注册页面 — 左右对称全屏布局
e759c8d9 feat(login): 重构登录页面 — 左侧功能特性卡片、右侧紧凑表单
24b366f9 feat(chat): 增强聊天输入框 — 快速命令建议、字符统计、自适应高度
46995b5a perf(animation): 美化侧边栏导航入场动画与活跃指示器
c3074598 fix(i18n): 修复 i18n.ts 重复 total 键; 引入 @/i18n 国际化支持
541141ea feat(chat): 重构 AgentChat 页面 — 拆分 1362 行为 5 个子组件
88afb1c0 规范(skill): 执行 frontend_next SKILL 代码审查并修复文件头规范问题
49a8ab3b fix(layout): 修复窗口最大化后内容消失的根本原因
3ffb6883 fix(layout): 修复ThreePanelLayout内容区域溢出问题
c0f6074b fix(media): 修复最大化后控制栏显示问题
ab1f8352 fix(media): 修复控制栏显示问题
5f5cb9ad fix(media): 优化媒体页面布局
62878ac0 fix(media): 修复媒体页面宽度问题
dcd65a88 fix(media): 修复媒体页面横向滚动条问题
6877f9fe feat(media): 增强媒体处理功能
06ec47e7 fix(media): 修复媒体处理页面布局
697cb4b9 feat(media): 新增媒体处理工具
2d0f899f fix(tools): 优化工具页面样式
68c5518c fix(tools): 修复工具页面布局问题
c3b0e63a feat(tools): 完善工具箱功能
7fd938a9 feat(tools): 新增工具分类
4ba7962d feat(tools): 优化工具页面交互
31367421 fix: 修复知识库相关问题
4a88222e feat: 增强知识库功能
482b358f feat: 优化用户管理功能 — VIP角色筛选、状态筛选、会话分页
946aefe7 perf(client_electron): 客户端性能优化 — 知识库页面组件优化、虚拟滚动
295389d9 优化窗口控制按钮颜色显示
4f73b09e feat: 完善系统设置功能
ec41d4ee feat: 新增系统监控功能
38260489 feat: 增强数据分析能力
573aa709 fix: 修复已知问题
00def81e fix: 代码优化
c2491fa0 feat: 新增反馈功能
3a509abd fix: 修复反馈页面问题
67a73aba feat: 增强用户管理
cc23a2c6 fix: 修复用户列表分页问题
22d2c302 feat: 新增通知管理
eccabb3f fix: 修复通知问题
cc504c9e feat: 增强通知功能
428b7e3f fix: 修复布局问题
8662f4ef feat: 新增分析功能
fe97781d fix: 修复分析页面问题
d04d063b feat: 增强分析能力
b9a5e8ab fix: 修复已知问题
351185bc feat: 新增强制功能
d43f2e47 fix: 修复登录问题
e211ae83 feat: 增强登录功能
e017cafe fix: 修复注册问题
81de2638 feat: 增强注册功能
48fe237b feat: 新增忘记密码功能
345319f9 fix: 修复忘记密码页面问题
97f26486 feat: 增强忘记密码功能
80e836cf fix: 修复安全问题
f04c73dd feat: 新增安全验证
2ebbe2fc fix: 修复验证问题
00994ac2 feat: 增强验证功能
5bdce8f6 fix: 修复Token问题
28392b90 feat: 增强Token管理
d5bcd7d7 fix: 修复会话问题
21c93d85 feat: 增强会话管理
3f0f11f7 feat: 客户端主题切换与预览
8dce34a7 feat(client): 新增系统信息接口和优化工具箱页面
6adf89fe fix(ruff): 修复后端代码 Lint 警告
991aed87 feat: 新增后端功能
c7bcb299 fix(tools): 添加PanelLeftClose导入
89d4dbc1 fix(agent): 添加PanelLeftClose导入
74ac1f2a feat: 新增系统功能
0bc0dd42 fix(settings): 修复设置问题
2274d465 fix(main): 初始化UpdateService
237ad97f feat(settings): 完善设置页面
2bdfa35 feat(ai): 增强AI功能
c3704b6e feat(ui): 完善UI组件
2b8783ac fix: 修复布局问题
94f2bbd5 feat(ai): 完善AI页面布局
c86359fb feat(text_to_image): 添加标题
a916b130 feat(text_to_image): 实现完整三段式布局
a724ef3d style: 优化样式
d5f3856f fix: 修复样式问题
860c9403 feat: 新增功能
729edbc1 fix: 修复问题
e54b9bb7 feat: 增强功能
c07dfd61 fix: 优化代码
bbba1f0a feat: 新增功能增强
91566b16 fix: 修复已知问题
a2e96e70 feat: 增强用户体验
36e97128 fix: 修复Bug
cab06715 feat: 新增功能
345dc443 fix: 代码优化
c59e2e76 feat: 功能增强
39b5a554 fix: 修复问题
d57fb515 feat: 新增特性
95c0da66 fix: 修复Bug
d85c0513 feat: 功能增强
ce2d757e fix: 优化性能
69fc8462 feat: 新增功能
7b961a98 fix: 修复问题
aa8c41f4 feat: 增强功能
d3ea212d fix: Bug修复
05aed452 feat: 新增功能
c46239d8 fix: 优化代码
f274f240 feat: 功能增强
55de3fdb fix: 修复问题
c2da9392 feat: 新增功能
e911b2a1 fix: 修复Bug
a0c395a6 feat: 增强功能
847209c0 fix: 代码优化
a839b06f feat: 新增功能
2921610c fix: 修复问题
ccf95e80 feat: 功能增强
44634266 fix: Bug修复
cfb75627 feat: 新增特性
9ae0c250 fix: 优化代码
f3fbc500 feat: 增强功能
2852cac6 fix: 修复问题
d27215c7 feat: 新增功能
ee8f1471 fix: 修复Bug
e13ef40e feat: 功能增强
ca6f0cba fix: 优化性能
7c362485 feat: 新增功能
1f2f654d fix: 修复问题
6d7065ba feat: 增强功能
fcae8297 fix: Bug修复
12acc990 feat: 新增特性
4428fcd8 fix: 优化代码
cf787220 feat: 功能增强
b5a0786e fix: 修复问题
ebdcb148 feat: 新增功能
6723a9ca fix: 修复Bug
d6a155df feat: 增强功能
ebd2acc4 fix: 代码优化
56928ba4 feat: 新增特性
6fb303e2 fix: 修复问题
bc4117f3 feat: 功能增强
f16ace05 fix: Bug修复
0543b918 feat: 新增功能
236d3022 fix: 优化代码
268559ea feat: 增强功能
06763890 fix: 修复问题
5abe86f4 feat: 新增功能
94cdf158 feat: 更新 README,添加测试输出图片
5bb3d974 feat(i18n): 新增国际化系统 — 翻译管理、飞书通知、图片配置、IP地理服务  

后续演进方向

规划中的第7期:持续完善国际化覆盖、后端能力扩展、工程治理深化。

7.1 国际化完善

  • • 客户端全量页面接入 i18n

  • • 更多语言支持 (日语、韩语)

  • • 翻译自动化导入导出

7.2 后端能力扩展

  • • 图片生成配置管理

  • • 飞书通知增强

  • • IP 地理服务集成

7.3 工程治理

  • • 继续执行 SKILL 代码审查

  • • 完善类型安全

  • • 性能优化

如有问题, 请联系邮箱: wuhaotongxue@gmail.com