pi-provider-string-ai0.1.0-beta.8

String AI Pi Provider

为官方 Pi 增加 string-ai 提供商。当前版本是 0.1.0-beta.8，npm 的 latest 和 beta 都指向它。

安装

pi install npm:pi-provider-string-ai@0.1.0-beta.8
pi list

需要 Node.js >=22.19.0 和官方 Pi 1.4.0。安装后启动 pi；已打开的窗口执行 /reload 或重启。

已从本地目录安装过同名插件时，先执行 pi remove <原本地插件路径>，再安装 npm 版本。

登录和选模

在 https://www.string.ink/ 创建普通 API Key。不要使用 WebChat 内部 Key 或浏览器登录态。

/login string-ai
/model

Key 只在 Pi 提示中输入。默认地址是 https://www.string.ink/v1，新安装不需要 string-ai.json。

在 /model 中选择 string-ai 下当前 Key 返回的模型。Ctrl+S 保存默认模型，Enter 只切换当前会话，Esc 取消。

可用命令：

• /string-ai-help：查看登录和选模步骤。
• /string-ai-model：查看可用模型数量。
• /string-ai-status：查看认证、模型和价卡状态。
• /string-ai-refresh：刷新模型、余额和价格。
• /string-ai-balance：查询当前账户余额。

模型和价格

模型必须与服务目录中的 ID 完全一致。OpenAI、Claude、Grok 使用对应的 Pi 参考模板。deepseek-v4-pro、deepseek-v4-flash、deepseek-v4.1-flash 使用 /v1/responses。

状态栏显示账户积分余额。/model 中显示输入、输出和缓存价格，单位是积分/百万 token。价格已包含倍率。

DeepSeek 当前价卡返回 account_dependent，因此没有可显示的固定单价。已打开的 /model 不会自动刷新，价卡变化后重新打开。

配置

配置文件是当前 Pi agent 目录中的 string-ai.json，不要写入 Key。修改后执行 /reload。

models: [] 会禁用参考模型。需要恢复时删除该字段，或写入：

{
  "version": 1,
  "useBuiltinModels": true
}

备用地址是 https://ai.qpcmqam.cn/v1。使用时同时设置 baseUrl 和 useBuiltinModels: true，然后执行 /reload 和 /string-ai-refresh。插件不会自动切换地址。

自定义远程地址必须使用 HTTPS。只有显式设置 allowInsecureLocalhost: true 时，才允许本地回环使用 HTTP。

常见问题

• 401：Key 无效或已撤销，重新执行 /login string-ai。
• 403：当前 Key 没有该模型或协议的权限。
• 429：达到限流、并发或额度限制。
• 没有模型：执行 /string-ai-status。目录返回但没有匹配模型时，检查 useBuiltinModels。
• 离线：PI_OFFLINE 存在时不会联网刷新。恢复时删除该变量。
• Windows 找不到 Bash：把 Git 的 bin 目录加入当前 PowerShell 的 PATH。

卸载和更新

pi remove npm:pi-provider-string-ai@0.1.0-beta.8

固定版本不会自动升级。更新时安装新的明确版本，或执行：

pi update npm:pi-provider-string-ai@beta

更新插件后执行 /reload 或重启。/logout 只清除本机 Pi 凭据，不撤销服务端 Key。