lanyuanxiaoyao/nex
1
0
Fork 0
Code Activity
Files
6b1af27ea2c898a20ef75f27f991581a03774e75
nex/openspec/changes/archive/2026-05-05-unify-branding-and-about-version/tasks.md
lanyuanxiaoyao 8eea30ea11 feat: 统一品牌标识、关于页面三卡片布局与版本诊断功能 
- 统一品牌为 Nex：侧边栏、托盘 tooltip、HTML 标题、favicon (PNG 替代 SVG)
- 重构关于页面为三卡片布局（品牌/版本/链接），版本状态 Tag 绝对定位右上角
- 新增 GET /api/version 后端接口，返回 version/commit/build_time
- 新增前端版本一致性诊断：匹配/不匹配/不可判断三种状态
- 同步 delta specs 到主 specs 并归档变更
2026-05-05 03:28:22 +08:00

3.5 KiB
Raw Blame History

1. 后端版本接口

  • 1.1 新增后端版本信息 handler，响应 version、commit、build_time 并复用 buildinfo
  • 1.2 在 server 入口注册 GET /api/version
  • 1.3 在 desktop 入口注册 GET /api/version
  • 1.4 为版本 handler 增加单元测试覆盖响应字段和默认降级值
  • 1.5 为 server 路由增加测试覆盖 GET /api/version
  • 1.6 为 desktop 路由增加测试覆盖 GET /api/version 不落入 SPA fallback

2. 前端版本 API 与状态判断

  • 2.1 新增前端版本信息类型定义，包含后端 version、commit、buildTime
  • 2.2 新增前端版本 API 调用 GET /api/version
  • 2.3 新增 TanStack Query hook 获取后端版本信息
  • 2.4 集中定义前端 APP_NAME、产品描述和 VITE_APP_VERSION 降级值
  • 2.5 实现前后端版本状态判断逻辑，覆盖一致、不一致、无法判断和请求失败
  • 2.6 为版本 API 和版本状态判断增加前端单元测试

3. 品牌与图标资源

  • 3.1 将侧边栏品牌名称从 AI Gateway 替换为 Nex
  • 3.2 使用统一应用图标渲染侧边栏 logo，折叠态保留图标并隐藏文字
  • 3.3 为侧边栏折叠按钮补充清晰的无障碍标签
  • 3.4 将根目录 assets/icon.png 复制为 frontend/public/icon.png
  • 3.5 将前端 HTML favicon 路径改为 /icon.png 并将 HTML title 改为 Nex
  • 3.6 将 desktop 静态文件服务的 /favicon.svg 路由替换为 /icon.png 路由
  • 3.7 删除未使用的 frontend/public/icons.svg 和旧 SVG favicon 资源
  • 3.8 全文确认不存在未处理的 icons.svg、favicon.svg 引用
  • 3.9 更新 AppLayout 组件测试覆盖展开态 Nex、折叠态图标和 About 菜单项
  • 3.10 更新导航 E2E 中旧 AI Gateway 品牌断言为 Nex

4. About 页面改造

  • 4.1 重构 About 页面为品牌卡片、版本信息卡片和链接卡片三卡布局
  • 4.2 使用 TDesign Card、Tag、Descriptions、Alert、Row/Col 等组件 props 完成主要视觉结构
  • 4.3 在 About 页面展示前端版本、后端版本、commit 和 build_time
  • 4.4 在 About 页面展示版本一致、不一致、无法判断和请求失败状态
  • 4.5 确保版本不一致或接口失败时 About 页面不崩溃且不阻断其他功能
  • 4.6 为 About 页面增加组件测试覆盖布局、版本展示和所有版本状态
  • 4.7 为 About 页面补充必要的 E2E 导航与版本区域可见性测试

5. 文档同步

  • 5.1 更新根 README 的管理接口列表，加入 GET /api/version
  • 5.2 更新根 README 的前端样式技术栈说明，体现 TDesign props、TDesign tokens、SCSS 优先级
  • 5.3 更新 backend README 的管理接口文档，说明版本响应字段来源
  • 5.4 更新 frontend README 的环境变量说明，加入 VITE_APP_VERSION
  • 5.5 更新 frontend README 的样式优先级为 TDesign props、TDesign tokens、SCSS
  • 5.6 更新 frontend README 的项目结构、About 页面说明和 public 图标来源说明
  • 5.7 更新 desktop 相关文档说明 PNG favicon、/icon.png 静态路由和 API 版本接口路由

6. 验证

  • 6.1 运行后端测试，确保 handler、server 和 desktop 路由测试通过
  • 6.2 运行前端测试，确保 API、hook、AppLayout 和 About 页面测试通过
  • 6.3 运行前端检查和构建，确保 Bun/Vite 构建能加载 PNG favicon
  • 6.4 运行 OpenSpec 校验，确保 proposal、design、specs 和 tasks 状态可实施
View Git Blame Copy Permalink