v0.2.4

CommandCode Provider v0.2.4

修复月度额度新增可选字段的异常解析，保留可信的余额、窗口和订阅状态。
保持 KISS：生产代码仅局部调整 quota，不修改 CPA 核心、Observer、UI、配置或依赖。

修复

• monthlyCreditsGranted 类型错误、溢出或负数只禁止月度进度，不再丢失合法余额和五小时/周窗口，也不以静态基准掩盖非法授额。
• quantity 类型错误不再抹掉套餐、账期或 past_due；非法席位只影响需要席位计算的团队基准，有效授额与个人套餐不受无关错误影响。
• 保留席位原有规则：缺失/null 或有限值小于 1 按单席处理；非法类型与溢出不冒充缺失。授额与席位各自局部解码，不引入通用解析层。
• 响应实际提供非空 cancelAt 或 pendingPhase 时，只省略月度重置日期；月度比例、来源、余额及五小时/周窗口保持不变。未返回这些状态字段时维持既有日期路径，不新增探测或轮询。
• 核心余额仍严格校验并 fail-fast；配额查询保持两个只读 GET、所选凭据作用域及既有超时。

升级与验证

• 保留现有配置和凭据，替换对应平台插件并重启 CPA 后刷新额度；无需重新导入凭据或删除数据库，本版不迁移 Observer 数据库。
• 配套 Observer 继续使用 v0.5.4，无需重复升级。
• 已确认反例、完整 Go 单测/vet/race、Node 62/62、发布资产测试及实际 CPA v8.0.23 隔离集成均通过。
• 候选原生库与正式 Observer 联调覆盖 CLI/Provider、三协议、流式/非流式、额度和重启幂等；缓存比例及动态成本保持正确。
• 所有验证使用合成凭据和回环 mock，未使用真实账号；公开 Web 字段不等于每个 /alpha 账号都会返回这些可选字段。

v0.2.3

CommandCode Provider v0.2.3

增加月度额度进度条和真实账期重置日期，保留既有五小时、每周窗口及信用余额。
不修改 CPA 核心、凭据模式、配置格式或调度逻辑，不增加依赖。

月度额度

• 配额 API 增加可选 monthly bucket，自带中文界面显示“月度额度”，CPA 原生配额卡片也可显示月度进度。
• 总额优先按可用本期授额 monthlyCreditsGranted 与官方套餐基准确定；没有授额时仅对已知套餐使用带日期、来源明确的官方基准快照。
• 剩余月余额不再被误当作总额：剩余比例为 monthlyCredits / total；团队按官方规则处理席位，不把充值或免费余额混入月 cap。
• 来源说明明确区分 API 本期授额与官网套餐基准。未知套餐且无可信授额、余额缺失、非法授额、欠费状态或总额溢出时，不伪造月度进度。
• 重置时间来自订阅账期结束时间，不猜测固定自然月；非法或不可表示的日期不影响其他有效窗口。
• 保持按所选凭据进行两个只读请求、短超时、无自动轮询、无上游额度重置、无密钥浏览器持久化。

升级与验证

• 保留现有配置与凭据，无须重新导入。升级后点击“刷新额度”。
• Go 单测/vet/race、Node UI、原生构建、CPA v8.0.23 隔离集成与 Chromium 回归均使用合成凭据、本地 mock。
• 官网 Web 与插件 CLI 接口路径不同，未使用真实 key 验证账号响应。官网基准为 2026-10-14 的公开快照，不冒充实时账号上限。
• CommandCode 缓存读占比及非零成本核算需配套 Observer v0.5.4；这是 Observer 侧的独立修复。

v0.2.2

CommandCode Provider v0.2.2

本次修复审查确认的协议、流生命周期与管理界面问题。不修改 CPA 核心、凭据模式、配置格式或调度逻辑，不增加依赖。

修复

• 跨协议转换前识别 Responses 的明确失败、取消及非终态状态，返回固定脱敏 502，不再把它们包装为成功回答。原生同协议 Responses 仍按既有契约透传。
• SSE 支持 LF、CRLF、单 CR 及分块换行，剥离流首 UTF-8 BOM，不吞首帧；拒绝非对象 JSON data。
• finish_reason 后仍检查 EOF 尾帧完整性，截断的 usage 帧不再被忽略；合法 finish_reason 加干净 EOF、缺少 [DONE] 的成功契约保持不变。
• quiesce/shutdown、下游发送失败或取消以明确错误关闭流；上游已经标记完成、但下游终态尚未送达的窗口也不会误报成功。Provider 与 CLI worker 均有回归覆盖。
• 拒绝尾随 ? 的 base-url，避免把上游 endpoint 拼入 query。
• 管理界面的非法 JSON、异常 keys 响应及 null/false/0 显示固定本地错误并保留旧列表，不再误报空目录；合法 files: [] 仍正常显示为空。

