# Pi

为 Pi 安装 Felo Skill；也可以把 Felo 配成 Pi 的模型 provider。

使用本指南为 Pi 安装 Felo Skill。Pi 保留自己的模型配置；Skill 可以配合你当前使用的任何模型工作，你也可以选择把 Felo 添加为 provider。

## 开始之前

- 一个 Felo API key：[创建一个](https://openapi.felo.ai/console/api-keys)。
- 如果要使用 FeloAPI CLI，需要 [Node.js 22 或更高版本](https://nodejs.org/en/download)。
- 已安装 Pi。

## 本指南会配置什么

| 项目 | 值 |
| --- | --- |
| 模型提供方 | 保持不变（沿用你现有的 Pi 模型） |
| Felo Skill 位置 | `~/.pi/agent/skills` |
| 可选 Felo 模型所用协议 | OpenAI-compatible |

## 方式一：安装 Felo Skill

```bash
npm install -g feloapi-cli@latest
feloapi setup --agent pi --skills-only --yes
```

这里只安装 Skill，不会修改 Pi 的模型提供方。开一个新的 Pi 会话，然后让它使用 `feloapi` Skill，例如：“用 feloapi skill 搜索今天的 AI 新闻并总结一下。”

## 方式二：使用 Felo 模型（手动，可选）

Pi 从 `~/.pi/agent/models.json` 读取 provider 配置。把 Felo 添加为 OpenAI-compatible provider：

```json
{
  "providers": {
    "feloapi": {
      "name": "Felo API",
      "baseUrl": "https://openapi.felo.ai/api/v1",
      "api": "openai-completions",
      "apiKey": "$FELO_API_KEY",
      "models": [
        { "id": "MODEL_ID", "name": "Felo model", "contextWindow": 128000, "maxTokens": 8192, "input": ["text"] }
      ]
    }
  }
}
```

在环境变量中设置 `FELO_API_KEY`，然后用 `pi --provider feloapi --model MODEL_ID` 启动 Pi。如果设置了 `PI_CODING_AGENT_DIR`，Skill 和 models 文件都会放在该目录下。

## 验证

```bash
feloapi doctor --agent pi
```

报告里 `pi` 显示 `ok: true`，就说明 Skill 状态正常。

## 切回／移除 Felo

当前模型提供方没有被改动，因此无需切回。如需移除 Skill：

```bash
feloapi disconnect pi --yes
```

## 故障排查

| 问题 | 处理方式 |
| --- | --- |
| `feloapi: command not found` | 重新打开终端再试；或运行 `npm install -g feloapi-cli@latest` 重新安装。 |
| Skill 没有被使用 | 开一个新的 Pi 会话；Skill 只在启动时才会被识别。 |
| Skill 调用 Felo 时认证失败 | 新建一个 key，运行 `feloapi auth login`（或导出 `FELO_API_KEY`）。 |
| Felo 模型没有响应 | 检查上面的手动 provider 字段；Base URL 和 key 必须一致。 |

## 相关

- [FeloAPI CLI 指南](https://openapi.felo.ai/zh-CN/docs/cli.md)
- [模型与价格](https://openapi.felo.ai/zh-CN/docs/guides/models-and-pricing.md)
- [其他 AI 工具](https://openapi.felo.ai/zh-CN/docs/agent-clients/other-tools.md)