pi-volcengine-coding-plan

Pi extension for Volcengine Coding Plan, registering Volcengine as a custom OpenAI-compatible provider for domestic coding models.

Packages

Package details

extension

Install pi-volcengine-coding-plan from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-volcengine-coding-plan
Package
pi-volcengine-coding-plan
Version
0.1.2
Published
Jun 8, 2026
Downloads
not available
Author
qsw745
License
MIT
Types
extension
Size
9 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-volcengine-coding-plan

npm version MIT License

给 pi 增加 Volcengine Coding Plan 国内版模型支持的扩展包。安装后会注册 volcengine-plan provider。

功能概览

  • 注册 Volcengine Coding Plan provider，兼容 pi 的 OpenAI 风格调用路径
  • 使用统一的 VOLCENGINE_API_KEY 环境变量访问全部模型
  • 覆盖 Volcengine Coding Plan 当前完整模型集合
  • 直接使用国内版 Coding Plan endpoint，而不是基础模型 endpoint

安装

pi install npm:pi-volcengine-coding-plan

配置

先准备 Volcengine Ark API Key，然后设置环境变量：

export VOLCENGINE_API_KEY="your-ark-api-key"

如果你想长期使用，把这一行写进 ~/.zshrc 或 ~/.bashrc。

使用方式

交互式选择模型

pi

进入后执行 /model，从列表中选择 volcengine-plan 下面的模型。

命令行直接指定模型

推荐始终使用完整 provider/model 语法，避免与内置 provider 的同名模型冲突：

pi --model volcengine-plan/ark-code-latest
pi --model volcengine-plan/doubao-seed-2.0-code
pi --model volcengine-plan/glm-5.1
pi --model volcengine-plan/deepseek-v4-pro

列出当前所有可用模型：

pi --list-models

如果你要把它设成默认模型，可以参考下面的配置思路：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "volcengine-plan/ark-code-latest"
      }
    }
  }
}

可用模型

Model ID Context Window Max Tokens Input
ark-code-latest 256000 32000 text, image
doubao-seed-code 256000 32000 text, image
glm-5.1 200000 65536 text
deepseek-v4-flash 1024000 65536 text
deepseek-v4-pro 1024000 65536 text
doubao-seed-2.0-code 256000 65536 text, image
doubao-seed-2.0-pro 256000 65536 text, image
doubao-seed-2.0-lite 256000 65536 text, image
minimax-latest 200000 65536 text
kimi-k2.6 256000 32000 text, image

重要说明

  • 本扩展使用的是 Volcengine Coding Plan endpoint：https://ark.cn-beijing.volces.com/api/coding/v3
  • 不要改成普通基础模型接口，否则调用路径和计费方式都可能不符合你的 Coding Plan 预期
  • 类似 glm-5.1、deepseek-v4-pro、kimi-k2.6 这类常见模型 id，可能与其他 provider 重名，建议始终使用 volcengine-plan/模型ID

发布与维护

完整发布流程见 PUBLISHING.md。

你至少需要完成这几件事：

  1. 把 package.json 里的 author 和 repository 改成你自己的信息
  2. 在 GitHub 仓库里配置 NPM_TOKEN
  3. 首次发布前执行一次 npm publish --dry-run

License

MIT