Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

RoundRedDot for Pi

在 Pi 中使用 RoundRedDot:配置一个 Key,自动发现可用对话模型,并按需查看 Key 的额度。

验证基线:Pi 1.3.0、Node.js 24.21.0;包声明 Node.js ≥22.19。首版供个人和团队通过本地目录或 Git 安装,未发布到 npm。

安装与首次使用

在已安装 Pi 的机器上,将仓库放到本地,然后运行:

pi install /absolute/path/to/pi-roundreddot
pi

插件使用 Pi 提供的依赖和 TypeScript 加载器,安装使用无需先构建。进入交互模式后:

/login roundreddot
/roundreddot refresh
/model

在登录的隐藏输入框中输入 Key;刷新后通过 /model 选择 roundreddot 的模型。重新登录可更换 Key。凭据由 Pi 保存,插件不另存 Key。

也可设置 ROUNDREDDOT_API_KEY。Pi 已保存的 Key 优先于环境变量。使用 Pi 的 /logout 流程可删除已保存的凭据;若环境变量仍存在,它会继续生效。

先完成一次交互初始化,再运行脚本:Pi 1.3.0 在启动时先从缓存解析扩展模型。更换 Key 或网关后,应再次在交互模式刷新对应模型。

pi --list-models roundreddot
pi --provider roundreddot --model deepseek-flash -p '你好'

模型 ID 必须以实际发现的列表为准。没有匹配缓存时,脚本无法首次发现模型;回到交互模式运行 /roundreddot refresh。pi update --models 不加载此扩展,不能用来初始化插件模型。

将来配置 Git 远程仓库后,可使用 Pi 的 pi install git:github.com/<组织>/pi-roundreddot@<标签或提交> 安装固定版本。当前仓库未配置远程地址。

命令与缓存

命令 行为
/roundreddot 查看已用、剩余或无限额度、到期时间、读取时间及模型状态
/roundreddot refresh 强制刷新模型列表和额度
/roundreddot help 查看用法

额度按 USD 展示;过期、耗尽、旧读数及换算率回退都会明确提示。没有状态栏组件,也不会后台轮询额度。短时间内的重复额度查询共享请求或复用 20 秒内读数;强制刷新绕过这个窗口,但尊重服务端 Retry-After 限流。

模型列表的正常刷新窗口为十分钟。缓存绑定网关和有效 Key;更换任一项都会隔离旧数据。临时网络错误保留同 Key 的最后一次模型列表;401/403 清除失效列表。缓存由 Pi 管理,包含模型及不可逆的凭据范围指纹,不包含 Key。额度只在当前进程内缓存。

Quota 是计费依据。 Pi 会话费用是估算,默认模型价格字段的 0 是占位值,不表示免费。插件不请求计费探测、不进行价格对比、不施加额外消费上限。

网关与模型覆盖

默认网关为 https://oneapi.rrdtech.cn。通过环境变量覆盖网关根地址;末尾的 /v1 也会被规范化:

ROUNDREDDOT_BASE_URL=https://your-roundreddot.example pi

根地址同时用于模型、额度和协议路由。建议使用这个变量更换部署地址。Pi 的 provider 级 models.json.baseUrl 会统一覆盖所有模型的地址;混用 Messages、Gemini 与 OpenAI 协议时,可能破坏各自的 /v1 路径。

v0.1.1 已重新核对模型参数。插件保留模型原始 ID,以 Key 的权限列表决定可用模型;参数按“用户覆盖 → 网关结构化字段 → 已核对的精确型号/渠道 → 待核实占位”取值。不会再按整个模型族统一填 128K。

