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

.wiki-cache.json

@@ -5,6 +5,11 @@
       "hash": "sha256:2537ce23e5cf284d1f1a8bb52a1a2db595b70eefd33042929da2fbf3979ee57b",
       "ingested_at": "2026-09-14T14:27:51Z",
       "source_page": "wiki/sources/2026-09-14-n8n调用hermes-agents工作流架构.md"
+    },
+    "raw/notes/2026-09-15-deepseek官方api接入codex.md": {
+      "hash": "sha256:3bd19c29b4093297baab3371446e8090734fbf2b73859295bd6a51be41ebda37",
+      "ingested_at": "2026-09-14T23:08:55Z",
+      "source_page": "wiki/sources/2026-09-15-deepseek官方api接入codex.md"
     }
   }
 }

index.md

@@ -1,14 +1,14 @@
 # 知识库索引
 
-> 最后更新：2026-09-14
+> 最后更新：2026-09-15
 
 ---
 
 ## 概览
 
 - 主题：通用个人知识库
-- 素材总数：1
+- 素材总数：2
-- Wiki 页面总数：6
+- Wiki 页面总数：13
 
 ---
 
@@ -20,6 +20,11 @@
 - [[Hermes API Server]] — 把 Agent 暴露为 OpenAI 兼容 HTTP 端点的内置组件，默认端口 8642
 - [[Hermes Profile]] — 多实例隔离机制，每个 profile 独立端口与 API key
 - [[n8n]] — 开源工作流自动化平台，通过 HTTP Request 节点编排多个 Agent
+- [[Codex]] — OpenAI 的 AI 编程 Agent，改 `.Codex` 目录下的配置即可接入第三方 OpenAI 兼容模型
+- [[DeepSeek]] — DeepSeek 开放平台，预付费 API，已正式支持 OpenAI 兼容类型接口
+- [[DeepSeek V4 Flash]] — DeepSeek 的编程向模型，对 Codex 兼容性优于 Pro，成本极低
+- [[OpenAI 兼容 API]] — 让客户端「换 provider 而不改代码」的协议接缝；Codex 是消费侧，Hermes API Server 是供给侧
+- [[Codex 配置三件套]] — Codex 主配置文件：provider 声明、模型名、端点与推理强度
 
 ---
 
@@ -28,6 +33,7 @@
 > 研究主题、知识领域
 
 - [[多 Agent 工作流编排]] — 多个专职 Agent 如何被组织进自动化流程：编排、隔离与上下文传递
+- [[AI 编程工具接入]] — 把外部模型接进 Codex 这类编程 Agent 的配置路径、兼容层机制与成本考量
 
 ---
 
@@ -36,6 +42,7 @@
 > 每个消化过的素材都有一篇摘要
 
 - [[wiki/sources/2026-09-14-n8n调用hermes-agents工作流架构]] — Hermes 自带 OpenAI 兼容 API Server + Profile 多实例，n8n 零中间件调用多个专职 Agent
+- [[wiki/sources/2026-09-15-deepseek官方api接入codex]] — 三文件配置法把 DeepSeek V4 Flash 接进 Codex，实测单次任务成本极低
 
 ---
 

log.md

@@ -31,3 +31,29 @@
   - `index.md`
   - `wiki/overview.md`
 - **待创建**：`n8n 调用 openclaw agents 的工作流架构`（同批 nexus 素材，尚未消化）
