feat(odyssey): 消化《DeepSeek 官方 API 接入 Codex》素材，新增 1 素材页 + 5 实体页 + 1 主题页

wiki/entities/OpenAI 兼容 API.md

@@ -0,0 +1,60 @@
+---
+tags: [实体, 概念, 协议]
+created: 2026-09-15
+updated: 2026-09-15
+sources: [raw/notes/2026-09-15-deepseek官方api接入codex.md]
+---
+
+# OpenAI 兼容 API
+
+> 一种让第三方服务按 OpenAI 接口形状对外提供模型能力的约定；客户端只需认这套协议，就能不经适配地切换到任意兼容 provider。
+
+## 简介
+
+传统上每接入一家模型厂商都要写一套适配代码。OpenAI 兼容 API 把这层差异抹平：只要服务端暴露的端点、鉴权方式和请求/响应结构对齐 OpenAI 规范，客户端（如 [[Codex]]、各类 SDK、Agent 框架）改一个 `base_url` 就能换 provider。
+
+本知识库中它同时出现在两条素材里，分别代表这个约定的两侧：
+
+- **消费侧**：《DeepSeek 官方 API 接入 Codex》——Codex 通过配置指向 DeepSeek 提供的兼容端点。
+- **供给侧**：[[Hermes API Server]]——把 Hermes Agent 暴露成 OpenAI 兼容 HTTP 端点，供 n8n 等上层调用。该关联为跨素材推断，原文并未提及 Hermes。
+  <!-- confidence: INFERRED -->
+
+## 关键信息
+
+- **类型**：概念（接口协议 / 约定）
+- **领域**：大模型集成
+- **在 Codex 侧的落点**：`wire_api = "responses"`、`requires_openai_auth = true`、`base_url`
+- **相关概念**：[[Codex]]、[[DeepSeek]]、[[Hermes API Server]]
+
+## 详细内容
+
+素材中体现该约定的关键配置（摘自 [[Codex 配置三件套]]）：
+
+```toml
+[model_providers.DPWorking]
+name = "OpenAI"
+wire_api = "responses"
+requires_openai_auth = true
+base_url = "https://api.deepseek.com/v1"
+experimental_bearer_token = "sk-xxxxxxxx"
+```
+
+可以读出的三条经验：
+
+1. **provider 名由用户自定义**（`DPWorking` 是随意取的），协议语义字段才是有约束的部分。
+2. **`name = "OpenAI"` 与 `requires_openai_auth = true`** 表示客户端仍按 OpenAI 的鉴权与调用习惯走，只是端点换成了 DeepSeek。
+3. **协议兼容不等于能力等价**：接入后桌面端会显示 `Custom`、部分模型参数（如思考强度滑块）可见性下降，说明兼容层主要保证调用链路，不保证体验完全一致。
+
+## 不同素材中的观点
+
+- [[Hermes API Server]]（供给侧）：Hermes 内置 API Server 默认端口 `8642`，对外提供标准 OpenAI 格式接口，n8n 用 HTTP Request 节点零适配调用。
+- 本素材（消费侧）：Codex 借助同一兼容协议接入 DeepSeek 模型。
+- 两篇素材合起来说明：**OpenAI 兼容 API 已成为 Agent 生态事实上的通用接缝**，既能作为被接入方，也能作为提供方。
+
+## 相关页面
+
+- [[Codex]]
+- [[DeepSeek]]
+- [[Hermes API Server]]
+- [[Codex 配置三件套]]
+- [[AI 编程工具接入]]