Oh My Pi 接入 DeepSeek V4：自定义 models.yml 配置指南

Oh My Pi 是终端 AI 编程 Agent，自 v14.5 起内置了 DeepSeek V4 模型条目，但内置条目缺少关键配置，直接使用可能报错。推荐通过自定义 models.yml 配置来完整支持 DeepSeek V4。

前置条件

安装 Oh My Pi（参考 GitHub 安装说明），并在 DeepSeek 开放平台获取 API Key：

bash

export DEEPSEEK_API_KEY=<你的 API Key>

配置 models.yml

创建 ~/.omp/agent/models.yml，添加 DeepSeek 供应商配置：

yaml

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
        # ...（配置同上，模型名不同）

配置要点

基础字段

baseUrl: https://api.deepseek.com：不要加 /v1
authHeader: true：发送 Authorization 头
supportsDeveloperRole: false：以 system 角色发系统提示词
maxTokensField: max_tokens：DeepSeek 使用 max_tokens 字段

三项关键 compat（必配）

这三个字段是避免 400 报错的关键：

supportsToolChoice: false — 不接受 tool_choice 参数
requiresReasoningContentForToolCalls: true — 历史消息中必须保留 reasoning_content
requiresAssistantContentForToolCalls: true — tool call 消息的 content 不为空

使用