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

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 工作流编排]]