上游会话 id:客户端显式带 x-opencode-session 时优先用它

老板要求:「x-opencode-session 如果 api 请求有带的话优先用请求上的,没有再用 apikey 的那个方式」。

取值优先级(_upstream_session):
  ① 入站 x-opencode-session 头(本轮新增) → sha256("s:{账号}:{客户端值}")[:32]
  ② conversation_id                          → sha256("{账号}:{conversation_id}")[:32]
  ③ 用这个 API Key 自己(一个 Key 一个稳定会话)→ sha256("k:{去前缀Key}")[:32]
  ④ 登录页会话(无 Key)                      → sha256("u:{账号}")[:32]

- 仍按账号哈希:保留第二十六轮的账号隔离(两个账号写同一个值也不会被绑到同一上游会话标识)
- 入站值过 conversation_id 同款入口校验(仅 ASCII、≤128 字符),非法值静默丢弃并回退
  (可选头不该把请求打回 400);三个调用点(直传 / managed 非流式 / managed 流式)全接
- 新增 _inbound_session(request) 与 SESSION_HEADER 常量

实测(生产):同一会话头连打两次同一段 4k 前缀 → cached 0 → 1920(稳定复用);不带头回退
Key 派生也命中。同时更正一条旧认知:上游缓存**并非严格按 session 隔离**(换会话头同前缀
照样命中 1920),会话 id 是「纳入缓存」的前提而非隔离边界 —— README 与代码注释已同步。

测试 204 → 206 全过(新增取值优先级+账号隔离、入站头端到端两条);ci_check 全绿。
This commit is contained in:
api-gateway committed 2026-09-28 19:35:59 +08:00
1 parent 3b35b14a8a
commit c68a76cb8c
4 files changed
+190 -15

No files matched your search

+29
View File
@@ -1,5 +1,34 @@
# CHANGELOG
## 2026-09-28 · 上游会话 id 支持客户端显式指定(`x-opencode-session` 优先)
老板要求:「x-opencode-session 如果 api 请求有带的话优先用请求上的,没有再用 apikey 的那个方式」。
**取值优先级**(`_upstream_session()`):
| 优先级 | 来源 | 派生 |
| --- | --- | --- |
| ① | **入站 `x-opencode-session` 头**(本轮新增) | `sha256("s:{账号}:{客户端值}")[:32]` |
| ② | 请求里的 `conversation_id` | `sha256("{账号}:{conversation_id}")[:32]` |
| ③ | 用这个 API Key 自己(一个 Key 一个稳定会话) | `sha256("k:{去前缀Key}")[:32]` |
| ④ | 登录页会话(无 Key) | `sha256("u:{账号}")[:32]` |
- 客户端带了就用客户端的(它最清楚哪几次调用算同一段对话),**但仍按账号哈希** —— 保留
第二十六轮定下的账号隔离:两个账号即便写同一个值,也不会被绑到同一个上游会话标识上;
- 入站值同样过 `conversation_id` 那套入口校验(仅 ASCII、≤128 字符),**非法值静默丢弃并回退**
(可选头不该把请求打回 400);非 ASCII 值在 HTTP 层就发不出去(httpx 直接拒),校验是兜底;
- 三个调用点(直传端点、managed 非流式、managed 流式)全部接上。
**实测(生产,2026-09-28)**:同一会话头连打两次同一段 4k 前缀 → `cached 0 → 1920`(稳定复用);
不带头(回退 Key 派生)两次都命中。
**顺带更正一条旧认知**:上游提示词缓存**并非严格按 session 隔离** —— 换一个会话头、同一段前缀
照样命中(1920)。所以稳定会话 id 是「纳入缓存」的前提之一,**不是隔离边界**,也不能拿缓存
命中率当会话隔离的判据(README 与代码注释已同步更正)。
**测试**:新增「取值优先级 + 账号隔离」与「入站头端到端(稳定/换头/回退/非法值)」两条回归,
测试数 204 → **206 全过**;`ci_check.sh` 全绿。
## 2026-09-28 · 修「token 统计恒 0」+ token 细分(缓存命中 / 推理)
老板报「token 数统计有问题,一直都是 0」。