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

This commit is contained in:
2026-09-15 07:10:34 +08:00
parent b0bbdb0a7b
commit 54c4b126b8
12 changed files with 426 additions and 9 deletions

View File

@@ -0,0 +1,62 @@
---
tags: [实体, 工具, 配置]
created: 2026-09-15
updated: 2026-09-15
sources: [raw/notes/2026-09-15-deepseek官方api接入codex.md]
---
# Codex 配置三件套
> Codex 接入第三方模型的配置三件套:`auth.json` 授权、`config.toml` 声明 provider 与模型、`deepseek-models.json` 做模型目录映射。
## 简介
素材把接入 DeepSeek 拆成三个文件(都在 `.Codex` 目录下),其中 `config.toml` 被明确点名为「这一步最关键」——它承担的不是填个 key 这么简单的事,而是**向 Codex 声明一个新的模型 provider 并指定其协议语义**。本页把三件套一并记录,便于对照。
## 关键信息
- **类型**:工具(配置文件)
- **所属**:[[Codex]]
- **位置**:用户根目录下的 `.Codex` 隐藏文件夹
- **相关概念**:[[OpenAI 兼容 API]]、[[DeepSeek V4 Flash]]
## 详细内容
素材给出的配置片段(API key 已脱敏;`...` 表示原文此处省略的其余默认内容):
```toml
model_provider = "DPWorking"
model = "deepseek-v4-flash"
model_reasoning_effort = "high"
...
model_catalog_json = "deepseek-models.json"
[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. **两层配置**:顶层 `model_provider` / `model` 决定用哪家、哪个模型;`[model_providers.<名字>]` 段定义该 provider 怎么调。
2. **provider 名可自定义**:`DPWorking` 是演示用的命名,替换成任意标识皆可,只需与顶层 `model_provider` 一致。
3. **`wire_api = "responses"` + `requires_openai_auth = true`**:声明走 OpenAI 兼容语义,这是 [[OpenAI 兼容 API]] 概念在图中的落点。
4. **`base_url`** 指向 DeepSeek 官方端点 `https://api.deepseek.com/v1`;换成别的兼容服务只改这一行。
5. **key 写两处**:`experimental_bearer_token`(本文件)与 `auth.json` 的 `OPENAI_API_KEY` 各写一份。
6. **`model_catalog_json`** 指向同目录下的 `deepseek-models.json`,负责模型目录映射。
## 不同素材中的观点
暂无其他素材讨论该文件。
## 相关页面
- [[Codex]]
- [[OpenAI 兼容 API]]
- [[DeepSeek V4 Flash]]
- [[AI 编程工具接入]]