+
+---
+
+## 2026-09-15 ingest | DeepSeek 官方 API 接入 Codex
+
+- **素材来源**：nexus 笔记（视频教程剪藏，作者 DP / dpit.lib00.com），原文 `~/Workspace/nexus/knowledgebase/DeepSeek官方API接入Codex保姆级教程 使用V4 Flash模型降低AI编程门槛.md`
+- **原始链接**：https://dpit.lib00.com/zh/content/1251/ultimate-guide-connect-deepseek-official-api-to-codex-using-the-v4-flash-model
+- **处理级别**：完整处理（139 行 / 3484 字，>1000 字）
+- **敏感信息**：原文含 1 个 DeepSeek API Key（出现 3 处）。经用户确认后，写入 `raw/` 时统一替换为 `sk-xxxxxxxx`；nexus 中的原始文件未作改动
+- **缓存**：`MISS:no_entry` → 处理后 `HIT`
+- **图片**：0 张（`![[deepseek-models.json]]` 为文件嵌入，非图片）
+- **新增**：
+  - `raw/notes/2026-09-15-deepseek官方api接入codex.md`
+  - `wiki/sources/2026-09-15-deepseek官方api接入codex.md`
+  - `wiki/entities/Codex.md`
+  - `wiki/entities/DeepSeek.md`
+  - `wiki/entities/DeepSeek V4 Flash.md`
+  - `wiki/entities/OpenAI 兼容 API.md`
+  - `wiki/entities/config.toml.md`
+  - `wiki/topics/AI 编程工具接入.md`
+- **更新**：
+  - `wiki/entities/Hermes API Server.md`（补 [[OpenAI 兼容 API]] 交叉引用）
+  - `index.md`
+  - `wiki/overview.md`
+- **未单独建页**：Step 1 曾识别主题「大模型调用成本」，因只有一条证据且口径不明（原文「仅需 0.02」未标货币单位），并入 `wiki/topics/AI 编程工具接入.md` 的「未解决的问题」章节
+- **待创建**：`Codex接入阿里云百炼Token Plan配置方法`（同批 nexus 素材，与本次题材同构，消化后可做对比页）

wiki/entities/Codex 配置三件套.md

@@ -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 编程工具接入]]

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]]

wiki/entities/DeepSeek V4 Flash.md

@@ -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 编程工具接入]]

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 编程工具接入]]

wiki/entities/Hermes API Server.md

@@ -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 则是「消费侧」

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 编程工具接入]]

wiki/overview.md

@@ -20,9 +20,13 @@
 
 ## 知识地图
 
-当前覆盖 1 个主题方向：
+当前覆盖 2 个主题方向：
 
 - **[[多 Agent 工作流编排]]** —— 把多个专职 Agent 接进自动化流程。已沉淀 [[Hermes Agent]]、[[Hermes API Server]]、[[Hermes Profile]]、[[n8n]] 四个实体，形成「平台 → 服务端点 → 实例隔离 → 上层编排」的完整链路。
+- **[[AI 编程工具接入]]** —— 把外部模型接进编程 Agent。已沉淀 [[Codex]]、[[DeepSeek]]、[[DeepSeek V4 Flash]]、[[Codex 配置三件套]]，核心机制落在 [[OpenAI 兼容 API]]。
+
+两条线在 [[OpenAI 兼容 API]] 上汇合：一边是**供给侧**（Hermes API Server 对外提供 OpenAI 兼容端点），一边是**消费侧**（Codex 通过兼容端点接入 DeepSeek），共同说明该协议已成为 Agent 生态事实上的通用接缝。
+<!-- confidence: INFERRED -->
 
 ---
 
@@ -30,9 +34,9 @@
 
 | 类型 | 数量 | 查看 |
 |------|------|------|
-| 素材 | 1 | [[wiki/sources/2026-09-14-n8n调用hermes-agents工作流架构]] |
+| 素材 | 2 | [[wiki/sources/2026-09-14-n8n调用hermes-agents工作流架构]]、[[wiki/sources/2026-09-15-deepseek官方api接入codex]] |
-| 实体 | 4 | [[Hermes Agent]]、[[Hermes API Server]]、[[Hermes Profile]]、[[n8n]] |
+| 实体 | 9 | [[Hermes Agent]]、[[Hermes API Server]]、[[Hermes Profile]]、[[n8n]]、[[Codex]]、[[DeepSeek]]、[[DeepSeek V4 Flash]]、[[OpenAI 兼容 API]]、[[Codex 配置三件套]] |
-| 主题 | 1 | [[多 Agent 工作流编排]] |
+| 主题 | 2 | [[多 Agent 工作流编排]]、[[AI 编程工具接入]] |
 | 对比 | 0 | （暂无） |
 | 综合 | 0 | （暂无） |
 
@@ -40,4 +44,5 @@
 
 ## 最近更新
 
+- **2026-09-15** — ingest《DeepSeek 官方 API 接入 Codex》：新增 1 篇素材摘要、5 个实体页、1 个主题页；为 [[Hermes API Server]] 补 [[OpenAI 兼容 API]] 交叉引用
 - **2026-09-14** — ingest《n8n 调用 Hermes Agents 的工作流架构》：新增 1 篇素材摘要、4 个实体页、1 个主题页

