From 54c4b126b87da31d3e994069b3ce6116047edf06 Mon Sep 17 00:00:00 2001 From: weishen Date: Tue, 15 Sep 2026 07:10:34 +0800 Subject: [PATCH] =?UTF-8?q?feat(odyssey):=20=E6=B6=88=E5=8C=96=E3=80=8ADee?= =?UTF-8?q?pSeek=20=E5=AE=98=E6=96=B9=20API=20=E6=8E=A5=E5=85=A5=20Codex?= =?UTF-8?q?=E3=80=8B=E7=B4=A0=E6=9D=90=EF=BC=8C=E6=96=B0=E5=A2=9E=201=20?= =?UTF-8?q?=E7=B4=A0=E6=9D=90=E9=A1=B5=20+=205=20=E5=AE=9E=E4=BD=93?= =?UTF-8?q?=E9=A1=B5=20+=201=20=E4=B8=BB=E9=A2=98=E9=A1=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .wiki-cache.json | 5 ++ index.md | 13 +++- log.md | 26 +++++++ wiki/entities/Codex 配置三件套.md | 62 +++++++++++++++++ wiki/entities/Codex.md | 49 ++++++++++++++ wiki/entities/DeepSeek V4 Flash.md | 44 ++++++++++++ wiki/entities/DeepSeek.md | 43 ++++++++++++ wiki/entities/Hermes API Server.md | 5 +- wiki/entities/OpenAI 兼容 API.md | 60 +++++++++++++++++ wiki/overview.md | 13 ++-- .../2026-09-15-deepseek官方api接入codex.md | 67 +++++++++++++++++++ wiki/topics/AI 编程工具接入.md | 48 +++++++++++++ 12 files changed, 426 insertions(+), 9 deletions(-) create mode 100644 wiki/entities/Codex 配置三件套.md create mode 100644 wiki/entities/Codex.md create mode 100644 wiki/entities/DeepSeek V4 Flash.md create mode 100644 wiki/entities/DeepSeek.md create mode 100644 wiki/entities/OpenAI 兼容 API.md create mode 100644 wiki/sources/2026-09-15-deepseek官方api接入codex.md create mode 100644 wiki/topics/AI 编程工具接入.md diff --git a/.wiki-cache.json b/.wiki-cache.json index 31280ee..6ca10c3 100644 --- a/.wiki-cache.json +++ b/.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" } } } diff --git a/index.md b/index.md index 7339cdc..651d7de 100644 --- a/index.md +++ b/index.md @@ -1,14 +1,14 @@ # 知识库索引 -> 最后更新：2026-09-14 +> 最后更新：2026-09-15 --- ## 概览 - 主题：通用个人知识库 -- 素材总数：1 -- Wiki 页面总数：6 +- 素材总数：2 +- 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，实测单次任务成本极低 --- diff --git a/log.md b/log.md index 53138b5..ceb56ca 100644 --- a/log.md +++ b/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 素材，与本次题材同构，消化后可做对比页） diff --git a/wiki/entities/Codex 配置三件套.md b/wiki/entities/Codex 配置三件套.md new file mode 100644 index 0000000..ef4d026 --- /dev/null +++ b/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 编程工具接入]] diff --git a/wiki/entities/Codex.md b/wiki/entities/Codex.md new file mode 100644 index 0000000..1aff882 --- /dev/null +++ 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]] diff --git a/wiki/entities/DeepSeek V4 Flash.md b/wiki/entities/DeepSeek V4 Flash.md new file mode 100644 index 0000000..02d9d52 --- /dev/null +++ b/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」，用于说明低成本。 + + +## 不同素材中的观点 + +暂无其他素材讨论该模型。 + +## 相关页面 + +- [[DeepSeek]] +- [[Codex]] +- [[OpenAI 兼容 API]] +- [[Codex 配置三件套]] +- [[AI 编程工具接入]] diff --git a/wiki/entities/DeepSeek.md b/wiki/entities/DeepSeek.md new file mode 100644 index 0000000..517a75c --- /dev/null +++ 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 编程工具接入]] diff --git a/wiki/entities/Hermes API Server.md b/wiki/entities/Hermes API Server.md index 948d3a6..e2933cb 100644 --- a/wiki/entities/Hermes API Server.md +++ b/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 则是「消费侧」 diff --git a/wiki/entities/OpenAI 兼容 API.md b/wiki/entities/OpenAI 兼容 API.md new file mode 100644 index 0000000..6fba6fb --- /dev/null +++ b/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。 + + +## 关键信息 + +- **类型**：概念（接口协议 / 约定） +- **领域**：大模型集成 +- **在 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 编程工具接入]] diff --git a/wiki/overview.md b/wiki/overview.md index 4ed210b..64babad 100644 --- a/wiki/overview.md +++ b/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 生态事实上的通用接缝。 + --- @@ -30,9 +34,9 @@ | 类型 | 数量 | 查看 | |------|------|------| -| 素材 | 1 | [[wiki/sources/2026-09-14-n8n调用hermes-agents工作流架构]] | -| 实体 | 4 | [[Hermes Agent]]、[[Hermes API Server]]、[[Hermes Profile]]、[[n8n]] | -| 主题 | 1 | [[多 Agent 工作流编排]] | +| 素材 | 2 | [[wiki/sources/2026-09-14-n8n调用hermes-agents工作流架构]]、[[wiki/sources/2026-09-15-deepseek官方api接入codex]] | +| 实体 | 9 | [[Hermes Agent]]、[[Hermes API Server]]、[[Hermes Profile]]、[[n8n]]、[[Codex]]、[[DeepSeek]]、[[DeepSeek V4 Flash]]、[[OpenAI 兼容 API]]、[[Codex 配置三件套]] | +| 主题 | 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 个主题页 diff --git a/wiki/sources/2026-09-15-deepseek官方api接入codex.md b/wiki/sources/2026-09-15-deepseek官方api接入codex.md new file mode 100644 index 0000000..8f3a2be --- /dev/null +++ b/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」。 + + +## 关键概念 + +- [[Codex]] — 被接入的编程 Agent，接入点是 `.Codex` 目录下的配置 +- [[DeepSeek]] — 提供 API 与模型的开放平台，预付费制 +- [[DeepSeek V4 Flash]] — 本次接入的模型，`model = "deepseek-v4-flash"` +- [[OpenAI 兼容 API]] — 让这次接入「不需要胶水代码」的协议约定 +- [[Codex 配置三件套]] — provider 声明与模型参数的主配置文件 + +## 与其他素材的关联 + +- 与 [[Hermes API Server]] 的关系：本素材讲的是「**作为客户端**接入一个 OpenAI 兼容服务」，另一篇素材讲的是「**作为服务端**对外提供 OpenAI 兼容端点」。两者是同一协议约定的两侧实现，共同构成 [[OpenAI 兼容 API]] 的完整图景。 + +- 与 [[多 Agent 工作流编排]] 的关系：编排侧的素材讨论「多个 Agent 怎么串起来」，本素材讨论「单个编程 Agent 怎么换模型」。两者目前没有直接的内容重叠，暂不做横向对比。 + +- 同批 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 配置三件套]] diff --git a/wiki/topics/AI 编程工具接入.md b/wiki/topics/AI 编程工具接入.md new file mode 100644 index 0000000..0bc9953 --- /dev/null +++ b/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」。 + + +## 素材汇总 + +| 素材 | 核心贡献 | 详见 | +|------|----------|------| +| 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 工作流编排]]