cc-switch-web v0.17.0

cc-switch-web v0.17.0 发布说明

v0.17.0 是 认证中心与第三方代理增强 版本，重点补齐 GitHub Copilot、Codex OAuth 托管登录能力，并把 Claude Desktop 第三方代理配置与本地代理 token 注入逻辑对齐到已验证的 cc-switch 处理方式。

认证中心

• 新增 Auth Center，用于集中管理 GitHub Copilot 与 Codex OAuth 账号。
• 支持 GitHub Copilot 设备码登录、token 刷新、live models 拉取与 usage 查询。
• 支持 Codex OAuth 设备码登录、token 刷新、live models 拉取与 usage 查询。
• 支持导入、删除、登出、设置默认账号，并允许供应商绑定默认账号或指定账号。
• 托管认证 token 现在会加密落库，并保留旧明文 token 的读取兼容。

代理与供应商

• GitHub Copilot 与 Codex OAuth 供应商可以通过托管账号解析真实 token，再注入到实际代理请求。
• Codex OAuth 代理请求会注入 Authorization、originator 与账号相关 header，处理逻辑与上游 cc-switch 保持一致。
• Claude Desktop 第三方代理预设新增 GitHub Copilot 与 Codex OAuth 入口，写入配置时会根据托管账号状态提示可用性。
• Codex 相关 Claude Desktop 预设模型路由同步上游 cc-switch 默认配置。

Web 与桌面端

• 设置页新增 Auth Center 区块，提供设备码登录、账号列表、默认账号切换和用量查询入口。
• 供应商表单支持托管认证模式，并在 GitHub Copilot、Codex、Claude Desktop 相关配置中展示账号绑定状态。
• Web API 新增托管认证账号管理、设备码登录轮询、live models 与 usage 查询接口。
• 模型拉取接口增强，支持从托管认证账号获取凭据后查询远端模型列表。

测试与发布

• 增加认证中心、托管 token 加密、代理 token 注入、Claude Desktop 代理配置和 Web API 覆盖。
• 最终发布前已执行完整前端、Rust、Tauri 与 Web 构建验证；真实账号登录、真实 token 刷新、真实 Claude Desktop 重启验证不纳入本次自动验证范围。

cc-switch-web v0.16.1

cc-switch-web v0.16.1 发布说明

v0.16.1 是 v0.16.0 的发布流程热修版本，功能内容与 v0.16.0 保持一致，重点修复 Windows 发布打包导致的整条 Release workflow 中断问题。

发布修复

• Windows Release 构建改为只生成当前发布流程实际上传的 MSI 包。
• 避免在 MSI 已构建成功后继续下载并打包未使用的 NSIS installer，防止外部下载 504 使 Windows job 失败。
• 补齐 v0.16.x 发布说明文件，并在 Release workflow 中增加发布说明存在性检查。

影响范围

• v0.16.0 首次发布已成功上传 macOS 和 Linux 桌面产物，但 Windows、server 二进制、latest.json 与 Docker 镜像缺失。
• 建议用户直接使用 v0.16.1；v0.16.1 会重新生成完整桌面产物、server 二进制、latest.json 和 Docker 镜像。

cc-switch-web v0.15.0

cc-switch-web v0.15.0 发布说明

v0.15.0 是 Local Routing + Claude Desktop 对齐版 的正式版本，整合 v0.15.0-rc 系列测试反馈，重点补齐本地路由、Claude Desktop 对齐、用量统计可见性、Web 模式稳定性与错误反馈。

用量页修复

• 用量 Dashboard 首次打开时，如果 Today 没有请求但数据库存在历史用量，会自动切到最新用量所在的 7 天窗口。
• 自动校准按当前 App 筛选生效，切到 Codex 时会优先使用 Codex 自己的最新用量时间范围。
• 时间范围下拉增加 All time，用户可以直接查看全量卡片、趋势、日志和统计表。
• 自动校准窗口在下拉框中显示为 Recent data，用户手动选择任意时间范围后不会再被自动覆盖。
• Data sources 标题调整为 All-time data sources，明确它展示的是全量来源统计，不是当前时间范围内的统计。

接口与测试

