v0.3.9：统一默认免冷却策略与误冷却修复

本版修复 Claude Code 等客户端的 Token 计数请求失败后，连带使可用账号/模型进入冷却的问题，并统一插件的默认错误处理策略。

• 计数端点兼容：未实现的 count_tokens 端点改为返回 404，避免触发原版 CPA 的普通服务错误冷却。针对 #14；Token 计数/本地估算功能仍未实现。
• 默认免新增冷却：普通服务、网络、协议、插件生命周期和未知故障默认不新增账号/模型冷却；明确的鉴权、套餐额度、团队限流及模型能力故障继续保留对应保护。
• 修复四类误冷却：覆盖流内 400/422 参数错误、普通 HTML/plain 路由 404、明确的 Cloudflare challenge 403，以及出口池关闭/插件热替换期间的 503。使用插件出口池时，明确挑战只冷却相应出口组。
• 请求与重试分开处理：确定的参数、上下文及大小限制错误结束当前请求；普通故障仍受重试预算限制，已输出的内容不自动重放。
• 保留显式设置：已有统一错误规则优先，原有配置与额度、团队、出口保护继续保留。

已通过插件回归与原版 CPA v8.0.13 的 26 次错误边界重放，并核对 v8.0.29 对应源码路径。原版字符串流接口仍会丢失强制冷却的具体状态与重试时间，最终时长以宿主实际结果为准；详见 CPA 兼容性说明。

提供 Linux / macOS 的 amd64、arm64 及 Windows amd64 插件安装包，并附 checksums.txt。

v0.3.8 · DeepSeek 1017 默认映射与供应商路由修复

本版新增 DeepSeek V4.1 Flash 1017 的首次安装默认映射，并修复供应商路由参数转发。

• 1017 默认映射：首次安装默认包含 deepseek-v4.1-flash-1017 → cline-pass/deepseek-v4.1-flash-1017，上游默认仅填 deepseek。
• 供应商路由修复：统一顶层 provider 与 providerOptions.gateway 的 only / order 字段，继续遵循配置优先或客户端优先策略；探测可钉上游时清除已有钉选，避免影响候选结果。修复 #12。
• 公告展示：顶部新增 1017 模型上线提醒，保留历史公告；正文独立滚动，标题和底部按钮保持可见，兼容浅色、深色及手机布局。

老用户请注意：1017 在 Cline 侧与老模型使用不同的模型名，需要自行添加新映射。升级保留已有模型列表及显式清空设置。模型候选继续直接读取 Cline 上游目录。

提供 Linux / macOS 的 amd64、arm64 及 Windows amd64 安装包，并附 checksums.txt。

v0.3.7 · 日志可靠性、流式稳定性与标准配额查询

ClinePassBridge v0.3.7

本次整合近期本地修复与 PR #11，改善请求日志持久化、流式调用、账号用量采样与管理页操作，并接入 CPA 标准配额查询。

更新内容

• 标准配额查询：第三方管理端可以通过 CPA 公开配额接口读取 Cline Pass 套餐、5 小时及每周等上游报告的额度窗口。复用现有查询缓存，手动停用和额度暂停账号仍可查询；上游失败或全部窗口缺少有效用量时返回错误。上游暂不支持重置额度。
• 请求日志持久化：改用逐条追加日志与快照重放，减少每次请求重写完整历史的开销；修复写入故障下的内存积压，支持存储恢复后从保留的日志生成一致快照。
• 流式稳定性与内存开销：修复下游发送阻塞时的超时和插件关闭滞留；流式内容与工具参数聚合使用缓冲区，减少长输出的重复分配。
• 凭据与用量采样：修复凭据删除与监听回写竞态，阻止迟到数据恢复已删除账号；保存凭据时保留宿主最新扩展字段。同账号某个 Key 失效时，后台采样可以继续尝试其他 Key，并保留各自退避状态。
• 管理页操作：钉上游策略与白名单自动保存，保存失败保留输入并支持重试；优化白名单布局。公告关闭状态在刷新和升级后继续保留，仅在明确发布新公告批次时重新提示。
• CI 测试同步：流式日志断言等待请求收尾，后台采样断言等待查询完成，修正 Windows 检查中暴露的等待时序问题。

