|
|
df253559a5
|
feat(cache): 实现 RoutingCache 和 StatsBuffer 优化数据库写入
- 新增 RoutingCache 组件，使用 sync.Map 缓存 Provider 和 Model
- 新增 StatsBuffer 组件，使用 sync.Map + atomic.Int64 缓冲统计数据
- 扩展 StatsRepository.BatchUpdate 支持批量增量更新
- 改造 RoutingService/StatsService/ProviderService/ModelService 集成缓存
- 更新 usage-statistics spec，新增 routing-cache 和 stats-buffer spec
- 新增单元测试覆盖缓存命中/失效/并发场景
|
2026-04-22 19:24:36 +08:00 |
|
|
|
5e7267db07
|
fix(e2e): 修复 10 个被 skip 的 E2E 测试
- 将 playwright.config.ts 的 mkdtemp 替换为固定路径，解决主进程/worker 临时目录不一致问题
- 交换后端 WAL 与迁移执行顺序，确保 sql.js 能读取到完整 schema
- 修复 models.spec.ts 断言使用 exact:true 避免统一模型 ID 列干扰
- 移除全部 10 个 test.skip，26 个 E2E 测试全部通过
|
2026-04-22 14:32:12 +08:00 |
|
|
|
7b28cee7a1
|
Merge branch 'dev-frontend-optimization'
|
2026-04-22 13:31:37 +08:00 |
|
|
|
934c8dea77
|
Merge branch 'dev-testcase-analysis'
|
2026-04-22 13:23:32 +08:00 |
|
|
|
4e86adffb7
|
feat: 系统性改进后端测试体系
- 新增 6 个测试场景 (config load pipe, handler errors, service aggregation, engine degradation, openai decoder edges, negative tests)
- 更新测试工具规格 (mockgen, in-memory SQLite)
- 覆盖率目标从 >80% 提升至 >85%
- 新增 test-unit 和 test-integration Makefile 命令
- 新增死代码清理和 mockgen 需求
- 归档变更至 openspec/changes/archive/2026-04-22-improve-backend-testing/
|
2026-04-22 13:18:51 +08:00 |
|
|
|
5d58acf5a6
|
fix: 修复供应商管理弹窗交互问题并去掉 API Key 脱敏
- Dialog 设置 lazy={false} 修复首次打开编辑弹窗表单为空
- API Key 改为普通字段（前端去掉 password 类型，后端去掉掩码逻辑）
- 删除模型编辑弹窗中的统一模型 ID 字段
- 简化 ProviderService.Get 签名（去掉 maskKey 参数）
- 删除 domain 和 config 层的 MaskAPIKey() 方法
- 更新前后端测试（107 单元测试 + 16 E2E 全部通过）
- 同步 delta spec 到主 spec
|
2026-04-22 13:13:25 +08:00 |
|
|
|
81dcecb723
|
docs: 补充 bun 作为前端唯一包管理器的说明
|
2026-04-22 11:37:05 +08:00 |
|
|
|
141f5f886f
|
fix: 修复供应商管理弹窗交互问题
- 导入 TDesign react-19-adapter 修复 MessagePlugin 在 React 19 下的渲染错误
- Dialog 禁用蒙版点击和 ESC 键关闭，防止误操作丢失表单数据
- 重构弹窗关闭逻辑，使用 mutateAsync 替代 useEffect 监听 isSuccess
- 成功后自动关闭弹窗，失败后保持弹窗打开并显示错误提示
|
2026-04-22 11:36:16 +08:00 |
|
|
|
f488b9cc15
|
fix(e2e): 修复对话框关闭问题，完善 E2E 测试
- 修复 TDesign Dialog onConfirm 不自动关闭的问题
- 使用 useEffect 监听 mutation 状态自动关闭对话框
- 测试使用 waitForResponse 等待 API 响应
- 添加 clearDatabase 函数确保测试隔离
- 归档 e2e-real-backend 变更到 archive/2026-04-22
- 同步 e2e-testing spec 到主 specs
|
2026-04-22 10:32:57 +08:00 |
|
|
|
59179094ed
|
feat: E2E 测试集成真实后端
- Playwright 双 webServer 模式自动启动 Go 后端 + Vite 前端
- 后端使用临时 SQLite 数据库隔离，固定端口 19026
- vite.config.ts proxy target 动态读取环境变量
- 新增 sql.js 依赖用于 SQLite 统计数据 seed
- 新增 e2e/fixtures.ts 共享工具模块（API seed + SQLite seed）
- 拆分测试文件 5→7（providers/models/stats/navigation/validation）
- 删除旧文件 crud.spec.ts/sidebar.spec.ts/stats-cards.spec.ts
- E2E 测试尚有部分用例需调试修复
|
2026-04-22 00:31:35 +08:00 |
|
|
|
4fc5fb4764
|
Merge branch 'dev-openai-path-parse'
|
2026-04-21 20:50:52 +08:00 |
|
|
|
feff97acbd
|
feat: 前端适配后端新接口
适配后端统一模型 ID、协议字段、UUID 自动生成和结构化错误响应：
- 类型定义：Provider 新增 protocol 字段，Model 新增 unifiedId，CreateModelInput 移除 id
- API 客户端：提取结构化错误响应中的错误码
- 供应商管理：添加协议选择下拉框和表格列
- 模型管理：移除 ID 输入，显示统一模型 ID（只读）
- Hooks：错误码映射为友好中文消息
- 测试：所有组件测试通过，mock 数据适配新字段
- 文档：更新 README 说明协议字段和统一模型 ID
|
2026-04-21 20:49:37 +08:00 |
|
|
|
b7e205f4b6
|
refactor: 优化 URL 路径拼接，修复 /v1 重复问题
## 主要变更
**核心修改**：
- 路由定义：/:protocol/v1/*path → /:protocol/*path
- proxy_handler：nativePath 直接使用 path 参数，不添加 /v1 前缀
- OpenAI 适配器：DetectInterfaceType 和 BuildUrl 去掉 /v1 前缀
- Anthropic 适配器：保持 /v1 前缀（Claude Code 兼容）
**URL 格式变化**：
- OpenAI: /openai/v1/chat/completions → /openai/chat/completions
- Anthropic: /anthropic/v1/messages (保持不变)
**base_url 配置**：
- OpenAI: 配置到版本路径，如 https://api.openai.com/v1
- Anthropic: 不配置版本路径，如 https://api.anthropic.com
## 测试验证
- 所有单元测试通过
- 所有集成测试通过
- 真实 API 测试验证成功
- 跨协议转换正常工作
## 文档更新
- 更新 backend/README.md URL 格式说明
- 同步 OpenSpec 规范文件
|
2026-04-21 20:21:17 +08:00 |
|
|
|
395887667d
|
feat: 实现统一模型 ID 机制
实现统一模型 ID 格式 (provider_id/model_name)，支持跨协议模型标识和 Smart Passthrough。
核心变更：
- 新增 pkg/modelid 包：解析、格式化、校验统一模型 ID
- 数据库迁移：models 表使用 UUID 主键 + UNIQUE(provider_id, model_name) 约束
- Repository 层：FindByProviderAndModelName、ListEnabled 方法
- Service 层：联合唯一校验、provider ID 字符集校验
- Conversion 层：ExtractModelName、RewriteRequestModelName/RewriteResponseModelName 方法
- Handler 层：统一模型 ID 路由、Smart Passthrough、Models API 本地聚合
- 新增 error-responses、unified-model-id 规范
测试覆盖：
- 单元测试：modelid、conversion、handler、service、repository
- 集成测试：统一模型 ID 路由、Smart Passthrough 保真性、跨协议转换
- 迁移测试：UUID 主键、UNIQUE 约束、级联删除
OpenSpec：
- 归档 unified-model-id 变更到 archive/2026-04-21-unified-model-id
- 同步 11 个 delta specs 到 main specs
- 新增 error-responses、unified-model-id 规范文件
|
2026-04-21 18:14:10 +08:00 |
|
|
|
f3a207fa16
|
docs: 添加 openspec 变更记录，归档已完成变更并添加 unified-model-id 提案
|
2026-04-21 00:45:39 +08:00 |
|
|
|
56ecc73d1b
|
docs: 整合 openspec 规范，合并配置和前端相关独立 spec
将 cli-config、config-priority、env-config 合并入 config-management；
将 tdesign-integration、recharts-integration、frontend-config-ui、
frontend-testing、stats-dashboard 合并入新的 frontend/spec.md；
清理其余 spec 中的冗余标记，补充缺失场景。
|
2026-04-20 19:55:56 +08:00 |
|
|
|
cfb0edf802
|
feat: 引入 Viper 实现多层配置管理
引入 Viper 配置管理框架，支持 CLI 参数、环境变量、配置文件和默认值四种配置方式。
主要变更：
- 引入 Viper、pflag、validator、mapstructure 依赖
- 实现配置优先级：CLI > ENV > File > Default
- 所有 13 个配置项支持 CLI 参数和环境变量
- 规范化命名：server.port → NEX_SERVER_PORT → --server-port
- 使用结构体验证器进行配置验证
- 添加配置摘要输出功能
新增能力：
- cli-config: 命令行参数配置支持
- env-config: 环境变量配置支持（符合 12-Factor App）
- config-priority: 配置优先级管理
修改能力：
- config-management: 扩展为多层配置源支持
使用示例：
./server --server-port 9000 --log-level debug
export NEX_SERVER_PORT=9000 && ./server
./server --config /path/to/custom.yaml
|
2026-04-20 18:04:42 +08:00 |
|
|
|
aea360bce8
|
chore: 更新 openspec 配置，补充项目上下文和规则
- backend 上下文：添加 README.md 说明和公共组件使用优先级
- design 规则：要求技术方案体现在设计文档中
- task 规则：一行一个任务，禁止跨行
|
2026-04-20 16:43:29 +08:00 |
|
|
|
d92db73937
|
refactor: 后端代码质量优化 - 复用公共库、使用标准库、类型安全错误判断
## 高优先级修复
- stats_service_impl: 使用 strings.SplitN 替代错误的索引分割
- provider_handler: 使用 errors.Is(err, gorm.ErrDuplicatedKey) 替代字符串匹配
- client: 重写 isNetworkError 使用 errors.As/Is 类型安全判断
- proxy_handler: 使用 encoding/json 标准库解析 JSON（extractModelName、isStreamRequest）
## 中优先级修复
- stats_handler: 添加 parseDateParam 辅助函数消除重复日期解析
- pkg/errors: 新增 ErrRequestCreate/Send/ResponseRead 错误类型和 WithCause 方法
- client: 使用结构化错误替代 fmt.Errorf
- ConversionEngine: logger 依赖注入，替换所有 zap.L() 调用
## 低优先级修复
- encoder: 删除 joinStrings，使用 strings.Join
- adapter: 删除 modelInfoRegex 正则，使用 isModelInfoPath 字符串函数
## 文档更新
- README.md: 添加公共库使用指南和编码规范章节
- specs: 同步 delta specs 到 main specs（error-handling、structured-logging、request-validation）
## 归档
- openspec/changes/archive/2026-04-20-refactor-backend-code-quality/
|
2026-04-20 16:42:48 +08:00 |
|
|
|
bc1ee612d9
|
refactor: 实现 ConversionEngine 协议转换引擎，替代旧 protocol 包
- 新增 ConversionEngine 核心引擎，支持 OpenAI 和 Anthropic 协议转换
- 添加 stream decoder/encoder 实现
- 更新 provider client 支持新引擎
- 补充单元测试和集成测试
- 更新 specs 文档
|
2026-04-20 13:02:28 +08:00 |
|
|
|
1dac347d3b
|
refactor: 实现 ConversionEngine 协议转换引擎，替代旧 protocol 包
引入 Canonical Model 和 ProtocolAdapter 架构，支持 OpenAI/Anthropic 协议间
无缝转换，统一 ProxyHandler 替代分散的 OpenAI/Anthropic Handler，简化
ProviderClient 为协议无关的 HTTP 发送器，Provider 新增 protocol 字段。
|
2026-04-20 00:36:27 +08:00 |
|
|
|
26810d9410
|
docs: 暂存本次变更的设计文档
|
2026-04-19 18:10:00 +08:00 |
|
|
|
2b1c5e96c3
|
refactor: 迁移 UI 组件库从 Ant Design 至 TDesign
- 替换 antd 为 tdesign-react 作为主要 UI 组件库
- 引入 Recharts 替代 @ant-design/charts 实现图表功能
- 移除主题系统相关代码（ThemeContext、themes 目录）
- 更新所有组件以适配 TDesign 组件 API
- 更新测试用例以匹配新的组件实现
- 新增 TDesign 和 Recharts 集成规范文档
|
2026-04-17 18:22:13 +08:00 |
|
|
|
6eeb38c15e
|
refactor: 迁移前端 antd 组件至 v6 规范 API，消除废弃用法
- 迁移静态 message 到 App.useApp() 模式，使 message 感知 ConfigProvider 上下文
- Button type/danger 迁移为 variant/color 新 API
- Space direction 迁移为 vertical 布尔属性
- Select.Option 子组件迁移为 options 属性
- AppLayout 硬编码颜色替换为 antd design token
- 优化 useThemeConfig：default/dark 改为静态导出，减少不必要的 hook 调用
- 同步更新 openspec 主规范文档
|
2026-04-17 00:59:36 +08:00 |
|
|
|
49818ed4d8
|
feat: 侧边栏默认亮色主题，暗黑主题下跟随切换
|
2026-04-17 00:30:26 +08:00 |
|
|
|
ddd284c1ca
|
feat: 实现多主题系统，支持6套主题切换和设置页面
重构 ThemeContext 为多主题模型（themeId + followSystem + systemIsDark），
新增设置页面（主题下拉栏 + 跟随系统开关），移除旧 ThemeToggle 按钮，
引入 antd-style 和 clsx 依赖支持 MUI/shadcn/Bootstrap/玻璃主题。
|
2026-04-17 00:06:08 +08:00 |
|
|
|
c5b3d9dfc7
|
style: 修复前端 UI 细节问题
- 供应商/模型/统计表格增加列宽约束和 ellipsis 省略号
- 修复主题切换按钮在暗色侧边栏中不可见
- 表格添加 scroll 属性防止窄屏溢出
- 自定义表格空状态提示文案
|
2026-04-16 22:59:26 +08:00 |
|
|
|
870004af23
|
feat: 现代化 UI 布局，实现侧边栏导航和统计仪表盘
- 重构 AppLayout 为可折叠侧边栏导航布局
- 实现统计仪表盘：统计摘要卡片 + 请求趋势图表
- Provider 页面使用 Card 包裹优化视觉层次
- 主题切换按钮移至侧边栏底部，支持折叠态
- Header 适配暗色主题，添加分隔线优化视觉过渡
- 添加全局样式重置（SCSS）
- 完善组件测试和 E2E 测试覆盖
- 同步 OpenSpec 规范到主 specs
|
2026-04-16 19:24:02 +08:00 |
|
|
|
5dd26d29a7
|
test: 修复单元测试并补充完善 E2E 测试用例
- 修复 5 个单元测试失败：ProviderForm 表单提交超时、ModelForm 初始值检查、
StatsTable Select 交互、ProviderTable 删除确认超时
- 适配 Ant Design 6 的 DOM 结构变化和异步行为
- 补充 E2E 测试从 6 个扩展到 32 个，覆盖供应商 CRUD、模型管理、
表单验证、错误处理、边界情况、用量统计筛选等完整用户流程
- 发现并处理 Ant Design 6 按钮文本渲染带空格的兼容性问题
|
2026-04-16 16:27:09 +08:00 |
|
|
|
47ecbadc7c
|
feat: 升级 Ant Design 6 并实现主题切换功能
- 升级 antd 从 5.24.9 到 6.3.5，@ant-design/icons 从 5.6.1 到 6.1.1
- 新增 ThemeContext 和 ThemeToggle 组件，支持明暗主题切换
- 移除自定义 SCSS 样式，采用 Ant Design 主题系统
- 测试环境从 jsdom 切换到 happy-dom，提升测试性能
- 更新 AppLayout、ModelForm、ProviderForm 以适配新主题系统
|
2026-04-16 13:32:57 +08:00 |
|
|
|
9359ca7f62
|
feat: 完成前端重构，采用 Ant Design 5 和完整测试体系
- 采用 Ant Design 5 作为 UI 组件库，替换自定义组件
- 集成 React Router v7 提供路由导航
- 使用 TanStack Query v5 管理数据获取和缓存
- 建立 Vitest + React Testing Library 测试体系
- 添加 Playwright E2E 测试覆盖
- 使用 MSW mock API 响应
- 配置 TypeScript strict 模式
- 采用 SCSS Modules 组织样式
- 更新 OpenSpec 规格以反映前端架构变更
- 归档 frontend-refactor 变更记录
|
2026-04-16 11:21:48 +08:00 |
|
|
|
f18904af1e
|
feat: 实现分层架构，包含 domain、service、repository 和 pkg 层
- 新增 domain 层：model、provider、route、stats 实体
- 新增 service 层：models、providers、routing、stats 业务逻辑
- 新增 repository 层：models、providers、stats 数据访问
- 新增 pkg 工具包：errors、logger、validator
- 新增中间件：CORS、logging、recovery、request ID
- 新增数据库迁移：初始 schema 和索引
- 新增单元测试和集成测试
- 新增规范文档：config-management、database-migration、error-handling、layered-architecture、middleware-system、request-validation、structured-logging、test-coverage
- 移除 config 子包和 model_router（已迁移至分层架构）
|
2026-04-16 00:47:20 +08:00 |
|
|
|
915b004924
|
feat: 初始化 AI Gateway 项目
实现支持 OpenAI 和 Anthropic 双协议的统一大模型 API 网关 MVP 版本，包含：
- OpenAI 和 Anthropic 协议代理
- 供应商和模型管理
- 用量统计
- 前端配置界面
|
2026-04-15 16:53:28 +08:00 |
|
