Repository navigation
Description
提交前确认
- 已搜索现有 Issue,未发现同范围 CC-Switch 方案研究单;已读目标功能表单与贡献指南,内容已脱敏。
使用场景与现有问题
关联 #854、#865、#866,但本单是独立的上游方案研究与完整验收设计,不替代事故根因分析,不自动关闭原单。
用户要求:服务端切号是常规操作,允许损失部分历史;原客户端原会话必须自动续答、工具循环继续,不能要求新建会话或人工重试,已完成工具副作用不得重复。
群聊声称“更新 CC-Switch 已彻底修复/剥离即可”。这尚不是我们的验证结论。需要固定源码、版本和路径,分析哪些可移植到服务端,哪些必须在客户端能力协商时解决。
建议行为与本次范围
先交付固定来源的源码分析、适配差异和可执行验收矩阵,再决定实现;本次建单没有修改代码、生产配置或发起付费测试。
已核实的上游证据(不是本机复测)
来源仓库 https://github.com/farion1231/cc-switch ,本轮查询 main 快照 fc3eb797c72e054d554eea6a2e7a8b93933c6ac5,可见 v4.0.33 发布记录;以下独立固定提交用于审计,实际发布包含关系仍须核验。
- 普通历史/compaction 跨上游恢复:
81cc2f7b引入 compaction bridge 与 opaque-state rectifier:可读摘要封装后回放;原生 Responses 上游明确拒绝不兼容状态后,清理相应 reasoning/加密片段/必要 compaction,对同一 provider 有界重试一次。正常路径不无条件删历史。 - HTTP200 流内加密拒绝:已实际读取
24eb40c6两文件 patch。forwarder.rs将首段探测范围从仅末尾加密 agent task 扩展为carries_opaque_state;覆盖 reasoning、function/custom output 加密部分、agent_message、compaction。在交付输出前识别加密拒绝,回到整流路径;单一固定截止时间,注释上限10秒;有输出、非目标错误、超时/缓冲上限则按原字节接回。提交附本地 raw upstream 测试;作者声称用 codex-cli 0.167.0 实测 A 配额失败→B流内拒绝→整流后本轮和下一轮成功。本单尚未独立重跑。 - 当前加密子任务不能直接删:
c37a2625明确保护末尾当前任务,避免替换为空任务;仍不可读时返回unreadable_encrypted_agent_task并解释 classic tools 选项。因此该分支不是原生V2跨账号“全部无感修复”。 - 多Agent根本兼容策略:#5792维护者结论 已读取。维护者称 v4.0.6 的
6760cfbbe为 Aggregation 全模型目录写multi_agent_version="v1";v4.0.13 的6aeaeb17a默认开启 classic sub-agent tools。显式[features] multi_agent_v2=true优先于目录,需要不设置;取舍是没有 V2 专用followup_task等工具。该 Issue 已关闭,不能继续把它描述为尚未解决的旧报告,也不能把 V1绕行误称原生V2已支持。提交完整SHA、配置生成位置及各模型行实际写入还需源码核查。 - Azure资源归属:
96f01af0针对明确跨 Azure resource 拒绝,除整流外移除 input item 顶层id,保留call_id、工具名/参数/结果和嵌套JSON;item_reference需要单独处理,不能泛化为清空所有ID。 - 第三方协议字段:
08ec82aa区分官方/第三方路径剔除不支持字段,不等于删除全部密文。与 reasoning 回放白名单5c573f19分开分析。
需要完成的源码研究交付
- 固定完整来源SHA/发布包含关系、许可与修改文件,列出检测→缓存/首段探测→整流→单次重试→最终交付完整调用链,不运行未知发布二进制。
- 分开研究 reasoning、工具输出密文、agent_message 当前任务、compaction、previous_response_id/item_reference,禁止凭同名 encrypted_content 当成同一语义。
- 实读 rectifier、流式forwarder、Aggregation目录生成及 classic tools 配置;核多Agent初始/追加任务和父子模型目录是否一致,V1/V2覆盖优先级、已启动客户端能否动态生效及工具能力损失。
- 输出 Sub2API 对照表:可直接借鉴的状态整流/首段探测/快照摘要;需要适配的HTTP/SSE/WS发送边界;服务端无法替客户端生成的新V1工具schema或解密正文。不能仅在服务器删V2标记,声称客户端已发出可读任务。
- 按产品目标提出完整方案:有可读任务时自动切号重建;任务只存在不可读密文时,需要上游/客户端预先协商可移植任务载荷或经典工具,不能编造任务、静默空答、让无人值守用户人工确认。若无法单靠服务端满足,准确说明缺失能力与客户端配套,不假称“彻底修复”。
- 专门评估 CC-Switch 的“输出前拒绝后重试”是否足以证明本站可安全重试:无可见输出不等于未发送、无费用或无副作用。本站必须保已提交/未知投递、权限、审核、计费和工具结果来源的安全边界,禁止扩大为全部409自动重放。
验收场景
- 隔离原生客户端 A→B切换:普通续聊、包含工具的多轮任务、断线恢复、至少53轮、下一轮继续;观察最终回答及真实工具循环,不仅HTTP200/WS101。
- reasoning/compaction/工具加密输出三类分别验证;HTTP拒绝、HTTP200输出前SSE拒绝、WS拒绝三种协议分别验证,正常路径原样保持。
- 当前子任务仅密文、有可读文本及混合文本三类;父子跨provider的初始任务与追加任务实际被执行,不把任务为空且返回“成功”当通过。V1替代与V2原生支持分别报告。
- 工具定义、call_id、参数、输出及已完成结果保留;可信来源绑定,伪造配对/未知投递/未完成工具/epoch变化负控;已完成副作用计数不增加,生成次数与收费独立核实。
- 心跳不能无限延长首段缓冲;输出开始后不改HTTP状态、不自动重放;已交付字节不重复、不吞输出,失败诊断无正文/密文/凭据。
- 固定版本同断言业务RED→GREEN、独立源码复审、精确头CI;真实客户端/供应商业务验收须另有明确授权,不用mock冒充。
现有替代方案与限制
#866继续解决已发现的服务端恢复与安全缺口,本单不另起竞争writer、不改写其未完成验收状态。CC-Switch classic tools 为客户端配置兼容方案,有能力取舍;单纯升级客户端或剥离所有加密内容不是已验证的通用服务端方案。
兼容性与运行成本
待评估请求首段延迟和缓冲上限、重试真实费用、WS多轮生命周期、摘要存储隐私/TTL、目录刷新覆盖与回滚。保持真实请求tier、账务与审核不变。不得为研究擅自部署、重启、清缓存、停调生产账号或发收费请求。
Agent 名称与参与范围
Hermes Agent:GitHub检索、固定提交消息与24eb40c6完整patch核查、维护者评论核读、方案拆解和Issue撰写;本单未调用实现子Agent或Codex,未运行上游测试。
模型名称
Hermes Agent:gpt-6.1-sol。
推理强度
未知(当前会话未提供可核配置值)。
Activity