下载与安装

按运行 CPA 的系统和架构选择 ZIP，并使用同页的 checksums.txt 校验 SHA-256：

平台	文件
Linux x64	clinepassbridge_0.3.7_linux_amd64.zip
Linux ARM64	clinepassbridge_0.3.7_linux_arm64.zip
macOS Intel	clinepassbridge_0.3.7_darwin_amd64.zip
macOS Apple Silicon	clinepassbridge_0.3.7_darwin_arm64.zip
Windows x64	clinepassbridge_0.3.7_windows_amd64.zip

适用于支持动态库插件的原版 CPA，可通过插件管理页升级。标准配额接口已按 CPA v8.0.31 的公开契约对接。升级请保留凭据、插件设置与持久化数据目录；已有 requests.json 会在加载时兼容读取，新的日志写入追加日志与快照文件。安装说明见 README。

v0.3.6 · 响应上限设置、更新公告与模型注册修复

ClinePassBridge v0.3.6

本次更新提高长输出的默认响应上限，增加可编辑设置与更新公告，并包含已合并的 PR #9：修复账号全部禁用后模型仍被静态注册的问题。

升级后请检查这两项设置

1. 强烈建议关闭「流式卡住时提前截流」并保存。 此功能有小概率提前截流，导致 502 错误。它原本是为前几天频繁出现的 Cline 流式卡住问题设计的，目前 Cline 那边已无此问题，就没有必要继续开启。此功能上线时默认开启，目前已默认关闭；升级会保留原有设置，老用户需要手动关闭。
2. 将「最大响应大小」调整为 64 MiB 并保存。 此前 max_response_bytes 默认只有 16 MiB，长思维链或工具调用输出可能在后期触及累计上限，出现 413 截断。新装默认已提高至 64 MiB；旧用户请前往「配置概览 → 请求与日志设置」手动调整。

更新内容

• 响应上限可视化配置：新增「最大响应大小（MiB）」设置，支持 0.0625–64 MiB，以整数字节保存。新装及缺少该字段的配置默认采用 64 MiB，已保存的配置保留。此上限统计单次上游响应累计字节，包含思考、正文、工具参数和 SSE 包装。
• 按版本显示更新公告：管理页首次读取新版本时自动弹出公告；关闭后，同一浏览器、同一服务路径下的该版本不再自动提示。插件名右侧新增小铃铛，可随时重看公告，并一键前往配置概览。
• 修复禁用账号后的模型残留（PR #9）：移除插件额外静态注册模型的路径，模型可用性跟随 CPA 账号绑定。所有 Cline Pass 账号禁用后，对应模型从 /v1/models 移除；重新启用账号后由 CPA 恢复注册。

下载与安装

按运行 CPA 的系统和架构选择 ZIP，同页下载 checksums.txt 校验压缩包的 SHA-256：

平台	ZIP 文件
Linux x64	clinepassbridge_0.3.6_linux_amd64.zip
Linux ARM64	clinepassbridge_0.3.6_linux_arm64.zip
macOS Intel	clinepassbridge_0.3.6_darwin_amd64.zip
macOS Apple Silicon	clinepassbridge_0.3.6_darwin_arm64.zip
Windows x64	clinepassbridge_0.3.6_windows_amd64.zip

适用于支持动态库插件的原版 CPA。可通过 CPA 插件管理页升级，安装步骤见 README。升级请保留现有凭据、插件设置和持久化数据；容器部署请保留插件目录、auth-dir 和插件数据目录的挂载。

v0.3.5

ClinePassBridge v0.3.5

本次更新重点修复额度暂停期间的人工启停状态，并优化凭据管理和控制台操作。

更新内容