升级

• 在插件商店刷新并升级到 v0.2.2，保留既有配置与凭据，无须重新导入或修改 CPA。
• 每凭据 cli/provider 模式、CPA 选凭据与重试职责、无密钥浏览器持久化约束保持不变。

验证与边界

• Go test/vet/race、原生构建、58 项 Node UI 测试、静态及打包安全检查通过。
• CPA v8.0.23/v8.0.24 真实宿主使用本地合成上游的集成测试通过；v8.0.15 不支持所需 schema 6，不在支持范围。
• 13 项既有 Chromium 检查通过，另与 OpenCode Provider 合计完成 36 个 keys 异常响应及刷新保留案例。
• 发布工作流对准确 tag 重新验证，并构建 linux/amd64、linux/arm64、macOS/arm64 安装包及 checksums.txt。
• 所有运行时验证只使用合成凭据、loopback 服务与隔离浏览器上下文，不代表对真实 CommandCode 套餐、缓存或扣费行为的验收。

v0.2.1

CommandCode Provider v0.2.1

本次只优化插件管理界面，不修改 CPA 核心、传输协议、凭据模式或调度逻辑，不增加运行时依赖。

界面优化

• 原生选择框继续作为值、选项和 change 事件的单一来源，新增 CPA 风格浮层菜单，支持方向键、Home/End、Enter/Space、Escape、Tab 与标签聚焦。
• 模式导入、每凭据模式及手动模型协议使用统一下拉；打开或高亮选项不会发起写入或上游探测。
• 常规控件收紧到 34px、凭据行控件到 28px；粗指针设备保留 44px 触控目标。
• 对齐 CPA 的浅色、纯白和深色主题、卡片间距与菜单圆角；移动端表格在容器内滚动，不产生整页横向溢出。
• 长 iframe 菜单按宿主可见视口定位，点击宿主外部区域可关闭；重复刷新凭据列表不会残留旧菜单或触发器。

保持不变

• 保存每凭据模式仍执行 PATCH 后 GET 回读确认；写入失败或无法确认生效时保留选择草稿，不误报成功。
• 密钥只用于当前输入及 Authorization 请求头，不写浏览器存储或 URL。
• 安装源、插件 ID、配置与凭据格式不变。可直接从插件商店升级至 v0.2.1，无须重新导入凭据。

验证

• Go test/vet/race、原生构建、55 项 Node UI 测试及 CPA v8.0.23 本地假上游集成测试通过。
• 13 项真实 Chromium 检查覆盖三主题 × 1280/768/390px、键盘操作、重复重载、模式回读与失败草稿、触控目标、CSP 和密钥保护。
• 发布流程对准确 tag 重新验证，并构建 linux/amd64、linux/arm64、macOS/arm64 安装包与 checksums.txt。
• 全部运行时验证只使用合成凭据与 loopback 服务；不代表对真实服务套餐或扣费行为的验收。

v0.2.0

CommandCode Provider v0.2.0

新增每凭据独立传输模式：同一个 CPA 凭据池可以混用 cli 与 provider。仅修改插件，不修改 CPA 核心，也不增加独立调度器。

新增与修复

• 物理 auth JSON 支持根级 mode: "cli" 或 "provider"；执行和模型发现按所选凭据解析模式，并绑定当前请求快照，不改变共享配置。
• 导入表单支持选择模式，凭据列表支持逐条修改模式并重新读取确认；新增 PATCH /keys，只改 mode，保留原凭据字段、未知 JSON 字段及精确数字。
• GET /keys 增加 mode、mode_source 与 mode_error；settings 增加 default_mode、mode_scope: "auth" 及两种目录状态。
• 手动模型元数据由两种模式共享，但按实际凭据模式判定资格；Provider-only 与 CLI-only 模型仅由对应凭据执行，避免模型发布与实际路由不一致。
• 严格拒绝非法、null、重复、未知或大小写变体管理字段及尾随 JSON；外来凭据不能通过此插件修改，错误不回显凭据。
• 保存后未确认、目标消失或读取失败时，管理页保留原列表与选择，不把“已提交”误报为“已生效”。

升级与兼容

1. 在 CPA 插件商店刷新源并升级到 v0.2.0；源地址和插件 ID 不变。
2. 保留现有配置与凭据，无须重新导入。没有根级 mode 的旧记录继续采用 YAML mode（缺省 cli）。
3. YAML mode 现在仅是旧记录及未传模式导入请求的默认值，不覆盖已有显式配置；需批量改模式时，应逐条更新凭据。
4. 管理页导入下拉默认选 CLI，显式提交本次选择；重复导入仍 skipped，不修改既有凭据模式。

插件不检测套餐，也不因 403 upgrade_required 或其他错误自动切换模式。Go 套餐仍没有 Provider API 权限，应由管理员显式选用适合该凭据的模式。

