ClinePassBridge

本项目是 CLIProxyAPI（CPA） 的插件，带一个网页管理界面。在界面内添加 Cline Pass API key 和模型后，就可以通过 CPA 发起请求。

• 管理多个账号：查看套餐用量、调整调度优先级、开关账号调度。额度用完自动暂停，额度恢复自动恢复。
• 映射模型：自定义模型名映射，避免客户端手敲 cline-pass/ 前缀。还能映射思考强度。
• 钉上游：当账号是可钉账号（即供应商不锁死在 openai_compatible_private 的账号）时，可以固定指定上游 provider，不让 Cline 替你选择。
• 查看请求情况：记录日志，显示上游、首字耗时、输出速度和缓存命中率。
• 调整请求行为：统一设置错误规则、提前截断流式卡住的请求。还提供实验性代理池，按需开启。

需要支持动态库插件和 JSON ABI v1 的原版 CPA。已核对 v8.0.13、v8.0.29 的相关接口与错误处理路径，具体范围见 CPA 兼容性。先在 CPA 配置里启用插件：

plugins:
  enabled: true
  dir: plugins

1. 在 CPA 插件市场的 CLIProxyAPI源（官方源） 中安装 ClinePassBridge。
2. 打开管理页 /v0/resource/plugins/clinepassbridge/console，在「凭据管理」中添加 Cline Pass API key。
3. 进入「模型映射」，点击「添加模型 → 获取上游模型」，勾选要用的模型。
4. 在客户端填入 CPA 的 API 地址和 CPA 的客户端 API key，选择刚添加的模型即可。

首次安装已默认添加 deepseek-v4.1-flash-1017 → cline-pass/deepseek-v4.1-flash-1017 映射，上游默认只钉 deepseek。其他模型按第 3 步添加，导入时客户端模型名默认去掉 cline-pass/ 前缀。升级保留已有映射，老用户使用 1017 模型时需自行添加映射。

管理页会尝试复用 CPA / CPAMP 的登录信息。如果提示输入密钥，直连 CPA 时填 CPA 管理密钥，经 CPAMP 完整模式访问时填面板管理密钥。

也可以从 Releases 下载 ZIP 手动安装。按 运行 CPA 的系统和架构 选择：Linux / macOS 支持 amd64、arm64，Windows 支持 amd64。每次发布附带 checksums.txt。

假设你添加了这条模型映射：

向 CPA 的 /v1/chat/completions 发送请求，model 填客户端模型名称：

{
  "model": "deepseek-flash",
  "messages": [{"role": "user", "content": "你好"}],
  "stream": true
}

• 流式卡住时提前截流默认关闭。 开启后，从首段有效输出后计时，默认连续 20 秒没有新的有效输出才触发；向下游发送的耗时不计入空闲时间，不缩短首字等待。开关和时长在「配置概览」里调整，已保存的 true / false 和自定义秒数升级后继续保留。
• Debug 默认关闭。 按需开启额外流诊断；普通请求日志、错误和用量照常记录，详见 进阶配置。
• 升级前保留数据。 容器部署请持久化插件目录、CPA 的 auth-dir 和插件数据目录（默认 plugins/clinepassbridge-data），升级前备份。

更多设置和细节放在下面，遇到需要时再查：

项目使用 Go 1.26。装好 Docker 后，在仓库根目录执行：

docker build --platform linux/amd64 -f Dockerfile.build --output type=local,dest=dist .

产物是 dist/clinepassbridge.so（Linux amd64）。其他平台的构建方式见 发布工作流。

MIT License。项目独立实现，曾参考 cline-pass-switcher 的公开协议行为，未复制其代码。

LINUX DO