mirror of
https://github.com/Wei-Shaw/claude-relay-service.git
synced 2026-01-23 00:53:33 +00:00
a3dacbccd0
## 问题分析 编辑账户时显示过期时间表单存在以下问题： 1. **相对时间 vs 绝对时间冲突**： - 下拉框提供相对时间选项（30天、90天等） - 实际存储的是绝对时间（如 2025-02-15） - 过了1天后，无法准确对应原来的"30天"选项 2. **用户体验混乱**： - 设置了30天过期，编辑时下拉框显示"永不过期" - 无法准确回显用户当初的选择 - 容易误导用户 3. **功能重复**： - 已有独立的AccountExpiryEditModal弹窗专门编辑过期时间 - 该弹窗使用绝对时间显示，更清晰准确 ## 解决方案 仅在编辑模式下隐藏过期时间表单： - 创建账户时：保留过期时间表单（相对时间设置合理） - 编辑账户时：隐藏过期时间表单，引导用户使用独立的编辑弹窗 ## 实现细节 在两处过期时间表单添加 v-if="!isEdit" 条件： - 第645行：OAuth添加方式的表单 - 第2116行：手动添加方式的表单 ## 用户流程改进 - 创建账户：可以快速选择相对过期时间（30天、90天等） - 编辑账户：在列表中点击"编辑到期时间"按钮 → 使用独立弹窗编辑 - 弹窗优势：显示当前绝对过期时间、支持快捷延期、实时预览新时间 文件: web/admin-spa/src/components/accounts/AccountForm.vue:645,2116
Claude Relay Service 管理后台 SPA
这是 Claude Relay Service 管理后台的 Vue3 SPA 重构版本。
开发环境要求
- Node.js >= 16
- npm >= 7
安装和运行
1. 安装依赖
cd web/admin-spa
npm install
2. 开发模式运行
npm run dev
重要提示：
- 开发服务器启动后，会自动在浏览器中打开
- 必须访问完整路径：http://localhost:3001/web/admin/
- 不要访问 http://localhost:3001/ （会显示404）
- 首次访问会自动跳转到登录页面
3. 生产构建
npm run build
构建产物将输出到 dist 目录。
4. 预览生产构建
npm run preview
项目结构
web/admin-spa/
├── public/ # 静态资源
├── src/
│ ├── api/ # API 接口封装
│ ├── assets/ # 资源文件
│ ├── components/ # 组件
│ ├── composables/ # 组合式函数
│ ├── router/ # 路由配置
│ ├── stores/ # Pinia 状态管理
│ ├── utils/ # 工具函数
│ ├── views/ # 页面视图
│ ├── App.vue # 根组件
│ └── main.js # 入口文件
├── package.json
└── vite.config.js
功能模块
- ✅ 登录认证
- ✅ 仪表板（系统统计、使用趋势、模型分布）
- 🚧 API Keys 管理
- 🚧 账户管理（Claude/Gemini）
- 🚧 使用教程
- 🚧 系统设置
技术栈
- Vue 3.3.4
- Vue Router 4
- Pinia（状态管理）
- Element Plus 2.4.4
- Tailwind CSS
- Chart.js 4.4.0
- Vite 5
开发注意事项
- 所有 API 请求都通过
/api目录下的模块进行封装 - 状态管理使用 Pinia，存放在
/stores目录 - 组件按功能模块组织在
/components目录下 - 保持与原版页面的功能和样式一致性
代理配置
如果你的后端服务器需要通过代理访问（例如服务器在国外），可以配置 HTTP 代理：
方法一：使用环境变量文件（推荐）
创建 .env.development.local 文件：
# 后端服务器地址
VITE_API_TARGET=http://74.48.134.98:3000
# HTTP 代理配置
VITE_HTTP_PROXY=http://127.0.0.1:7890
方法二：使用系统环境变量
# Linux/Mac
export VITE_HTTP_PROXY=http://127.0.0.1:7890
npm run dev
# Windows
set VITE_HTTP_PROXY=http://127.0.0.1:7890
npm run dev
注意：.env.development.local 文件不会被提交到版本控制，适合存放本地特定的配置。
部署
构建后的文件需要部署到 Claude Relay Service 的 web/admin/ 路径下。
常见问题
Q: 访问 localhost:3001 显示 404？
A: 这是正常的。应用配置在 /web/admin/ 路径下，必须访问完整路径：http://localhost:3001/web/admin/
Q: 登录时 API 请求失败（500错误）？
A:
- 确保主服务运行：Claude Relay Service 必须运行在 http://localhost:3000
- 检查代理配置：Vite 会自动代理
/admin和/api请求到 3000 端口 - 重启开发服务器：如果修改了配置，需要重启
npm run dev - 测试代理：运行
node test-proxy.js检查代理是否正常工作
Q: 如何处理开发和生产环境的 API 配置？
A:
- 开发环境：使用 Vite 代理，自动转发请求到 localhost:3000
- 生产环境：直接使用相对路径
/admin，无需配置 - 两种环境都使用相同的 API 路径，通过环境变量自动切换
Q: 如何部署到生产环境？
A:
- 运行
npm run build构建项目 - 将
dist目录内容复制到服务器的/web/admin/路径 - 确保服务器配置了 SPA 路由回退规则