本目录是 Trajecta 的协议参考入口。
它区分两类内容：
- Trajecta 当前实现事实：代理现在能路由、录制、回放、解析什么
- 上游协议材料：实现 parser 与协议族路由时使用的官方 API 规范或文档快照
Trajecta 当前是一个协议族感知的透传录制器，代理热路径不做协议族之间的请求翻译。
- 已实现的协议：当前代码支持的协议族、endpoint、路由 profile 与 parser 覆盖范围。
- 协议差异：OpenAI Chat Completions、OpenAI Responses、Anthropic Messages、Google Gemini GenerateContent 与 Vertex native GenerateContent 之间的实际差异。
当前快照日期：2026-06-02。
| 协议族 | 快照索引 | 主要材料 |
|---|---|---|
| OpenAI | schema-index-2026-06-02.md | 官方 OpenAPI 快照，以及 /chat/completions、/responses、/models、/embeddings 的 path item 抽取 |
| Anthropic Messages | schema-index-2026-06-02.md | Messages API 参考与流式 Messages 文档的 HTML 快照 |
| Google Gemini | schema-index-2026-06-02.md | v1beta discovery 文档与 GenerateContent 核心 schema 抽取 |
| Google Vertex AI | schema-index-2026-06-02.md | v1 AI Platform discovery 文档与 Vertex GenerateContent schema 抽取 |
每个索引都记录官方来源、快照文件与 Trajecta 当前的 parser 覆盖范围。上游材料存放在 upstream/ 下；上游 API 变化时，新增一个带日期的快照，而不是覆盖旧文件。
- 优先使用官方上游规范或文档。
- 原始快照保持可人工定位，并带日期。
- 抽取出的 schema 子集与原始快照放在一起，便于实现时查阅。
- 不要把上游 schema 当作 Trajecta 的内部 IR。Trajecta 的语义 parser 输出始终是 Observation IR。
- OpenAI-compatible provider 只声明"兼容 OpenAI 风格行为的某个子集"，不自动等同于 OpenAI 官方 API。
- 本目录是上游协议快照的唯一事实源。