> ## Documentation Index
> Fetch the complete documentation index at: https://platform.stepfun.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Oh My Pi

Oh My Pi（OMP）是 Pi 的工作流扩展，通过 npm 包 `oh-my-pi` 安装，提供任务分类、角色指令和 Skill 加载能力。模型调用沿用 Pi 的 Provider 配置，通过 Anthropic Messages API 接入 Step Plan。

## 接入条件

* 已按 [Pi 接入指南](/docs/zh/step-plan/integrations/pi)安装 Pi 0.87.1，并完成 Step Plan 配置与基础对话验证。
* 启动 Pi 的终端已设置 `STEP_API_KEY` 环境变量。

## 安装 OMP

1. 在终端中安装 `oh-my-pi` 0.2.0。

   ```bash theme={"theme":{"light":"light-plus","dark":"dark-plus"}}
   pi install npm:oh-my-pi@0.2.0
   ```

2. 检查已安装的软件包。

   ```bash theme={"theme":{"light":"light-plus","dark":"dark-plus"}}
   pi list
   ```

软件包列表应包含 `npm:oh-my-pi@0.2.0`。Pi 会在新会话中自动加载扩展。

## 配置编排器

如需自定义编排器名称和提示词模板，在项目根目录的 `.oh-my-pi.jsonc` 中合并以下配置，保留已有字段。文件不存在时创建该文件。

```json theme={"theme":{"light":"light-plus","dark":"dark-plus"}}
{
  "orchestrator": {
    "agentName": "stepfun",
    "promptTemplate": "sisyphus"
  }
}
```

保存后，在已有 Pi 会话中执行 `/oh-my-pi-reload`，或重新启动 Pi。

## 启动 Pi

在项目目录的终端中执行：

```bash theme={"theme":{"light":"light-plus","dark":"dark-plus"}}
pi --provider stepfun --model step-5-preview
```

## 验证接入

### 检查扩展状态

在 Pi 会话中输入：

```text theme={"theme":{"light":"light-plus","dark":"dark-plus"}}
/oh-my-pi-doctor
```

诊断结果应显示 `Healthy`，且配置诊断无错误。

### 验证对话

在终端中执行：

```bash theme={"theme":{"light":"light-plus","dark":"dark-plus"}}
pi --provider stepfun --model step-5-preview --print "请只回复 OK。"
```

预期返回 `OK`。

### 验证工具调用

1. 在安装了 Python 的独立测试目录中创建 `README.md`，内容为 `Oh My Pi Step Plan test`。

2. 从该目录启动 Pi。

3. 在会话中输入以下任务。

   ```text theme={"theme":{"light":"light-plus","dark":"dark-plus"}}
   读取 README.md，创建 hello.py，输出 Hello, StepFun!。
   使用本机可用的 Python 解释器运行 hello.py，并汇报执行命令和输出。
   不要修改其他文件。
   ```

4. 核对文件读取、创建和命令执行记录，确认生成的 `hello.py` 运行输出为 `Hello, StepFun!`。

### 验证角色调用

在同一测试目录的 Pi 会话中输入：

```text theme={"theme":{"light":"light-plus","dark":"dark-plus"}}
调用 oh_my_pi_subagent 工具，请 oracle 评审 hello.py 的输出和可移植性。
只给出简短结论，不修改文件。
```

核对工具记录中包含 `oh_my_pi_subagent`，并确认当前会话返回评审结果。

### 核查请求通道

Pi 的 Step Plan 配置 Base URL 为 `https://api.stepfun.com/step_plan`，对应请求路径为 `/step_plan/v1/messages`。如需核查请求路由或计费归属，请提供请求时间、模型 ID 和 Request ID 联系技术支持。

## 常见问题

<AccordionGroup>
  <Accordion title="Q: 安装时找不到软件包怎么办？">
    npm 软件包源使用 `npm:` 前缀。请执行 `pi install npm:oh-my-pi@0.2.0`，安装后运行 `pi list` 检查结果。
  </Accordion>

  <Accordion title="Q: 可以为 oracle 单独指定模型吗？">
    0.2.0 的 `oh_my_pi_subagent` 工具向当前会话返回角色指令，后续请求仍使用 Pi 当前选择的模型。该版本尚未实现通过 `agents.oracle.model` 或任务分类的 `model` 字段切换实际调用模型。选择模型时，请使用 Pi 的 `--provider` 和 `--model` 参数。
  </Accordion>

  <Accordion title="Q: 如何停用 OMP？">
    在终端中执行 `pi remove npm:oh-my-pi@0.2.0`，然后重新启动 Pi。
  </Accordion>

  <Accordion title="Q: 认证、请求路径或上下文配置异常怎么办？">
    OMP 沿用 Pi 的模型和凭据配置。请按 [Pi 接入指南](/docs/zh/step-plan/integrations/pi)检查 `STEP_API_KEY`、`models.json` 中的 `baseUrl` 和对应模型的 `contextWindow`。
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.