wiki/sources/2026-09-15-deepseek官方api接入codex.md

@@ -0,0 +1,67 @@
+---
+tags: [素材摘要]
+created: 2026-09-15
+updated: 2026-09-15
+sources: [raw/notes/2026-09-15-deepseek官方api接入codex.md]
+source_type: notes
+source_path: raw/notes/2026-09-15-deepseek官方api接入codex.md
+images: 0
+image_paths: []
+---
+
+# DeepSeek 官方 API 接入 Codex
+
+> DeepSeek 官方支持 OpenAI 兼容 API 后，改 `.Codex` 目录下三个配置文件即可把 DeepSeek V4 Flash 接进 Codex，无需任何中间件，实测单次任务成本极低。
+
+## 基本信息
+
+- **来源类型**：笔记（视频教程剪藏，作者 DP / dpit.lib00.com，视频时长 08:12）
+- **原文位置**：raw/notes/2026-09-15-deepseek官方api接入codex.md
+- **原始链接**：https://dpit.lib00.com/zh/content/1251/ultimate-guide-connect-deepseek-official-api-to-codex-using-the-v4-flash-model
+- **素材日期**：2026-09-02
+- **消化日期**：2026-09-15
+- **敏感信息处理**：原文含 1 个 DeepSeek API Key（出现 3 处），入库前已统一替换为 `sk-xxxxxxxx`
+- **图片**：0 张（文中的 `![[deepseek-models.json]]` 是 Obsidian 文件嵌入，不是图片）
+
+## 核心观点
+
+1. **前提是 DeepSeek 官方支持了 OpenAI 兼容类型的 API**。这是整条链路成立的根因：客户端只要认 OpenAI 协议，就能把 DeepSeek 当成 provider 接进去，不需要为 DeepSeek 单独写适配。
+2. **接入成本集中在三个配置文件**（位于用户根目录下的 `.Codex` 隐藏文件夹）：`auth.json` 负责授权、`config.toml` 负责声明 provider 与模型、`deepseek-models.json` 负责模型目录映射，且该 JSON 必须直接放在 `.Codex` 目录最底层，不能套多余的文件夹。
+3. **`config.toml` 是最关键的一步**。provider 名可以自定义（素材里叫 `DPWorking`），但 `wire_api = "responses"`、`requires_openai_auth = true`、`base_url = "https://api.deepseek.com/v1"` 这些兼容语义字段必须对齐；API key 在 `auth.json` 与 `config.toml` 里各写一份。
+4. **实机可用，且 CLI 表现优于桌面端**。CLI 里 Codex 能自动识别 Flash 与 Pro 模型，V4 Flash 对 Codex 的兼容性更好，被推荐为日常开发首选；桌面端 APP 模型会显示为 `Custom`，思考强度滑块的实际作用无法直观验证，但代码生成与执行表现稳定。
+5. **成本极低是主要卖点**。教材给出的实测数据是「一次完整的任务交互后计费刷新显示仅需 0.02」。
+   <!-- confidence: AMBIGUOUS -->
+
+## 关键概念
+
+- [[Codex]] — 被接入的编程 Agent，接入点是 `.Codex` 目录下的配置
+- [[DeepSeek]] — 提供 API 与模型的开放平台，预付费制
+- [[DeepSeek V4 Flash]] — 本次接入的模型，`model = "deepseek-v4-flash"`
+- [[OpenAI 兼容 API]] — 让这次接入「不需要胶水代码」的协议约定
+- [[Codex 配置三件套]] — provider 声明与模型参数的主配置文件
+
+## 与其他素材的关联
+
+- 与 [[Hermes API Server]] 的关系：本素材讲的是「**作为客户端**接入一个 OpenAI 兼容服务」，另一篇素材讲的是「**作为服务端**对外提供 OpenAI 兼容端点」。两者是同一协议约定的两侧实现，共同构成 [[OpenAI 兼容 API]] 的完整图景。
+  <!-- confidence: INFERRED -->
+- 与 [[多 Agent 工作流编排]] 的关系：编排侧的素材讨论「多个 Agent 怎么串起来」，本素材讨论「单个编程 Agent 怎么换模型」。两者目前没有直接的内容重叠，暂不做横向对比。
+  <!-- confidence: INFERRED -->
+- 同批 nexus 笔记中还有《Codex接入阿里云百炼Token Plan配置方法》，题材高度同构（同一个 Codex，换一个 provider），消化后可考虑做成对比页。
+
+## 原文精彩摘录
+
+> 随着 DeepSeek 官方正式支持了 OpenAI 兼容类型的 API, 开发者迎来了更多的集成可能.
+
+> 这一步最关键. 你需要对应修改 `provider` (如自定为 DPWorking), 将 `model` 指定为 `Deepseek V4 Flash`, 调整 `URL` 为 DeepSeek API 官方接口地址, 并将你的 API key 再次同步更新.
+
+> CLI 里 Codex 能够自动识别出 `Flash` 和 `Pro` 模型. 由于 V4 Flash 模型对 Codex 的兼容性更好, 推荐作为日常开发首选.
+
+> 一次完整的任务交互后, 系统计费刷新显示仅需 **0.02**, 彰显了 DeepSeek 的极致性价比.
+
+## 相关页面
+
+- [[AI 编程工具接入]]
+- [[Codex]]
+- [[DeepSeek V4 Flash]]
+- [[OpenAI 兼容 API]]
+- [[Codex 配置三件套]]

