- 统一品牌为 Nex:侧边栏、托盘 tooltip、HTML 标题、favicon (PNG 替代 SVG) - 重构关于页面为三卡片布局(品牌/版本/链接),版本状态 Tag 绝对定位右上角 - 新增 GET /api/version 后端接口,返回 version/commit/build_time - 新增前端版本一致性诊断:匹配/不匹配/不可判断三种状态 - 同步 delta specs 到主 specs 并归档变更
2.7 KiB
2.7 KiB
Why
当前前端侧边栏仍显示旧的 AI Gateway 文案,折叠后品牌区域为空;About 页面信息展示较简陋,无法展示和判断前后端构建版本是否匹配。同时前端 public 图标资源与仓库统一的 assets/icon.png 不一致,并存在未使用的 SVG 图标资源,增加了品牌和资源维护成本。
What Changes
- 将前端侧边栏品牌统一为
Nex,展开时显示统一图标和应用名称,折叠时仍显示图标。 - 将前端 favicon/public 图标统一复用仓库
assets/icon.png,运行时统一使用/icon.png;替换当前/favicon.svg引用并清理未使用的frontend/public/icons.svg资源。 - 将前端 HTML 标题等用户可见应用名称同步为
Nex,保留AI Gateway作为产品描述。 - 重新设计 About 页面信息结构,使用三个独立卡片分别展示品牌、版本信息和外部链接,版本状态 Tag 浮动在版本信息卡片右上角。
- 新增后端管理接口
GET /api/version,暴露构建注入的version、commit、build_time,供前端判断前后端版本一致性。 - 在 server 和 desktop 两种启动模式下都注册版本接口,并确保 desktop 静态资源路由支持新的 PNG 图标路径。
- 明确前端样式优先级:TDesign 组件 props 优先,其次使用 TDesign tokens,最后才在无法通过前两者表达时使用 SCSS,并同步更新 README。
- 为菜单品牌、About 页面、版本接口、版本匹配状态和资源清理补充测试。
Capabilities
New Capabilities
无。
Modified Capabilities
frontend: 侧边栏品牌标识、折叠态 logo、HTML 标题、前端样式优先级和 public 图标资源使用规则发生变化。about-page: About 页面从简单品牌信息扩展为现代化信息面板,并展示前后端版本与匹配状态。repository-versioning: 后端需要通过管理接口暴露构建版本信息,前端需要使用构建注入版本与后端版本进行一致性判断。desktop-app: desktop 模式需要支持新的 PNG 图标静态资源路径,保证版本接口作为 API 路由处理,并同步现有Nex托盘 tooltip 规范。
Impact
- 前端:
frontend/src/components/AppLayout、frontend/src/pages/About、frontend/src/api、frontend/src/hooks、frontend/src/types、frontend/index.html、frontend/public、前端测试和 E2E 测试。 - 后端:
backend/internal/handler、backend/cmd/server、backend/cmd/desktop、后端测试。 - 文档与规范:根
README.md、frontend/README.md、backend/README.md、相关 OpenSpec specs。 - API:新增
GET /api/version管理接口;不引入新依赖。