## 问题 代理的会话 ID 目前是四维度哈希:`hash(protocol | upstream | credential | conversation)`(src/session-id.ts:89)。其中: - **credential 维度** = Authorization / x-api-key 的原始值。对 Codex/ChatGPT 这是**定期轮换的 OAuth bearer**; - **upstream 维度** = 上游 origin。用户切换中转站/上游时变化。 任一维度变化都会产生一个全新的会话 ID,所有压缩状态(内存 blocks、lastInputTokens、持久化记录)立即成为孤儿——持久化记录也以同一个 ID 为键,同样无法恢复。 ## 症状(#280 场景) 长会话进行中会话"丢失"后,客户端重放全量原始历史:usage=0%、nudge 盲(tokenCount=0 时不注入)、payload 超过真实窗口 → 上游 400 / 任务失败。#280 的 macOS 休眠唤醒场景即此类(bearer 轮换 + 重连)。 ## 受影响范围 1. **Codex/ChatGPT**:OAuth bearer 轮换 → 会话 ID 随轮换变化(#280 主因)。 2. **中转站场景**:切换上游/中转 → upstream 维度变化 → 同样丢会话。 3. **无原生 session id 的客户端**(hermes、dsh、以及不发任何识别 header/body 字段的通用客户端):conversation 维度退化为内容指纹,碰撞面大,隔离完全依赖 credential/upstream 维度。 ## 方向(owner 已确认,见 #280 讨论) 客户端**原生 session id**(codex `session-id`/`thread-id`、claude `x-claude-code-session-id`、opencode `x-opencode-session`、Responses body `session_id`、`prompt_cache_key` 等)才是与会话绑定的唯一不变量;用户随时可能切换账号/上游,这些都不应打断会话连续性。 因此:**强信号(clientProvided 身份)→ 会话 ID = `hash(protocol | conversation)`**;四维度哈希仅保留给内容指纹回退(hermes/dsh/匿名客户端,指纹有真实碰撞面,需要 account/upstream 维度维持隔离)。 一次性代价:存量持久化会话重新定键一次(旧记录孤儿化),可接受。 ## 相关 - #280:原始故障报告(休眠唤醒 + compaction_trigger 400) - #281:preflight 安全网 + 保守窗口学习(缓解,不治本) - #249:codex thread-id 子代理身份 + chatgpt-account-id + compaction 快速路径(部分重叠,需协调) - 本 issue 的 codex 修复 PR:待提交(强信号身份定键)
Activity
ranxianglei commentedon Aug 27, 2026
收到,开始处理。方向确认:强信号(clientProvided 身份:codex session-id/thread-id、claude x-claude-code-session-id、opencode x-opencode-session、Responses body session_id/prompt_cache_key、插件 x-bili-plugin-conversation)→ 会话 ID =
hash(protocol | conversation);四维度哈希仅保留给内容指纹回退(hermes/dsh/匿名客户端)。正在阅读 src/session-id.ts 与各协议的 conversationSignal 调用点,随后提交 PR。ranxianglei commentedon Aug 27, 2026
修复已提交:PR #288
feat: key sessions on (protocol, conversation) for client-provided identity (#286)(分支2026-08-27_strong-signal-session-id,commit 6215446)。实现
deriveSessionId(src/session-id.ts)新增clientProvided维度,两级定键:hash(protocol | conversation)。credential(ChatGPT 轮换 bearer)与 upstream(中转切换)维度不再参与——它们不是会话生命周期内的不变量,AND 进去就会孤儿化全部压缩状态(Codex 长会话在 macOS 休眠唤醒后 Bili 未触发压缩,导致上下文窗口超限 #280 根因)。hash(protocol | upstream | credential | conversation)。指纹有真实碰撞面,credential/upstream 维度继续为匿名会话兜隔离。server.ts 按协议传标志:responses/openai 取 kernel identity 的
clientProvided(header / bodysession_id/metadata.session_id/prompt_cache_key提升 → true;previous_response_id/ 内容指纹 → false);anthropic 取客户端 session header 是否存在。覆盖的强信号:codex
session-id/thread-idheader + bodysession_id、claudex-claude-code-session-id、opencodex-opencode-session、通用x-session-id/x-session-affinity/x-acp-session、ompprompt_cache_key。一次性代价
存量持久化会话升级后重新定键一次(旧记录孤儿化)——按 issue 讨论接受,旧键本身不稳定。
测试
tests/proxy-session-id.test.ts:原四维隔离测试全部保留(弱层)+ 6 个强层新测试(bearer 轮换、中转切换、稳定性、conversation/protocol 分离、两层不碰撞)。tests/e2e-session-identity.test.ts(新增,7 个):三协议全链路往返,验证轮换凭证/切换上游后仍是同一 session(/__bili/stats断言),外加弱信号隔离对照与不同 session_id 隔离对照。协调
chatgpt-account-id作为 credential 维度的部分在本修复后不再必要(账号切换不应打断会话);thread-id 子代理身份与 compaction 快速路径仍互补,可后续单独跟进。PR 待人工 review + merge(按仓库规范我不合并)。
ranxianglei commentedon Aug 27, 2026
PR #288 CI 已全部通过:test 矩阵(ubuntu/windows × node 22/24)✅、build-artifact ✅、version-guard ✅。
可以 review + merge 了:#288
merge 后如需发版,走标准 release 流程(
*_release-v*分支 +release v{VERSION}commit,CI 自动 publish)。注意本修复含一次性重定键:升级后存量持久化会话的旧记录会孤儿化,属预期行为。ranxianglei commentedon Aug 27, 2026
protocol
不管是强还是弱都不应该保留类似可变的东西,你需要仔细思考如何处理这个问题 。现在大部分都是通过 bili 启动器,所有启动器理论上都有强信号。
直接网络代理的大部分有强信号。
剩下的先报错
ranxianglei commentedon Aug 27, 2026
收到,方向改。四维 fallback 确实违反同一条原则——upstream 和 credential 都是可变的,弱层定键同样不稳定,留着它就是留着一个"看起来隔离、实际会孤儿化"的假安全感。新方案:
hash(protocol | conversation)(PR 中不变)推论与边界:
previous_response_id是 per-turn id 不是会话不变量,不算强信号;我先排查影响面(现有匿名测试客户端、count_tokens 与 /responses/compact 的路由、各启动器实际发送的 header),然后更新 PR #288。
ranxianglei commentedon Aug 27, 2026
protocol 不能作为身份 讨论明白再搞
ranxianglei commentedon Aug 27, 2026
同意。protocol 是可变的(relay 翻译 responses↔chat、跨协议切模型),不该进 key。查完存储层,状态本身就是协议中立的,key 可以进一步简化:
提案:session ID = hash(client-provided conversation value),protocol / credential / upstream 全部不进 key
为什么安全(已核实):
state: CompressionState(kernel 归一化,src/session.ts:65)、blockContents存纯文本{text, count}(src/session.ts:4-7)、lastMessages: CoreMessage[](src/session.ts:85);meta.protocol/upstreamOrigin本来就只是描述属性(UI 展示 + 磁盘文件名命名空间),不参与 key(src/session.ts:13-18)。碰撞面:只有 client-provided 值进 key(内容指纹已按你上一条改成 400),客户端的值是 UUID/不透明串,设计目的就是每会话唯一;同一值被两个会话复用属于客户端自己的责任(与任何 cache key 语义一致)。
三个待确认点:
hash(value)(16 hex,现状,UI/测试/持久化文件名都不用动)还是直接用 value 原文(日志/UI 里直接看到 codex session UUID,可调试性更好)?我倾向保留 hash——raw value 已经在 label 字段里了。影响面已审计:7 处匿名测试调用点需要补强信号(vscode-copilot、e2e-compress-prompts、e2e-responses-chat-relay、e2e-proxy-smoke、e2e-anthropic、launcher-plugin-mode ×2、forward-absolute-url);launcher-plugin-mode 的两个 headless-binding 测试要特殊处理(首请求带一个与 register 的 id 不同的强信号,否则走 identity 路径而不是 headless pending 路径)。
确认后我更新 PR #288。
ranxianglei commentedon Aug 27, 2026
session ID = hash(client-provided conversation value),
否决
sessionid = session 没有 hash 没有其他的了
ranxianglei commentedon Aug 27, 2026
收到:session ID = client-provided conversation 值原文,无 hash、无其他维度。开始实现:
deriveSessionId/extractKey,server 直接用 conversation 值作 ID完成后更新 PR #288。
feat: session id is the client-provided conversation value verbatim; …
ranxianglei commentedon Aug 27, 2026
按最终设计实现完毕,PR #288 已更新(commit
2b48762):#288session ID = client-provided conversation 值原文,无 hash、无其他维度:
src/session-id.ts删除deriveSessionId/extractKey;server 直接sessionId = conversationsessions/<proto>/<host>_<sha>.json由它们派生,更新成最新值会在每次切中转时孤儿化旧文件。会话状态本身协议中立,协议切换不断状态顺带修了一个本设计暴露的潜在 bug:route 的
compressProtocol配置原先按session.meta.upstreamOrigin(first-wins)解析(src/server.ts:1235)——会话跨中转续接后,新中转的 route 配置会被静默忽略。现按请求实际 upstream 解析。测试:
e2e-session-identity.test.ts重写为 10 例:bearer 轮换、中转切换、跨协议续接(同一 session_id 先 responses 后 chat → 同一会话)、匿名 400 ×3(含断言不建会话)、隔离代价不变:存量持久化会话一次性重新定键(旧记录孤儿化);无原生 session id 的客户端收到 400(显式失败)。PR 等你 review/merge。
ranxianglei commentedon Aug 27, 2026
CI 全绿:test (ubuntu/windows × node 22/24)、build-artifact、version-guard 全部通过。PR #288 可以 merge 了(merge 由你操作)。
ranxianglei commentedon Aug 27, 2026
升级后可能不兼容老会话 考虑如何过渡迁移
feat: one-time startup migration re-keys legacy session files to clie…
ranxianglei commentedon Aug 27, 2026
[bot] 已加一次性启动迁移,老会话不丢(PR #288,commit
85765d5):机制:
initSessions()在loadAll()之前先跑store.migrateLegacyIds()(src/persist.ts,src/session.ts:114):meta.label:旧代码里clientLabel(= 客户端提供的 conversation 值)本来就存进了meta.label,而新设计下 session id 正是这个值本身 —— 所以旧记录可以直接按 label 重新定键,不需要任何启发式。savedAt最新的,其余文件删除;label 已被新格式会话占用 → 旧文件删除(新格式优先)。代价:迁移后旧 hash 文件名消失(内容保留在 re-key 后的文件里),
/sessions目录里每个会话一个文件,id 即文件名可读部分。测试:
tests/proxy-persist.test.ts新增迁移测试(re-key、同 label 冲突保留最新、二次运行 no-op);全量 658/658 通过,typecheck 干净。13 remaining items
feat(storage): unified-first read path with organic import + GC parity (
fix(storage): guard load-side import against stale payloads (#2671)
fix: bound sessions storage growth (ranxianglei#407)
fix: key sessions on the client's native session id, not rotating cre…
fix: strip leading system/developer messages from prefix-affinity ide…
feat: opt-in content-fingerprint sessions for header-less clients (ra…
Merge pull request #4269 from ranxianglei/2026-10-22_4140-verif-detec…
fix: stabilize Windows CI flakes — verif detect-once solver cache + d…
fix(server): unwrap/rewrap omp antigravity envelope for google bodies
fix(server): unwrap/rewrap omp antigravity envelope for google bodies
fix: forward single-shot Responses server-tool calls instead of 400 (r…
fix(affinity): keep the v1 pass for empty-neutral-projection requests (…
test(affinity): pin the machinery-only mint the #7149 v1 skip nearly …
fix(affinity): keep the v1 pass for empty-neutral-projection requests (…
test(affinity): pin the machinery-only mint the #7149 v1 skip nearly …