fix(gateway): OpenCode 分组自动生成 x-opencode-session 支持通用客户端，发布 1.2.65

- 通用 OpenAI 客户端(Cherry Studio)不携带 x-opencode-session，仅透传无法满足上游要求
- 网关在缺失时生成 UUID 会话标识，覆盖 chat raw 与 responses passthrough 路径
- 无数据库迁移

Author: Open-Pixel-AI

backend/cmd/server/VERSION

@@ -1 +1 @@
-1.2.64
+1.2.65

backend/internal/service/openai_gateway_chat_completions_raw.go

@@ -129,6 +129,7 @@ func (s *OpenAIGatewayService) forwardAsRawChatCompletions(
 		upstreamReq.Header.Set("user-agent", userAgent)
 	}
 	account.ApplyHeaderOverrides(upstreamReq.Header)
+	ensureOpencodeSessionHeader(account, upstreamReq)
 
 	proxyURL := ""
 	if account.Proxy != nil {

backend/internal/service/openai_gateway_service.go

@@ -5196,6 +5196,7 @@ func (s *OpenAIGatewayService) buildUpstreamRequestOpenAIPassthrough(
 	if account.IsOpenAIOAuth() {
 		enforceCodexIdentityHeaders(req.Header)
 	}
+	ensureOpencodeSessionHeader(account, req)
 
 	return req, nil
 }
@@ -6670,6 +6671,7 @@ func (s *OpenAIGatewayService) buildUpstreamRequest(ctx context.Context, c *gin.
 	if account.IsOpenAIOAuth() {
 		enforceCodexIdentityHeaders(req.Header)
 	}
+	ensureOpencodeSessionHeader(account, req)
 
 	return req, nil
 }

backend/internal/service/opencode_go_gateway.go

@@ -12,11 +12,26 @@ import (
 
 	"github.com/Wei-Shaw/sub2api/internal/pkg/apicompat"
 	"github.com/gin-gonic/gin"
+	"github.com/google/uuid"
 	"github.com/tidwall/sjson"
 )
 
 const opencodeResponsesRawEndpoint = "/v1/responses"
 
+// ensureOpencodeSessionHeader 确保 OpenCode 上游请求携带 x-opencode-session。
+// OpenCode Go 上游用该头做会话路由和 prompt 缓存；原生 OpenCode 客户端会自动携带，
+// 但通用 OpenAI 兼容客户端（如 Cherry Studio）不会。网关在缺失时生成一个稳定标识，
+// 避免上游报 "missing x-opencode-session" 400。
+func ensureOpencodeSessionHeader(account *Account, req *http.Request) {
+	if account == nil || req == nil || !account.IsOpencode() {
+		return
+	}
+	if req.Header.Get("x-opencode-session") != "" {
+		return
+	}
+	req.Header.Set("x-opencode-session", uuid.New().String())
+}
+
 // OpencodeGoResolvedModel is the single routing decision shared by all three
 // OpenCode Go ingress protocols. Protocol selection must use UpstreamModel,
 // after channel/account mapping and provider-prefix normalization.

docs/site/content/docs/operations/changelog.mdx

@@ -3,6 +3,11 @@ title: 更新日志
 description: 按版本记录 Pixel API 的主要功能更新。
 ---
 
+## v1.2.65
+
+- 修复 OpenCode 分组对通用客户端（Cherry Studio 等）仍报 `missing x-opencode-session` 的问题：网关现在在客户端未携带该头时自动生成会话标识，而不仅是透传。
+- 数据库无新增迁移。
+
 ## v1.2.64
 
 - 补完 OpenCode Go 会话标识 `x-opencode-session` 的透传：Chat Completions 的 Anthropic 桥接路径此前仍会丢弃该请求头导致上游 400，现覆盖全部转发路径。