[Phantivia]

Refs Pal-AI-Lab/Coopanion#552, Refs #372

问题

带图的请求被上游拒收后，会话停在同一个请求上:

• 请求体超过网关的大小上限时回 413(Coopanion#552 是 94 MB 撞 32 MB,请求体字节没有预算：历史图片每轮 base64 重发撞 20MB 上限，413 不被认成上下文超限，会话卡死到手动交接 #372 是约 20 MB 起 openresty 回 413)。isContextOverflow 只认正文里 context length 一类字样，网关的 413 不匹配，Core 不交接。
• 单张图不合规时回 400(Coopanion#635:一张 1280×11323 的 JPEG 超过上游的单边上限)。
• 400 / 413 不重试，本批结束;下一批从同一份记录组出同样的字节，再次被拒。

改动

前四个提交，顺序即依赖(后两个是按评审意见改的：去图重发不认 422、交接页不复述 provider 的回落):

1. isContextOverflow 把任何 413 算作输入超限，由 Core 走现有的交接路径。
2. src/providers/transport/image-fallback.ts 的 ImageFallback:带图请求回 413,或回 400 且模块的 contextOverflow 不认，去掉这次请求的图片重发一次。重发被接受，按句柄记下这些图(只在内存里),之后经这个 client 的请求都不带，每条失去图片的记录在正文后补一行 imageLeftOut;重发也被拒，错误带上两次尝试，什么都不记。openai-responses-compat 和 llamacpp 的 client 套上。
3. 补的说明行另起一行(Chat 把各段文字直接拼接)。
4. ProviderRegistry.bind 给没有声明 ProviderInstance.handlesRefusedImages 的实例套一层 ImageFallback,扩展 provider 不用各自改就有这层回落。bind 每次请求都跑，回落要记住被拒的句柄，所以按实例存一份，随实例重建。两个内建模块声明 handlesRefusedImages,不套两层;只给一部分记录附图的 client 自己套，用 attached 交回附了图的记录。

合起来的顺序：带图的 413 先去图重发;去图后仍 413,或请求里本来没有图，按输入超限交接。正常请求的字节不变。

文档：docs/providers.md「传输」、src/providers/README.md;docs/sessions.md 只补「413 也算服务拒绝超长输入」。

取舍

• 不另设请求体字节上限：上限取决于中间网关，配置不出来;去图重发从上游的拒收里得到实际上限。
• 400 时去掉这次请求的全部图片，不只去上次成功之后的新图：请求里图片数量变化会改变旧图的边长上限，那时旧图才是原因。
• 去图重发只认 400 和 413,都有上面的现场。Coopanion#636 那一份还认 422,没有观察到的现场，这里不带。
• ProviderInstance 加的是可选字段，provider 契约版本不动。

验证

• pnpm test、pnpm run typecheck、pnpm run typecheck:web 通过。
• tests/providers/transport/image-fallback.test.ts 经两个内建模块和本机假服务;tests/providers/registry.test.ts 新增两条：经 bind 的带图请求被拒后去图重发一次、下一次 bind 不再带图(共一次请求);声明了 handlesRefusedImages 的实例只发一次，拒收原样交回。
• 按 请求体字节没有预算：历史图片每轮 base64 重发撞 20MB 上限，413 不被认成上下文超限，会话卡死到手动交接 #372 的形状重放(本机假网关 20 MB 上限、每轮一张 0.65 MB 的图、60 轮):第 24、48 轮各一次 413→200,其余每轮一次 200,没有失败的轮次。
• 没有对真实的模型服务跑过。

合入后

Coopanion 升子模块时,packages/cortico-provider-coo 改用这里的 ImageFallback(attached 传它的 sinceLastDelivery)并声明 handlesRefusedImages,删掉自己那份。

🤖 Generated with Claude Code

[cursor]

先前两条已不成立。422 被纳进去图重发 那条：REFUSED 现只含 400 与 413。交接页写了 provider 的去图重发 那条：docs/sessions.md 只留「413 请求体过大也算」。

— Cortico PR Gate via Cursor Cloud Agent

  

_{Sent by Cursor Automation: Cortico PR Gate}