# Oh My Pi

来源: https://docs.aicentos.com/clients/oh-my-pi

Language: zh-CN

> 在 Oh My Pi（omp）里接入 aicentos —— models.yml 加一个 openai-completions provider

Oh My Pi 是 Pi 的分支，用 Rust 重写了核心，命令是 `omp`。它通过 `~/.omp/agent/models.yml` 定义 provider，字段 `baseUrl` / `api` / `apiKey` 写清楚就能指向 aicentos。

## 准备工作

先在控制台为 Oh My Pi 建一个专用 Key（建议命名 `oh-my-pi`）。

运行时需要 bun 1.4.4 及以上：

```bash
curl -fsSL https://omp.sh/install | sh
```

也可以用 Homebrew 或 npm 分发：

```bash
brew install can1357/tap/omp
# 或
bun install -g @oh-my-pi/pi-coding-agent
```

## 需要填写的配置

| 字段            | 值                         |
| ------------- | ------------------------- |
| provider 名    | 自取，例如 `aicentos`          |
| `baseUrl`     | `https://aicentos.com/v1` |
| `api`         | `openai-completions`      |
| `apiKey`      | 控制台创建的 Key                |
| `models[].id` | 控制台「模型广场」中的模型名            |

## 配置步骤

编辑 `~/.omp/agent/models.yml`：

```yaml
providers:
  aicentos:
    baseUrl: https://aicentos.com/v1
    api: openai-completions
    apiKey: sk-你的-API-Key
    models:
      - id: 你的模型名
        contextWindow: 128000
```

在 `~/.omp/agent/config.yml` 里把它设为默认：

```yaml
modelRoles:
  default: aicentos/你的模型名
```

不想把 Key 写进文件时，把 `apiKey` 换成环境变量引用，并在启动前 `export AICENTOS_API_KEY="sk-你的-API-Key"`。

## 测试

```bash
omp models aicentos
```

能列出刚配的模型即说明 provider 认到了。再进 TUI 发一句话确认能返回，最后回控制台核对用量。

## 注意事项

* `api` 必须是 `openai-completions`（或其它它认识的协议名），写 `openai` 会被当成未知协议。
* 它默认关闭了大量工具，接入成功但「什么都不能干」时先看工具开关，不是端点问题。
* 打开仓库即加载项目级配置与钩子，接入前确认仓库可信。
* Alpine 环境需要额外装 `libstdc++`、`libgcc`。

## 相关链接

* [Oh My Pi provider 文档](https://omp.sh/docs/providers)
* [oh-my-pi 仓库](https://github.com/can1357/oh-my-pi)