Repository navigation
v0.1.8
通过 CPA 插件商店安装(推荐)
本插件已收录进 CPA 官方插件源,无需额外配置三方源。
在管理面板的插件商店里直接搜 FreeTier 2API 一键安装即可。
手动安装
下载对应平台的 freetier2api_<版本>_<goos>_<goarch>.zip,解压后把其中的
freetier2api 动态库放进 CPA 的 plugins/ 目录。
归档里已经用的是宿主要求的 freetier2api{ext} 文件名,解压后无需改名。
| 平台 | 下载归档 |
|---|---|
| Linux x86_64 | freetier2api_<版本>_linux_amd64.zip |
| Linux arm64 | freetier2api_<版本>_linux_arm64.zip |
| macOS Apple Silicon | freetier2api_<版本>_darwin_arm64.zip |
| macOS Intel | freetier2api_<版本>_darwin_amd64.zip |
| Windows x64 | freetier2api_<版本>_windows_amd64.zip |
checksums.txt 可用于核对归档完整性;配置与账号导入见仓库 README。
本版要点
feat: Qoder 模型 ID 规范化为 display_name slug,提升至 0.1.8
模型 ID 与别名
- Qoder 国内版/国际版的对外模型 ID 改为上游 display_name 的规范化形式
(小写、空白折叠为 "-"):DeepSeek-V4-Pro -> deepseek-v4-pro、
GLM-5.3 -> glm-5.3、Qwen3.8-Max -> qwen3.8-max。 - slug -> 上游 key 的对应关系不写死在代码里:每次拿到上游 model/list
就在 adapter 实例内重建索引(国内版/国际版各自独立),出站时精确还原
为 model_config.key / x-model-key。旧上游 key 仍可直接请求。 - 移除 Qoder 内置兜底模型清单:写死的目录会随上游过时,探测失败改为
返回错误,由宿主跳过该凭证。
陈旧键不再误伤新模型
- 供应商换掉对外 ID 后,state.json 里按旧 ID 保存的别名与禁用项会失效。
此前它们会让请求被翻回旧 ID 再撞上禁用,报
「model is disabled by plugin configuration」——而列表里该模型是启用的。 - 现在别名与禁用判定都先对照当前清单:只对真实存在的模型 ID 生效。
刻意不删除状态里的旧键——清单可能因探测失败暂时拿不到,删除会让用户
配置永久丢失;清单恢复后旧键自动重新生效。
管理面韧性
- 额度批量查询改到后台作用域并做单轮 singleflight:页面刷新取消管理 RPC
时不再中断整轮查询,账号不会卡在「查询中…」。 - 模型清单在缓存为空时按供应商补探测(singleflight + 冷却),
控制台不再出现「整家供应商缺模型」,前端最多轮询两轮等待补齐。
文档
- README 重排:安装提前到供应商表之后,添加账号合并为一张凭证字段总表,
删除重复章节,已知限制每条压缩为一句话。
Co-Authored-By: Claude Code noreply@anthropic.com
Full Changelog: v0.1.7...v0.1.8