### OpenAI Chat Golden Request Samples

存放位置：`~/.rcc/golden_samples/openai_requests/<slug>/`

> **提示**：
> - 自 0.87.21 起，chat 入口的 provider 专属样本统一存放在
>   `~/.rcc/golden_samples/new/<entryType>/<providerId>/`（例如 `new/openai-chat/glm`）。
>   目录内包含 `request.sample.json`（直接从阶段快照复制的 `body`）以及 `meta.json`
>   （指向原始 `*_stage2_format_build.json` 路径）。`scripts/tools/capture-provider-goldens.mjs`
>   会优先读取这些“真实快照”，无需再回放 `samples/chat-blackbox/**/request-basic.json`。
> - 仍需保留仓库内 `samples/chat-blackbox/*/request-basic.json`，用于快速审查/比较；当新增场景时，
>   先运行真实请求生成阶段快照，再在 `new/<entryType>/<providerId>/` 放置 `request.sample` 与 `meta`，
>   最后执行 `node scripts/tools/capture-provider-goldens.mjs --update-golden`，脚本会把同一份请求复制到
>   `provider_golden_samples/`，供 mock/provider 单元测试使用。

```
<slug>/
  request_payload.json  # 直接发送到 /v1/chat/completions 的 JSON
  meta.json             # 包含来源阶段、endpoint、描述等元数据
```

| slug | 描述 | Source Stage |
|------|------|--------------|
| `chat-toolcall-20251209T225016004-002` | Codex CLI 会话（用户 repeatedly “列出本地文件”，`stream=true`，含完整 system/环境上下文与工具 schema），用于验证 chat 入口 → glm.provider 的骨架路径 | `openai-chat/req_1765291814052_req_inbound_stage1_format_parse.json` |

#### 回放方式

```bash
curl -s http://127.0.0.1:5555/v1/chat/completions \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer test' \
  --data @~/.rcc/golden_samples/openai_requests/chat-toolcall-20251209T225016004-002/request_payload.json
```

该样本会沿 V2 骨架走 chat 入口 → hub → glm provider，可直接用来对比 legacy/chat-provider 行为。

#### 如何扩展

1. 在 `~/.rcc/golden_samples/openai-chat/req_*_req_inbound_stage1_format_parse.json` 中找到需要的请求负载。
2. 将 `body.payload` 拷贝为新的 `request_payload.json`；注明 slug、描述后写入 `meta.json`。
3. 更新本文件表格，描述该样本的用途、对应阶段文件。若需要刷新所有 provider 的黄金请求，可运行
   `node scripts/tools/capture-provider-goldens.mjs --update-golden`，脚本将自动覆盖 `provider_golden_samples/` 下对应入口的请求副本。