• 人工启停独立保存：额度耗尽自动暂停时，仍可调整人工启用或停用状态，保存及重载后继续保留。额度复查确认恢复后遵循你的选择：人工启用的账号重新参与调度，人工停用的账号继续停用；暂停期间打开开关仍需等待额度恢复。
• 停用账号也能手选测试：在管理页显式选择人工停用、仍有可用额度且具有 API key 的账号，可执行模型测试和可钉上游探测，操作后保留原启停状态。自动选择凭据仍排除人工停用账号，额度暂停账号仍受额度保护。
• 额度恢复时间更直观：凭据卡片显示预计恢复倒计时；额度暂停凭据排在其余凭据之后，并按预计恢复时间从早到晚排列。时间到达后显示“等待额度复查”，实际恢复以复查结果为准。这是列表展示顺序，实际请求调度仍由 CPA 及账号状态决定。
• 控制台操作更统一：常用按钮补充统一图标，更新操作文案时保留图标；请求日志页的刷新统一更新状态、日志和统计，并在日志、统计加载或清空统计期间禁用刷新按钮。

下载与安装

按运行 CPA 的系统和架构选择 ZIP，同页下载 checksums.txt 校验压缩包的 SHA-256：

平台	ZIP 文件
Linux x64	clinepassbridge_0.3.5_linux_amd64.zip
Linux ARM64	clinepassbridge_0.3.5_linux_arm64.zip
macOS Intel	clinepassbridge_0.3.5_darwin_amd64.zip
macOS Apple Silicon	clinepassbridge_0.3.5_darwin_arm64.zip
Windows x64	clinepassbridge_0.3.5_windows_amd64.zip

适用于支持动态库插件的原版 CPA。可通过 CPA 插件管理页升级，安装步骤见 README。升级前备份现有凭据与插件数据；容器部署请保留插件目录、auth-dir 和插件数据目录的持久化挂载。

v0.3.4 · 默认关闭提前截流与可选 Debug 诊断

流式回复中的正常长暂停也可能触发提前截流。本版将「启用提前截流」改为默认关闭，需要时可在配置概览中手动开启；开启后的默认等待时间为20秒。

我发现在我朋友使用时会出现莫名其妙的流截断，在我关掉“流式卡住时提前截流”功能后就不会截断了，也没遇见前几次说的那个litellm报错。我感到非常诡异，我自己使用时不会出此问题。排查了半天也没解决。给astra许愿也没解决😂
如果有同款问题的佬欢迎开issue！非常感谢
目前建议佬们先关闭“流式卡住时提前截流”。因为这功能用处不大了，cline那边现在不会频繁报错了

请求处理

• 修复下游发送阻塞被计入上游卡流时间的问题，保留请求总时长限制。
• 新增更多上游故障类型的针对性处理，减少请求故障造成的误冷却。
• 响应大小超限单独分类，避免同一请求反复换账号。

管理界面

• 新增默认关闭的Debug诊断开关。开启时记录并显示流式时序、输出类型和下游发送耗时；关闭时停止新增诊断并隐藏历史诊断。
• 额度耗尽并自动暂停的凭据默认折叠，窄条保留账号信息及额度；点击可展开，再点右上角小箭头可收起。

升级说明

• 已保存的提前截流开关和自定义秒数保持不变；仅新装或缺少该字段时采用默认关闭。
• 提前截流和Debug诊断是独立开关；关闭提前截流后，请求总时长上限仍有效。
• Debug不保存对话、思考正文或工具参数；关闭期间没有采集的诊断不会补算。
• 保留并备份CPA凭据目录、插件目录和插件数据目录后更新。正常模型或工具调用指令生成中的长暂停也可能超过所设阈值，请按实际情况启用提前截流。

提供Linux amd64/arm64、macOS Intel/Apple Silicon、Windows amd64插件包及SHA-256校验清单。

v0.3.3 · 修复响应截断与闲置截流误冷却

修复

• 修复指定 Fireworks/LiteLLM 响应截断和插件主动闲置截流导致 CPA 凭据或模型误冷却的问题，兼容原版 CPA，无需宿主补丁。
• 覆盖流内错误、首段输出前及非流式聚合。仍记录请求失败并向客户端报错，保留已有冷却、套餐额度保护及其他错误处理；关闭「重试兼容」也保留这两类故障的免冷却兼容。

兼容说明

