docs/oh-my-pi.zh-CN.md 接入说明已过时：内置 DeepSeek V4 条目已在 Oh My Pi v15.1.8+ 修复

## 问题

[docs/oh-my-pi.zh-CN.md](https://github.com/deepseek-ai/awesome-deepseek-agent/blob/main/docs/oh-my-pi.zh-CN.md) 当前写道：

> Oh My Pi 是终端 AI 编程 Agent。自 v14.5 起内置了 DeepSeek V4 模型条目，但内置条目缺少关键配置，直接使用可能报错，仍需自定义 `models.yml`。
> ...
> **不推荐依赖内置模型条目。** 较新版本 `omp --list-models deepseek` 能列出 `deepseek-v4-pro` 和 `deepseek-v4-flash`，但内置条目缺少上述三项关键 compat。直接用内置条目在 thinking mode 下带 tool call 的长对话大概率 400。始终使用上方的 `models.yml` 配置。

这段描述已经**过时**。Oh My Pi 在 **v14.5.14** 和 **v15.1.8** 已经修复了对应的 DeepSeek V4 兼容性问题，当前最新版本（v16.3.10）的内置 `deepseek-v4-pro` / `deepseek-v4-flash` 条目已经包含文档里要求的全部关键 `compat` 字段。

## 证据

### 1. Oh My Pi 官方 Changelog 已记录修复

在 `packages/ai/CHANGELOG.md` 中可以找到：

- **v15.1.8**（2026-05-20）
`Fixed DeepSeek V4 direct API requests with tools to keep documented thinking mode instead of dropping reasoning: lower OMP efforts now map to DeepSeek's supported high, tool_choice is omitted, thinking: { type: "enabled" } and max_tokens are sent, and partial user reasoningEffortMap overrides merge with DeepSeek defaults.`
关联 issue：[can1357/oh-my-pi#1207](https://github.com/can1357/oh-my-pi/issues/1207)

- **v14.5.14**（2026-05-01）
`Fixed DeepSeek V4 tool-call follow-up 400 errors from three root causes:`
- `Mapped reasoning_effort "xhigh" to "max" for DeepSeek-family models on any provider`
- `Recovered reasoning_content from thinking blocks with valid signatures`
- `Added empty-string fallback when reasoning_content is genuinely absent but the provider requires the field`

### 2. 当前内置模型条目已包含文档要求的三项关键 compat

拉取当前 `main` 分支的 `packages/catalog/src/models.json`，`deepseek` provider 下的内置条目 `compat` 字段如下（已验证）：

```json
{
"supportsDeveloperRole": false,
"supportsReasoningEffort": true,
"maxTokensField": "max_tokens",
"supportsToolChoice": false,
"extraBody": { "thinking": { "type": "enabled" } },
"reasoningContentField": "reasoning_content",
"requiresReasoningContentForToolCalls": true,
"requiresAssistantContentForToolCalls": true
}
```

这正好对应文档里强调必须手动配置的“三项关键 compat”：

| 文档要求字段 | 当前内置条目状态 |
|---|---|
| `supportsToolChoice: false` | ✅ 已内置 |
| `requiresReasoningContentForToolCalls: true` | ✅ 已内置 |
| `requiresAssistantContentForToolCalls: true` | ✅ 已内置 |
| `extraBody.thinking.type: enabled` | ✅ 已内置 |
| `reasoningEffortMap: { high: high, xhigh: max }` | ✅ 已内置（通过 `thinking.effortMap`） |

## 建议修改

1. 在文档开头说明：**Oh My Pi v15.1.8+（当前最新 v16.3.10）已修复内置 DeepSeek V4 条目的 compat，官方 `api.deepseek.com` 用户通常无需再手动写 `models.yml`**。
2. 保留 `models.yml` 示例，但改为“旧版本 / 非官方 provider / 校内端点等场景下的备用配置”。
3. “已知问题”里“不推荐依赖内置模型条目”的段落需要更新，避免继续误导用户。
4. 如果仍想提醒非官方 provider 的兼容性问题，可以保留该部分说明，但明确区分“官方 API 已可用”和“第三方 proxy 可能仍需自定义配置”。

这样能让新用户直接用上内置配置，降低接入门槛。