Files
Agent-Workbench/docs/APIKEY-ROUTE-L-INVESTIGATION.md

64 lines
8.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# apikey Claude接入调查
后续N更正:用户确认这把Key实际属于GPT分组,原型号误填Claude。L发现的“当时缺少Messages适配”是产品能力边界,不是该GPT连接故障的根因证明。Messages后由M独立交付,当前连接已按GPT/Responses校正并保留停用;见[复查](ROUTING-AUDIT-N.md)。以下为分组尚未确认时的历史调查,原证据保持。
本次确定了工作台的协议接入缺口:1.24.3尚未实现Anthropic Messages,现有apikey连接使用Chat Completions,其地址拼接也与供应商公开示例不同。原预检的GPT标识确实出现在上游原SSE;没有发现工作台将所选Claude请求替换成legacy GPT或把返回型号按默认模型填充的证据。供应商内部为何返回这个标识、这把Key的分组与映射,仍未得到验证。
本报告记录2026-11-03的调查,源码与已安装版本来源均为`f53eebb7171f169ac3620b93bdbd9b8bc6ba3401`。这是诊断结果,不是新协议已经上线的发行说明。
## 已确认的事实
| 项目 | 原J样本 / 当前实现 | 供应商公开文档 |
| --- | --- | --- |
| 请求型号 | `claude-opus-5-5`,单独指定apikey连接,`poolId=null` | Claude示例同名 |
| 协议 | Chat Completions,SSE | Claude脚本示例为Anthropic Messages |
| 拼接地址 | `https://api.apikey.fan` + `/chat/completions` | Chat示例为`https://api.apikey.fan/v1/chat/completions`;Claude示例为`https://api.apikey.fan/v1/messages` |
| 原响应 | HTTP200,23个JSON data事件,所报告型号只有`gpt-6.1-sol`,另有`[DONE]` | Chat示例请求GPT;Messages示例请求Claude |
| 工作台支持范围 | 仅`chat-completions`和`responses`,没有Messages适配器 | Claude Code教程通过Anthropic客户端使用根地址 |
供应商来源:[API脚本教程](https://apikey.fan/docs/api-scripts#anthropic-messages-%E6%96%87%E6%9C%AC-%E8%A7%86%E8%A7%89)、[Claude Code教程](https://apikey.fan/docs/claude)。公开页面原观察与截图已保存:[API文档](apikey-route-l-evidence/observations/vendor-api-scripts-ax.txt)、[Claude手动说明](apikey-route-l-evidence/observations/vendor-claude-ax.txt)、[截图](apikey-route-l-evidence/observations/vendor-messages.jpg)。只读访问,未登录或执行文档中的安装命令。
Claude Code教程把`ANTHROPIC_BASE_URL`写成域名根地址,由其客户端追加Messages路径。工作台Chat适配器则把`/chat/completions`直接追加到用户填写的根地址。两种客户端的根地址填写规则不同,不能照抄同一个值就视为同一种Claude接入。仅增加`/v1`只能对齐Chat路径,不能把Chat请求转换成Messages协议。
公开示例也不能证明该服务绝不支持Chat调用Claude;它没有给出原请求所在Key分组或Chat到Claude的兼容映射依据。因此“协议/路径与Claude示例不一致”是已确认事实,“这就是服务端返回GPT的唯一原因”仍是未证实推断。
## 原字节与代码核对
原请求SHA-256为`0820d369158abe498f72811970cc6667ff49579394ecf10c7fa3b8b4bde67b28`,发送字段是Claude;原响应SHA-256为`af7ed87879b9a8af76850f26c4274a4684a72c19900c8c46a4c5e83b97dab6e0`,`responseRedacted=false`,型号字段直接是GPT。原J清单、30份原件及4334报告tokens均再次离线核对通过,没有重发这次请求。
所审查的八个源码模块逐字节与最终1.24.3发行冻结输入一致,见[源码身份](apikey-route-l-evidence/observations/source-review.json)。实际链路为:
1. `actualRequest`取所选成员对应的请求体;ModelHub保存实际请求SHA,再把同一请求体、成员地址、成员凭据交给Provider。
2. Provider发送`base + route`与`JSON.stringify(body)`。请求型号不从左下角旧连接重新读取;`protocolRoute`仅返回`/responses`或`/chat/completions`。
3. 流读取器先把收到的JSON事件交给型号观察器,再处理文字和工具;观察器读取事件自己的`model`,没有缺省GPT回填。
4. 原响应字节保存为工件。原J标记没有脱敏改写,完整响应的型号不一致触发严格暂停、保留用量,工具数为0。
原J上游请求ID为`225f0a8c-60e6-4fca-a8f8-2baeabf3238b, 3e0f36b5-5266-4d1b-b9f0-cd75ae32edb9`,时间为`2026-11-03T05:25:12.732Z`。这些信息可供供应商查内部路由,本轮没有向其发送用户日志或联系消息。响应ID前缀等外观只能作线索,不能认证底层权重。
原封存保存了endpoint与route,但未保存任何重定向后的最终URL;报告中的历史完整地址由已封存配置和发行源码拼接得出,不能当成历史TLS抓包。当前公开GET所用运输层未配置环境代理,不倒推原J进程当时的代理环境。
## 本机验证及边界
实际localhost HTTP回放三组通过,[收据](apikey-route-l-evidence/observations/provider-replay.json):原根地址与带`/v1`地址的两个隔离样本都发出了与原J相同SHA的Claude请求,接收原J未修改SSE后均报告GPT并严格拒绝。第三组仅在独立副本把响应型号换成Claude,作为明确标注的合成正对照,观察器正常判定一致。原J文件与正式模型均未修改。
这项回放验证客户端实际发送与接收,不是供应商的新推理实测,也不能证明改`/v1`后其实际路由结果会相同。对原路径及两个文档路径进行匿名GET均为404;这些是需要POST的接口,GET404不能用于判断带凭据POST的可用性、映射或Key分组。
当前正式仍为1.24.3、原PID36552/Provider/凭据,55项目/71会话及每表原行、全部导出、工件字节、公开模型中心与K最后快照精确一致,当前无活动任务;见[状态收据](apikey-route-l-evidence/observations/formal-retention.json)。本阶段真实模型新增请求0;公开页面不使用Key,回放使用自有本机凭据。
## 下一修复与验收
1. 优先补齐原生Anthropic Messages适配,而非为GPT返回配置Claude别名。覆盖请求与历史/工具结果转换、鉴权契约、JSON及SSE事件、用量/缓存来源、原错误、停止、身份暂停与原响应证据;未验证能力继续标为未知。
2. 显示实际协议和最终拼接路径,提示SDK根地址与Chat根地址的差异;不对所有供应商盲目补`/v1`。后续请求记录最终响应URL/重定向标记,帮助定位兼容网关。
3. 按供应商文档配置Messages后,用原Provider保存凭据另开一个新预检:单请求、无工具、最多256输出、累计16000tokens、无切池或自动重试。记录原请求与原响应、实际URL、型号和用量;不续跑J/E/H,不认证模型自述。
4. 若Messages也返回GPT,保留新结果并用请求ID核对供应商分组/映射;若型号一致,先判定接入预检通过,再分别做真实工程交付与Purge对照。相同型号字段仍不能认证底层权重。
本轮只完成调查和证据保存,上述产品修复尚未实现,正式连接保持原样。1.25更广功能继续保留计划,原失败和模型/Purge收益结论不改写。
## 可复核记录
最终37份证据、652352字节,[最终清单](apikey-route-l-evidence/manifest-final.json)的SHA-256为`bd900d169944161058e25fa4fa2675560e44e3f36e9b73ef8dab14078e111fad`。运行`node scripts/verify-apikey-route-l.mjs`可离线核对原字节、原J清单、三组回放、公开文档、截图实际格式与正式保留收据;[最终离线结果](apikey-route-l-offline-final.txt)。
首34份/564873字节封存和离线结果保持,原清单SHA为`b627e578795ec28148ed5d258a0b2cbc03b75fdf9ffad62ff5dede4faa516a04`。随后按魔数核对发现浏览器截图实际返回JPEG,最初扩展名写成PNG;首校验只核对字节,没有检查媒体格式。保留原图和首清单,追加同字节JPG与更正收据,最终校验增加JPEG签名和两份完全相等的断言。
调查中两次Windows通配路径/一处猜测文件名的只读搜索失败、公开配置解析首次遗漏脚本末分号、网页导航首次使用了渲染更新前索引均已纠正;没有据此改写原件、重放真实请求或把404当作POST失败。