# T-WEB-011 管理端展示当前版本号 - **状态**: done - **依赖**: T-WEB-010 - **文档**: v1.6 §11(版本号展示) ## 目标 管理端页面**左下角**展示当前运行版本 `vX.Y.Z`,且与 `GET /health` 的 `version` 同源(文档 §11.1 的硬性要求:单一来源、可核对)。 ## 方案 | 项 | 做法 | |--|--| | 唯一来源 | `web-server/package.json` 的 `version`(同时是 `/health` 的 `version`) | | 注入方式 | Vite 构建期 `define: { __APP_VERSION__: }` | | 展示位置 | `admin/src/components/Layout.tsx` 侧边栏底部 `APP_VERSION_LABEL` | | 禁止重复 | `admin/src/lib/version.ts` 是唯一读取点,界面不出现版本号字面量 | `/health` 的 `version` 取 `process.env.npm_package_version`(由 npm 脚本注入), 与构建期注入管理端的值来自同一个 `package.json`,因此**不可能不一致**。 ## 验收(文档 §11.3) | 验收项 | 结果 | |--|--| | 管理端任一页面左下角可见 `vX.Y.Z` | ✅ 侧边栏底部固定显示 | | 与 `GET /health` 的 `version` 相同 | ✅ 同源于 `web-server/package.json` | | 与产物文件名一致 | ✅ `opendance-web-vX.Y.Z.tar.gz`;打包脚本读取同一个 package.json |