GitLab

ApiKey 更新时显式设置 updated_at 并回填，避免二次查询竞态
补充软删除范围注释以统一审计语义

## 主要变更

### 对话框系统重构
- 升级 BaseDialog 组件，添加动画、焦点管理、响应式宽度
- 删除旧的 Modal.vue，统一使用 BaseDialog

### 使用量数据导出升级
- 改为 Excel 格式导出，支持分页全量导出
- 添加导出进度对话框，支持取消操作
- 新增依赖：xlsx、file-saver

### 使用量页面优化
- Token 明细悬浮提示
- 请求 ID 一键复制
- 新增 first_token 列

### 后端修复
- 账户统计查询添加软删除过滤

## 冲突解决
- 保留 driver.js 依赖（onboarding 功能需要）
- 合并 package.json 变更

- 使用 Teleport 将 Select 下拉菜单渲染到 body，避免 driver.js 遮罩层阻挡
- 添加 pointer-events 和 @click.stop 确保下拉选项可点击
- 移除 useOnboardingTour 中无效的 Select 组件处理代码
- 清理未使用的 CSS 样式和 console 调试语句
- 简化 Select 组件在引导期间的交互逻辑

同步生成文件以匹配最新的 schema 与运行时变更

修复软删除拦截器使用错误，确保默认查询过滤已删记录
仓储层改用 ent.Tx 与扫描辅助，避免 sql.Tx 断言问题
同步更新集成测试以覆盖事务与统计变动

删除开发过程中遗留的未使用文件：
- TourDescription.vue: 未被使用的结构化描述组件
- useTourStepDescription.ts: 步骤key映射，引用的组件从未创建
- TourStepDescriptions/: 空的组件目录

当前实现通过 i18n + HTML 字符串直接提供描述内容，无需这些文件。

创建/删除用户失败时优先展示后端 message\n保留原有兜底提示

避免软删除钩子类型断言失败导致 500\n删除无记录时返回未找到错误并记录日志

- 使用 BaseDialog 替代旧版 Modal 组件
- 添加平滑过渡动画和更好的可访问性支持
- 新增 ExportProgressDialog 导出进度弹窗
- 优化所有账号管理和使用记录相关弹窗
- 更新国际化文案，改进用户交互体验
- 精简依赖，减少 package.json 体积

1. 移除重复的"不再提示"按钮
   - 只保留右上角的关闭按钮（X）
   - 简化用户操作，避免混淆

2. 移除退出确认框
   - 点击关闭按钮直接退出并标记为已看过
   - ESC 键也直接退出，不再弹出确认框
   - 提升用户体验，减少打扰

3. 修复 Select 下拉菜单被遮挡问题
   - 增加被高亮元素的下拉菜单 z-index
   - 确保下拉菜单在引导 popover 之上显示
   - 解决步骤 5/21 (平台选择) 无法操作的问题

问题：创建用户时发生 panic，错误信息为
"interface conversion: sql.ExecQuerier is *sql.Tx, not *sql.DB"

原因：基于事务创建的 ent client 在调用 Close() 时，ent 的 sql driver
会尝试将 ExecQuerier 断言为 *sql.DB 来关闭连接，但实际类型是 *sql.Tx

修复：移除对 txClient.Close() 的调用，事务的清理通过
sqlTx.Rollback() 和 sqlTx.Commit() 完成即可

影响范围：
- user_repo.go: Create 和 Update 方法
- group_repo.go: Delete 方法

🤖 Generated with [Claude Code](https://claude.com/claude-code

)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

修复 Gemini 审查发现的潜在问题，并增强新手引导功能：

1. 简易模式下完全禁用新手引导
   - useOnboardingTour: 添加 isSimpleMode 判断，简易模式下不自动启动
   - 只在标准模式的管理员第一次加载时自动弹出

2. 动态过滤简易模式相关步骤
   - steps.ts: getAdminSteps 添加 isSimpleMode 参数
   - 简易模式下自动过滤分组管理和账号分组选择步骤
   - 避免引导找不到被隐藏的元素

3. 优化引导按钮显示条件
   - AppHeader: 添加 showOnboardingButton computed
   - 只在标准模式的管理员下显示"重新开始引导"按钮
   - 非管理员或简易模式下不显示按钮

4. 确保引导只在首次自动弹出
   - 关闭后不再自动出现
   - 只能从右上角手动重新打开

- 添加 Guide 组件和引导步骤配置
- 实现 useOnboardingTour 和 useTourStepDescription composables
- 添加 onboarding store 管理引导状态
- 更新多个视图和组件以支持引导功能
- 添加国际化支持（中英文）
- 删除旧的实现指南文档

覆盖管理员创建用户与注册流程的关键失败分支\n完善创建成功路径的断言

新增 AdminService 删除路径单元测试与规范场景更新\n同步调整 Google API Key 中间件测试桩与签名

- 新增 AccountService.Delete 方法的 4 个测试用例
- 新增 ApiKeyService.Delete 方法的 4 个测试用例
- 使用 stub 模式隔离数据库依赖，验证权限检查和缓存清理逻辑
- 添加详细的中文注释说明测试设计和预期行为