验证与限制

• Go test/vet/race、54 项 UI 测试、23 项资产校验及打包检查。
• CPA v8.0.23 + 本地合成上游：27 项顶层集成测试，包含三协议/两模式矩阵、混合池、专属模型、热修改及重启持久化、非法模式零上游调用与外来凭据隔离。
• 新增每凭据模式集成测试连续重复 5 轮通过；热改后、执行后及重启后均检查精确 JSON 整数 9007199254740993 保留。
• 发布流程对准确 tag 重新验证，原生构建 linux/amd64、linux/arm64、macOS/arm64，并提供 checksums.txt。
• 全部运行时验收使用合成凭据与 loopback 上游；未验证真实服务的套餐、缓存命中率或扣费。CPA 原生 ABI 与 Observer 未定价限制保持不变。

v0.1.1

CommandCode Provider v0.1.1

修复 v0.1.0 经 CPA 插件商店安装后“已配置、已启用，但未注册、未生效”的问题。仅修改插件，不修改 CPA 核心。

修复

• 接受并忽略 CPA 在生命周期配置中透传的 store 元数据，避免 plugin.register / plugin.reconfigure 返回 invalid config yaml。
• 保持业务配置严格校验：未知顶层字段仍拒绝，商店版本、来源及扩展元数据不影响传输模式或上游地址。
• 添加商店注册与配置热重载回归测试；全部真实宿主测试使用版本化动态库文件名及商店配置形状。

升级

• 刷新 CPA 插件商店，升级或重新安装 v0.1.1。保留现有插件设置与凭据，无须删除 store 或修改 CPA。
• 若此前为临时恢复删除了 store，通过商店安装 v0.1.1，让 CPA 重建新版本元数据；不要原样恢复指向 v0.1.0 的旧元数据。
• registry.json 源地址不变，继续跟随最新正式 Release。

验证与限制

• Go test/vet/race、42 项 UI 测试、23 项资产校验测试及打包检查。
• CPA v8.0.23 + 本地合成上游：21 项顶层集成测试，涵盖商店注册、配置热重载及既有三协议/两模式/流式与非流式链路。
• 发布流程对准确 tag 重新执行验证，并构建 linux/amd64、linux/arm64、macOS/arm64 原生资产与 checksums.txt。
• 未调用真实上游，未使用真实凭据；套餐权限、配额、缓存、费用及 ABI 限制与 v0.1.0 相同。

v0.1.0

CommandCode Provider v0.1.0

CLIProxyAPI v8 原生 CommandCode provider 首版。首批验证宿主为 CPA v8.0.23，CLI 兼容性基线为 1.79.2；不 fork、不修改 CPA 核心。

功能

• 显式 cli（默认 /alpha/generate）与 provider（/provider/v1）双模式，不自动降级或切换。
• OpenAI Chat、Anthropic Messages、OpenAI Responses 三协议流式与非流式；text、inline image、function tools、reasoning 及 usage 投影。
• 宿主选凭据/亲和/冷却/故障转移；UUIDv5 按选定 AuthID 与 canonical session 隔离上游 thread，无插件侧影子调度器。
• CLI wire header profile、ZDR opt-in、合成 workspace、pause_turn 续跑及累计 usage。
• 中文同源管理 UI、密钥导入/列表/删除、手动模型配置、单凭据只读配额。
• 三平台原生 ZIP、checksums.txt，发布前校验版本、提交、SDK、动态库架构与归档内容。

验证

• Go test/vet/race、UI 42 项测试、交付与资产校验测试。
• CPA v8.0.23 + 本地 loopback 合成上游：20 项顶层测试、36 单元协议矩阵，另含亲和/故障转移/配额/UTF-8/截断/取消/关停。
• 发布流程重新对准确 tag 执行验证，随后在 linux/amd64、linux/arm64、macOS/arm64 原生 runner 构建。

使用与限制

• 推荐通过本仓库 registry.json 自定义源安装；详见 README。Linux 产物依赖 glibc，不支持 musl/Alpine。
• Go 套餐没有 Provider API 权限，应显式使用 CLI 模式；不会通过自动降级隐藏 403 upgrade_required。
• 全部上游验收为合成数据；未使用真实凭据、未调用真实推理/billing，真实 workspace 接受性、配额 schema、缓存效果与扣费未验收。
• 原生 ABI 无法无损传递 Retry-After/Retryable，以及已输出内容后的流式错误状态码。
• Observer v0.4.4 尚不支持 CommandCode 精确 cohort，非零费用仍为未定价；不猜测可定价分区。
• CLI transport 不是官方支持的第三方 API。使用前确认条款/授权，只使用有权使用的凭据；不分发官方 CLI 源码或系统提示词。