wiki/topics/AI 编程工具接入.md

@@ -0,0 +1,48 @@
+---
+tags: [主题]
+created: 2026-09-15
+updated: 2026-09-15
+sources: [raw/notes/2026-09-15-deepseek官方api接入codex.md]
+---
+
+# AI 编程工具接入
+
+> 把外部模型接进 Codex 这类编程 Agent 的配置路径、兼容层机制与成本考量。
+
+## 核心观点
+
+1. **接入的本质是换 provider，不是改客户端**。因为 [[Codex]] 的模型调用遵循 [[OpenAI 兼容 API]]，只要服务端兼容，改配置文件即可换模型，全程不需要中间件或胶水代码。
+2. **配置是耦合的一整套，不是单点开关**。`auth.json`（授权）、`config.toml`（provider 与模型声明）、`deepseek-models.json`（模型目录映射）三件套必须同时到位，缺一项链路就不成立。
+3. **兼容层保证「能调通」，不保证「体验一致」**。CLI 端能自动识别模型并推荐 [[DeepSeek V4 Flash]]；桌面端则显示 `Custom`，部分参数（思考强度滑块）可见性下降，但执行核心逻辑不受影响。
+4. **成本是接入决策的主要变量之一**。素材给出的实测是单次任务交互计费「仅需 0.02」。
+   <!-- confidence: AMBIGUOUS -->
+
+## 素材汇总
+
+| 素材 | 核心贡献 | 详见 |
+|------|----------|------|
+| DeepSeek 官方 API 接入 Codex | 给出三文件配置法、V4 Flash 的实机表现与成本观察 | [[wiki/sources/2026-09-15-deepseek官方api接入codex]] |
+
+## 关键概念
+
+- [[Codex]] — 被接入的编程 Agent，接入点是 `.Codex` 目录下的配置
+- [[DeepSeek]] — 提供兼容 API 的服务方，预付费制
+- [[DeepSeek V4 Flash]] — 本次接入的模型
+- [[OpenAI 兼容 API]] — 让「换 provider」成立而不必改代码的协议接缝
+- [[Codex 配置三件套]] — provider 声明与模型参数的主配置文件
+
+## 未解决的问题
+
+- **计费口径不明**：素材只说「仅需 0.02」，未标货币单位，也未说明按 token 还是按会话计价，无法与其他模型做严格的成本对比。
+- **key 的双写关系不明**：`auth.json` 的 `OPENAI_API_KEY` 与 `config.toml` 的 `experimental_bearer_token` 是各自独立生效还是任一即可，原文未说明。
+- **桌面端降级的影响面未验证**：模型显示 `Custom`、思考强度滑块不可验证，是否代表实际能力或参数被裁剪，素材只给了「不影响核心逻辑」的定性判断。
+- **`deepseek-models.json` 的内容与来源**：素材只给了网盘与备用下载链接，未说明文件内容结构，也未说明能否自行手写。
+- **多 provider 共存可行性**：一套 `config.toml` 是否能同时声明多个兼容 provider 并按需切换，未涉及。
+
+## 相关页面
+
+- [[OpenAI 兼容 API]]
+- [[Codex]]
+- [[DeepSeek]]
+- [[Codex 配置三件套]]
+- [[多 Agent 工作流编排]]