// session.go 免费车道的会话/项目身份与请求头。 // // 这些值不是业务字段,而是上游用来校验「这是官方 OpenCode 客户端」的指纹: // - ses_<12 hex><14 base62>,12 位 hex 是 ~(ms<<12|1) 的降序编码; // - x-opencode-project 是 40 位 hex(git 根提交形状); // - 四个会话头同值,另带 traceparent/b3。 // // 移植自 dsh-our-free-model 的 src/o2a/{identity,headers}.js。 package freemodel import ( "crypto/rand" "crypto/sha256" "encoding/hex" "net/http" "strings" "sync" "time" ) const ( base62Alphabet = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz" clientUA = "opencode/latest/2.2.3/cli" anonCredential = "public" sessionPrefix = "ses_" ) var ( bootNonce = randomBytes(16) lastStamp int64 seq int stampMu sync.Mutex sessionNow = time.Now ) func randomBytes(n int) []byte { buf := make([]byte, n) _, _ = rand.Read(buf) return buf } func isHex(s string) bool { if s == "" { return false } for _, r := range s { if !((r >= '0' && r <= '9') || (r >= 'a' && r <= 'f')) { return false } } return true } // isCanonicalSession 报告 id 是否是上游接受的会话形状。 func isCanonicalSession(id string) bool { if !strings.HasPrefix(id, sessionPrefix) || len(id) != 4+12+14 { return false } if !isHex(id[4:16]) { return false } // 降序时间编码的计数器窗口:第 10 位必须是 f,第 11 位 c-f。 if id[13] != 'f' { return false } if id[14] < 'c' || id[14] > 'f' { return false } for _, r := range id[16:] { if !strings.ContainsRune(base62Alphabet, r) { return false } } return true } // canonicalSession 把任意 signal 收敛成上游接受的会话 id。 func canonicalSession(signal string) string { signal = strings.TrimSpace(signal) if isCanonicalSession(signal) { return signal } h := sha256.New() h.Write([]byte("ses\x00")) h.Write(bootNonce) h.Write([]byte{0}) h.Write([]byte(signal)) digest := h.Sum(nil) return sessionPrefix + descendingTimePart(digest) + base62Fixed(digest[6:16], 14) } // descendingTimePart 生成 12 位降序时间 hex:今日 UTC 零点减去最多 30 天的 // 哈希偏移,再 <<12|1 取反。 func descendingTimePart(hash []byte) string { offset := (uint32(hash[0])<<24 | uint32(hash[1])<<16 | uint32(hash[2])<<8 | uint32(hash[3])) % uint32(30*24*60*60*1000) now := sessionNow().UTC() midnight := time.Date(now.Year(), now.Month(), now.Day(), 0, 0, 0, 0, time.UTC).UnixMilli() base := uint64(midnight) - uint64(offset) inverted := ^((base << 12) | 1) & 0xFFFFFFFFFFFF return hex.EncodeToString([]byte{ byte(inverted >> 40), byte(inverted >> 32), byte(inverted >> 24), byte(inverted >> 16), byte(inverted >> 8), byte(inverted), }) } func base62Fixed(bytes []byte, width int) string { n := newBigInt() for _, b := range bytes { n.mul(256) n.add(int(b)) } out := make([]byte, width) for i := width - 1; i >= 0; i-- { out[i] = base62Alphabet[n.mod(62)] n.div(62) } return string(out) } // 极小的大整数实现:只用于 8 字节 → 14 位 base62,避免为一行逻辑引入 math/big。 type smallBig struct{ words [8]uint32 } // 256-bit,足够 func newBigInt() *smallBig { return &smallBig{} } func (b *smallBig) mul(m uint32) { carry := uint64(0) for i := range b.words { v := uint64(b.words[i])*uint64(m) + carry b.words[i] = uint32(v) carry = v >> 32 } } func (b *smallBig) add(v int) { carry := uint64(v) for i := range b.words { if carry == 0 { return } sum := uint64(b.words[i]) + carry b.words[i] = uint32(sum) carry = sum >> 32 } } func (b *smallBig) div(d uint32) { rem := uint64(0) for i := len(b.words) - 1; i >= 0; i-- { cur := (rem << 32) | uint64(b.words[i]) b.words[i] = uint32(cur / uint64(d)) rem = cur % uint64(d) } } func (b *smallBig) mod(d uint32) int { rem := uint64(0) for i := len(b.words) - 1; i >= 0; i-- { rem = ((rem << 32) | uint64(b.words[i])) % uint64(d) } return int(rem) } // sessionSignal 从请求里挑一个稳定的会话信号:优先显式头,其次首条用户消息, // 最后回落到全局桶。 func sessionSignal(r *http.Request, body map[string]any) string { for _, key := range []string{"x-opencode-session", "x-session-id", "X-Session-Id", "x-session-affinity"} { if v := strings.TrimSpace(r.Header.Get(key)); isCanonicalSession(v) { return v } } if v, ok := body["user"].(string); ok && strings.TrimSpace(v) != "" { return "user:" + strings.TrimSpace(v) } if messages, ok := body["messages"].([]any); ok { for _, raw := range messages { msg, _ := raw.(map[string]any) if msg == nil { continue } if role, _ := msg["role"].(string); role != "system" && role != "developer" { if text, ok := msg["content"].(string); ok && strings.TrimSpace(text) != "" { sum := sha256.Sum256([]byte(text)) return "chat:" + hex.EncodeToString(sum[:8]) } } } } return "global" } func sessionFor(r *http.Request, body map[string]any) string { return canonicalSession(sessionSignal(r, body)) } // projectID 生成 40 位 hex 项目 id:调用方给了 git 提交形状或 global 就沿用, // 其余从会话 id 派生(同一会话一个配额桶)。 func projectID(r *http.Request, session string) string { if r != nil { if raw := strings.TrimSpace(r.Header.Get("x-opencode-project")); raw == "global" || (len(raw) == 40 && isHex(raw)) { return raw } } sum := sha256.Sum256([]byte("opencode-project\x00" + session)) return hex.EncodeToString(sum[:20]) } // gatewayHeaders 官方 2.2.3 客户端的请求头集合。 func gatewayHeaders(session, project string) map[string]string { trace := randomBytes(16) span := randomBytes(8) parent := randomBytes(8) return map[string]string{ "content-type": "application/json", "authorization": "Bearer " + anonCredential, "user-agent": clientUA, "accept": "*/*", "x-opencode-client": "cli", "x-session-affinity": session, "x-session-id": session, "x-opencode-session": session, "x-opencode-session-id": session, "x-opencode-project": project, "traceparent": "00-" + hex.EncodeToString(trace) + "-" + hex.EncodeToString(span) + "-01", "b3": hex.EncodeToString(trace) + "-" + hex.EncodeToString(span) + "-1-" + hex.EncodeToString(parent), } } // mintSessionID 仅用于测试与调试:按上游算法铸造一个新会话。 func mintSessionID(t time.Time) string { stampMu.Lock() defer stampMu.Unlock() ms := t.UnixMilli() if ms != lastStamp { lastStamp = ms seq = 0 } seq++ value := ^((uint64(ms) << 12) | uint64(seq)) var out [6]byte for i := 0; i < 6; i++ { out[i] = byte(value >> (40 - 8*i)) } return sessionPrefix + hex.EncodeToString(out[:]) + base62Fixed(randomBytes(14), 14) }