型号 / 渠道 上下文 / 最大输出(token) 关键区别
DeepSeek V4.1 Flash (deepseek-flash) 1,048,576 / 393,216 图文;off/low/high/max
DeepSeek V4 Pro 1,048,576 / 393,216 纯文本
GPT-4.1 / mini / nano 1,047,576 / 32,768 不能套用 GPT-4o 的 128K
GPT-5.4 1,050,000 / 128,000 mini/nano 仍为 400,000 上下文
Gemini 已核对的标准 2.5/3/4 型号 1,048,576 / 65,536 优先原生 Gemini,保留工具续轮签名;各型号 off/minimal 支持不同
Claude Opus 4.6 / 4.7 / 4.8 1,000,000 / 128,000 原生 Messages + adaptive thinking
Kimi K3 1,048,576 / 1,048,576 输入与输出共享上下文;并非默认每次生成 1M
Qwen3 Coder Plus / Qwen3.6 Plus 1,000,000 / 65,536 Coder 不思考且纯文本;3.6 Plus 可思考且支持图片
GLM-5 / 5.1 原生 保守 200,000 / 131,072 官方 API 只写 200K;不把权重上限当成精确部署上限

完整的 237 项公开清单、历史快照、来源和未核实项见 模型参数审计。这不是当前 Key 的权限清单,也不表示全部 237 项都已查明或可用。最大输出包含模型适用的思考开销,并受剩余上下文限制;Gemini 2.5/3 的官方输入上限在 Pi 中保守作为总容量使用。

模型名带 [参数待核实] 表示仍有不明确的参数或渠道。完全未知的上限暂用 32,768 上下文 / 1,024 输出(留出 Pi 的请求及压缩安全余量),不能视为模型真实上限;部分历史记录和 Doubao 别名另有注明的保守预算。可通过 models.json 覆盖。图片生成、嵌入、音频、旧 Completions 等不支持的操作会排除。

当前接入限制:

  • GPT-6 Sol/Luna 的 Chat 工具调用只开放 off;网关声明 Responses 后可使用完整思考档位。
  • Gemini 3/4 缺少原生 gemini 端点时暂不纳入工具对话,避免丢失必需的思考签名。
  • kimi/kimi-k3 为百炼的 Moonshot 直供路由,仅 max;该渠道要求公网图片 URL,Pi 的 Base64 图片暂不开放。原生 kimi-k3 支持图文及 low/high/max。
  • 已核对的 Doubao Seed 2.x 别名暂时显式关闭思考,因为 Pi Chat 不回传加密思考字段;缺失会影响工具续轮推理质量。未标日期的别名不能确认具体快照与精确容量。
  • 原生与百炼的 Kimi、GLM、MiniMax 限额不同,只有明确渠道才应用对应参数。网关仍可能施加更低上限。

从 v0.1.0 升级后,请重启 Pi 并运行 /roundreddot refresh。 旧参数缓存已失效;刷新后再使用脚本。手动配置的模型覆盖仍然优先。

请求和流事件交由 Pi 原生适配器处理;验证包含本地工具回合和打包安装,不包含付费线上模型探测。

Pi 的 ~/.pi/agent/models.json 支持用户覆盖名称、上下文、图片能力、思考映射、兼容参数及费用。覆盖以用户配置为准,例如:

{
  "providers": {
    "roundreddot": {
      "modelOverrides": {
        "deepseek-flash": {
          "name": "Team DeepSeek",
          "contextWindow": 96000,
          "input": ["text"]
        }
      }
    }
  }
}

费用可按实际价格增加 cost,字段为 input、output、cacheRead、cacheWrite,单位 USD/百万 token。修改后运行 /roundreddot refresh 加载覆盖。不要把 Key 提交到仓库。

开发与验证

npm ci
npm run typecheck
npm test
npm run build
npm run test:install
npm run audit:catalog
npm pack

test:install 在临时目录中打包、解压、执行 pi install,通过原生登录初始化缓存,再从新 CLI 进程验证模型列表和 -p 流式请求。它仅使用合成 Key 和本地 HTTP 服务,不修改用户 Pi 配置。

分发压缩包时先解压,再用 pi install /absolute/path/to/extracted/package 安装该目录。保留目录,Pi 直接引用它。

验收证据见 verification.md,设计与范围见 planning.md。

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages