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

​
接入条件

  • 已按 Pi 接入指南安装 Pi 0.87.1，并完成 Step Plan 配置与基础对话验证。
  • 启动 Pi 的终端已设置 STEP_API_KEY 环境变量。

​
安装 OMP

  1. 在终端中安装 oh-my-pi 0.2.0。
  2. 检查已安装的软件包。
软件包列表应包含 npm:oh-my-pi@0.2.0。Pi 会在新会话中自动加载扩展。

​
配置编排器

如需自定义编排器名称和提示词模板，在项目根目录的 .oh-my-pi.jsonc 中合并以下配置，保留已有字段。文件不存在时创建该文件。
保存后，在已有 Pi 会话中执行 /oh-my-pi-reload，或重新启动 Pi。

​
启动 Pi

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

​
验证接入

​
检查扩展状态

在 Pi 会话中输入：
诊断结果应显示 Healthy，且配置诊断无错误。

​
验证对话

在终端中执行：
预期返回 OK。

​
验证工具调用

  1. 在安装了 Python 的独立测试目录中创建 README.md，内容为 Oh My Pi Step Plan test。
  2. 从该目录启动 Pi。
  3. 在会话中输入以下任务。
  4. 核对文件读取、创建和命令执行记录，确认生成的 hello.py 运行输出为 Hello, StepFun!。

​
验证角色调用

在同一测试目录的 Pi 会话中输入：
核对工具记录中包含 oh_my_pi_subagent，并确认当前会话返回评审结果。

​
核查请求通道

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

​
常见问题

npm 软件包源使用 npm: 前缀。请执行 pi install npm:oh-my-pi@0.2.0，安装后运行 pi list 检查结果。
0.2.0 的 oh_my_pi_subagent 工具向当前会话返回角色指令，后续请求仍使用 Pi 当前选择的模型。该版本尚未实现通过 agents.oracle.model 或任务分类的 model 字段切换实际调用模型。选择模型时，请使用 Pi 的 --provider 和 --model 参数。
在终端中执行 pi remove npm:oh-my-pi@0.2.0，然后重新启动 Pi。
OMP 沿用 Pi 的模型和凭据配置。请按 Pi 接入指南检查 STEP_API_KEY、models.json 中的 baseUrl 和对应模型的 contextWindow。