M0-M4: 推倒重来基线(基建+用户/密钥/核心代理+前端+管理后台+三协议互转)

- 后端 Go+Gin+GORM: 配置(OT_ env)/SQLite/Postgres 双驱动、用户体系(argon2id+JWT access/refresh)、
  API Key(sk- 48位, 仅存 SHA-256 哈希)
- 代理网关: /v1/chat/completions、/v1/responses、/v1/messages、/v1/models;错误按客户端协议返回
- 三协议互转(convert 包): Chat↔Messages↔Responses 请求/响应 + 流式 SSE 逐事件转换(直通优先)
- 用量计费: 异步批量记账、余额扣减、balance_logs、usage_daily 日聚合
- 管理 API: 用户/渠道 CRUD+测试+模型导入/模型定价+绑定/统计/系统配置
- 前端 Vue3+TS+Tailwind(taste-skill 设计 tokens): Landing/登录注册/控制台/管理后台,
  自建组件+Phosphor 图标+自建 SVG 趋势图, 已过 web-design-guidelines 复查
- mock 上游: OpenAI+Anthropic 双协议模拟(含流式)

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

server/internal/usage/usage.go

@@ -1,4 +1,5 @@
 // Package usage 异步记账：请求完成后写入 usage_logs，批量落库（PLANNING §3.2）。
+// 每个请求在 flush 时同步完成：写明细 + 扣余额 + 写流水 + 日聚合。
 package usage
 
 import (
@@ -11,6 +12,7 @@ import (
 	"gorm.io/gorm/clause"
 )
 
+// Recorder 异步记账器：缓冲队列 + 批量事务落库。
 type Recorder struct {
 	db     *gorm.DB
 	ch     chan *store.UsageLog
@@ -36,7 +38,6 @@ func (r *Recorder) Record(l *store.UsageLog) {
 	select {
 	case r.ch <- l:
 	default:
-		// 队列积压：直接同步写，避免丢账
 		if err := r.flush([]*store.UsageLog{l}); err != nil {
 			log.Printf("usage: sync write failed: %v", err)
 		}
@@ -99,13 +100,15 @@ func (r *Recorder) flush(logs []*store.UsageLog) error {
 			if l.Status != store.UsageStatusSuccess || l.Cost <= 0 {
 				continue
 			}
-			// 扣余额（余额可为负，流式请求不中断；后续请求被拒）
+			// 扣余额（余额可为负：流式请求不中断；后续请求被拒）
 			var user store.User
 			if err := tx.Clauses(clause.Locking{Strength: "UPDATE"}).First(&user, l.UserID).Error; err != nil {
 				continue
 			}
 			newBalance := user.Balance - l.Cost
-			tx.Model(&store.User{}).Where("id = ?", l.UserID).Update("balance", newBalance)
+			if err := tx.Model(&store.User{}).Where("id = ?", l.UserID).Update("balance", newBalance).Error; err != nil {
+				continue
+			}
 			tx.Create(&store.BalanceLog{
 				UserID:       l.UserID,
 				Change:       -l.Cost,
@@ -118,18 +121,23 @@ func (r *Recorder) flush(logs []*store.UsageLog) error {
 			// 日聚合 upsert
 			date := l.CreatedAt.UTC().Format("2006-01-02")
 			tx.Clauses(clause.OnConflict{
-				Columns:   []clause.Column{{Name: "user_id"}, {Name: "model_id"}, {Name: "date"}},
+				Columns: []clause.Column{{Name: "user_id"}, {Name: "model_id"}, {Name: "date"}},
 				DoUpdates: clause.Assignments(map[string]any{
-					"requests":         gorm.Expr("requests + 1"),
-					"input_tokens":     gorm.Expr("input_tokens + ?", l.InputTokens),
-					"output_tokens":    gorm.Expr("output_tokens + ?", l.OutputTokens),
+					"requests":          gorm.Expr("requests + 1"),
+					"input_tokens":      gorm.Expr("input_tokens + ?", l.InputTokens),
+					"output_tokens":     gorm.Expr("output_tokens + ?", l.OutputTokens),
 					"cache_read_tokens": gorm.Expr("cache_read_tokens + ?", l.CacheReadTokens),
-					"cost":             gorm.Expr("cost + ?", l.Cost),
+					"cost":              gorm.Expr("cost + ?", l.Cost),
 				}),
 			}).Create(&store.UsageDaily{
-				UserID: l.UserID, ModelID: l.ModelID, Date: date,
-				Requests: 1, InputTokens: l.InputTokens, OutputTokens: l.OutputTokens,
-				CacheReadTokens: l.CacheReadTokens, Cost: l.Cost,
+				UserID:          l.UserID,
+				ModelID:         l.ModelID,
+				Date:            date,
+				Requests:        1,
+				InputTokens:     l.InputTokens,
+				OutputTokens:    l.OutputTokens,
+				CacheReadTokens: l.CacheReadTokens,
+				Cost:            l.Cost,
 			})
 		}
 		return nil