 iomgaa
|
d2be742383
|
docs(design): 落定网关转发改用保留前缀的方案
回答 GovDoc-SaaS 提的 issue #6，取代 0012 决策四。那一条的结论（只转发 session_id 与
parent_call_id）和它的理由（网关只有两个槽位）都不成立：0012 定于 2026-08-10，而依赖下界
polygateway>=1.1 里 registry 上唯一装得到的 1.1.1 发布于 08-06，那一版的 chat() 上已经有四个
str | None 的槽位。被挡在外面的 cache_namespace 恰恰是上游指定的租户隔离手段，挡掉之后两个
租户提交相同文本时，第二个会读到第一个的模型输出。
要换掉的不是那份白名单的取值，是「哪些键往下传由下游取的名字和网关取的名字偶然相同来决定」
这个机制——补成五个键只是把同一个陷阱重新上好膛。改成绑定里带 gateway. 前缀的键才转发，前缀
之后整段当 chat() 的关键字参数名。由此本库不必列举网关能接受哪些坐标维度，依赖下界照旧
>=1.1,<2，上游此后加维度也不用本库发版（限于取值是字符串的维度，绑定装不下别的类型）。
issue 给的三条路都不采纳，理由分别在决策一到决策三；meta 这一维不做，写在决策五。四条防御
（结构性参数、空串或纯空白、前缀后无参数名、不带前缀的两个历史裸键）都在 call() 里抛
ValueError，表现为一次「第 0 步就以 LLM_ERROR 收尾」的运行。
过了两轮硕士生冷读。第二轮抓出一处事实错误：初稿跟着 issue 写了「下游自己写的 ModelClient
契约套件覆盖不到」，而 polyloop.testing.ModelClientContract 1.0.2 起就随包发布，继承它就能跑，
取消传播恰恰是它覆盖的五条之一。背景那一段换成了成立的那条代价——两份网关适配器各自漂移。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
2026-08-29 11:52:37 -04:00 |
|