MNModel Nexus 使用文档
Model Nexus Docs

Oh My Pi 教程

Oh My Pi 适合多模型、多角色和更复杂的开发工作流。本页提供本机已验证过的 Model Nexus 接入方式。

Oh My Pi 能做什么

多模型工作流

Oh My Pi 适合把多个模型、多个角色和较长任务放在一个工作流里使用。它通过本地配置文件读取供应商地址和 key。

适合谁

如果你需要更复杂的开发流程，或已经有人帮你安装好了 Oh My Pi，只需要按本页复制配置即可。

推荐 companion：VS Code

为什么推荐

Oh My Pi 的接入重点是编辑 .env 和 models.yml。VS Code 可以清楚显示文件夹、缩进和 YAML 格式，适合不熟悉终端的人。

VS Code 官网下载 VS Code

不用 VS Code 也可以

任何纯文本编辑器都能修改这些文件。不要用会自动改格式的富文本软件。

Windows / macOS / Linux 配置

  2. 打开 Oh My Pi 配置目录；如果由支持人员安装，请让对方确认目录位置。
  3. 把下面两段分别保存为 .env 和 models.yml。
  4. 重启 Oh My Pi。
  2. 打开 ~/.omp/agent/。
  3. 把下面两段分别保存为 .env 和 models.yml。
  4. 重启 Oh My Pi。
  1. 安装 VS Code for Linux 或使用你熟悉的文本编辑器。
  2. 打开 ~/.omp/agent/。
  3. 把下面两段分别保存为 .env 和 models.yml。
  4. 重启 Oh My Pi。

复制 .env

~/.omp/agent/.env
MODELNEXUS_OPENAI_KEY={{MODELNEXUS_API_KEY}}
PI_OPENAI_STREAM_IDLE_TIMEOUT_MS=600000

PI_OPENAI_STREAM_IDLE_TIMEOUT_MS 是流式输出空闲超时，600000 等于 10 分钟。

复制 models.yml

~/.omp/agent/models.yml
providers:
  modelnexus-openai:
    baseUrl: https://api.modelnexus.net/v1
    apiKey: MODELNEXUS_OPENAI_KEY
    authHeader: true
    api: openai-responses
    compat:
      supportsReasoningEffort: true
      supportsDeveloperRole: true
    discovery:
      type: openai-models-list

常见问题

  • 启动后仍用旧模型：保存文件后重启 Oh My Pi。
  • YAML 报错：检查缩进，不要把空格改成制表符。
  • 请求超时：保留 10 分钟空闲超时，长任务不要同时开太多。