// Package proxy API 网关核心:代理 /v1/chat/completions、/v1/responses、/v1/messages、/v1/models。 // M1 直通 OpenAI 渠道;M4 起按客户端协议 × 渠道协议自动转换(见 convert)。 package proxy import ( "errors" "net/http" "strings" "time" "github.com/gin-gonic/gin" "github.com/openteam/server/internal/channel" "github.com/openteam/server/internal/pkg/apikey" "github.com/openteam/server/internal/pkg/crypto" "github.com/openteam/server/internal/proxy/convert" "github.com/openteam/server/internal/store" "github.com/openteam/server/internal/usage" "gorm.io/gorm" ) const ( CtxUserID = "proxy_user_id" CtxKeyID = "proxy_key_id" CtxTrace = "proxy_trace_id" ) type Gateway struct { db *gorm.DB ch *channel.Service rec *usage.Recorder enc *crypto.Encryptor hc *http.Client } func NewGateway(db *gorm.DB, enc *crypto.Encryptor, rec *usage.Recorder) *Gateway { return &Gateway{ db: db, ch: channel.NewService(db, enc), rec: rec, enc: enc, hc: &http.Client{Timeout: 120 * time.Second}, } } // Auth 代理鉴权中间件:Bearer sk-xxx → 哈希查表 → 校验状态/过期/模型白名单。 func (g *Gateway) Auth(c *gin.Context) { // 先按路径确定客户端协议,保证 Auth 阶段错误也按协议格式返回 switch c.Request.URL.Path { case "/v1/messages": c.Set("protocol", convert.ProtoMessages) case "/v1/responses": c.Set("protocol", convert.ProtoResponses) default: c.Set("protocol", convert.ProtoChat) } auth := c.GetHeader("Authorization") key := strings.TrimPrefix(auth, "Bearer ") key = strings.TrimSpace(key) if !apikey.Valid(key) { apiError(c, http.StatusUnauthorized, "invalid_api_key", "Invalid API key format. Expected: Bearer sk-...") c.Abort() return } hash := apikey.Hash(key) var k store.APIKey if err := g.db.Where("key_hash = ? AND status = ?", hash, store.KeyStatusActive).First(&k).Error; err != nil { apiError(c, http.StatusUnauthorized, "invalid_api_key", "Invalid API key") c.Abort() return } var u store.User if err := g.db.First(&u, k.UserID).Error; err != nil || u.Status != store.UserStatusActive { apiError(c, http.StatusForbidden, "user_disabled", "User account is disabled") c.Abort() return } if k.ExpiresAt != nil && time.Now().After(*k.ExpiresAt) { apiError(c, http.StatusUnauthorized, "key_expired", "API key has expired") c.Abort() return } c.Set(CtxUserID, u.ID) c.Set(CtxKeyID, k.ID) c.Set(CtxTrace, newTraceID()) g.db.Model(&store.APIKey{}).Where("id = ?", k.ID).Update("last_used_at", time.Now()) c.Next() } // Handle 路由到对应协议处理器。 func (g *Gateway) Handle(c *gin.Context) { switch { case c.Request.URL.Path == "/v1/chat/completions": g.chatCompletions(c) case c.Request.URL.Path == "/v1/responses": g.responses(c) case c.Request.URL.Path == "/v1/messages": g.messages(c) case c.Request.URL.Path == "/v1/models" && c.Request.Method == http.MethodGet: g.models(c) default: apiError(c, http.StatusNotFound, "not_found", "Unknown endpoint: "+c.Request.URL.Path) } } // models GET /v1/models:返回启用的全局模型(OpenAI 风格)。 func (g *Gateway) models(c *gin.Context) { var ms []store.Model if err := g.db.Where("enabled = ?", true).Order("sort ASC, id ASC").Find(&ms).Error; err != nil { apiError(c, http.StatusInternalServerError, "internal_error", "failed to load models") return } data := make([]gin.H, 0, len(ms)) for _, m := range ms { data = append(data, gin.H{ "id": m.Name, "object": "model", "created": m.CreatedAt.Unix(), "owned_by": "openteam", }) } c.JSON(http.StatusOK, gin.H{"object": "list", "data": data}) } // candidateChannels 返回可用渠道候选(按模型绑定优先,退化全局)。 func (g *Gateway) candidateChannels(model string) []*store.Channel { return g.ch.Candidates(model) } // resolveUser 取当前用户(含余额)。 func (g *Gateway) resolveUser(c *gin.Context) (*store.User, bool) { uid, _ := c.Get(CtxUserID) var u store.User if err := g.db.First(&u, uid).Error; err != nil { apiError(c, http.StatusUnauthorized, "invalid_api_key", "Invalid API key") return nil, false } return &u, true } // checkBalance 余额不足返回 402(PLANNING §4.4.3)。 func (g *Gateway) checkBalance(c *gin.Context, u *store.User) bool { if u.Balance <= 0 { apiError(c, http.StatusPaymentRequired, "insufficient_balance", "Insufficient balance. Please recharge or contact admin.") return false } return true } // --------------------------------------------------------------------------- // 协议分派 // upstreamProtoFor 根据渠道 provider 与客户端协议确定上游协议与路径。 func upstreamProtoFor(provider, clientProto string) string { switch provider { case store.ChannelProviderAnthropic: return convert.ProtoMessages case store.ChannelProviderOpenAI: if clientProto == convert.ProtoMessages { return convert.ProtoChat } return clientProto default: // compatible:假定 OpenAI Chat 形状 return convert.ProtoChat } } func upstreamPath(proto string) string { switch proto { case convert.ProtoMessages: return "/v1/messages" case convert.ProtoResponses: return "/v1/responses" default: return "/v1/chat/completions" } } // upstreamPlan 描述一次代理请求的上游访问方式。 type upstreamPlan struct { path string // 上游路径 body []byte // 已转换的请求体 lineConv func([]byte) []byte // 流式逐行转换(nil=直通) bodyConv func([]byte) ([]byte, error) // 非流式响应体转换(nil=直通) } // prepareUpstream 计算上游访问计划:协议匹配直通,否则转换。 func prepareUpstream(provider, clientProto string, body []byte) (*upstreamPlan, error) { up := upstreamProtoFor(provider, clientProto) plan := &upstreamPlan{path: upstreamPath(up), body: body} if up != clientProto { converted, err := convert.ConvertRequest(body, clientProto, up) if err != nil { return nil, err } plan.body = converted plan.lineConv = convert.NewStreamTransformer(up, clientProto) plan.bodyConv = func(b []byte) ([]byte, error) { return convert.ConvertResponse(b, up, clientProto) } } return plan, nil } var errNoChannel = errors.New("no available channel")