lanyuanxiaoyao
8eea30ea11
- 统一品牌为 Nex：侧边栏、托盘 tooltip、HTML 标题、favicon (PNG 替代 SVG) - 重构关于页面为三卡片布局（品牌/版本/链接），版本状态 Tag 绝对定位右上角 - 新增 GET /api/version 后端接口，返回 version/commit/build_time - 新增前端版本一致性诊断：匹配/不匹配/不可判断三种状态 - 同步 delta specs 到主 specs 并归档变更
35 lines
2.7 KiB
Markdown
35 lines
2.7 KiB
Markdown
## 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` 管理接口；不引入新依赖。
|