Skip to content

README.md

Latest commit

 

History

History
149 lines (97 loc) · 11.8 KB

README.md

File metadata and controls

149 lines (97 loc) · 11.8 KB
Raw

CommandCodeBridge

将 CommandCode Provider API 接入 CLIProxyAPI，在 CPAMP 中管理凭证、模型、额度和请求记录。

下载最新版 · 更新记录 · 部署说明

功能

  • 多凭证管理：添加 Studio API key 或通过官方网页登录授权，支持备注、优先级、停用、删除和会话重新分配。
  • 模型映射：读取官方模型目录，选择导入，设置客户端别名、协议和逐模型思考强度。
  • 协议接入：支持 Chat Completions、Responses、Anthropic Messages，包含流式响应、工具调用和图片；原生 Messages 历史保留 Claude thinking signature。
  • 原生额度窗口：在 CPAMP 列表、卡片和详情查看 5h、周、月额度，查询窗口请求统计、预测和周期快照。
  • 请求记录：查看凭证健康度、tokens、缓存用量、预估花费、首字耗时、输出速率及模型统计；支持明暗主题和手机布局。

当前版本 v0.2.14。插件调用官方 Provider API；Go 订阅的 /alpha/generate 路径和固定上游 provider 模式不在支持范围内。账户用量通过官方 /alpha/... 查询接口读取，模型权限以实际套餐为准。

v0.2.14 更新

claude-sonnet-5-5 上的 model(none) 和强制工具选择不再返回 400：插件识别这两类上游拒绝，改用最接近的可接受请求（自适应低强度思考、tool_choice: auto）重试一次，并在请求日志与控制台显示「兼容调整」。默认请求超时从 600 秒改为 1800 秒；已保存过设置的实例需在「设置 → 请求策略」手动修改。

v0.2.13 更新

Linux 包的 glibc 要求从 2.34 降至 2.28（RHEL/AlmaLinux 8、Debian 10、Ubuntu 20.04 起）；运行数据改为紧凑 JSON，并限制大文件的持续重写频率，持续流量下统计文件写盘约降为原来的 1/37；新增可选的首字节超时与流空闲超时（默认关闭，在「设置 → 请求策略」启用）。

v0.2.12 更新

修复两类会让 CPA 宿主误冷却凭证的请求：count_tokens 改为本地 404，不再在 v8.0.23 等宿主上触发随后的 503 auth_unavailable；model(high)、model(16384) 等思考后缀按宿主规则解析，不再因 404 冷却基础模型。CI 新增对应宿主联测，并每周复核最新 CPA 候选版本。

v0.2.11 更新

修复 Antigravity Gemini 5h／周额度缺失：面板对齐上游 Hub UA，构建、发布与安装增加旧 UA 拦截。升级插件后需在「设置 → CPAMP 原生面板」更新页面并强制刷新浏览器。CPAMP 源码基线统一记录在 compatibility.json。

v0.2.10 功能

新增凭证运行登记诊断、脱敏摘要和升级兼容检查。在「凭据与用量」查看登记与三类证据，在「设置」核对插件、页面和快照后端。保存成功与宿主加载分别显示；只读诊断不发模型生成请求。

五页控制台参照 CommandCode 官方公开 Studio 截图统一布局与明暗主题，加入组合搜索、证据筛选和详情抽屉。详见第三轮交付和验证记录。

模型页按凭证显示实测证据和 24 小时有效期；运行历史支持损坏隔离与检查点恢复；统计自动转为近期分钟级、历史日级，默认不删除日总量。真实 Claude／图片／thinking／ZDR 和账户身份共享按用户选择标为待验证。详见验证记录与数据恢复说明。

快速安装

需要启用插件的 CLIProxyAPI。四个平台的原生宿主联测基线为 CPA v8.0.23；名称含 no-plugin 的宿主构建不能加载本插件。

将以下源合并到现有 CPA 配置，保留已有插件源和其他配置：

plugins:
  enabled: true
  store-sources:
    - https://raw.githubusercontent.com/Gaoshou101/CommandCodeBridge/main/registry.json

保存并重载配置，在 CPAMP「插件商店」找到 CommandCodeBridge，选择 Latest 或 v0.2.14 安装。支持热升级的宿主会下载匹配平台的 ZIP、验证校验值并切换版本；安装后检查插件控制台显示的运行版本。

也可从 Releases 手动下载 ZIP 和 checksums.txt。按 CPA 所在服务器选择动态库：

平台 安装包后缀 动态库
Linux x64 _linux_amd64.zip commandcodebridge.so
Linux ARM64 _linux_arm64.zip commandcodebridge.so
Windows x64 _windows_amd64.zip commandcodebridge.dll
macOS Apple Silicon _darwin_arm64.zip commandcodebridge.dylib

Linux 发布包要求 glibc ≥2.28（v0.2.12 及更早为 ≥2.34）；Alpine/musl 需自行构建。手动安装时核验校验值，将动态库放入实际 plugins.dir，合并 config.example.yaml，按宿主的加载方式启用插件。完整步骤见部署说明。

快速开始

  1. 在 CPAMP 打开 CommandCodeBridge 插件控制台，或访问 CPA 地址下的 /v0/resource/plugins/commandcodebridge/console。直接访问时使用 CPA 管理密钥登录。
  2. 在「凭据与用量」添加 CommandCode Studio API key，点击刷新，确认套餐和真实余额。
  3. 在「模型映射」获取目录，选择当前套餐可用的模型并导入；按需要设置客户端别名。
  4. 在客户端填写 CPA API 地址、CPA 客户端密钥、已导入的模型别名，即可调用。

