1
0
Files
nex/openspec/changes/archive/2026-05-05-unify-branding-and-about-version/proposal.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

2.7 KiB
Raw Blame History

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,暴露构建注入的 versioncommitbuild_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/AppLayoutfrontend/src/pages/Aboutfrontend/src/apifrontend/src/hooksfrontend/src/typesfrontend/index.htmlfrontend/public、前端测试和 E2E 测试。
  • 后端:backend/internal/handlerbackend/cmd/serverbackend/cmd/desktop、后端测试。
  • 文档与规范:根 README.mdfrontend/README.mdbackend/README.md、相关 OpenSpec specs。
  • API新增 GET /api/version 管理接口;不引入新依赖。