feat(web): support deployment under a configurable base path

[Phil-OSophy-42]

概述

支持将 Web 应用部署在反向代理的子路径下（例如 https://example.com/skillhub/），
不再局限于域名根目录。默认行为完全不变：根路径部署与改动前逐字节等价。

背景

当 SkillHub 与其他应用共用一个域名、部署在网关之后时，需要挂在自己的路径前缀下。
目前构建产物将根路径 / 写死，资源 URL、前端路由和少数硬编码跳转在子路径下全部失效。

实现

两层设计：

构建期：VITE_BASE_PATH 驱动 Vite base，其余位置统一读 import.meta.env.BASE_URL
（router basepath、withBasePath() 跳转辅助），一处配置保持一致。

运行时（单镜像多路径）：镜像默认以占位符 /__SKILLHUB_WEB_BASE_PATH__/ 构建，
entrypoint（20-base-path.sh）启动时将占位符替换为 SKILLHUB_WEB_BASE_PATH
环境变量的值（默认 /）。同一镜像通过环境变量即可部署在任意子路径，无需重建：

docker run -e SKILLHUB_WEB_BASE_PATH=/skillhub/ ...

如需构建期烤死固定 base（跳过运行时替换）：--build-arg VITE_BASE_PATH=/skillhub/。

改动清单

• vite.config.ts — base: process.env.VITE_BASE_PATH ?? '/'
• src/app/router.tsx — basepath: import.meta.env.BASE_URL
• src/shared/lib/base-path.ts（新增）— withBasePath()，为绕过路由的整页跳转
  与动态资源地址补前缀，绝对 URL 原样放行
• api-error.ts / user-menu.tsx / login-button.tsx — 硬编码的 /login、/
  跳转及 provider 图标地址改经 withBasePath()
• api/client.ts — 顺带修复：logout 原先用原始 fetch('/api/v1/auth/logout')
  绕过 apiBaseUrl，子路径下请求打到域名根、会话无法清除；改经 buildApiUrl()
• use-notification-sse.ts — EventSource URL 改经 buildApiUrl()，与其他 API 一致
• src/vite-env.d.ts（新增）— vite/client 类型
• Dockerfile / docker-entrypoint.d/20-base-path.sh — 占位符构建 + 启动替换
• compose.release.yml / deploy/k8s/base/frontend-deployment.yaml /
  .env.release.example — 暴露 SKILLHUB_WEB_BASE_PATH

API 请求前缀沿用已有的运行时 apiBaseUrl（SKILLHUB_WEB_API_BASE_URL），无需新机制。

测试

• pnpm vitest run — 609 个用例全部通过
• 默认构建：index.html 引用 /assets/...，与原先一致（向后兼容）
• VITE_BASE_PATH=/skillhub/ pnpm build：产物引用 /skillhub/assets/...
• 占位符构建 + entrypoint 替换实测：env 未设 → /（根）；env=/skillhub/ →
  /skillhub/assets/...，零占位符残留
• 已在 Kubernetes + Istio 网关的真实环境按子路径 /skillhub/ 部署验证：页面加载、
  客户端路由深链/刷新、API 调用、登录/注销均正常

[CLAassistant]

All committers have signed the CLA.

[Phil-OSophy-42]

@dongmucat Hi! please take a took

[Phil-OSophy-42]

/cc @dongmucat