• 简体中文
  • PI 接入

    极简、可扩展的开源终端 coding agent(earendil-works 出品)。默认只给模型 read / write / edit / bash 四个工具,通过 Extensions、Skills 和 Pi Packages 按需扩展。自定义服务商写一个 JSON 文件即可接入 ByteSeek。

    下载安装

    npm
    npx 免安装
    Arch Linux
    npm install -g --ignore-scripts @earendil-works/pi-coding-agent

    --ignore-scripts 跳过依赖的生命周期脚本,PI 正常安装用不到它们,还能降低供应链风险。

    npm 包页面见 @earendil-works/pi-coding-agent,官网见 pi.dev

    旧包名已废弃

    2026 年 5 月起包名从 @mariozechner/pi-coding-agent 迁到 @earendil-works/pi-coding-agent,旧教程里的包名不要再用;老安装执行 pi update --self 迁移。

    前置条件

    • 已安装 PI(pi --version 可输出版本)
    • 已在API 密钥页面创建 OpenAI 格式分组的 Key

    配置

    编辑 ~/.pi/agent/models.json,把 ByteSeek 加为自定义服务商:

    {
      "providers": {
        "byteseek": {
          "baseUrl": "https://tokens.byteseek.ai/v1",
          "api": "openai-completions",
          "apiKey": "sk-你的密钥",
          "models": [
            { "id": "gpt-5.6-sol", "name": "GPT-5.6 Sol", "reasoning": true },
            { "id": "gpt-5.6-terra", "name": "GPT-5.6 Terra", "reasoning": true }
          ]
        }
      }
    }
    • models 里的 id模型广场为准,用复合 Key时写带前缀的 ID。
    • apiKey 支持环境变量写法 "$BYTESEEK_API_KEY",不想把密钥落盘时用这种。
    • Key 属于 Anthropic 格式分组时,把 api 改为 anthropic-messagesbaseUrl 改为 https://tokens.byteseek.ai(不带 /v1)。

    文件在每次打开 /model 时自动重载,改完不用重启会话。

    验证时你应看到
    • 输入 /model 后,弹出的模型列表中出现 byteseek 分组,其下列出你在 models.json 里配置的模型(如 GPT-5.6 Sol);
    • 选中后,界面底部状态栏显示当前模型 ID;
    • 发送一句话能正常收到回复,无 401 / 403 报错。

    验证

    启动 pi,按 /model(或 Ctrl+L)切换到 byteseek 下的模型,发一句话确认正常回复。扣费明细在使用记录页面可查。

    常见问题

    症状处理
    /model 里看不到模型models.json 语法错误,或该服务商没配置任何 apiKey / 登录凭据
    401apiKey 填错;用环境变量写法时确认变量已 export
    403分组不含该模型或格式选错,见错误码清单
    服务端不认 developer 角色在服务商配置里加 "compat": { "supportsDeveloperRole": false }(ByteSeek 标准接口一般不需要)
    © 2026 ByteSeek Limited. 保留所有权利。服务条款隐私政策免责声明