diff --git a/.gitattributes b/.gitattributes index 3162722f..ab08c1a4 100644 --- a/.gitattributes +++ b/.gitattributes @@ -173,3 +173,12 @@ docs/model-selection-k-evidence/source-bytes/** binary docs/model-selection-k-offline.txt binary docs/model-selection-k-git-index.txt binary docs/model-selection-release-identity.json -text + +docs/apikey-route-l-evidence/** -text whitespace=blank-at-eol,blank-at-eof,space-before-tab,cr-at-eol +docs/apikey-route-l-evidence/source/** binary +docs/apikey-route-l-evidence/**/*.log binary +docs/apikey-route-l-evidence/**/*.txt binary +docs/apikey-route-l-evidence/**/*.body binary +docs/apikey-route-l-evidence/observations/public-main.js binary +docs/apikey-route-l-offline.txt binary +docs/apikey-route-l-offline-final.txt binary diff --git a/AGENTS.md b/AGENTS.md index 4db0e1e2..13bf24de 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,5 +1,7 @@ # Agent Workbench项目执行规范 +L只读调查完成:确认当前1.24.3仅支持Chat/Responses,没有原生Messages;供应商公开Claude示例为/v1/messages,原apikey请求按封存配置拼接为/chat/completions,协议/路径与示例不同。原J原字节GPT、单独选定Claude请求与无切池保持,三组实际localhost回放证明没有客户端默认GPT回填;不把文档差异或匿名GET404当作服务器映射的唯一原因,Key分组/实际权重未知。最终37份/652352字节证据离线通过,截图实际JPEG更正与首封存保持;正式PID36552/Provider/55项目71会话及所有原行导出工件/配置精确保持,本轮0真实模型请求。见docs/APIKEY-ROUTE-L-INVESTIGATION.md。下一优先完整Messages协议适配与实际URL诊断,再新开单次有界预检;该产品修复尚未实现,不重跑J/E/H或伪造型号别名。 + K已本地交付:1.24.3/source f53eebb7/候选20261103065830519,左下角与顶部统一模型中心,可直接选择/添加连接或号池;独立预算不覆盖路由、旧Run身份保持、跨窗口同步。30相关后端/25升级安装、六类历史UI、最终源码/便携/安装载荷各七组UI、541源码输入/22编译独立重建、三归档/实际便携/12隔离安装及安装副本16+9组通过。正式原PID36552/Provider、55项目/71会话及每表原行/全导出/工件/模型中心精确保持;正式网页和原生窗口回看及再次核对通过,9229关闭。743份/29747694字节证据离线通过,首验收器/长路径/版本清单失败保留;见docs/QA-MODEL-SELECTION-K.md及docs/model-selection-release-identity.json。本阶段真实模型请求0,原J请求Claude/上游报告GPT仍未解决,当前默认高性能池保持;更正连接后再开独立单次身份预检,不重跑J/E/H。下方旧记录按历史时点理解。 J已按用户选择完成现有apikey Claude单次真实预检:请求claude-opus-5-5,完整上游SSE标记gpt-6.1-sol;1请求/4334报告tokens/0未知/0工具,strict model_identity暂停,未启动新工程或Purge。原1.24.2/PID36552/Provider/凭据修订2保持,原70导出/3566工件/全部原表行经精确声明归一化核对;新增1项目/1会话/8记录/25事件及outbox、1尝试归属明确。原池/参数恢复,configRevision48→52、连接6→7→8,原缺省身份策略显式record/[]/空串。三次本机整表验收器首失败与更正保留;30份/190046字节新样本证据离线通过。见docs/LIVE-MODEL-IDENTITY-J-RESULTS.md。下一等待更正后的Claude连接或用户选定其它连接,另开单次预检;不自动重试J/E/H,不认证底层权重,1.25仍计划。下方旧数字保持历史含义。 diff --git a/docs/APIKEY-ROUTE-L-INVESTIGATION.md b/docs/APIKEY-ROUTE-L-INVESTIGATION.md new file mode 100644 index 00000000..aadab889 --- /dev/null +++ b/docs/APIKEY-ROUTE-L-INVESTIGATION.md @@ -0,0 +1,61 @@ +# apikey Claude接入调查 + +本次确定了工作台的协议接入缺口: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失败。 diff --git a/docs/apikey-route-l-evidence/drivers/apikey-route-l-public-routes.mjs b/docs/apikey-route-l-evidence/drivers/apikey-route-l-public-routes.mjs new file mode 100644 index 00000000..12918eae --- /dev/null +++ b/docs/apikey-route-l-evidence/drivers/apikey-route-l-public-routes.mjs @@ -0,0 +1,22 @@ +import fs from 'node:fs'; +import {createHash} from 'node:crypto'; +import {ModelTransport} from '../src/core/models/transport.mjs'; +const transport=new ModelTransport(); +const root='.qa/apikey-route-l/'; +const known=[{label:'original-path',url:'https://api.apikey.fan/chat/completions',source:'Original J endpoint + sealed route'}, + {label:'documented-chat',url:'https://api.apikey.fan/v1/chat/completions',source:'Supplier public API scripts example'}, + {label:'documented-messages',url:'https://api.apikey.fan/v1/messages',source:'Supplier public API scripts example'}]; +try{ + const results=await Promise.all(known.map(async({label,url,source})=>{ + const startedAt=new Date().toISOString(); + try{ + const response=await transport.fetch(url,{method:'GET',redirect:'manual',headers:{Accept:'application/json'},signal:AbortSignal.timeout(20000)}); + const bytes=Buffer.from(await response.arrayBuffer());if(bytes.length>65536)throw Error('Public diagnostic body too large'); + fs.writeFileSync(root+label+'.body',bytes,{flag:'wx'}); + return{label,url,source,method:'GET',status:response.status,location:response.headers.get('location'),contentType:response.headers.get('content-type'),bytes:bytes.length, + sha256:createHash('sha256').update(bytes).digest('hex'),preview:bytes.toString('utf8').slice(0,1200),authorizationSent:false,startedAt,finishedAt:new Date().toISOString()}; + }catch(error){return{label,url,source,method:'GET',error:error.message,authorizationSent:false,startedAt,finishedAt:new Date().toISOString()};} + })); + const result={results,realModelRequests:0,scope:'Anonymous read-only GET against exactly the original or supplier-documented paths. No credential or POST. GET status does not establish authenticated POST behavior or key group.'}; + fs.writeFileSync(root+'public-route-checks.json',JSON.stringify(result,null,2)+'\n',{flag:'wx'});console.log(JSON.stringify(result)); +}finally{await transport.close();} diff --git a/docs/apikey-route-l-evidence/drivers/apikey-route-l-public.mjs b/docs/apikey-route-l-evidence/drivers/apikey-route-l-public.mjs new file mode 100644 index 00000000..32f623f2 --- /dev/null +++ b/docs/apikey-route-l-evidence/drivers/apikey-route-l-public.mjs @@ -0,0 +1,19 @@ +import fs from 'node:fs'; +import {createHash} from 'node:crypto'; +import {ModelTransport} from '../src/core/models/transport.mjs'; +const html=fs.readFileSync('.qa/apikey-route-l/public-website.body','utf8'); +const asset=html.match(/ + + + + + + +
+ + +