Pi Agent

在终端执行：

npm install -g --ignore-scripts @earendil-works/pi-coding-agent
pi --version

• 在 Mengbi Router 个人控制台创建 API Key。
• 确认模型目录中存在 gpt-5.6-sol。
• 官方项目：https://github.com/earendil-works/pi；官方文档：https://pi.dev/docs/latest。

NotePi 会在当前项目目录中读取和修改文件。需要更强的文件、进程或网络隔离时，请在容器或其他沙箱中运行。

在 macOS/Linux 的 ~/.pi/agent/models.json 写入下面内容；Windows 使用用户目录下的 .pi/agent/models.json。

{
  "providers": {
    "mengbi": {
      "name": "Mengbi Router",
      "baseUrl": "https://router-api.mengbi-ai.net/v1",
      "apiKey": "$MENGBI_ROUTER_API_KEY",
      "api": "openai-completions",
      "models": [
        {
          "id": "gpt-5.6-sol",
          "name": "GPT-5.6 Sol",
          "reasoning": true,
          "input": ["text"],
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "contextWindow": 128000,
          "maxTokens": 16384
        }
      ]
    }
  }
}

在启动 Pi 的同一个终端中设置 Key：

export MENGBI_ROUTER_API_KEY="sk-mengbi-xxxxxx"
pi --provider mengbi --model gpt-5.6-sol

$env:MENGBI_ROUTER_API_KEY="sk-mengbi-xxxxxx"
pi --provider mengbi --model gpt-5.6-sol

models.json 里的 cost 只影响 Pi 本地的模型信息展示，示例设为 0 不代表 Mengbi Router 免费。实际扣费以 Router 当前实际折扣价格和个人控制台账单为准。

Note不要把真实 API Key 写入 models.json、项目文件或 Git 仓库；这里只保留 $MENGBI_ROUTER_API_KEY 环境变量引用。

在终端执行：

pi --list-models --provider mengbi

进入项目目录后执行 pi，选择 gpt-5.6-sol，发送一条简单任务，例如“列出当前项目的目录结构”。能正常返回结果即表示接入完成。

• 模型列表为空：确认 models.json 位于 ~/.pi/agent/models.json，并检查 JSON 逗号和括号。
• 提示未配置 Key：确认当前终端已经设置 MENGBI_ROUTER_API_KEY，再重新启动 Pi。
• 出现 404：确认 baseUrl 保留 /v1，api 使用 openai-completions，不要把 /chat/completions 再拼到 baseUrl。
• 提示模型不存在：模型 ID 必须完整写成 gpt-5.6-sol，并以 Mengbi Router 模型目录为准。