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

2026-09-15 07:10:34 +08:00
parent b0bbdb0a7b
commit 54c4b126b8
12 changed files with 426 additions and 9 deletions
--- a/wiki/entities/Codex
+++ b/wiki/entities/Codex
@@ -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 编程工具接入]]
--- a/wiki/entities/Codex.md
+++ b/wiki/entities/Codex.md
@@ -0,0 +1,49 @@
+---
+tags: [实体, 工具]
+created: 2026-09-15
+updated: 2026-09-15
+sources: [raw/notes/2026-09-15-deepseek官方api接入codex.md]
+---
+
+# Codex
+
+> OpenAI 的 AI 编程 Agent（CLI + 桌面端 APP），因模型接入层走 OpenAI 兼容协议，可通过改配置文件换成第三方模型。
+
+## 简介
+
+Codex 默认绑定 OpenAI 自家模型。由于它对上游模型的调用遵循 OpenAI 兼容协议，只要能改配置把 provider 指向别处，就能接入 DeepSeek 这类同样兼容的 API —— 这正是本知识库中《DeepSeek 官方 API 接入 Codex》一文的做法。
+
+接入点是用户根目录下的隐藏文件夹 `.Codex`（素材原文写法；对应本机通常为 `~/.codex`），视频演示在 VSCode 的 CLI 中执行 `Codex` 启动项目。
+
+## 关键信息
+
+- **类型**：工具（AI 编程 Agent）
+- **领域**：AI 辅助编程
+- **接入方式**：改 `.Codex` 目录下的 `auth.json`、`config.toml`，并放入 `deepseek-models.json`
+- **相关概念**：[[OpenAI 兼容 API]]、[[Codex 配置三件套]]、[[DeepSeek V4 Flash]]
+
+## 详细内容
+
+### 三个配置文件的分工
+
+| 文件 | 作用 | 要点 |
+|------|------|------|
+| `auth.json` | 授权 | `{"auth_mode": "apikey", "OPENAI_API_KEY": "sk-xxxxxxxx"}` |
+| `config.toml` | 声明 provider 与模型 | 见 [[Codex 配置三件套]]；`wire_api` / `requires_openai_auth` / `base_url` 必须对齐 |
+| `deepseek-models.json` | 模型目录映射 | 直接放在 `.Codex` 目录最底层，不要嵌套文件夹 |
+
+### 实机表现
+
+- **CLI**：Codex 能自动识别出 `Flash` 和 `Pro` 两个模型；V4 Flash 兼容性更好，被素材推荐为日常开发首选。指令下发后可准确生成代码并执行新任务（演示中与语音提示 hook 结合生效）。
+- **桌面端 APP**：模型显示为 `Custom`，思考强度（High）滑块的实际作用无法直观验证，但不影响执行核心逻辑，表现稳定、符合预期。
+
+## 不同素材中的观点
+
+暂无其他素材讨论 Codex。同批 nexus 笔记中另有《Codex接入阿里云百炼Token Plan配置方法》，题材同构（同一个 Codex 换 provider），尚未消化。
+
+## 相关页面
+
+- [[AI 编程工具接入]]
+- [[OpenAI 兼容 API]]
+- [[Codex 配置三件套]]
+- [[DeepSeek V4 Flash]]
--- a/wiki/entities/DeepSeek
+++ b/wiki/entities/DeepSeek
@@ -0,0 +1,44 @@
+---
+tags: [实体, 概念, 模型]
+created: 2026-09-15
+updated: 2026-09-15
+sources: [raw/notes/2026-09-15-deepseek官方api接入codex.md]
+---
+
+# DeepSeek V4 Flash
+
+> DeepSeek 面向编程场景的低成本模型，在本知识库素材中是接入 Codex 的主力模型。
+
+## 简介
+
+V4 Flash 是 [[DeepSeek]] 提供的模型之一（同系列另有 `Pro`）。素材的核心判断是：**V4 Flash 对 [[Codex]] 的兼容性更好，推荐作为日常开发首选**，这与它「极低的调用成本」共同构成了接入的主要动机。
+
+## 关键信息
+
+- **类型**：概念（大语言模型）
+- **所属**：[[DeepSeek]]
+- **在 Codex 中的标识**：`model = "deepseek-v4-flash"`
+- **推理强度设置**：`model_reasoning_effort = "high"`
+- **相关概念**：[[OpenAI 兼容 API]]、[[Codex 配置三件套]]
+
+## 详细内容
+
+素材中与 V4 Flash 相关的配置与表现：
+
+- **模型声明**：在 [[Codex 配置三件套]] 中写 `model = "deepseek-v4-flash"`，并通过 `model_catalog_json = "deepseek-models.json"` 指向模型目录映射文件。
+- **自动识别**：接好之后 Codex 能自动识别出 `Flash` 和 `Pro` 两个档位。
+- **兼容性**：视频明确推荐 V4 Flash 而非 Pro 作为日常开发首选，理由是兼容性更好。
+- **成本**：「一次完整的任务交互后，系统计费刷新显示仅需 0.02」，用于说明低成本。
+  <!-- confidence: AMBIGUOUS -->
+
+## 不同素材中的观点
+
+暂无其他素材讨论该模型。
+
+## 相关页面
+
+- [[DeepSeek]]
+- [[Codex]]
+- [[OpenAI 兼容 API]]
+- [[Codex 配置三件套]]
+- [[AI 编程工具接入]]
--- a/wiki/entities/DeepSeek.md
+++ b/wiki/entities/DeepSeek.md
@@ -0,0 +1,43 @@
+---
+tags: [实体, 组织, 平台]
+created: 2026-09-15
+updated: 2026-09-15
+sources: [raw/notes/2026-09-15-deepseek官方api接入codex.md]
+---
+
+# DeepSeek
+
+> 提供 DeepSeek 系列大模型的厂商与其开放平台；API 采用预付费模式，并已正式支持 OpenAI 兼容类型的接口。
+
+## 简介
+
+DeepSeek 开放平台（`https://platform.deepseek.com/`）是申请 API Key、充值和管理模型调用的入口。官方 API 文档位于 `https://api-docs.deepseek.com/zh-cn/`。
+
+对本知识库而言，DeepSeek 的意义在于两点：一是**正式支持 OpenAI 兼容类型的 API**，让 Codex 这类只认 OpenAI 协议的客户端能零适配接入；二是**预付费模式带来的低成本**，使接入后的日常使用门槛显著下降。
+
+## 关键信息
+
+- **类型**：组织 / 平台
+- **领域**：大语言模型 API 服务
+- **接入地址**：`https://api.deepseek.com/v1`
+- **计费模式**：预付费，需先保证账户余额充足
+- **相关概念**：[[DeepSeek V4 Flash]]、[[OpenAI 兼容 API]]
+
+## 详细内容
+
+- **申请与保密**：前往开放平台申请 API Key，素材强调「保护好你的 Key 不要公开」。
+- **账户充值**：API 调用采用预付费模式，开始前需确保账户内有足够余额。
+- **官方接入指引**：文档中提供了 Codex 的官方接入章节（`api-docs.deepseek.com/.../agent_integrations/codex`，对应「方式二手动编辑配置文件」），本素材的三文件配置法与此对应。
+- **模型供给**：素材中涉及其 V4 Flash 与 Pro 两个模型，均可被 Codex 自动识别。
+- **配套资源**：UP 主提供了 `deepseek-models.json` 模型映射文件（网盘 + 备用下载链接）。
+
+## 不同素材中的观点
+
+暂无其他素材讨论 DeepSeek。
+
+## 相关页面
+
+- [[DeepSeek V4 Flash]]
+- [[OpenAI 兼容 API]]
+- [[Codex]]
+- [[AI 编程工具接入]]
--- a/wiki/entities/Hermes
+++ b/wiki/entities/Hermes
@@ -1,7 +1,7 @@
 ---
 tags: [实体]
 created: 2026-09-14
-updated: 2026-09-14
+updated: 2026-09-15
 sources: [raw/notes/2026-09-14-n8n调用hermes-agents工作流架构.md]
 ---

@@ -17,7 +17,7 @@ Hermes API Server 是 [[Hermes Agent]] 自带的 HTTP 服务层，遵循 OpenAI

 - **类型**：概念 / 组件
 - **领域**：AI Agent 服务化
- **相关概念**：[[Hermes Agent]]、[[Hermes Profile]]、[[n8n]]
+- **相关概念**：[[Hermes Agent]]、[[Hermes Profile]]、[[n8n]]、[[OpenAI 兼容 API]]
 - **默认端口**：`8642`
 - **协议**：OpenAI 兼容（`/v1/chat/completions`、`/v1/health`）

@@ -65,3 +65,4 @@ X-Hermes-Session-Id: my-workflow-session-001
 - [[Hermes Profile]]
 - [[n8n]]
 - [[多 Agent 工作流编排]]
+- [[OpenAI 兼容 API]] — 本端点是该协议在「供给侧」的一种实现，另一条素材里的 Codex 则是「消费侧」
--- a/wiki/entities/OpenAI
+++ b/wiki/entities/OpenAI
@@ -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 编程工具接入]]