Oh My Pi 接入 DeepSeek V4models.yml 兼容配置实战指南【免费下载链接】awesome-deepseek-agent项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-agent在终端 AI 编程 Agent Oh My Pi 中使用 DeepSeek V4 系列模型deepseek-v4-pro / deepseek-v4-flash需要一份完整、准确的models.yml自定义配置才能稳定运行。本指南以docs/oh-my-pi.md为主体完整覆盖从安装、API Key 准备到配置文件编写、字段含义、命令行使用的全过程并重点解析三个决定成败的 compat 兼容字段帮助你在几分钟内让 Oh My Pi 稳定驱动 DeepSeek V4 完成带工具调用的长对话编程任务。Oh My Pi 与 DeepSeek V4 的适配背景根据 README.md 的定位Oh My Pi 是基于 Pi 分支扩展的终端 AI 编程 Agent提供了 OMP 专用工具、模型角色、MCP、插件与 Agent 工作流等能力。从 v14.5 起Oh My Pi 虽然内置了 DeepSeek V4 模型条目但内置条目的兼容配置并不完整——直接用内置条目在 thinking思考模式下带工具调用tool call进行长对话时会触发 DeepSeek API 的 400 错误。因此编写自定义~/.omp/agent/models.yml是可靠使用 DeepSeek V4 的必要步骤这也是本指南的核心。前置条件安装 Oh My Pi按其官方安装说明完成安装Oh My Pi 的安装命令以官方仓库 Installation 章节为准。获取 DeepSeek API Key登录 DeepSeek 开放平台在 API Keys 页面创建密钥然后写入环境变量export DEEPSEEK_API_KEY你的 API Key注意Oh My Pi 目前没有 DeepSeek 的 OAuth/login入口API Key 只能通过DEEPSEEK_API_KEY环境变量或models.yml中的apiKey字段提供二者取其一即可。完整配置创建 ~/.omp/agent/models.yml在用户主目录下创建~/.omp/agent/models.yml将以下内容完整写入providers: deepseek: baseUrl: https://api.deepseek.com api: openai-completions apiKey: DEEPSEEK_API_KEY authHeader: true models: - id: deepseek-v4-pro name: DeepSeek V4 Pro reasoning: true thinking: minLevel: high maxLevel: xhigh mode: effort input: [text] contextWindow: 1000000 maxTokens: 384000 compat: supportsDeveloperRole: false supportsReasoningEffort: true maxTokensField: max_tokens reasoningEffortMap: high: high xhigh: max supportsToolChoice: false requiresReasoningContentForToolCalls: true requiresAssistantContentForToolCalls: true extraBody: thinking: type: enabled - id: deepseek-v4-flash name: DeepSeek V4 Flash reasoning: true thinking: minLevel: high maxLevel: xhigh mode: effort input: [text] contextWindow: 1000000 maxTokens: 384000 compat: supportsDeveloperRole: false supportsReasoningEffort: true maxTokensField: max_tokens reasoningEffortMap: high: high xhigh: max supportsToolChoice: false requiresReasoningContentForToolCalls: true requiresAssistantContentForToolCalls: true extraBody: thinking: type: enabled这份配置同时注册了两个模型deepseek-v4-pro追求深度推理的旗舰型号与deepseek-v4-flash追求更快响应的轻量型号两者在 thinking 模式、上下文窗口与 compat 兼容策略上保持一致。配置要点详解基础字段字段说明baseUrl: https://api.deepseek.comDeepSeek OpenAI 兼容接口地址。不要追加/v1路径后缀。api: openai-completions声明使用 OpenAI Chat Completions 兼容协议。apiKey: DEEPSEEK_API_KEY引用环境变量名而非明文密钥配合authHeader使用。authHeader: true以Authorization: Bearer $DEEPSEEK_API_KEY方式发送认证头不经过 OAuth/login流程。input: [text]模型仅接受文本输入不声明图片等多模态输入。contextWindow: 1000000上下文窗口 100 万 token与 DeepSeek V4 的 1M 上下文能力一致CONTRIBUTING.md 亦要求配置体现 1M context。maxTokens: 384000单次最大输出 token 数上限 384000。supportsDeveloperRole: false系统提示词以system角色发送。DeepSeek API 不接受 OpenAI 风格的developer角色必须关闭。maxTokensField: max_tokensDeepSeek 请求体中的输出限制字段是max_tokens而非 OpenAI 的max_completion_tokens。Thinking 思考模式字段字段说明reasoning: true声明该模型支持推理/思考能力。thinking.mode: effort采用 effort-based thinking 模式Oh My Pi 会向 API 发送reasoning_effort参数。thinking.minLevel: high/maxLevel: xhigh将模型选择器锁定到 DeepSeek 官方支持的high与xhigh两档避免出现不被识别的档位。reasoningEffortMap: { high: high, xhigh: max }将 Oh My Pi 内部的xhigh档映射为 DeepSeek API 的max档。不配置此映射xhigh将无法被 DeepSeek 识别。supportsReasoningEffort: true允许 Oh My Pi 在请求中携带reasoning_effort参数。extraBody.thinking.type: enabled在请求体附加thinking: { type: enabled }显式启用 DeepSeek V4 思考模式。推理档位说明DeepSeek V4 Pro 支持max与high两个推理强度档位见 CONTRIBUTING.md本配置通过reasoningEffortMap将 Oh My Pi 的两档选择精确对齐到这两个官方档位保证思考模式全程可用。三项关键 compat 字段必配以下三个字段是避免报错的关键。缺失任何一项DeepSeek V4 在 thinking 模式下使用工具时都会返回 400 错误字段说明supportsToolChoice: falseDeepSeek V4 的 thinking 模式不接受tool_choice参数。置为false可让 Oh My Pi 不在请求中发送该参数。requiresReasoningContentForToolCalls: trueDeepSeek 要求 tool call 对话历史的消息中必须保留reasoning_content字段。开启后 Oh My Pi 会在跨轮次工具调用时回传该内容否则 400。requiresAssistantContentForToolCalls: true确保 tool call 消息的content字段非空。需与上一个字段配合使用。这三个字段共同解决的是思考模式 工具调用组合下的消息结构合规问题既不能带 DeepSeek 拒绝的tool_choice又必须把reasoning_content与content完整保留在历史消息中。使用方法进入项目目录指定模型启动 Oh My Picd /path/to/your-project omp --model deepseek/deepseek-v4-pro需要更快响应时切换到 Flash 型号omp --model deepseek/deepseek-v4-flash启动后也可以在 Oh My Pi 会话内部随时切换模型输入/model命令或按CtrlL快捷键打开模型选择器。已知问题与规避建议不要依赖内置模型条目较新版本执行omp --list-models deepseek虽然能列出deepseek-v4-pro与deepseek-v4-flash但内置条目缺少上文所述的三项关键 compat 字段在 thinking 模式下带工具调用的长对话中大概率 400 报错。请始终使用本指南给出的models.yml配置。compat是整块替换不合并models.yml中编写compat时它会整体替换内置条目中的 compat 块而不是增量合并。因此 compat 字段必须写全不能只补充缺失的那几个字段。非官方 provider 兼容性未收敛通过 DeepInfra、KiloCode、NVIDIA NIM、Zenmux 等非官方 provider 的 OpenAI 兼容接口使用 DeepSeek V4 时reasoning_content的回传规则可能各不相同兼容性问题尚未解决。建议优先使用官方api.deepseek.com端点以获得一致的行为。与上游 Pi 配置的对照Oh My Pi 源自 Pi二者的模型配置文件结构相近但字段命名存在差异。仓库中 docs/pi_mono.md 展示了 Pi 使用 JSON 格式~/.pi/agent/models.json配置 DeepSeek 的方式其中同类能力通过thinkingLevelMap、requiresReasoningContentOnAssistantMessages、thinkingFormat: deepseek、reasoningEffortMap等字段表达。可以看到必须保留推理内容以支持工具调用将内部档位映射到 DeepSeek 的high/max这些兼容思路在 Pi 系工具中是通用的只是 Oh My Pi 采用了 YAML 格式~/.omp/agent/models.yml与compat块组织方式。如果你此前配置过 Pi迁移到 Oh My Pi 时需按本指南的字段结构重写而不能直接复用 JSON。小结在 Oh My Pi 中稳定使用 DeepSeek V4 的要点可概括为三条一是通过~/.omp/agent/models.yml显式注册模型并关闭developer角色、指定max_tokens字段二是用reasoningEffortMap与extraBody正确对齐思考模式档位三是必须配齐三项关键 compat 字段否则 thinking 模式下的工具调用会触发 400。按本指南配置后即可在终端中享受 DeepSeek V4 的深度推理与 1M 上下文编程体验。相关双语文档可进一步参考 docs/oh-my-pi.md 与 docs/oh-my-pi.zh-CN.md。【免费下载链接】awesome-deepseek-agent项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
