feat: enhance response serialization for compact mode

- Added support for preserving native response.compaction payloads when compact serialization is requested in `serializeResponsesFinalPayload`.
- Implemented serialization of compact mode as `response.compaction` instead of an ordinary response object.
- Introduced a new type `ResponsesFinalSerializationMode` to manage serialization modes.
- Refactored `serializeResponsesFinalPayload` to handle different serialization modes and usage payloads.
- Added tests to ensure correct behavior for compact serialization and preservation of upstream payloads.
- Updated favicon assets and documentation configuration for VitePress.

docs/client-integration.md

@@ -13,10 +13,13 @@ Metapi 暴露标准 OpenAI / Claude 兼容接口，下游客户端通常只需
 | 配置项 | 值 |
 |--------|-----|
 | **Base URL** | 按客户端字段行为填写：会自动补 `/v1` 的字段填 `https://your-domain.com`；要求完整 API URL 的字段填 `https://your-domain.com/v1` |
-| **API Key** | 你设置的 `PROXY_TOKEN` 值，或创建的下游 API Key |
+| **API Key** | 你设置的 `PROXY_TOKEN` 值，或创建的[下游 API Key](./configuration.md#下游-api-key-策略) |
 
 模型列表自动从 `GET /v1/models` 获取，无需手动配置。
 
+> [!TIP]
+> 如果不确定客户端是否自动补 `/v1`，先试根域名，报 404 再改成带 `/v1` 的完整路径。
+
 ## 支持的接口
 
 | 接口 | 方法 | 说明 |
@@ -82,9 +85,19 @@ Metapi 暴露标准 OpenAI / Claude 兼容接口，下游客户端通常只需
 }
 ```
 
-> 说明：`ANTHROPIC_BASE_URL` 这里填根域名，不要手动拼接 `/v1`；不同版本客户端可能读取 `ANTHROPIC_API_KEY` 或 `ANTHROPIC_AUTH_TOKEN`，建议同时设置。
-> 上述变量由 Claude Code 客户端读取，属于客户端行为开关；
-> `metapi` 服务端无法替代客户端自行设置这些变量，只能处理已经发来的请求。
+**环境变量说明：**
+
+| 变量 | 作用 |
+|------|------|
+| `ANTHROPIC_BASE_URL` | 指向 Metapi 的根域名，Claude Code 会自动拼接 `/v1/messages` |
+| `ANTHROPIC_API_KEY` | 认证令牌，填 `PROXY_TOKEN` 值 |
+| `ANTHROPIC_AUTH_TOKEN` | 部分版本读取此变量而非 `ANTHROPIC_API_KEY`，建议两个都设 |
+| `CLAUDE_CODE_ATTRIBUTION_HEADER` | 设为 `0` 禁用 Attribution 头，避免部分上游不支持该头导致报错 |
+| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | 设为 `1` 减少非必要请求（遥测等），降低 Token 消耗 |
+
+> [!IMPORTANT]
+> `ANTHROPIC_BASE_URL` 填根域名即可，**不要**手动拼接 `/v1`。
+> 上述变量由 Claude Code 客户端读取，属于客户端行为开关；Metapi 服务端只能处理已经发来的请求。
 
 ### Codex CLI
 
@@ -115,7 +128,17 @@ base_url = "https://your-domain.com/v1"
 
 ### 其他客户端
 
-所有支持 OpenAI API 格式的客户端均可接入，只需找到 Base URL 和 API Key 的配置位置即可：如果客户端会自动补 `/v1`，填根域名；如果字段要求完整 OpenAI API URL，就填 `https://your-domain.com/v1`。
+所有支持 OpenAI API 格式的客户端均可接入，只需找到 Base URL 和 API Key 的配置位置即可：
+
+| 你的客户端... | 填法 |
+|--------------|------|
+| 有 "Base URL" 字段，会自动补 `/v1` | 填 `https://your-domain.com` |
+| 有 "OpenAI API URL" 字段，要求完整路径 | 填 `https://your-domain.com/v1` |
+| 有 "Anthropic" 选项 | 填 `https://your-domain.com`，Metapi 自动处理 `/v1/messages` |
+| 只能填 API Key | 填 `PROXY_TOKEN` 值即可 |
+
+> [!TIP]
+> 不确定选哪种？先用 `/v1/models` 测试连通性，再配置模型。
 
 ## 下游 API Key 策略
 
@@ -188,5 +211,7 @@ curl -sS https://your-domain.com/v1/chat/completions \
 
 ## 下一步
 
-- [配置说明](./configuration.md) — 环境变量详解
+- [配置说明](./configuration.md) — 环境变量详解与下游 API Key 策略
+- [上游接入](./upstream-integration.md) — 添加和管理上游平台
+- [运维手册](./operations.md) — 日志排查与健康检查
 - [常见问题](./faq.md) — 更多故障排查