🤖 Generated with [Claude Code](https://claude.com/claude-code

)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

- 新增 ExistsByID 方法用于账号存在性检查，避免加载完整对象
- 新增 GetOwnerID 方法用于 API Key 所有权验证，仅查询 user_id 字段
- 优化 AccountService.Delete 使用轻量级存在性检查
- 优化 ApiKeyService.Delete 使用轻量级权限验证
- 改进前端删除错误提示，显示后端返回的具体错误消息
- 添加详细的中文注释说明优化原因

🤖 Generated with [Claude Code](https://claude.com/claude-code

)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

允许通过构建参数/脚本选项切换基础镜像来源，避免镜像源 403 影响构建

确保安装时至少存在一个默认分组

新增迁移补齐 cache_creation_5m_tokens/cache_creation_1h_tokens 列，并从旧列回填数据

新增 build_docker.sh 脚本，支持以下功能：
- -t, --tag: 指定镜像标签 (默认: latest)
- -r, --registry: 指定镜像仓库地址
- -p, --push: 构建后推送镜像到仓库
- --no-cache: 不使用 Docker 构建缓存

自动获取 Git 版本信息并注入到构建参数中。

🤖 Generated with [Claude Code](https://claude.com/claude-code

)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

该文件是 GORM 迁移到 Ent ORM 过程中遗留的，仍然导入了
gorm.io/gorm，导致 Docker 构建失败。

文件中的功能已被迁移到 SQL 迁移文件中：
- fixInvalidExpiresAt → 006_fix_invalid_subscription_expires_at.sql
- ensureDefaultGroups → 001_init.sql

🤖 Generated with [Claude Code](https://claude.com/claude-code

)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

通过迁移补种默认 groups 记录，避免新装空分组
迁移锁改为 try lock + 重试并加入超时
写入 usage_logs 时保留 rate_multiplier=0 语义
测试: go test ./...

将仓储层/基础设施改为 Ent + 原生 SQL 执行路径，并移除 AutoMigrate 与 GORM 依赖。
重构内容包括：
- 仓储层改用 Ent/SQL（含 usage_log/account 等复杂查询），统一错误映射
- 基础设施与 setup 初始化切换为 Ent + SQL migrations
- 集成测试与 fixtures 迁移到 Ent 事务模型
- 清理遗留 GORM 模型/依赖，补充迁移与文档说明
- 增加根目录 Makefile 便于前后端编译

测试：
- go test -tags unit ./...
- go test -tags integration ./...

- 移除 api_contract_test.go 中的 SettingKeySimpleMode 引用
- 移除期望响应中的 simple_mode 字段
- 修复 NewSettingHandler 调用参数数量

移除与 PR #66 冲突的旧版简易模式实现（commit 7d4b7dee）。
新版简易模式通过 run_mode 配置文件/环境变量控制，无需数据库设置。

后端变更：
- 移除 SettingKeySimpleMode 常量
- 移除 SystemSettings/PublicSettings 中的 SimpleMode 字段
- 移除 setting_handler 中的简易模式切换逻辑
- 移除 userService 依赖（不再需要自动设置管理员并发数）

前端变更：
- 移除 appStore.simpleMode 状态
- 移除设置页面的"使用模式"设置区块
- 移除 GroupsView 中的简易模式相关逻辑
- 移除相关国际化文案

- Remove unused simpleMode variable in AppSidebar.vue
- Add run_mode to AuthResponse.user type definition

**问题**：
1. login/register 未处理 run_mode，导致 authStore.runMode 不更新
2. 侧边栏使用 simpleMode.value，与路由守卫的 authStore.isSimpleMode 不一致

**修复**：
1. 在 login() 和 register() 中提取并设置 run_mode
2. 统一侧边栏使用 authStore.isSimpleMode

**影响**：
- 路由守卫现在可以正确工作
- 前端UI状态与后端配置保持一致
- 登录/注册后立即生效，无需刷新

由于简易模式会自动创建3个默认分组（anthropic-default, openai-default, gemini-default），
需要更新测试用例的预期数量：
- TestList: 期望5个分组（3个默认 + 2个测试）
- TestListActive: 期望4个活跃分组（3个默认 + 1个测试）
- TestListActiveByPlatform: 期望2个Anthropic分组（1个默认 + 1个测试）
- TestListWithFilters_Platform: 期望2个OpenAI分组（1个默认 + 1个测试）

**问题**：
- 使用 toISOString() 格式化日期导致UTC时区问题
- 在UTC+8时区凌晨时，日期会显示为前一天
- 日期范围初始化在 onMounted 中导致重复渲染和请求

**修复**：
- 统一使用本地时区格式化日期
- 在变量声明时就初始化日期范围，避免延迟初始化
- 移除 initializeDateRange() 函数，直接在声明时设置正确值
- 添加 formatLocalDate() 辅助函数统一日期格式化逻辑

**影响范围**：
- 用户仪表盘 (DashboardView)
- 管理员仪表盘 (admin/DashboardView)
- 用户使用记录 (UsageView)
- 管理员使用记录 (admin/UsageView)

**效果**：
- 日期范围正确包含当天数据
- 避免页面加载时的重复请求
- 改善用户体验，减少不必要的重新渲染