管理密钥、客户端密钥和 CommandCode Studio API key 分别用于管理、客户端调用和上游授权，不能互换。上游 key 由 CPA 保存到 auth-dir，无需写入模型配置。

官方网页登录入口位于 CPAMP「OAuth 登录」。远端服务器场景下，在浏览器所在电脑运行安装包里的 commandcodebridge-login（Windows 为 .exe），再完成授权并提交接收器显示的认证结果。浏览器电脑与 CPA 服务器平台不同时，接收器需另下载对应电脑平台的包。详见远程认证步骤。

安装或更新原生面板

升级插件后还要更新 CPAMP 页面，才能使用新版凭证布局。v0.2.14 动态库已内嵌匹配页面。

CPA 与 Manager Server 在同一主机直接运行时：

  1. 打开插件控制台「设置 → CPAMP 原生面板」。
  2. 首次使用点击「安装原生面板」；已有外部页面点击「更新原生面板」。
  3. 点击「检查生效状态」，再强制刷新浏览器，在凭证页点击「刷新额度」。
操作 是否需要重启
保存日常插件设置，或更新已启用外部面板的文件 无需重启
通过支持热升级的插件商店更新动态库 确认宿主已切换到新版本
首次启用外部页面，或更改 Manager Server 的页面路径 重启 Manager Server 一次
迁移插件数据目录，或旧宿主不支持动态库热升级 安排相应服务重启

Manager Server 在另一台主机或独立容器中时，在其运行环境安装 commandcodebridge_0.2.14_cpamp-web.zip 内的 management.html，通过 PANEL_PATH 或 panelPath 托管。面板源码基线见 compatibility.json 的 cpamp_source_commit；不同版本应在匹配源码上应用适配。

完整周期快照另需 Manager Server 接受 commandcode 平台。 前端包附带适配脚本、服务器名单补丁和测试；按现有 Manager Server 的同一源码版本重建并部署。仅更新插件和页面不能替代这个服务器改动。原生集成说明包含构建、HTTP 生效核验和回滚步骤。

套餐与额度

CPAMP 套餐名统一显示 Go、GOAT、Pro、Max。月额度与 5h 顶部对齐，两列之间无分割线；月额度下方显示真实剩余 credits 与月上限。

月比例优先使用上游真实窗口比例和 cap；上游未提供月窗口时，用 monthly_credits 除以已核实的套餐月上限。以下依据官方 Pricing & Limits和官方 command-code@1.81.0，核实于 2026-10-13：

套餐 原始套餐标识 月上限（credits）
Go individual-go / individual-go-v1 10
GOAT individual-goat 70
Pro individual-pro-v1 80
Pro（旧版） individual-pro 30
Max 10× individual-max 150
Max 20× individual-ultra 300

例如 GOAT 剩余 61.083 credits 时，显示 61.083 / 70 credits、剩余 87%。两种 Pro 均显示 Pro，两种 Max 均显示 Max，计算仍保留原始套餐标识。

  • 月余额不混入购买或免费 credits；Max 标准与高级模型限额独立，不相加。
  • 5h 和周比例采用真实上游数据，重置时间取真实窗口或订阅周期。缺失值显示 — 或「重置未知」。
  • 详情页的请求数、tokens、预估花费和预测来自原生窗口统计；花费为请求价格估算，不将账户 credits 当作历史美元花费。
  • 刷新失败保留上次结果并标记过期；过期比例不用于新预测。历史周期缺失时不推算上个月边界。

配置与数据

完整配置见 config.example.yaml。日常设置和模型映射可在插件控制台修改，保存后即时生效。已保存的 settings.json 通常优先于初始 YAML；显式非空的 CPAMP 路径配置按部署说明处理。

  • auth-dir：上游凭证及会话恢复副本。
  • data_dir：设置、模型映射、最近请求日志、统计数据，以及 usage.json 中的额度观察。v0.2.9 在重启和页面重新打开后恢复上次额度；凭证页每 30 秒同步服务端缓存与最近请求。额度刷新失败保留上次值和真实采集时间，更换密钥后不复用旧额度。
  • Docker 部署应持久化以上目录和插件目录，并使用容器内路径。
  • 出站网络复用 CPA 的全局代理；当前宿主通用 HTTP RPC 不支持凭据级代理。
  • 同账号多个 key 共享额度及账号／模型冷却，额度不相加。

开发与验证

原生插件构建需要 Go ≥1.26、CGO 和目标平台 C 编译器。发行构建先生成 pinned CPAMP 页面，再内嵌到四个平台的动态库。

控制台脚本与样式（internal/bridge/ui/console.js、console.css）以格式化后的源码原样内嵌；修改后运行 npx prettier@3.7.4 --write internal/bridge/ui/console.js internal/bridge/ui/console.css（配置见 .prettierrc.json），CI 会检查格式。

GitHub Actions 运行 Go race/vet、前端测试与类型检查、CPA 原生协议及异常恢复联测、CPAMP 页面安装与热更新联测，并校验四平台插件和独立前端包的来源、校验值及内嵌页面一致性。具体步骤与验证边界见以下文档。

文档 内容
部署说明 商店／手动安装、路径、升级、热更新和回滚
CPAMP 原生集成 页面构建、Manager 快照补丁、OAuth 和实际页面核验
验证记录 模拟宿主、真实接口、浏览器验证及尚未覆盖的场景
版本说明 当前发行内容与升级步骤
更新记录 各版本改动

许可

本项目按 MIT 发布，参考 ClinePassBridge。第三方来源与版权见 NOTICE。CommandCodeBridge 是独立集成项目。