协议、Agent 识别与目录映射的能力边界

API 协议是请求和响应的格式

Messages、Chat Completions、Responses 是不同格式。User Client 暴露兼容入口，Worker 按路由执行转换或相应上游调用。消费工具仍需要能解析它选择的响应协议。

入口	主要用途
POST /v1/messages	Anthropic Messages，支持相应流式响应
POST /v1/chat/completions	Chat Completions
POST /v1/responses	Responses
POST /v1/responses/compact	支持渠道的远程上下文压缩
GET /v1/models 与模型详情	当前 Key 的模型目录
POST /v1/images/generations、edits	支持渠道的图片生成与编辑

还有相应 token 计数、旧式文本补全和 WebSocket 入口。接口存在不保证所有模型、套餐和渠道都有该能力。当前不提供 embeddings、files、独立 HTTP audio 等已移除入口，不能因为第三方 SDK 有这些方法就认为 PrimeRouter 一定支持。

流式不等于每个网络片段是一个 Token

SSE／WebSocket 可以分段返回内容。网络缓冲、代理、协议转换与工具参数拼接都可能影响片段大小。收到一段文字或分片工具参数后，Agent 会按自己的规则处理。

不要把 HTTP 200 或 WebSocket 握手成功当成整个请求已经完成；流打开后仍可能出现协议内的错误，记录里会体现结果。

来源、OS 与 CWD 分开识别

Agent 来源依据配置的识别规则和请求线索；OS 主要从 UA 等线索判断。识别出 Windows 并不等于知道这个 Agent 的项目目录。

CWD 是 Agent 当前工作目录。提取成功或可信会话复用时，路径映射可以开启；未知 Agent、缺失或冲突的目录会保守降级。目录识别缺失本身不作为新增拒绝请求理由。

路径映射具体做什么

在已知 Agent 且有可靠目录的条件下，请求中匹配的目录会映射到供应环境的虚拟目录；返回给 Agent 时恢复真实路径。映射会处理协议解码后的文本、JSON 和流式工具参数，而不修改加密推理片段等不透明内容。

协议转换并不天然让路径映射失效，但未知格式、动态内容或不匹配路径可能不在可改写范围内，不能承诺完全无损。

Shell 不会被翻译

Windows 路径与 Unix 路径可以映射，PowerShell、cmd、Bash 语法却不会自动互译。已识别编码 Agent 的系统信息可帮助同系统优先选择；跨系统仍可能遇到不兼容命令。

遇到错误要检查工具结果与收据状态，让 Agent 针对真实执行环境处理，必要时联系运营方调整可用供给。不要把多轮自我纠正当成可靠的 Shell 转换服务。

规则更新与隐私

识别规则由平台版本化下发；新 Agent 版本可能需要更新规则或 Client 解析能力。未知来源仍可以作为普通兼容 HTTP 请求使用，OS 线索也不会独立把普通未知调用强行路由到某系统。

真实业务信息、你主动发送的文件路径和上游提供商看到的输入，不会仅靠目录映射全部消失。