Astra大人用小邪道绕开了cpa冷却凭据的限制。现在再也不需要宿主补丁了！
两类指定故障通过原版 CPA 的传输错误识别处理，客户端错误默认按 500 封装，插件日志仍保留 502；已开始的 HTTP 200 保持，以 SSE 错误结束。首段输出前及非流式聚合的这两类错误不再匹配自定义 500/502 冷却规则；其他错误仍按原规则处理。CPA 与客户端分别按各自配置决定重试。

提供 Linux amd64/arm64、macOS amd64/arm64、Windows amd64 五平台插件包及 SHA-256 校验清单。

v0.3.2 · 流式卡住时提前截流

ClinePassBridge v0.3.2

新增「流式卡住时提前截流」，及时结束已开始输出但持续停顿的请求，交由客户端按自身策略重试。

• 此版本用于对抗 openai_compatible_private 供应商近日频繁出现的 Litellm 网关报错。这种报错 dsh 不会自动重试，还会在思维链里卡住长达一分钟，简直是傻逼😡令我非常红温。插件优化了出现此报错时的用户体验，通过改错误码和删报错体里的"400"字样让dsh自动重试，并新增了流卡住自动截断功能。这样每次出现此报错也能接上了，舒服不少

• 独立设置栏目：「配置概览」右侧独立展示「重试兼容」，下方新增「流式卡住时提前截流」；各自提供开关

• 默认开启、阈值可调：截流默认等待 10 秒，可调整为整数 1–1800 秒。旧配置缺少字段时沿用默认值。

• 按有效输出计时：从首段有效输出后开始计时，思考、正文及工具内容增量重置计时，心跳、role 和空帧不重置。

• 便于dsh客户端重试：重试兼容清理指定 LiteLLM 截断报错中的嵌套 400；截流报告明确的失败，日志显示「卡住截流」。是否重试及次数由客户端配置决定。

使用原版 CPA：安装对应平台的插件即可使用上述功能。插件记录截流为 502；原版 CPA 的流错误接口可能按 500 处理，已开始的 SSE 保持 HTTP 200 并以错误帧结束。非流式聚合请求返回 HTTP 502。账号和模型冷却由 CPA 的现有规则处理，插件不保证这些错误免冷却。

• 刚开始我的AI给我写了个cpa补丁包，来修那个cpa按500处理的问题和cpa误冷却账号的问题。但没有太大必要。我过几天给cpa提个issue看看能不能直接让cpa修。我当时没有仔细检查所以补丁包带在了release里面，现已删除

安装：通过 CPA 插件市场安装，或下载对应系统与架构的 ZIP。提供 Linux amd64 / arm64、macOS Intel / Apple Silicon、Windows amd64 共五个平台插件包，以及 checksums.txt。

v0.3.1 · 修复网络误冷却与重试兼容开关

ClinePassBridge v0.3.1 修复响应截断与网络回调错误的分类丢失，并新增默认开启的「重试兼容」开关。

• 在「配置概览 → 请求与日志设置」右侧新增「重试兼容」开关和圈 i 说明。保存后生效，旧配置默认开启，明确关闭后重启保留。
• 开启时，指定 Fireworks/LiteLLM 响应截断返回干净的 502，避免嵌套 TransferEncodingError: 400 让原版 DSH 等客户端停止重试；关闭后返回原始报错。完整异常始终保留在请求日志中，重试次数由客户端控制。
• 网络回调保留连接重置、DNS/TLS 故障、网络超时、取消与截止时间分类；输出前后均保留请求级语义，配套宿主默认免账号和模型冷却。真实上游 HTTP 认证、额度、限流及普通 5xx 保留原处理；明确配置的冷却规则仍优先。
• 账号卡片显示具体模型冷却范围；日志记录失败阶段、有效输出和宿主兼容情况，区分「未报告用量」与明确的零用量。

**宿主兼容：**完整免冷却和网络错误分类需要 CPA 宿主扩展。附带的 clinepassbridge_0.3.1_cpa_compatibility.zip 包含基于官方 CPA v8.0.13（d7914afd）的源码补丁、测试和构建说明。仅更新插件不会自动更新 CPA；旧宿主保留降级路径。配套补丁不包含独立的 payload 定制。详细说明。

