# Oh My Pi

來源: https://docs.aicentos.com/zh-TW/clients/oh-my-pi

Language: zh-TW

> 在 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)