• 新增用量数据范围接口，用于返回 firstSeenAt、lastSeenAt 和请求数量。
• Web API 新增 /api/usage/data-extent，桌面端新增 get_usage_data_extent command。
• 修复 Codex 用量同步中中文模型名可能触发 UTF-8 byte boundary panic 的问题。
• Web 模式下不存在的 /api/* 路径现在返回 JSON 404，不再被 SPA fallback 伪装成 HTML 200。
• 前端增加全局 API 失败 toast，并对断线、超时、HTML 错误响应给出更明确的错误消息。
• 用量 Dashboard 增加内联错误态，关键用量请求失败时不再静默显示为 0。
• 增加前端 range helper 与 Dashboard 自动校准测试。
• 增加 Rust 内存库单测，覆盖按 App 查询用量首末时间。
• 增加中文模型名规范化和 Web API 未匹配路由回归测试。
• 增加 API adapter 错误响应和全局 query client 错误 toast 回归测试。

说明

• Rectifier 当前仍是配置入口和体验对齐入口，不是完整的上游修复引擎。
• v0.15.0-rc.1、v0.15.0-rc.2、v0.15.0-rc.3 均为测试候选版本；正式使用建议升级到 v0.15.0。

验证

• pnpm typecheck
• pnpm vitest run tests/lib/query/queryClient.test.ts tests/lib/adapter.core.test.ts tests/components/usage/UsageDashboard.test.tsx tests/lib/usageRange.test.ts tests/lib/query/usage.test.tsx
• cargo test --manifest-path src-tauri/Cargo.toml usage_data_extent_reports_latest_data_by_app --lib
• cargo test --manifest-path src-tauri/Cargo.toml codex_model_normalization_handles_multibyte_names --lib
• cargo test --manifest-path src-tauri/Cargo.toml --no-default-features --features web-server,test-hooks --test web_auth test_missing_api_route_returns_json_404
• pnpm build:web
• git diff --check

cc-switch-web v0.15.0-rc.3

cc-switch-web v0.15.0-rc.3 预发布说明

v0.15.0-rc.3 是 Local Routing + Claude Desktop 对齐版 的有效测试候选版本，重点修复 v0.15.0-rc.2 复查中发现的安全与运行时一致性问题。

安全修复

• Claude Desktop 本地 Gateway 增加 Bearer Token 校验，未配置、缺失或错误 token 的请求会返回 401。
• Gateway token 改为安全随机生成，并使用常量时间比较。
• Claude Desktop Gateway 的本地 Authorization 头不会再转发到上游，避免泄漏本地 gateway bearer token。
• Proxy 与 WebDAV 下载路径增加响应体大小限制，避免异常大响应造成内存风险。

稳定性修复

• Proxy 配置保存后支持运行时热更新，但仅热更新超时、日志、熔断、failover、定价与 Rectifier 等无需重启监听器的字段。
• host、port、upstream proxy 与 live takeover 状态不会被普通保存错误标记为已在运行中生效。
• live takeover / restore / recover stale takeover 在完成系统配置副作用后，会单独同步运行时 takeover 状态。
• 修复旧配置缺失 Rectifier 字段时被反序列化为关闭的问题，现在保持默认启用。

Web 与构建修复

• WebDAV 设置 schema 增加前端校验，保留密码原始空格，同时规范化 URL、用户名、目录和 profile。
• 修复 web-server-only 与 desktop feature 下的测试、检查和发布构建边界。

说明

• Rectifier 当前仍是配置入口和体验对齐入口，不是完整的上游修复引擎。
• v0.15.0-rc.2 已发布但不建议作为有效测试基线；请使用 v0.15.0-rc.3 继续测试。

验证

• pnpm build:web
• pnpm typecheck
• pnpm vitest run tests/lib/schemas/settings.test.ts
• cargo fmt --manifest-path src-tauri/Cargo.toml --check
• cargo check --manifest-path src-tauri/Cargo.toml --no-default-features --features web-server --example server
• cargo check --manifest-path src-tauri/Cargo.toml --features desktop
• cargo test --manifest-path src-tauri/Cargo.toml --no-default-features --features web-server,test-hooks --lib
• cargo test --manifest-path src-tauri/Cargo.toml --no-default-features --features web-server,test-hooks --test proxy_web_api

v0.15.0-rc.2 - Local Routing + Claude Desktop 对齐版

cc-switch-web v0.15.0-rc.2 预发布说明

v0.15.0-rc.2 是 Local Routing + Claude Desktop 对齐版 的候选预发布，用于替代资产不完整的 v0.15.0-rc.1。

新增与对齐

• 新增 Local Routing 入口与配置闭环，继续向 cc-switch 的本地路由能力对齐。
• 新增 Claude Desktop 应用类型识别与配置目录入口，和 Claude Code 共享 Claude 配置目录基础能力。
• 保持 Claude Desktop 在 Prompt、MCP、Skills 与通用配置片段等未完全适配功能中的显式边界，避免误写入不支持的配置面。

修复

• 修复 v0.15.0-rc.1 发布流水线中 web-server feature 构建失败的问题。
• 补齐 web API 配置处理器中的 Claude Desktop 分支，确保 server 二进制和 latest.json 能随 Release workflow 正常生成。

说明

• Rectifier 当前是配置入口和体验对齐入口，不是完整的上游修复引擎。
• v0.15.0-rc.1 的桌面端资产已上传，但缺少 server 二进制和 latest.json，因此不建议作为有效候选版本使用。

验证

• pnpm build:web
• cargo check --manifest-path src-tauri/Cargo.toml --features web-server --example server
• pnpm typecheck

v0.15.0-rc.1 - superseded by v0.15.0-rc.2

0.15.0-rc.1 - Local Routing + Claude Desktop 对齐版

This is a pre-release for the 0.15.0 Local Routing + Claude Desktop alignment release. It focuses on the highest-impact gaps from cc-switch 3.15.0 without attempting a full upstream feature catch-up.

Highlights

• Local Routing v2

  • Unifies the local proxy/takeover surface as Local Routing.
  • Keeps web/headless-friendly start, stop, status, takeover, and restore paths.
  • Adds per-app routing settings for Claude, Codex, Gemini, and OpenCode.
  • Adds failover queue controls, max retries, streaming first-byte timeout, streaming idle timeout, and non-streaming timeout.
  • Adds configurable circuit breaker thresholds: failure threshold, recovery threshold, recovery wait, and error-rate threshold.
  • Adds proxy status details for running state, takeover apps, current providers, failover count, recent errors, and request stats.

• Claude Desktop MVP

  • Adds claude-desktop as an independent app target.
  • Supports provider CRUD/switching and importing Claude Code providers.
  • Supports direct and proxy write modes.
  • Supports role route mappings for sonnet, opus, and haiku.
  • Adds Claude Desktop-safe model catalog behavior for proxy mode.

• Usage improvements

  • Improves cache token and cache cost semantics.
  • Moves model pricing editing into a dialog.
  • Adds clearer request log data-source labels.
  • Adds direct page jump support in request logs.

• WebDAV manual sync MVP

  • Adds WebDAV settings for base URL, username, password, remote directory, and profile.
  • Supports manual snapshot upload.
  • Supports remote snapshot preview.
  • Supports manual download/apply with compatibility checks.
  • Compatibility preview reports version, schema, and artifact information.

• Provider ecosystem

  • Adds upstream-priority presets for PatewayAI, Volcengine Agentplan, BytePlus, Baidu Qianfan Coding Plan, ClaudeAPI, ClaudeCN, RunAPI, RelaxyCode, and Compshare.
  • Keeps provider preset order author-defined with partner-oriented priority.
  • Adds routing support badges on provider cards.
  • Adds duplicate provider operation support.

Important RC Note

The Rectifier settings for thinking signature and thinking budget are included as configuration entry points in this release candidate. The full upstream request-body repair engine is not included yet and should be treated as follow-up work after this RC validates the routing and Claude Desktop paths.

Validation

• pnpm typecheck
• Targeted Vitest suite: 7 files, 61 tests
• cargo check --manifest-path src-tauri/Cargo.toml --features test-hooks
• Rust lib tests: 142 tests
• cargo test --manifest-path src-tauri/Cargo.toml --features test-hooks --test app_type_parse: 7 tests

Known Scope Limits

• No Hermes Agent.
• No full OpenClaw support.
• No full Session Manager.
• No desktop tray/light mode/terminal recovery launchers.
• No full Copilot/Codex OAuth migration.
• No automatic WebDAV conflict merge.

cc-switch-web v0.14.1

cc-switch-web v0.14.1 发布说明

v0.14.1 是 v0.14 系列 Usage Dashboard 的补丁发布，重点修复自动刷新、历史 rollup 展示、request logs 分页以及模型定价匹配边界。

修复

• 修复 Usage Dashboard 自动刷新时相对时间范围不会前进的问题，1d、7d、today 等范围现在会在每次 refetch 时重新计算。
• 修复 request logs 在切换全局 App 或时间范围后仍停留旧页码的问题，避免筛选后误显示为空。
• 修复短时间范围查询只有 usage_daily_rollups 历史归档数据时趋势图为空的问题。
• 修复模型定价匹配过宽的问题，避免 gpt-4 错误匹配 gpt-4o / gpt-4.1 并导致 session import 或历史回填成本错误。
• 保留合法的命名空间模型匹配，例如 provider/custom-model:extra 仍可匹配 custom-model 定价并回填成本。

验证

• pnpm vitest run tests/lib/query/usage.test.tsx
• pnpm vitest run tests/lib/query/usage.test.tsx tests/components/usage/RequestLogTable.test.tsx
• cd src-tauri && cargo test services::usage_stats --features desktop,test-hooks
• pnpm typecheck
• git diff --check

cc-switch-web v0.14.0

cc-switch-web v0.14.0 预发布说明

v0.14.0 聚焦补齐 Usage Dashboard、request logs 与 pricing/cost 闭环。

新增

• 新增完整 Usage Dashboard，支持查看总成本、请求数、真实 token 消耗、成功率、cache hit rate 与应用维度拆分。
• 新增请求趋势图，按当前时间范围展示代理请求成本变化。
• 新增 request logs 表格，支持按 Provider、Model、状态码、时间范围筛选，并支持分页。
• 新增请求详情面板，展示单次请求的 token、成本、延迟、流式状态、错误信息与数据来源。
• 新增 Provider / Model 统计表，便于定位高成本模型、低成功率 Provider 和异常延迟。
• 新增 Dashboard 内模型定价维护，并在更新模型价格后尝试回填历史零成本代理日志。
• 新增 Claude、Codex、Gemini 本地 session log 导入，支持增量同步、跨来源去重和基于模型定价的成本计算。
• 新增桌面端 Tauri commands 与 Web/headless /api/usage/* API。

说明

• Dashboard 统计会合并实时代理请求日志、历史 daily rollups 和已导入的 Claude/Codex/Gemini session logs。
• Session log 导入会先与 proxy 日志做指纹去重，避免同一次请求重复计费。

cc-switch-web v0.13.0

cc-switch-web v0.13.0

这是 v0.13.0 正式版。此版本将 v0.13.0-preview.1 验证过的 P1/P2 功能面作为正式版本发布：OMO Slim 完整 UI、上游新版 OMO 表单、OpenCode provider preset/NPM selector/model fetch，以及 stream health check。

主要更新

• 新增 OMO Slim 专用配置 UI，支持 Slim agents、隐藏分类、顶层选项、本地导入和 Slim 专属对象字段。
• 更新标准 OMO 表单，对齐当前上游 schema，补齐新版 agents、顶层字段和结构化对象字段。
• 扩展 OpenCode provider preset，加入 NPM SDK selector、模型 URL 覆写、模型拉取和推荐模型元数据合并。
• 新增 stream health check，用于验证 Claude、Codex、Gemini、OpenCode provider 的流式响应可用性。
• 补齐 Amazon Bedrock：模型拉取使用本地 preset 导入，流式健康检查使用 Bedrock Runtime ConverseStream 和 AWS SigV4 签名。

重点验证

• OMO/OMO Slim 配置保存、导入、模型选择和生成结果。
• OpenCode provider preset 生成的 NPM SDK、options、models 和模型变体配置。
• Google/Anthropic/OpenAI-compatible/OpenAI/Amazon Bedrock 的模型拉取或推荐模型导入流程。
• Stream health check 在桌面、Web/headless 和远程服务器环境下的状态、超时、重试和错误分类。
• 现有 SQLite 运行时存储、Provider/MCP/Prompt/Skill/Proxy 设置兼容性。

已知边界

• OMO/OMO Slim 本身不直接暴露流式探测端点；需要测试其底层 OpenCode provider。
• Bedrock 模型列表来自内置 preset，不调用 AWS 的模型枚举接口。

cc-switch-web v0.13.0-preview.1

cc-switch-web v0.13.0-preview.1 预览版

这是 v0.13.0 的第一个预览版本，用于验证从 cc-switch 迁移过来的 P1/P2 功能面：OMO Slim 完整 UI、上游新版 OMO 表单、OpenCode provider preset/NPM selector/model fetch，以及 stream health check。

主要更新

• 新增 OMO Slim 专用配置 UI，支持 Slim agents、隐藏分类、顶层选项、本地导入和 Slim 专属对象字段。
• 更新标准 OMO 表单，对齐当前上游 schema，补齐新版 agents、顶层字段和结构化对象字段。
• 扩展 OpenCode provider preset，加入 NPM SDK selector、模型 URL 覆写、模型拉取和推荐模型元数据合并。
• 新增 stream health check，用于验证 Claude、Codex、Gemini、OpenCode provider 的流式响应可用性。
• 补齐 Amazon Bedrock：模型拉取使用本地 preset 导入，流式健康检查使用 Bedrock Runtime ConverseStream 和 AWS SigV4 签名。

重点验证

• OMO/OMO Slim 配置保存、导入、模型选择和生成结果是否符合预期。
• OpenCode provider preset 是否能正确生成 NPM SDK、options、models 和模型变体配置。
• Google/Anthropic/OpenAI-compatible/OpenAI/Amazon Bedrock 的模型拉取或推荐模型导入流程。
• Stream health check 在桌面、Web/headless 和远程服务器环境下的状态、超时、重试和错误分类。
• 现有 SQLite 运行时存储、Provider/MCP/Prompt/Skill/Proxy 设置迁移后是否仍保持兼容。

已知边界

• 这是预览测试版本，不是稳定版。
• OMO/OMO Slim 本身不直接暴露流式探测端点；需要测试其底层 OpenCode provider。
• Bedrock 模型列表来自内置 preset，不调用 AWS 的模型枚举接口。
• Tauri 桌面包和 updater 使用兼容版本号 0.13.0-1，npm/Cargo/headless 元数据使用 0.13.0-preview.1。