安装插件请选择对应系统和架构的 ZIP：Linux amd64 / arm64、macOS Intel / Apple Silicon、Windows amd64。全部 ZIP 的 SHA-256 见 checksums.txt。

验证：插件 Go 测试、管理页 JavaScript 测试、配套 CPA 干净基线应用/测试/Linux 构建，以及合成 HTTPS 上游通过 CPA + 动态库的联调通过；验证了兼容功能开启/关闭、输出前后网络故障免冷却及真实 HTTP 401 状态保留。桌面原版 DSH 的实际交互可在升级后验收。

v0.3.0 · 统一凭据管理与实验性代理池

ClinePassBridge v0.3.0

这次更新将账号、模型和代理出口分开管理，加入统一错误规则和额度耗尽自动暂停，让多账号使用更直观。以下为自 v0.2.15 以来的主要变化。

管理更顺手

• 独立管理页：新增「凭据管理」「模型映射」「代理池」标签。账号用量、状态和启停集中在凭据页，模型名称、映射及思考强度集中在模型页，「钉上游」继续用于选择和测试上游。
• 账号状态更清楚：展示参与调度、人工停用、冷却、额度自动暂停和复查时间；可直接切换启停、刷新用量、清除冷却。
• 统一错误规则：在凭据页按状态码、文本或正则设置错误处理，选择停止、继续尝试及是否冷却。支持调整顺序、恢复默认、保存后同步所有账号和失败重试；新账号自动沿用，重启后保留。常见错误和处理动作配有中文说明。
• 日志更紧凑：调整列宽和窄屏布局，在更多窗口宽度下保持清晰的一行展示，长模型名称按空间收起。

自动额度暂停

额度保护始终开启：五小时、周或月任一窗口耗尽，或上游明确返回额度耗尽，就自动暂停对应账号。新的成功用量查询确认额度恢复后，才解除暂停；到达重置时间只触发复查。已确认属于同一真实账号的多个 API key 共享额度状态。

人工停用和自动暂停分开保存。停用账号仍可查询用量，额度恢复后保留人工停用选择。更换 API key 后会清除旧账号的自动额度状态。

实验性通用代理池

代理池为实验性功能，默认关闭。 支持标准 HTTP、HTTPS、SOCKS5、SOCKS5h 代理和显式直连出口，可接入 Resin 或其他标准代理服务。

• 管理多个出口，按实际出口 IP 分组，共享每 60 秒请求数和并发上限，查看当前占用与冷却状态。
• 账号独立代理优先，其余请求轮选启用的出口。用量查询、上游探测和模型测试也支持凭据独立代理及代理池。
• 容量不足时按设置排队，超时返回限流错误；流式请求结束或关闭后释放并发名额。
• 关闭代理池时，普通模型请求沿用 CPA 原有代理设置。配置方法见「代理池」页的使用指南。

修复与升级说明

• 修复额度暂停后账号开关仍显示启用，以及刷新时旧状态覆盖最新状态的问题。
• 改进凭据保存与后台刷新，保留人工编辑、最新额度状态及其他凭据字段，减少旧数据覆盖新设置的问题。
• 直接安装到支持兼容插件接口的官方 CPA 即可，无需新增宿主补丁。
• 升级前备份凭据目录和插件数据目录。已有 API key、模型映射、设置与累计统计继续保留；统一错误规则及代理池配置也保存在插件数据目录。

安装包

在 CPA 插件市场更新，或选择与 CPA 运行系统和架构一致的 ZIP 包：

平台	安装包
Linux amd64	clinepassbridge_0.3.0_linux_amd64.zip
Linux arm64	clinepassbridge_0.3.0_linux_arm64.zip
macOS Intel	clinepassbridge_0.3.0_darwin_amd64.zip
macOS Apple Silicon	clinepassbridge_0.3.0_darwin_arm64.zip
Windows amd64	clinepassbridge_0.3.0_windows_amd64.zip

发布附件同时提供 checksums.txt，可用于校验下载文件。