[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-farion1231--cc-switch":3,"tool-farion1231--cc-switch":64},[4,17,27,35,48,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",138956,2,"2026-04-05T11:33:21",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":23,"last_commit_at":41,"category_tags":42,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,43,44,45,15,46,26,13,47],"数据工具","视频","插件","其他","音频",{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":10,"last_commit_at":54,"category_tags":55,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[15,14,13,26,46],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":16},2181,"OpenHands","OpenHands\u002FOpenHands","OpenHands 是一个专注于 AI 驱动开发的开源平台，旨在让智能体（Agent）像人类开发者一样理解、编写和调试代码。它解决了传统编程中重复性劳动多、环境配置复杂以及人机协作效率低等痛点，通过自动化流程显著提升开发速度。\n\n无论是希望提升编码效率的软件工程师、探索智能体技术的研究人员，还是需要快速原型验证的技术团队，都能从中受益。OpenHands 提供了灵活多样的使用方式：既可以通过命令行（CLI）或本地图形界面在个人电脑上轻松上手，体验类似 Devin 的流畅交互；也能利用其强大的 Python SDK 自定义智能体逻辑，甚至在云端大规模部署上千个智能体并行工作。\n\n其核心技术亮点在于模块化的软件智能体 SDK，这不仅构成了平台的引擎，还支持高度可组合的开发模式。此外，OpenHands 在 SWE-bench 基准测试中取得了 77.6% 的优异成绩，证明了其解决真实世界软件工程问题的能力。平台还具备完善的企业级功能，支持与 Slack、Jira 等工具集成，并提供细粒度的权限管理，适合从个人开发者到大型企业的各类用户场景。",70612,"2026-04-05T11:12:22",[26,15,13,45],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":79,"owner_location":79,"owner_email":79,"owner_twitter":80,"owner_website":79,"owner_url":81,"languages":82,"stars":103,"forks":104,"last_commit_at":105,"license":106,"difficulty_score":107,"env_os":108,"env_gpu":109,"env_ram":109,"env_deps":110,"category_tags":114,"github_topics":115,"view_count":134,"oss_zip_url":79,"oss_zip_packed_at":79,"status":16,"created_at":135,"updated_at":136,"faqs":137,"releases":138},3131,"farion1231\u002Fcc-switch","cc-switch","A cross-platform desktop All-in-One assistant tool for Claude Code, Codex, OpenCode, openclaw & Gemini CLI.","cc-switch 是一款专为命令行 AI 编程助手打造的跨平台桌面管理工具。它旨在解决开发者在同时使用 Claude Code、Codex、Gemini CLI、OpenCode 及 OpenClaw 等多个工具时，面临的环境配置繁琐、版本切换困难以及管理分散等痛点。通过提供统一的图形化界面，cc-switch 让用户能够轻松安装、更新和在不同 AI 模型工具间一键切换，无需再手动处理复杂的终端命令或配置文件。\n\n这款工具特别适合频繁使用各类 CLI 版 AI 编码助手的软件开发者、技术研究人员及极客用户。无论是需要快速对比不同模型能力的工程师，还是希望简化工作流的重度用户，都能从中获益。其独特的技术亮点在于基于 Tauri 2 框架构建，不仅实现了 Windows、macOS 和 Linux 的全平台支持，还确保了应用轻量、启动迅速且系统资源占用极低。cc-switch 将分散的命令行工具整合为“一站式”管理中心，显著提升了 AI 辅助开发的工作效率与体验，让技术人员能更专注于代码创作本身。","\u003Cdiv align=\"center\">\n\n# CC Switch\n\n### The All-in-One Manager for Claude Code, Codex, Gemini CLI, OpenCode & OpenClaw\n\n[![Version](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Ffarion1231\u002Fcc-switch?color=blue&label=version)](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Freleases)\n[![Platform](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Freleases)\n[![Built with Tauri](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fbuilt%20with-Tauri%202-orange.svg)](https:\u002F\u002Ftauri.app\u002F)\n[![Downloads](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdownloads\u002Ffarion1231\u002Fcc-switch\u002Ftotal)](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Freleases\u002Flatest)\n\n\u003Ca href=\"https:\u002F\u002Ftrendshift.io\u002Frepositories\u002F15372\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_4a68feb902da.png\" alt=\"farion1231%2Fcc-switch | Trendshift\" style=\"width: 250px; height: 55px;\" width=\"250\" height=\"55\"\u002F>\u003C\u002Fa>\n\nEnglish | [中文](README_ZH.md) | [日本語](README_JA.md) | [Changelog](CHANGELOG.md)\n\n\u003C\u002Fdiv>\n\n## ❤️Sponsor\n\n> [Want to appear here?](mailto:farion1231@gmail.com)\n\n\u003Cdetails open>\n\u003Csummary>Click to collapse\u003C\u002Fsummary>\n\n[![MiniMax](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_ff1817df9c9d.jpeg)](https:\u002F\u002Fplatform.minimax.io\u002Fsubscribe\u002Fcoding-plan?code=ClLhgxr2je&source=link)\n\nMiniMax-M2.7 is a next-generation large language model designed for autonomous evolution and real-world productivity. Unlike traditional models, M2.7 actively participates in its own improvement through agent teams, dynamic tool use, and reinforcement learning loops. It delivers strong performance in software engineering (56.22% on SWE-Pro, 55.6% on VIBE-Pro, 57.0% on Terminal Bench 2) and excels in complex office workflows, achieving a leading 1495 ELO on GDPval-AA. With high-fidelity editing across Word, Excel, and PowerPoint, and a 97% adherence rate across 40+ complex skills, M2.7 sets a new standard for building AI-native workflows and organizations.\n\n[Click](https:\u002F\u002Fplatform.minimax.io\u002Fsubscribe\u002Fcoding-plan?code=ClLhgxr2je&source=link) to get an exclusive 12% off the MiniMax Token Plan!\n\n---\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fwww.packyapi.com\u002Fregister?aff=cc-switch\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_566804b8936a.png\" alt=\"PackyCode\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Thanks to PackyCode for sponsoring this project! PackyCode is a reliable and efficient API relay service provider, offering relay services for Claude Code, Codex, Gemini, and more. PackyCode provides special discounts for our software users: register using \u003Ca href=\"https:\u002F\u002Fwww.packyapi.com\u002Fregister?aff=cc-switch\">this link\u003C\u002Fa> and enter the \"cc-switch\" promo code during first recharge to get 10% off.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fcloud.siliconflow.cn\u002Fi\u002FdrGuwc9k\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_2f7d5a3358bd.jpg\" alt=\"SiliconFlow\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Thanks to SiliconFlow for sponsoring this project! SiliconFlow is a high-performance AI infrastructure and model API platform, providing fast and reliable access to language, speech, image, and video models in one place. With pay-as-you-go billing, broad multimodal model support, high-speed inference, and enterprise-grade stability, SiliconFlow helps developers and teams build and scale AI applications more efficiently. Register via \u003Ca href=\"https:\u002F\u002Fcloud.siliconflow.cn\u002Fi\u002FdrGuwc9k\">this link\u003C\u002Fa> and complete real-name verification to receive ¥20 in bonus credit, usable across models on the platform. SiliconFlow is also now compatible with OpenClaw, allowing users to connect a SiliconFlow API key and call major AI models for free.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Faigocode.com\u002Finvite\u002FCC-SWITCH\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_e72c1d832a0f.png\" alt=\"AIGoCode\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Thanks to AIGoCode for sponsoring this project! AIGoCode is an all-in-one platform that integrates Claude Code, Codex, and the latest Gemini models, providing you with stable, efficient, and highly cost-effective AI coding services. The platform offers flexible subscription plans, zero risk of account suspension, direct access with no VPN required, and lightning-fast responses. AIGoCode has prepared a special benefit for CC Switch users: if you register via \u003Ca href=\"https:\u002F\u002Faigocode.com\u002Finvite\u002FCC-SWITCH\">this link\u003C\u002Fa>, you'll receive an extra 10% bonus credit on your first top-up!\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fwww.aicodemirror.com\u002Fregister?invitecode=9915W3\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_6a9c99218cac.jpg\" alt=\"AICodeMirror\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Thanks to AICodeMirror for sponsoring this project! AICodeMirror provides official high-stability relay services for Claude Code \u002F Codex \u002F Gemini CLI, with enterprise-grade concurrency, fast invoicing, and 24\u002F7 dedicated technical support.\nClaude Code \u002F Codex \u002F Gemini official channels at 38% \u002F 2% \u002F 9% of original price, with extra discounts on top-ups! AICodeMirror offers special benefits for CC Switch users: register via \u003Ca href=\"https:\u002F\u002Fwww.aicodemirror.com\u002Fregister?invitecode=9915W3\">this link\u003C\u002Fa> to enjoy 20% off your first top-up, and enterprise customers can get up to 25% off!\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fcubence.com\u002Fsignup?code=CCSWITCH&source=ccs\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_bfd2773346b9.png\" alt=\"Cubence\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Thanks to Cubence for sponsoring this project! Cubence is a reliable and efficient API relay service provider, offering relay services for Claude Code, Codex, Gemini, and more with flexible billing options including pay-as-you-go and monthly plans. Cubence provides special discounts for CC Switch users: register using \u003Ca href=\"https:\u002F\u002Fcubence.com\u002Fsignup?code=CCSWITCH&source=ccs\">this link\u003C\u002Fa> and enter the \"CCSWITCH\" promo code during recharge to get 10% off every top-up!\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fwww.dmxapi.cn\u002Fregister?aff=bUHu\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_d992abadb10b.jpg\" alt=\"DMXAPI\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Thanks to DMXAPI for sponsoring this project! DMXAPI provides global large model API services to 200+ enterprise users. One API key for all global models. Features include: instant invoicing, unlimited concurrency, starting from $0.15, 24\u002F7 technical support. GPT\u002FClaude\u002FGemini all at 32% off, domestic models 20-50% off, Claude Code exclusive models at 66% off! \u003Ca href=\"https:\u002F\u002Fwww.dmxapi.cn\u002Fregister?aff=bUHu\">Register here\u003C\u002Fa>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fwww.compshare.cn\u002Fcoding-plan?ytag=GPU_YY_YX_git_cc-switch\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_1ff59e724827.png\" alt=\"Compshare\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Thanks to Compshare for sponsoring this project! Compshare is UCloud's AI cloud platform, providing stable and comprehensive domestic and international model APIs with just one key. Featuring cost-effective monthly and pay-as-you-go Coding Plan packages at 60-80% off official prices. Supports Claude Code, Codex, and API access. Enterprise-grade high concurrency, 24\u002F7 technical support, and self-service invoicing. Users who register via \u003Ca href=\"https:\u002F\u002Fwww.compshare.cn\u002Fcoding-plan?ytag=GPU_YY_YX_git_cc-switch\">this link\u003C\u002Fa> will receive a free 5 CNY platform trial credit!\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fwww.right.codes\u002Fregister?aff=CCSWITCH\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_cd017fc8c081.jpg\" alt=\"RightCode\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Thank you to Right Code for sponsoring this project! Right Code reliably provides routing services for models such as Claude Code, Codex, and Gemini. It features a highly cost-effective Codex monthly subscription plan and \u003Cstrong>supports quota rollovers—unused quota from one day can be carried over and used the next day.\u003C\u002Fstrong> Invoices are available upon top-up. Enterprise and team users can receive dedicated one-on-one support. Right Code also offers an exclusive discount for CC Switch users: register via \u003Ca href=\"https:\u002F\u002Fwww.right.codes\u002Fregister?aff=CCSWITCH\">this link\u003C\u002Fa>, and with every top-up you will receive pay-as-you-go credit equivalent to 25% of the amount paid.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Faicoding.sh\u002Fi\u002FCCSWITCH\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_4f321f0d2381.jpg\" alt=\"AICoding\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Thanks to AICoding.sh for sponsoring this project! AICoding.sh — Global AI Model API Relay Service at Unbeatable Prices! Claude Code at 19% of original price, GPT at just 1%! Trusted by hundreds of enterprises for cost-effective AI services. Supports Claude Code, GPT, Gemini and major domestic models, with enterprise-grade high concurrency, fast invoicing, and 24\u002F7 dedicated technical support. CC Switch users who register via \u003Ca href=\"https:\u002F\u002Faicoding.sh\u002Fi\u002FCCSWITCH\">this link\u003C\u002Fa> get 10% off their first top-up!\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fcrazyrouter.com\u002Fregister?aff=OZcm&ref=cc-switch\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_7b7186cdaf1f.jpg\" alt=\"Crazyrouter\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Thanks to Crazyrouter for sponsoring this project! Crazyrouter is a high-performance AI API aggregation platform — one API key for 300+ models including Claude Code, Codex, Gemini CLI, and more. All models at 55% of official pricing with auto-failover, smart routing, and unlimited concurrency. Crazyrouter offers an exclusive deal for CC Switch users: register via \u003Ca href=\"https:\u002F\u002Fcrazyrouter.com\u002Fregister?aff=OZcm&ref=cc-switch\">this link\u003C\u002Fa>  to get \u003Cstrong>$2 free credit\u003C\u002Fstrong> instantly, plus enter promo code `CCSWITCH` on your first top-up for an extra \u003Cstrong>30% bonus credit\u003C\u002Fstrong>! \u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fwww.sssaicode.com\u002Fregister?ref=DCP0SM\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_bea9974db82f.png\" alt=\"SSSAiCode\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Thanks to SSSAiCode for sponsoring this project! SSSAiCode is a stable and reliable API relay service, dedicated to providing stable, reliable, and affordable Claude and Codex model services, \u003Cstrong>offering high cost-effective official Claude service at just ¥0.5\u002F$ equivalent\u003C\u002Fstrong>, supporting monthly and pay-as-you-go billing plans with same-day fast invoicing. SSSAiCode offers a special deal for CC Switch users: register via \u003Ca href=\"https:\u002F\u002Fwww.sssaicode.com\u002Fregister?ref=DCP0SM\">this link\u003C\u002Fa> to enjoy $10 extra credit on every top-up!\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fwww.openclaudecode.cn\u002Fregister?aff=aOYQ\">\u003Cimg src=\"assets\u002Fpartners\u002Flogos\u002Fmikubanner.svg\" alt=\"Micu\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Thanks to Micu API for sponsoring this project! Micu API is a global LLM relay service provider dedicated to delivering the best cost-performance ratio with high stability. Backed by a registered enterprise for core assurance, eliminating any risk of service discontinuation, with fast official invoicing support! We champion \"zero cost to try\": top up from as low as ¥1 with no minimum, and get fee-free refunds anytime! Micu API offers an exclusive deal for CC Switch users: register via \u003Ca href=\"https:\u002F\u002Fwww.openclaudecode.cn\u002Fregister?aff=aOYQ\">this link\u003C\u002Fa> and enter promo code \"ccswitch\" when topping up to enjoy a \u003Cstrong>10% discount\u003C\u002Fstrong>!\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fx-code.cc\u002Fregister?aff=IbPp\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_01180fa0182f.png\" alt=\"XCodeAPI\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Thanks to XCodeAPI for sponsoring this project! XCodeAPI offers a special benefit for CC Switch users: register via \u003Ca href=\"https:\u002F\u002Fx-code.cc\u002Fregister?aff=IbPp\">this link\u003C\u002Fa> and get an extra 10% credit bonus on your first order! (Contact the site admin to claim)\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fctok.ai\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_d71d41404dc0.png\" alt=\"CTok\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Thanks to CTok.ai for sponsoring this project! CTok.ai is dedicated to building a one-stop AI programming tool service platform. We offer professional Claude Code packages and technical community services, with support for Google Gemini and OpenAI Codex. Through carefully designed plans and a professional tech community, we provide developers with reliable service guarantees and continuous technical support, making AI-assisted programming a true productivity tool. Click \u003Ca href=\"https:\u002F\u002Fctok.ai\">here\u003C\u002Fa> to register!\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fchefshop.ai\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_8a4f60c9948f.png\" alt=\"ChefShop\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Thanks to ChefShop AI for sponsoring this project! ChefShop AI is a premium account service provider tailored for heavy AI subscription users. The platform offers official top-up and stable account services for mainstream large models including ChatGPT Plus\u002FPro, Claude Max, Grok Super\u002FHeavy, and Gemini. Click \u003Ca href=\"https:\u002F\u002Fchefshop.ai\">here\u003C\u002Fa> to purchase!\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003C\u002Ftable>\n\n\u003C\u002Fdetails>\n\n## Why CC Switch?\n\nModern AI-powered coding relies on CLI tools like Claude Code, Codex, Gemini CLI, OpenCode, and OpenClaw — but each has its own configuration format. Switching API providers means manually editing JSON, TOML, or `.env` files, and there is no unified way to manage MCP and Skills across multiple tools.\n\n**CC Switch** gives you a single desktop app to manage all five CLI tools. Instead of editing config files by hand, you get a visual interface to import providers with one click, switch between them instantly, with 50+ built-in provider presets, unified MCP and Skills management, and system tray quick switching — all backed by a reliable SQLite database with atomic writes that protect your configs from corruption.\n\n- **One App, Five CLI Tools** — Manage Claude Code, Codex, Gemini CLI, OpenCode, and OpenClaw from a single interface\n- **No More Manual Editing** — 50+ provider presets including AWS Bedrock, NVIDIA NIM, and community relays; just pick and switch\n- **Unified MCP & Skills Management** — One panel to manage MCP servers and Skills across four apps with bidirectional sync\n- **System Tray Quick Switch** — Switch providers instantly from the tray menu, no need to open the full app\n- **Cloud Sync** — Sync provider data across devices via Dropbox, OneDrive, iCloud, or WebDAV servers\n- **Cross-Platform** — Native desktop app for Windows, macOS, and Linux, built with Tauri 2\n- **Built-in Utilities** — Includes various utilities for first-launch login confirmation, signature bypass, plugin extension sync, and more\n\n## Screenshots\n\n|                  Main Interface                   |                  Add Provider                  |\n| :-----------------------------------------------: | :--------------------------------------------: |\n| ![Main Interface](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_ef81292d0e26.png) | ![Add Provider](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_257df63e1590.png) |\n\n## Features\n\n[Full Changelog](CHANGELOG.md) | [Release Notes](docs\u002Frelease-notes\u002Fv3.12.3-en.md)\n\n### Provider Management\n\n- **5 CLI tools, 50+ presets** — Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw; copy your key and import with one click\n- **Universal providers** — One config syncs to multiple apps (OpenCode, OpenClaw)\n- One-click switching, system tray quick access, drag-and-drop sorting, import\u002Fexport\n\n### Proxy & Failover\n\n- **Local proxy with hot-switching** — Format conversion, auto-failover, circuit breaker, provider health monitoring, and request rectifier\n- **App-level takeover** — Independently proxy Claude, Codex, or Gemini, down to individual providers\n\n### MCP, Prompts & Skills\n\n- **Unified MCP panel** — Manage MCP servers across 4 apps with bidirectional sync and Deep Link import\n- **Prompts** — Markdown editor with cross-app sync (CLAUDE.md \u002F AGENTS.md \u002F GEMINI.md) and backfill protection\n- **Skills** — One-click install from GitHub repos or ZIP files, custom repository management, with symlink and file copy support\n\n### Usage & Cost Tracking\n\n- **Usage dashboard** — Track spending, requests, and tokens with trend charts, detailed request logs, and custom per-model pricing\n\n### Session Manager & Workspace\n\n- Browse, search, and restore conversation history across all apps\n- **Workspace editor** (OpenClaw) — Edit agent files (AGENTS.md, SOUL.md, etc.) with Markdown preview\n\n### System & Platform\n\n- **Cloud sync** — Custom config directory (Dropbox, OneDrive, iCloud, NAS) and WebDAV server sync\n- **Deep Link** (`ccswitch:\u002F\u002F`) — Import providers, MCP servers, prompts, and skills via URL\n- Dark \u002F Light \u002F System theme, auto-launch, auto-updater, atomic writes, auto-backups, i18n (zh\u002Fen\u002Fja)\n\n## FAQ\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Which AI CLI tools does CC Switch support?\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nCC Switch supports five tools: **Claude Code**, **Codex**, **Gemini CLI**, **OpenCode**, and **OpenClaw**. Each tool has dedicated provider presets and configuration management.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Do I need to restart the terminal after switching providers?\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nFor most tools, yes — restart your terminal or the CLI tool for changes to take effect. The exception is **Claude Code**, which currently supports hot-switching of provider data without a restart.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>My plugin configuration disappeared after switching providers — what happened?\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nCC Switch provides a \"Shared Config Snippet\" feature to pass common data (beyond API keys and endpoints) between providers. Go to \"Edit Provider\" → \"Shared Config Panel\" → click \"Extract from Current Provider\" to save all common data. When creating a new provider, check \"Write Shared Config\" (enabled by default) to include plugin data in the new provider. All your configuration items are preserved in the default provider imported when you first launched the app.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>macOS installation\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nCC Switch for macOS is code-signed and notarized by Apple. You can download and install it directly — no extra steps needed. We recommend using the `.dmg` installer.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Why can't I delete the currently active provider?\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nCC Switch follows a \"minimal intrusion\" design principle — even if you uninstall the app, your CLI tools will continue to work normally. The system always keeps one active configuration, because deleting all configurations would make the corresponding CLI tool unusable. If you rarely use a specific CLI tool, you can hide it in Settings. To switch back to official login, see the next question.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>How do I switch back to official login?\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nAdd an official provider from the preset list. After switching to it, run the Log out \u002F Log in flow, and then you can freely switch between the official provider and third-party providers. Codex supports switching between different official providers, making it easy to switch between multiple Plus or Team accounts.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Where is my data stored?\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- **Database**: `~\u002F.cc-switch\u002Fcc-switch.db` (SQLite — providers, MCP, prompts, skills)\n- **Local settings**: `~\u002F.cc-switch\u002Fsettings.json` (device-level UI preferences)\n- **Backups**: `~\u002F.cc-switch\u002Fbackups\u002F` (auto-rotated, keeps 10 most recent)\n- **Skills**: `~\u002F.cc-switch\u002Fskills\u002F` (symlinked to corresponding apps by default)\n- **Skill Backups**: `~\u002F.cc-switch\u002Fskill-backups\u002F` (created automatically before uninstall, keeps 20 most recent)\n\n\u003C\u002Fdetails>\n\n## Documentation\n\nFor detailed guides on every feature, check out the **[User Manual](docs\u002Fuser-manual\u002Fen\u002FREADME.md)** — covering provider management, MCP\u002FPrompts\u002FSkills, proxy & failover, and more.\n\n## Quick Start\n\n### Basic Usage\n\n1. **Add Provider**: Click \"Add Provider\" → Choose a preset or create custom configuration\n2. **Switch Provider**:\n   - Main UI: Select provider → Click \"Enable\"\n   - System Tray: Click provider name directly (instant effect)\n3. **Takes Effect**: Restart your terminal or the corresponding CLI tool to apply changes (Claude Code does not require a restart)\n4. **Back to Official**: Add an \"Official Login\" preset, restart the CLI tool, then follow its login\u002FOAuth flow\n\n### MCP, Prompts, Skills & Sessions\n\n- **MCP**: Click the \"MCP\" button → Add servers via templates or custom config → Toggle per-app sync\n- **Prompts**: Click \"Prompts\" → Create presets with Markdown editor → Activate to sync to live files\n- **Skills**: Click \"Skills\" → Browse GitHub repos → One-click install to all apps\n- **Sessions**: Click \"Sessions\" → Browse, search, and restore conversation history across all apps\n\n> **Note**: On first launch, you can manually import existing CLI tool configs as the default provider.\n\n## Download & Installation\n\n### System Requirements\n\n- **Windows**: Windows 10 and above\n- **macOS**: macOS 12 (Monterey) and above\n- **Linux**: Ubuntu 22.04+ \u002F Debian 11+ \u002F Fedora 34+ and other mainstream distributions\n\n### Windows Users\n\nDownload the latest `CC-Switch-v{version}-Windows.msi` installer or `CC-Switch-v{version}-Windows-Portable.zip` portable version from the [Releases](..\u002F..\u002Freleases) page.\n\n### macOS Users\n\n**Method 1: Install via Homebrew (Recommended)**\n\n```bash\nbrew tap farion1231\u002Fccswitch\nbrew install --cask cc-switch\n```\n\nUpdate:\n\n```bash\nbrew upgrade --cask cc-switch\n```\n\n**Method 2: Manual Download**\n\nDownload `CC-Switch-v{version}-macOS.dmg` (recommended) or `.zip` from the [Releases](..\u002F..\u002Freleases) page.\n\n> **Note**: CC Switch for macOS is code-signed and notarized by Apple. You can install and open it directly.\n\n### Arch Linux Users\n\n**Install via paru (Recommended)**\n\n```bash\nparu -S cc-switch-bin\n```\n\n### Linux Users\n\nDownload the latest Linux build from the [Releases](..\u002F..\u002Freleases) page:\n\n- `CC-Switch-v{version}-Linux.deb` (Debian\u002FUbuntu)\n- `CC-Switch-v{version}-Linux.rpm` (Fedora\u002FRHEL\u002FopenSUSE)\n- `CC-Switch-v{version}-Linux.AppImage` (Universal)\n\n> **Flatpak**: Not included in official releases. You can build it yourself from the `.deb` — see [`flatpak\u002FREADME.md`](flatpak\u002FREADME.md) for instructions.\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Architecture Overview\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n### Design Principles\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                    Frontend (React + TS)                    │\n│  ┌─────────────┐  ┌──────────────┐  ┌──────────────────┐    │\n│  │ Components  │  │    Hooks     │  │  TanStack Query  │    │\n│  │   (UI)      │──│ (Bus. Logic) │──│   (Cache\u002FSync)   │    │\n│  └─────────────┘  └──────────────┘  └──────────────────┘    │\n└────────────────────────┬────────────────────────────────────┘\n                         │ Tauri IPC\n┌────────────────────────▼────────────────────────────────────┐\n│                  Backend (Tauri + Rust)                     │\n│  ┌─────────────┐  ┌──────────────┐  ┌──────────────────┐    │\n│  │  Commands   │  │   Services   │  │  Models\u002FConfig   │    │\n│  │ (API Layer) │──│ (Bus. Layer) │──│     (Data)       │    │\n│  └─────────────┘  └──────────────┘  └──────────────────┘    │\n└─────────────────────────────────────────────────────────────┘\n```\n\n**Core Design Patterns**\n\n- **SSOT** (Single Source of Truth): All data stored in `~\u002F.cc-switch\u002Fcc-switch.db` (SQLite)\n- **Dual-layer Storage**: SQLite for syncable data, JSON for device-level settings\n- **Dual-way Sync**: Write to live files on switch, backfill from live when editing active provider\n- **Atomic Writes**: Temp file + rename pattern prevents config corruption\n- **Concurrency Safe**: Mutex-protected database connection avoids race conditions\n- **Layered Architecture**: Clear separation (Commands → Services → DAO → Database)\n\n**Key Components**\n\n- **ProviderService**: Provider CRUD, switching, backfill, sorting\n- **McpService**: MCP server management, import\u002Fexport, live file sync\n- **ProxyService**: Local proxy mode with hot-switching and format conversion\n- **SessionManager**: Conversation history browsing across all supported apps\n- **ConfigService**: Config import\u002Fexport, backup rotation\n- **SpeedtestService**: API endpoint latency measurement\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Development Guide\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n### Environment Requirements\n\n- Node.js 18+\n- pnpm 8+\n- Rust 1.85+\n- Tauri CLI 2.8+\n\n### Development Commands\n\n```bash\n# Install dependencies\npnpm install\n\n# Dev mode (hot reload)\npnpm dev\n\n# Type check\npnpm typecheck\n\n# Format code\npnpm format\n\n# Check code format\npnpm format:check\n\n# Run frontend unit tests\npnpm test:unit\n\n# Run tests in watch mode (recommended for development)\npnpm test:unit:watch\n\n# Build application\npnpm build\n\n# Build debug version\npnpm tauri build --debug\n```\n\n### Rust Backend Development\n\n```bash\ncd src-tauri\n\n# Format Rust code\ncargo fmt\n\n# Run clippy checks\ncargo clippy\n\n# Run backend tests\ncargo test\n\n# Run specific tests\ncargo test test_name\n\n# Run tests with test-hooks feature\ncargo test --features test-hooks\n```\n\n### Testing Guide\n\n**Frontend Testing**:\n\n- Uses **vitest** as test framework\n- Uses **MSW (Mock Service Worker)** to mock Tauri API calls\n- Uses **@testing-library\u002Freact** for component testing\n\n**Running Tests**:\n\n```bash\n# Run all tests\npnpm test:unit\n\n# Watch mode (auto re-run)\npnpm test:unit:watch\n\n# With coverage report\npnpm test:unit --coverage\n```\n\n### Tech Stack\n\n**Frontend**: React 18 · TypeScript · Vite · TailwindCSS 3.4 · TanStack Query v5 · react-i18next · react-hook-form · zod · shadcn\u002Fui · @dnd-kit\n\n**Backend**: Tauri 2.8 · Rust · serde · tokio · thiserror · tauri-plugin-updater\u002Fprocess\u002Fdialog\u002Fstore\u002Flog\n\n**Testing**: vitest · MSW · @testing-library\u002Freact\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Project Structure\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n```\n├── src\u002F                        # Frontend (React + TypeScript)\n│   ├── components\u002F\n│   │   ├── providers\u002F          # Provider management\n│   │   ├── mcp\u002F                # MCP panel\n│   │   ├── prompts\u002F            # Prompts management\n│   │   ├── skills\u002F             # Skills management\n│   │   ├── sessions\u002F           # Session Manager\n│   │   ├── proxy\u002F              # Proxy mode panel\n│   │   ├── openclaw\u002F           # OpenClaw config panels\n│   │   ├── settings\u002F           # Settings (Terminal\u002FBackup\u002FAbout)\n│   │   ├── deeplink\u002F           # Deep Link import\n│   │   ├── env\u002F                # Environment variable management\n│   │   ├── universal\u002F          # Cross-app configuration\n│   │   ├── usage\u002F              # Usage statistics\n│   │   └── ui\u002F                 # shadcn\u002Fui component library\n│   ├── hooks\u002F                  # Custom hooks (business logic)\n│   ├── lib\u002F\n│   │   ├── api\u002F                # Tauri API wrapper (type-safe)\n│   │   └── query\u002F              # TanStack Query config\n│   ├── locales\u002F                # Translations (zh\u002Fen\u002Fja)\n│   ├── config\u002F                 # Presets (providers\u002Fmcp)\n│   └── types\u002F                  # TypeScript definitions\n├── src-tauri\u002F                  # Backend (Rust)\n│   └── src\u002F\n│       ├── commands\u002F           # Tauri command layer (by domain)\n│       ├── services\u002F           # Business logic layer\n│       ├── database\u002F           # SQLite DAO layer\n│       ├── proxy\u002F              # Proxy module\n│       ├── session_manager\u002F    # Session management\n│       ├── deeplink\u002F           # Deep Link handling\n│       └── mcp\u002F                # MCP sync module\n├── tests\u002F                      # Frontend tests\n└── assets\u002F                     # Screenshots & partner resources\n```\n\n\u003C\u002Fdetails>\n\n## Contributing\n\nIssues and suggestions are welcome!\n\nBefore submitting PRs, please ensure:\n\n- Pass type check: `pnpm typecheck`\n- Pass format check: `pnpm format:check`\n- Pass unit tests: `pnpm test:unit`\n\nFor new features, please open an issue for discussion before submitting a PR. PRs for features that are not a good fit for the project may be closed.\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_b1db3cfc7f47.png)](https:\u002F\u002Fwww.star-history.com\u002F#farion1231\u002Fcc-switch&Date)\n\n## License\n\nMIT © Jason Young\n","\u003Cdiv align=\"center\">\n\n# CC Switch\n\n### 集成 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 的一站式管理工具\n\n[![版本](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Ffarion1231\u002Fcc-switch?color=blue&label=version)](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Freleases)\n[![平台](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Freleases)\n[![基于 Tauri 构建](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fbuilt%20with-Tauri%202-orange.svg)](https:\u002F\u002Ftauri.app\u002F)\n[![下载量](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdownloads\u002Ffarion1231\u002Fcc-switch\u002Ftotal)](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Freleases\u002Flatest)\n\n\u003Ca href=\"https:\u002F\u002Ftrendshift.io\u002Frepositories\u002F15372\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_4a68feb902da.png\" alt=\"farion1231%2Fcc-switch | Trendshift\" style=\"width: 250px; height: 55px;\" width=\"250\" height=\"55\"\u002F>\u003C\u002Fa>\n\nEnglish | [中文](README_ZH.md) | [日本語](README_JA.md) | [Changelog](CHANGELOG.md)\n\n\u003C\u002Fdiv>\n\n## ❤️赞助商\n\n> [想在这里展示您的品牌吗？](mailto:farion1231@gmail.com)\n\n\u003Cdetails open>\n\u003Csummary>点击收起\u003C\u002Fsummary>\n\n[![MiniMax](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_ff1817df9c9d.jpeg)](https:\u002F\u002Fplatform.minimax.io\u002Fsubscribe\u002Fcoding-plan?code=ClLhgxr2je&source=link)\n\nMiniMax-M2.7 是一款面向自主进化与实际生产力的新一代大型语言模型。与传统模型不同，M2.7 通过代理团队、动态工具使用和强化学习循环积极参与自身的优化迭代。它在软件工程领域表现出色（SWE-Pro 测试得分为 56.22%，VIBE-Pro 得分为 55.6%，Terminal Bench 2 得分为 57.0%），同时在复杂办公流程中也表现卓越，在 GDPval-AA 测试中以 1495 ELO 排名领先。M2.7 在 Word、Excel 和 PowerPoint 中实现了高保真编辑，并且在 40 多项复杂技能上的执行准确率高达 97%，为构建 AI 原生的工作流和组织树立了全新标准。\n\n[点击](https:\u002F\u002Fplatform.minimax.io\u002Fsubscribe\u002Fcoding-plan?code=ClLhgxr2je&source=link) 即可享受 MiniMax Token Plan 的专属 12% 折扣！\n\n---\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fwww.packyapi.com\u002Fregister?aff=cc-switch\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_566804b8936a.png\" alt=\"PackyCode\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>感谢 PackyCode 对本项目的赞助！PackyCode 是一家可靠高效的 API 中继服务提供商，支持 Claude Code、Codex、Gemini 等多种模型的中继服务。针对我们的用户，PackyCode 特别推出了优惠活动：通过 \u003Ca href=\"https:\u002F\u002Fwww.packyapi.com\u002Fregister?aff=cc-switch\">此链接\u003C\u002Fa> 注册，并在首次充值时输入“cc-switch”优惠码，即可享受 10% 的折扣。\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fcloud.siliconflow.cn\u002Fi\u002FdrGuwc9k\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_2f7d5a3358bd.jpg\" alt=\"SiliconFlow\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>感谢 SiliconFlow 对本项目的赞助！SiliconFlow 是一个高性能的 AI 基础设施与模型 API 平台，能够在一个地方快速、稳定地访问语言、语音、图像和视频模型。凭借按需付费的计费模式、广泛的多模态模型支持、高速推理能力以及企业级稳定性，SiliconFlow 帮助开发者和团队更高效地构建与扩展 AI 应用。通过 \u003Ca href=\"https:\u002F\u002Fcloud.siliconflow.cn\u002Fi\u002FdrGuwc9k\">此链接\u003C\u002Fa> 注册并完成实名认证，即可获得 ¥20 的奖励积分，可用于平台上的各类模型。此外，SiliconFlow 现已兼容 OpenClaw，用户可以绑定 SiliconFlow API 密钥，免费调用主流 AI 模型。\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Faigocode.com\u002Finvite\u002FCC-SWITCH\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_e72c1d832a0f.png\" alt=\"AIGoCode\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>感谢 AIGoCode 对本项目的赞助！AIGoCode 是一个集成了 Claude Code、Codex 以及最新 Gemini 模型的一站式平台，为您提供稳定、高效且极具性价比的 AI 编程服务。该平台提供灵活的订阅方案，无账号被封风险，无需 VPN 即可直接访问，响应速度极快。AIGoCode 为 CC Switch 用户准备了特别福利：通过 \u003Ca href=\"https:\u002F\u002Faigocode.com\u002Finvite\u002FCC-SWITCH\">此链接\u003C\u002Fa> 注册，在首次充值时将额外赠送 10% 的奖励积分！\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fwww.aicodemirror.com\u002Fregister?invitecode=9915W3\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_6a9c99218cac.jpg\" alt=\"AICodeMirror\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>感谢 AICodeMirror 对本项目的赞助！AICodeMirror 提供官方授权的高稳定性中继服务，覆盖 Claude Code、Codex 和 Gemini CLI，具备企业级并发处理能力、快速开票以及全天候专属技术支持。\nClaude Code、Codex 和 Gemini 的官方渠道价格分别仅为原价的 38%、2% 和 9%，并且充值还可享受额外折扣！AICodeMirror 为 CC Switch 用户准备了特别福利：通过 \u003Ca href=\"https:\u002F\u002Fwww.aicodemirror.com\u002Fregister?invitecode=9915W3\">此链接\u003C\u002Fa> 注册，首次充值立享 20% 折扣；企业客户最高可享受 25% 的优惠！\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fcubence.com\u002Fsignup?code=CCSWITCH&source=ccs\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_bfd2773346b9.png\" alt=\"Cubence\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>感谢 Cubence 对本项目的赞助！Cubence 是一家可靠高效的 API 中继服务提供商，支持 Claude Code、Codex、Gemini 等多种模型的中继服务，并提供灵活的计费方式，包括按量付费和包月套餐。针对 CC Switch 用户，Cubence 特别推出优惠活动：通过 \u003Ca href=\"https:\u002F\u002Fcubence.com\u002Fsignup?code=CCSWITCH&source=ccs\">此链接\u003C\u002Fa> 注册，并在充值时输入“CCSWITCH”优惠码，每次充值均可享受 10% 的折扣。\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fwww.dmxapi.cn\u002Fregister?aff=bUHu\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_d992abadb10b.jpg\" alt=\"DMXAPI\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>感谢 DMXAPI 对本项目的赞助！DMXAPI 为 200 多家企业提供全球大型模型 API 服务。只需一个 API 密钥，即可访问所有全球主流模型。其特色包括：即时开票、无限并发、起步价低至 0.15 美元，以及 24\u002F7 全天候技术支持。GPT、Claude、Gemini 均可享受 32% 的折扣，国内模型则有 20%-50% 的优惠，Claude Code 的独家模型更是低至原价的 66%！\u003Ca href=\"https:\u002F\u002Fwww.dmxapi.cn\u002Fregister?aff=bUHu\">立即注册\u003C\u002Fa>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003C\u002Ftable>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fwww.compshare.cn\u002Fcoding-plan?ytag=GPU_YY_YX_git_cc-switch\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_1ff59e724827.png\" alt=\"Compshare\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>感谢 Compshare 对本项目的赞助！Compshare 是 UCloud 的 AI 云平台，只需一个密钥即可提供稳定、全面的国内外模型 API。主打高性价比的月度与按量计费 Coding Plan 套餐，价格仅为官方定价的 60%-80%。支持 Claude Code、Codex 及 API 直接接入。具备企业级高并发能力、全天候技术支持以及自助开票服务。通过 \u003Ca href=\"https:\u002F\u002Fwww.compshare.cn\u002Fcoding-plan?ytag=GPU_YY_YX_git_cc-switch\">此链接\u003C\u002Fa> 注册的用户，还将获得 5 元的平台试用额度哦！\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fwww.right.codes\u002Fregister?aff=CCSWITCH\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_cd017fc8c081.jpg\" alt=\"RightCode\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>感谢 Right Code 对本项目的赞助！Right Code 稳定可靠地为 Claude Code、Codex、Gemini 等模型提供路由服务。特别推出极具性价比的 Codex 月度订阅套餐，并且 \u003Cstrong>支持配额结转——当天未使用的配额可顺延至次日使用。\u003C\u002Fstrong> 充值后即可开具发票。企业及团队用户还可享受专属的一对一支持。Right Code 还为 CC Switch 用户准备了独家优惠：通过 \u003Ca href=\"https:\u002F\u002Fwww.right.codes\u002Fregister?aff=CCSWITCH\">此链接\u003C\u002Fa> 注册，每次充值都将获赠相当于充值金额 25% 的按量计费额度。\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Faicoding.sh\u002Fi\u002FCCSWITCH\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_4f321f0d2381.jpg\" alt=\"AICoding\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>感谢 AICoding.sh 对本项目的赞助！AICoding.sh — 全球 AI 模型 API 中转服务，价格无敌！Claude Code 仅需原价的 19%，GPT 更低至 1%！数百家企业信赖其高性价比的 AI 服务。支持 Claude Code、GPT、Gemini 及国内主流模型，具备企业级高并发能力、快速开票及 7x24 小时专属技术支持。通过 \u003Ca href=\"https:\u002F\u002Faicoding.sh\u002Fi\u002FCCSWITCH\">此链接\u003C\u002Fa> 注册的 CC Switch 用户，首次充值立享九折优惠！\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fcrazyrouter.com\u002Fregister?aff=OZcm&ref=cc-switch\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_7b7186cdaf1f.jpg\" alt=\"Crazyrouter\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>感谢 Crazyrouter 对本项目的赞助！Crazyrouter 是一款高性能的 AI API 聚合平台——一个 API 密钥即可畅享 300 多种模型，包括 Claude Code、Codex、Gemini CLI 等。所有模型均以官方定价的 55% 提供，配备自动故障转移、智能路由及无限并发能力。Crazyrouter 为 CC Switch 用户准备了专属福利：通过 \u003Ca href=\"https:\u002F\u002Fcrazyrouter.com\u002Fregister?aff=OZcm&ref=cc-switch\">此链接\u003C\u002Fa> 注册，即刻领取 \u003Cstrong>2 美元免费额度\u003C\u002Fstrong>；首次充值时输入优惠码 `CCSWITCH`，还可额外获得 \u003Cstrong>30% 的奖励额度\u003C\u002Fstrong>！\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fwww.sssaicode.com\u002Fregister?ref=DCP0SM\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_bea9974db82f.png\" alt=\"SSSAiCode\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>感谢 SSSAiCode 对本项目的赞助！SSSAiCode 是一家稳定可靠的 API 中转服务商，专注于提供稳定、可靠且经济实惠的 Claude 和 Codex 模型服务，\u003Cstrong>官方 Claude 服务的性价比极高，仅需人民币 0.5 元或等值美元\u003C\u002Fstrong>。支持月度与按量计费模式，并可当日快速开票。SSSAiCode 为 CC Switch 用户特别推出优惠：通过 \u003Ca href=\"https:\u002F\u002Fwww.sssaicode.com\u002Fregister?ref=DCP0SM\">此链接\u003C\u002Fa> 注册，每次充值均可额外获得 10 美元额度！\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fwww.openclaudecode.cn\u002Fregister?aff=aOYQ\">\u003Cimg src=\"assets\u002Fpartners\u002Flogos\u002Fmikubanner.svg\" alt=\"Micu\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>感谢 Micu API 对本项目的赞助！Micu API 是一家全球 LLM 中转服务商，致力于以高稳定性实现最佳性价比。依托注册企业作为核心保障，彻底消除服务中断风险，并提供快速的官方开票支持！我们倡导“零成本试用”：最低仅需 1 元即可充值，无最低限额，且随时可无手续费退款！Micu API 为 CC Switch 用户准备了专属优惠：通过 \u003Ca href=\"https:\u002F\u002Fwww.openclaudecode.cn\u002Fregister?aff=aOYQ\">此链接\u003C\u002Fa> 注册，并在充值时输入优惠码 “ccswitch”，即可享受 \u003Cstrong>10% 的折扣\u003C\u002Fstrong>！\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fx-code.cc\u002Fregister?aff=IbPp\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_01180fa0182f.png\" alt=\"XCodeAPI\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>感谢 XCodeAPI 对本项目的赞助！XCodeAPI 为 CC Switch 用户特别推出福利：通过 \u003Ca href=\"https:\u002F\u002Fx-code.cc\u002Fregister?aff=IbPp\">此链接\u003C\u002Fa> 注册，首次下单即可额外获得 10% 的信用奖励！（请联系网站管理员领取）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fctok.ai\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_d71d41404dc0.png\" alt=\"CTok\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>感谢 CTok.ai 对本项目的赞助！CTok.ai 致力于打造一站式 AI 编程工具服务平台。我们提供专业的 Claude Code 套餐及技术社区服务，同时支持 Google Gemini 和 OpenAI Codex。通过精心设计的方案和专业的技术社区，我们为开发者提供可靠的服务保障和持续的技术支持，让 AI 辅助编程真正成为提升效率的利器。点击 \u003Ca href=\"https:\u002F\u002Fctok.ai\">这里\u003C\u002Fa> 即可注册！\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fchefshop.ai\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_8a4f60c9948f.png\" alt=\"ChefShop\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>感谢 ChefShop AI 对本项目的赞助！ChefShop AI 是一家专为重度 AI 订阅用户打造的优质账号服务提供商。平台为 ChatGPT Plus\u002FPro、Claude Max、Grok Super\u002FHeavy 以及 Gemini 等主流大模型提供官方充值及稳定的账号服务。点击 \u003Ca href=\"https:\u002F\u002Fchefshop.ai\">这里\u003C\u002Fa> 即可购买！\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003C\u002Ftable>\n\n\u003C\u002Fdetails>\n\n## 为什么选择 CC Switch？\n\n现代基于 AI 的编码工作流依赖于 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 等 CLI 工具，但每款工具都有各自的配置格式。切换 API 提供商时，往往需要手动编辑 JSON、TOML 或 `.env` 文件，而且目前并没有一种统一的方式来跨多个工具管理 MCP 和 Skills。\n\n**CC Switch** 提供了一款桌面应用，帮助你一站式管理这五款 CLI 工具。无需再手动编辑配置文件，你可以通过直观的界面一键导入提供商、即时切换，并享受 50 多种内置提供商预设、统一的 MCP 和 Skills 管理，以及系统托盘快速切换等功能。所有数据都存储在可靠的 SQLite 数据库中，采用原子写入机制，有效防止配置损坏。\n\n- **一款应用，五款 CLI 工具** — 从单一界面管理 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw\n- **告别手动编辑** — 50 多种提供商预设，包括 AWS Bedrock、NVIDIA NIM 和社区中继；只需选择并切换\n- **统一的 MCP 和 Skills 管理** — 一个面板即可跨四款应用管理 MCP 服务器和 Skills，并实现双向同步\n- **系统托盘快速切换** — 无需打开完整应用，直接从托盘菜单即可即时切换提供商\n- **云同步** — 通过 Dropbox、OneDrive、iCloud 或 WebDAV 服务器，在不同设备间同步提供商数据\n- **跨平台支持** — 原生桌面应用，适用于 Windows、macOS 和 Linux，基于 Tauri 2 构建\n- **内置实用工具** — 包括首次启动登录确认、签名绕过、插件扩展同步等多种实用功能\n\n## 截图\n\n|                  主界面                   |                  添加提供商                  |\n| :---------------------------------------: | :------------------------------------------: |\n| ![主界面](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_ef81292d0e26.png) | ![添加提供商](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_257df63e1590.png) |\n\n## 功能特性\n\n[完整更新日志](CHANGELOG.md) | [发布说明](docs\u002Frelease-notes\u002Fv3.12.3-en.md)\n\n### 提供商管理\n\n- **5 款 CLI 工具，50 多种预设** — Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw；复制你的密钥，一键导入\n- **通用提供商** — 一份配置可同步至多个应用（OpenCode、OpenClaw）\n- 一键切换、系统托盘快速访问、拖放排序、导入导出\n\n### 代理与故障转移\n\n- **本地代理与热切换** — 格式转换、自动故障转移、断路器、提供商健康监测和请求修复\n- **应用级接管** — 可独立代理 Claude、Codex 或 Gemini，甚至针对单个提供商进行代理\n\n### MCP、提示词与 Skills\n\n- **统一的 MCP 面板** — 跨 4 款应用管理 MCP 服务器，支持双向同步和 Deep Link 导入\n- **提示词** — Markdown 编辑器，支持跨应用同步（CLAUDE.md \u002F AGENTS.md \u002F GEMINI.md）和回填保护\n- **Skills** — 一键从 GitHub 仓库或 ZIP 文件安装，自定义仓库管理，支持符号链接和文件复制\n\n### 使用情况与成本跟踪\n\n- **使用情况仪表盘** — 通过趋势图、详细请求日志和自定义模型定价，跟踪支出、请求数量和令牌使用情况\n\n### 会话管理器与工作区\n\n- 浏览、搜索和恢复所有应用中的对话历史\n- **工作区编辑器**（OpenClaw）— 使用 Markdown 预览编辑代理文件（AGENTS.md、SOUL.md 等）\n\n### 系统与平台\n\n- **云同步** — 自定义配置目录（Dropbox、OneDrive、iCloud、NAS）及 WebDAV 服务器同步\n- **Deep Link** (`ccswitch:\u002F\u002F`) — 通过 URL 导入提供商、MCP 服务器、提示词和 Skills\n- 黑色\u002F白色\u002F系统主题、自动启动、自动更新、原子写入、自动备份、多语言支持（zh\u002Fen\u002Fja）\n\n## 常见问题解答\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>CC Switch 支持哪些 AI CLI 工具？\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nCC Switch 支持五款工具：**Claude Code**、**Codex**、**Gemini CLI**、**OpenCode** 和 **OpenClaw**。每款工具都配有专门的提供商预设和配置管理功能。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>切换提供商后，我需要重启终端吗？\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n对于大多数工具来说，是的——你需要重启终端或对应的 CLI 工具才能使更改生效。例外的是 **Claude Code**，它目前支持在不重启的情况下热切换提供商数据。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>切换提供商后，我的插件配置消失了——这是怎么回事？\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nCC Switch 提供“共享配置片段”功能，用于在不同提供商之间传递公共数据（除了 API 密钥和端点之外）。请前往“编辑提供商”→“共享配置面板”→点击“从当前提供商提取”，以保存所有公共数据。创建新提供商时，请确保勾选“写入共享配置”（默认已启用），这样插件数据就会包含在新提供商中。你首次启动应用时导入的默认提供商中，会保留所有配置项。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>macOS 安装\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nCC Switch 的 macOS 版本已通过 Apple 的代码签名和公证认证。你可以直接下载并安装，无需额外步骤。我们建议使用 `.dmg` 安装程序。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>为什么无法删除当前正在使用的提供商？\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nCC Switch 遵循“最小侵入性”设计原则——即使你卸载了应用，你的 CLI 工具仍能正常运行。系统始终会保留一个有效的配置，因为删除所有配置会导致相应的 CLI 工具无法使用。如果你很少使用某款 CLI 工具，可以在设置中将其隐藏。如需切换回官方登录方式，请参阅下一个问题。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>如何切换回官方登录方式？\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n从预设列表中添加一个官方提供商。切换到该提供商后，执行登出\u002F登录流程，之后你就可以在官方提供商和第三方提供商之间自由切换。Codex 支持在不同的官方提供商之间切换，因此可以轻松在多个 Plus 或 Team 账户之间切换。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>我的数据存储在哪里？\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- **数据库**：`~\u002F.cc-switch\u002Fcc-switch.db`（SQLite — 提供商、MCP、提示词、Skills）\n- **本地设置**：`~\u002F.cc-switch\u002Fsettings.json`（设备级 UI 配置）\n- **备份**：`~\u002F.cc-switch\u002Fbackups\u002F`（自动轮换，保留最近 10 个备份）\n- **Skills**：`~\u002F.cc-switch\u002Fskills\u002F`（默认软链接到相应应用）\n- **Skill 备份**：`~\u002F.cc-switch\u002Fskill-backups\u002F`（卸载前自动创建，保留最近 20 个备份）\n\n\u003C\u002Fdetails>\n\n## 文档\n\n有关各项功能的详细指南，请参阅 **[用户手册](docs\u002Fuser-manual\u002Fen\u002FREADME.md)** — 涵盖提供商管理、MCP\u002F提示词\u002FSkills、代理与故障转移等内容。\n\n## 快速入门\n\n### 基本使用\n\n1. **添加提供商**：点击“添加提供商”→选择预设或创建自定义配置\n2. **切换提供商**：\n   - 主界面：选择提供商→点击“启用”\n   - 系统托盘：直接点击提供商名称（即时生效）\n3. **生效**：重启终端或相应的 CLI 工具以应用更改（Claude Code 无需重启）\n4. **恢复官方设置**：添加“官方登录”预设，重启 CLI 工具，然后按照其登录\u002FOAuth 流程操作\n\n### MCP、提示词、技能与会话\n\n- **MCP**：点击“MCP”按钮→通过模板或自定义配置添加服务器→按应用开启同步\n- **提示词**：点击“提示词”→使用 Markdown 编辑器创建预设→激活后同步到实时文件\n- **技能**：点击“技能”→浏览 GitHub 仓库→一键安装至所有应用\n- **会话**：点击“会话”→跨所有应用浏览、搜索并恢复对话历史\n\n> **注意**：首次启动时，您可以手动导入现有的 CLI 工具配置作为默认提供商。\n\n## 下载与安装\n\n### 系统要求\n\n- **Windows**：Windows 10 及以上版本\n- **macOS**：macOS 12（Monterey）及以上版本\n- **Linux**：Ubuntu 22.04+ \u002F Debian 11+ \u002F Fedora 34+ 及其他主流发行版\n\n### Windows 用户\n\n从 [Releases](..\u002F..\u002Freleases) 页面下载最新的 `CC-Switch-v{version}-Windows.msi` 安装程序或 `CC-Switch-v{version}-Windows-Portable.zip` 便携版。\n\n### macOS 用户\n\n**方法 1：通过 Homebrew 安装（推荐）**\n\n```bash\nbrew tap farion1231\u002Fccswitch\nbrew install --cask cc-switch\n```\n\n更新：\n\n```bash\nbrew upgrade --cask cc-switch\n```\n\n**方法 2：手动下载**\n\n从 [Releases](..\u002F..\u002Freleases) 页面下载 `CC-Switch-v{version}-macOS.dmg`（推荐）或 `.zip` 文件。\n\n> **注意**：macOS 版 CC Switch 经过 Apple 代码签名和公证，您可以直接安装并打开。\n\n### Arch Linux 用户\n\n**通过 paru 安装（推荐）**\n\n```bash\nparu -S cc-switch-bin\n```\n\n### Linux 用户\n\n从 [Releases](..\u002F..\u002Freleases) 页面下载最新的 Linux 版本：\n\n- `CC-Switch-v{version}-Linux.deb`（Debian\u002FUbuntu）\n- `CC-Switch-v{version}-Linux.rpm`（Fedora\u002FRHEL\u002FopenSUSE）\n- `CC-Switch-v{version}-Linux.AppImage`（通用）\n\n> **Flatpak**：未包含在官方发布中。您可以自行基于 `.deb` 构建——具体步骤请参阅 [`flatpak\u002FREADME.md`](flatpak\u002FREADME.md)。\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>架构概述\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n### 设计原则\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                    前端 (React + TS)                    │\n│  ┌─────────────┐  ┌──────────────┐  ┌──────────────────┐    │\n│  │ 组件      │  │    钩子     │  │  TanStack Query  │    │\n│  │   (UI)      │──│ (业务逻辑) │──│   (缓存\u002F同步)   │    │\n│  └─────────────┘  └──────────────┘  └──────────────────┘    │\n└────────────────────────┬────────────────────────────────────┘\n                         │ Tauri IPC\n┌────────────────────────▼────────────────────────────────────┐\n│                  后端 (Tauri + Rust)                     │\n│  ┌─────────────┐  ┌──────────────┐  ┌──────────────────┐    │\n│  │  命令   │  │   服务   │  │  模型\u002F配置   │    │\n│  │ (API 层) │──│ (业务层) │──│     (数据)       │    │\n│  └─────────────┘  └──────────────┘  └──────────────────┘    │\n└─────────────────────────────────────────────────────────────┘\n```\n\n**核心设计模式**\n\n- **SSOT**（单一数据源）：所有数据存储在 `~\u002F.cc-switch\u002Fcc-switch.db`（SQLite）\n- **双层存储**：SQLite 用于可同步数据，JSON 用于设备级设置\n- **双向同步**：切换时写入实时文件，编辑活动提供商时从实时文件回填\n- **原子写入**：临时文件 + 重命名模式防止配置损坏\n- **并发安全**：互斥锁保护的数据库连接避免竞态条件\n- **分层架构**：清晰分离（命令 → 服务 → DAO → 数据库）\n\n**关键组件**\n\n- **ProviderService**：提供商的增删改查、切换、回填及排序\n- **McpService**：MCP 服务器管理、导入导出及实时文件同步\n- **ProxyService**：本地代理模式，支持热切换和格式转换\n- **SessionManager**：跨所有支持的应用浏览对话历史\n- **ConfigService**：配置的导入导出及备份轮转\n- **SpeedtestService**：API 端点延迟测量\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>开发指南\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n### 环境要求\n\n- Node.js 18+\n- pnpm 8+\n- Rust 1.85+\n- Tauri CLI 2.8+\n\n### 开发命令\n\n```bash\n# 安装依赖\npnpm install\n\n# 开发模式（热重载）\npnpm dev\n\n# 类型检查\npnpm typecheck\n\n# 格式化代码\npnpm format\n\n# 检查代码格式\npnpm format:check\n\n# 运行前端单元测试\npnpm test:unit\n\n# 推荐在开发时使用监听模式运行测试\npnpm test:unit:watch\n\n# 构建应用\npnpm build\n\n# 构建调试版本\npnpm tauri build --debug\n```\n\n### Rust 后端开发\n\n```bash\ncd src-tauri\n\n# 格式化 Rust 代码\ncargo fmt\n\n# 运行 clippy 检查\ncargo clippy\n\n# 运行后端测试\ncargo test\n\n# 运行特定测试\ncargo test test_name\n\n# 使用 test-hooks 功能运行测试\ncargo test --features test-hooks\n```\n\n### 测试指南\n\n**前端测试**：\n\n- 使用 **vitest** 作为测试框架\n- 使用 **MSW（Mock Service Worker）** 模拟 Tauri API 调用\n- 使用 **@testing-library\u002Freact** 进行组件测试\n\n**运行测试**：\n\n```bash\n# 运行所有测试\npnpm test:unit\n\n# 监听模式（自动重新运行）\npnpm test:unit:watch\n\n# 带有覆盖率报告\npnpm test:unit --coverage\n```\n\n### 技术栈\n\n**前端**: React 18 · TypeScript · Vite · TailwindCSS 3.4 · TanStack Query v5 · react-i18next · react-hook-form · zod · shadcn\u002Fui · @dnd-kit\n\n**后端**: Tauri 2.8 · Rust · serde · tokio · thiserror · tauri-plugin-updater\u002Fprocess\u002Fdialog\u002Fstore\u002Flog\n\n**测试**: vitest · MSW · @testing-library\u002Freact\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>项目结构\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n```\n├── src\u002F                        # 前端（React + TypeScript）\n│   ├── components\u002F\n│   │   ├── providers\u002F          # Provider 管理\n│   │   ├── mcp\u002F                # MCP 面板\n│   │   ├── prompts\u002F            # Prompts 管理\n│   │   ├── skills\u002F             # Skills 管理\n│   │   ├── sessions\u002F           # 会话管理器\n│   │   ├── proxy\u002F              # 代理模式面板\n│   │   ├── openclaw\u002F           # OpenClaw 配置面板\n│   │   ├── settings\u002F           # 设置（终端\u002F备份\u002F关于）\n│   │   ├── deeplink\u002F           # 深度链接导入\n│   │   ├── env\u002F                # 环境变量管理\n│   │   ├── universal\u002F          # 跨应用配置\n│   │   ├── usage\u002F              # 使用统计\n│   │   └── ui\u002F                 # shadcn\u002Fui 组件库\n│   ├── hooks\u002F                  # 自定义 Hook（业务逻辑）\n│   ├── lib\u002F\n│   │   ├── api\u002F                # Tauri API 封装（类型安全）\n│   │   └── query\u002F              # TanStack Query 配置\n│   ├── locales\u002F                # 多语言翻译（zh\u002Fen\u002Fja）\n│   ├── config\u002F                 # 预设（providers\u002Fmcp）\n│   └── types\u002F                  # TypeScript 类型定义\n├── src-tauri\u002F                  # 后端（Rust）\n│   └── src\u002F\n│       ├── commands\u002F           # Tauri 命令层（按领域划分）\n│       ├── services\u002F           # 业务逻辑层\n│       ├── database\u002F           # SQLite DAO 层\n│       ├── proxy\u002F              # 代理模块\n│       ├── session_manager\u002F    # 会话管理\n│       ├── deeplink\u002F           # 深度链接处理\n│       └── mcp\u002F                # MCP 同步模块\n├── tests\u002F                      # 前端测试\n└── assets\u002F                     # 截图及合作伙伴资源\n```\n\n\u003C\u002Fdetails>\n\n## 参与贡献\n\n欢迎提出问题和建议！\n\n在提交 PR 之前，请确保：\n\n- 通过类型检查：`pnpm typecheck`\n- 通过格式检查：`pnpm format:check`\n- 通过单元测试：`pnpm test:unit`\n\n对于新功能，请先开一个议题进行讨论，再提交 PR。不符合项目定位的功能 PR 可能会被关闭。\n\n## 星标历史\n\n[![星标历史图表](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_readme_b1db3cfc7f47.png)](https:\u002F\u002Fwww.star-history.com\u002F#farion1231\u002Fcc-switch&Date)\n\n## 许可证\n\nMIT © Jason Young","# CC Switch 快速上手指南\n\nCC Switch 是一款基于 Tauri 构建的一体化管理工具，旨在帮助用户轻松切换和管理多种 AI 编程助手，包括 **Claude Code**、**Codex**、**Gemini CLI**、**OpenCode** 和 **OpenClaw**。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**：支持 Windows、macOS 或 Linux。\n*   **前置依赖**：\n    *   已安装目标 AI 工具的底层环境（如 Node.js 用于 Claude Code\u002FCodex，Python 用于 Gemini CLI 等）。\n    *   已配置好相应的 API Key 或认证信息（CC Switch 主要负责工具间的切换与管理，不负责提供模型服务本身，除非配合第三方中继服务使用）。\n\n## 安装步骤\n\n推荐通过 GitHub Releases 页面下载预编译的安装包，这是最稳定且适合国内网络环境的方式。\n\n1.  **访问发布页**：\n    前往 [CC Switch GitHub Releases](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Freleases) 页面。\n\n2.  **下载对应版本**：\n    根据您的操作系统选择最新的安装包：\n    *   **Windows**: 下载 `.exe` 或 `.msi` 文件。\n    *   **macOS**: 下载 `.dmg` (Intel\u002FApple Silicon 通用) 或 `.zip` 文件。\n    *   **Linux**: 下载 `.AppImage`, `.deb` (Debian\u002FUbuntu) 或 `.rpm` (Fedora\u002FRHEL) 文件。\n\n    > **提示**：如果直接下载速度较慢，可尝试使用国内镜像加速工具或代理下载链接。\n\n3.  **执行安装**：\n    *   **Windows**: 双击运行下载的安装程序，按向导完成安装。\n    *   **macOS**: 打开 `.dmg` 文件，将 `CC Switch` 图标拖入 `Applications` 文件夹。\n    *   **Linux**:\n        *   Debian\u002FUbuntu: `sudo dpkg -i cc-switch_x.x.x_amd64.deb`\n        *   其他发行版: 根据文件格式使用对应的包管理器或直接运行 AppImage。\n\n## 基本使用\n\n安装完成后，启动 CC Switch 即可看到图形化界面。\n\n1.  **启动应用**：\n    在系统应用程序列表中找到并打开 **CC Switch**。\n\n2.  **选择目标工具**：\n    在主界面中，您会看到支持的 AI 工具列表（Claude Code, Codex, Gemini CLI 等）。点击您想要使用的工具卡片。\n\n3.  **一键切换\u002F激活**：\n    点击选中工具下方的 **\"Activate\"** 或 **\"Switch\"** 按钮。\n    *   工具会自动配置当前的环境变量或别名，使其在终端中生效。\n    *   状态栏会显示当前活跃的工具名称。\n\n4.  **验证使用**：\n    打开您的终端（Terminal \u002F PowerShell \u002F CMD），输入对应命令即可直接使用选中的工具，无需手动修改配置文件。\n\n    ```bash\n    # 示例：如果您切换到了 Claude Code\n    claude\n\n    # 示例：如果您切换到了 Gemini CLI\n    gemini\n    ```\n\n5.  **配置管理（可选）**：\n    如需添加新的 API Key 或调整特定工具的路径，可在应用设置（Settings）面板中进行可视化配置，无需手动编辑 JSON\u002FYAML 文件。","资深全栈开发者李明正在同时维护三个不同技术栈的项目，需要频繁切换使用 Claude Code 进行重构、Codex 处理遗留逻辑以及 Gemini CLI 生成测试用例。\n\n### 没有 cc-switch 时\n- **环境配置繁琐**：每次切换模型都要手动修改终端环境变量（如 `ANTHROPIC_API_KEY` 或 `GEMINI_API_KEY`），极易出错且打断心流。\n- **多终端混乱**：为了并行任务，不得不打开多个终端窗口分别运行不同 CLI 工具，屏幕空间拥挤，上下文难以管理。\n- **版本更新滞后**：需要单独关注每个 CLI 工具的 GitHub 发布页，手动下载二进制文件并替换，维护成本极高。\n- **配置分散难管**：各个模型的配置文件散落在系统不同目录下，缺乏统一视图，调整参数时如同“大海捞针”。\n\n### 使用 cc-switch 后\n- **一键无缝切换**：通过 cc-switch 的图形界面点击即可瞬间激活目标模型，自动注入对应密钥，无需任何手动命令操作。\n- **统一调度中心**：在一个轻量级窗口内集中管理所有 CLI 工具的状态，支持快速启动和停止，桌面整洁有序。\n- **自动平滑升级**：cc-switch 内置版本检测与更新功能，一键即可完成所有集成工具的升级，始终保持在最新稳定版。\n- **全局配置可视**：提供统一的配置面板，可直观查看和编辑各模型的参数设置，极大提升了调试与优化效率。\n\ncc-switch 将原本碎片化、高摩擦的多模型工作流整合为流畅的一站式体验，让开发者能真正专注于代码本身而非工具调度。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffarion1231_cc-switch_ef81292d.png","farion1231","Jason Young","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Ffarion1231_e57c0e7d.jpg","Full-stack development engineer, exploring magical AI world. Open to interesting opportunities in AI & developer tools.",null,"Jason_Young1231","https:\u002F\u002Fgithub.com\u002Ffarion1231",[83,87,91,95,99],{"name":84,"color":85,"percentage":86},"Rust","#dea584",52.3,{"name":88,"color":89,"percentage":90},"TypeScript","#3178c6",44.8,{"name":92,"color":93,"percentage":94},"HTML","#e34c26",2.3,{"name":96,"color":97,"percentage":98},"JavaScript","#f1e05a",0.5,{"name":100,"color":101,"percentage":102},"CSS","#663399",0.1,38559,2385,"2026-04-04T04:55:59","MIT",1,"Windows, macOS, Linux","未说明",{"notes":111,"python":109,"dependencies":112},"该工具是基于 Tauri 2 构建的桌面应用程序，用于统一管理 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 等 AI 编程工具。作为预编译的二进制文件发布，无需配置 Python 环境或安装额外的 AI 模型依赖库。用户可直接从 GitHub Releases 页面下载对应操作系统的安装包使用。",[113],"Tauri 2",[15],[116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133],"ai-tools","claude-code","desktop-app","open-source","rust","tauri","typescript","codex","mcp","provider-management","wsl-support","minimax","opencode","skills","skills-management","omo","openclaw","openclaw-ui",4,"2026-03-27T02:49:30.150509","2026-04-06T06:46:03.467808",[],[139,144,149,154,159,164,169,174,179,184,189,194,199,204,209,214,219,224,229,234],{"id":140,"version":141,"summary_zh":142,"released_at":143},81296,"v3.12.3","# CC Switch v3.12.3\n\n> GitHub Copilot 反向代理、macOS 代码签名与公证、推理力度映射、OpenCode SQLite 后端\n\n**[中文版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-notes\u002Fv3.12.3-zh.md) | [日语版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-notes\u002Fv3.12.3-ja.md)**\n\n---\n\n## 概述\n\nCC Switch v3.12.3 是一次重要的功能发布，新增了针对 GitHub Copilot 的反向代理支持，并配备了专用的认证中心；引入了 macOS 代码签名和 Apple 公证机制，以提供无缝的安装体验；实现了跨各服务商的推理力度等级映射；将 OpenCode 迁移到 SQLite 后端；通过原生的 `ENABLE_TOOL_SEARCH` 环境变量开关启用了工具搜索功能；并完善了技能的完整备份与恢复流程。此外，还进行了多项改进，包括代理端的 gzip 压缩、o 系列模型兼容性调整、技能导入功能重构、Ghostty 终端问题修复、技能缓存策略优化、Claude 4.6 上下文窗口更新，以及多处 bug 修复。\n\n**发布日期**: 2026-03-24\n\n**更新规模**: 36 次提交 | 107 个文件变更 | 新增 9,124 行 \u002F 删除 802 行\n\n---\n\n## 亮点\n\n- **GitHub Copilot 反向代理**: 完整支持 Copilot 代理功能，包含 OAuth 设备流认证、令牌刷新及请求指纹模拟\n- **Copilot 认证中心**: 专为 GitHub Copilot OAuth 流程设计的认证管理界面，可显示令牌状态并支持一键刷新\n- **macOS 代码签名与公证**: 现在所有 macOS 版本均经过 Apple 代码签名和公证，彻底消除“未识别开发者”的警告提示\n- **推理力度映射**: 在代理层实现自动映射——优先使用显式指定的 `output_config.effort` 参数，若未设置则根据 `budget_tokens` 阈值进行分级（\u003C4,000→低，4,000–16,000→中，≥16,000→高），适用于 o 系列及 GPT-5+ 等模型\n- **OpenCode SQLite 后端**: 为 OpenCode 新增 SQLite 会话存储功能，与现有 JSON 后端并存；当 ID 冲突时优先使用 SQLite 后端\n- **Codex 1M 上下文窗口开关**: 提供一键勾选选项，可将 `model_context_window` 设置为 1,000,000，并自动填充 `model_auto_compact_token_limit`\n- **禁用自动升级开关**: 在 Claude 通用配置编辑器中新增 `DISABLE_AUTOUPDATER` 环境变量开关，用于阻止 Claude Code 自动升级\n- **工具搜索环境变量开关**: 通过 Claude 2.1.76 及更高版本中的原生 `ENABLE_TOOL_SEARCH` 环境变量，在通用配置编辑器中即可启用工具搜索功能，无需对二进制文件进行任何修改\n- **技能备份\u002F恢复生命周期**: 卸载前会自动备份技能；新增备份列表，支持恢复与删除管理\n- **代理 gzip 压缩**: 非流式代理请求现可自动协商启用 gzip 压缩，从而降低带宽消耗\n- **o 系列模型兼容性**: Chat Completions 代理正确使用 `max_completion_tokens` 来处理 o1\u002Fo3\u002Fo4-mini 等模型；而 Responses API 则继续使用正确的 `max_output_tokens` 字段\n- **技能导入功能重构**: 替换了原有的基于文件系统的","2026-03-24T07:44:08",{"id":145,"version":146,"summary_zh":147,"released_at":148},81297,"v3.12.2","# CC Switch v3.12.2\n\n> 代理接管期间的通用配置保护、代码片段生命周期稳定性、分段感知的 Codex TOML 编辑\n\n**[中文版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-notes\u002Fv3.12.2-zh.md) | [日语版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-notes\u002Fv3.12.2-ja.md)**\n\n---\n\n## 概述\n\nCC Switch v3.12.2 是一个以可靠性为核心的补丁版本，主要解决了代理接管过程中通用配置丢失的问题，并提升了 Codex TOML 文件编辑的准确性。现在，代理接管的热切换和提供商同步会更新恢复备份文件，而不是直接覆盖实时配置文件；启动流程也进行了重新排序，确保在恢复接管状态之前，先从干净的实时文件中提取代码片段；此外，Codex 的 `base_url` 编辑功能已被重构为分段感知的模型，不再简单地追加到文件末尾。\n\n**发布日期**：2026年3月12日\n\n**更新规模**：5 个提交 | 22 个文件变更 | 增加 1,716 行 \u002F 减少 288 行\n\n---\n\n## 亮点\n\n- **空状态引导**：提供商列表为空时，现会显示详细的导入说明，并根据条件提示适用于 Claude\u002FCodex\u002FGemini 的通用配置代码片段。\n- **代理接管恢复流程重构**：热切换和提供商同步现在会刷新恢复备份文件，而非直接覆盖实时配置文件，从而在回滚时完整保留用户配置。\n- **代码片段生命周期稳定性**：引入了 `cleared` 标志位，防止已清除的代码片段被自动提取而重新激活；同时调整了启动顺序，确保从干净的状态中提取代码片段。\n- **分段感知的 Codex TOML 编辑**：`base_url` 和 `model` 字段的读写操作现已定向至正确的 `[model_providers.\u003Cname>]` 分段。\n- **Codex MCP 配置保护**：恢复快照中现有的 `mcp_servers` 块会在提供商热切换时通过按服务器 ID 合并的方式保留下来，而非被整体替换；当发生冲突时，提供商定义和通用配置定义将优先生效。\n\n---\n\n## 新特性\n\n### 空状态引导\n\n优化了首次运行体验，在提供商列表为空时提供有用的引导信息。\n\n- 空状态页面显示逐步的导入指南。\n- 根据条件显示适用于 Claude\u002FCodex\u002FGemini 提供商的通用配置代码片段提示（OpenCode\u002FOpenClaw 不显示）。\n\n---\n\n## 变更\n\n### 代理接管恢复流程\n\n针对代理接管的热切换和提供商同步逻辑进行了重构，以在整个接管生命周期中保护通用配置。\n\n- 提供商同步在接管处于活动状态时，会更新恢复备份文件，而非直接写入实时配置文件。\n- 在保存恢复快照之前，系统会基于通用配置重新构建有效的提供商设置，从而确保回滚时能够恢复真实的用户配置。\n- 对于使用推断通用配置的旧版提供商，会自动标记为 `commonConfigEnabled=true`。\n\n### Codex TOML 编辑引擎\n\nCodex 的 `config.toml` 更新逻辑已被重构为共享的分段感知 TOML 辅助函数。\n\n- 引入新的 Rust 模块 `codex_config.rs`，包含 ","2026-03-12T16:02:53",{"id":150,"version":151,"summary_zh":152,"released_at":153},81298,"v3.12.1","# CC Switch v3.12.1\n\n> 稳定性修复、StepFun 预设、OpenClaw authHeader 以及新赞助合作伙伴\n\n**[中文版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-notes\u002Fv3.12.1-zh.md) | [日本語版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-notes\u002Fv3.12.1-ja.md)**\n\n---\n\n## 概述\n\nCC Switch v3.12.1 是一个以稳定性改进和错误修复为重点的补丁版本。它解决了 Common Config 模态框无限重新打开的循环问题、WebDAV 同步中外键约束失败的问题，以及多个 i18n 插值相关的问题。此外，还新增了 **StepFun** 提供商预设、**OpenClaw 输入类型选择** 和 **authHeader** 支持，将默认 Gemini 模型升级至 **3.1-pro**，并迎来了四位新的赞助合作伙伴。\n\n**发布日期**: 2026-03-12\n\n**更新规模**: 19 次提交 | 56 个文件变更 | +1,429 \u002F -396 行\n\n---\n\n## 亮点\n\n- **Common Config 模态框修复**: 解决了 Common Config 模态框中无限重新打开的循环问题，并增加了草稿编辑支持\n- **WebDAV 同步可靠性**: 修复了在 WebDAV 同步过程中恢复 `provider_health` 时出现的外键约束失败问题\n- **StepFun 预设**: 新增 StepFun（阶跃星辰）提供商预设，其中包括 step-3.5-flash 模型\n- **OpenClaw 增强**: 为模型高级选项添加了输入类型选择，并为供应商特定的认证头支持新增了 `authHeader` 字段\n- **Gemini 模型升级**: 在提供商预设中将默认 Gemini 模型升级至 3.1-pro\n- **新赞助商**: 迎来了 Micu API、XCodeAPI、SiliconFlow 和 CTok 四家赞助合作伙伴\n\n---\n\n## 新功能\n\n### StepFun 提供商预设\n\n新增了针对中国领先的 AI 模型提供商 StepFun（阶跃星辰）的提供商预设。\n\n- 在所有支持的应用程序中新增 StepFun 的预设条目\n- 包括 step-3.5-flash 模型 (#1369，感谢 @hengm3467)\n\n### OpenClaw 增强\n\n对 OpenClaw 配置进行了增强，提供了更精细的控制和更好的供应商兼容性。\n\n- 为模型高级选项新增了输入类型选择下拉菜单 (#1368，感谢 @liuxxxu)\n- 在 `OpenClawProviderConfig` 中新增了可选的 `authHeader` 布尔字段，用于支持供应商特定的认证头（例如 Longcat），并重构了表单状态以复用共享类型\n\n### 赞助合作伙伴\n\n- **Micu API**: 新增 Micu API 作为赞助合作伙伴，并附带联盟链接\n- **XCodeAPI**: 新增 XCodeAPI 作为赞助合作伙伴\n- **SiliconFlow**: 新增 SiliconFlow（硅基流动）作为赞助合作伙伴，并附带联盟链接\n- **CTok**: 新增 CTok 作为赞助合作伙伴\n\n---\n\n## 变更\n\n- **UCloud → Compshare**: 将 UCloud 提供商更名为 Compshare（优云智算），并在三种语言环境（EN\u002FZH\u002FJA）中全面支持国际化\n- **Compshare 链接**: 更新了 Compshare 赞助注册链接，指向 coding-plan 页面\n- **Gemini 模型升级**: 在提供商预设中将默认 Gemini 模型从 2.5-pro 升级至 3.1-pro\n\n---\n\n## 错误修复\n\n### Common Config & UI\n\n- 修复了 Common Config 模态框中的无限重新打开循环问题，并增加了草稿编辑支持，以防止数据丢失","2026-03-11T16:26:25",{"id":155,"version":156,"summary_zh":157,"released_at":158},81299,"v3.12.0","# CC Switch v3.12.0\n\n> 流检查回归，OpenAI Responses API 上线，OpenClaw 和 WebDAV 迎来重大升级\n\n**[中文版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-notes\u002Fv3.12.0-zh.md) | [日语版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-notes\u002Fv3.12.0-ja.md)**\n\n---\n\n## 概述\n\nCC Switch v3.12.0 是一次以提供商兼容性、OpenClaw 编辑功能、Common Config 易用性以及同步\u002F数据可靠性为重点的功能发布。它恢复了 **模型健康检查（流检查）** UI，并提升了稳定性；新增了 **OpenAI Responses API** 格式转换功能；扩展了对 **Ucloud**、**Micu**、**X-Code API**、**Novita** 和 **Bailian For Coding** 的提供商预设；同时对 **WebDAV 同步** 进行了升级，引入双层版本控制。\n\n**发布日期**：2026-03-09\n\n**更新规模**：56 个提交 | 221 个文件变更 | +20,582 \u002F -8,026 行代码\n\n---\n\n## 亮点\n\n- **流检查回归**：恢复模型健康检查界面，增加首次运行确认，并修复了 `openai_chat` 提供商的支持问题。\n- **OpenAI Responses API**：新增 `api_format = \"openai_responses\"` 选项，支持双向格式转换，并统一了转换逻辑——只需在添加提供商时选择 Responses API 格式并启用代理接管，即可在 Claude Code 中使用 GPT 系列模型！\n- **OpenClaw 全面升级**：引入 JSON5 循环编辑配置、配置健康状态横幅、更完善的代理模型选择以及 User-Agent 切换功能。\n- **预设扩展**：新增 Ucloud、Micu、X-Code API、Novita 和 Bailian For Coding 的更新，同时增加了 SiliconFlow 合作伙伴徽章和模型角色徽章。\n- **同步与维护改进**：新增 WebDAV 协议 v2 和 db-v6 版本控制，支持每日汇总、增量自动清理以及同步感知的备份功能。\n- **Common Config 易用性提升**：更新 Common Config Snippet 后，切换提供商时会自动应用，无需再手动勾选复选框。\n\n---\n\n## 主要特性\n\n### 模型健康检查（流检查）\n\n恢复了用于实时验证提供商状态的流检查面板，进一步提升了提供商管理的可靠性。\n\n- 恢复流检查 UI 面板，支持单个或批量提供商可用性检测。\n- 增加首次运行确认对话框，避免不支持的提供商显示误导性错误信息。\n- 修复了对 `openai_chat` API 格式提供商的检测兼容性问题。\n\n### OpenAI Responses API\n\n新增对使用 OpenAI Responses API 的提供商的原生支持，引入全新的 `openai_responses` API 格式。\n\n- 新增 `api_format = \"openai_responses\"` 提供商格式选项。\n- 支持 Anthropic Messages 与 OpenAI Responses API 格式之间的双向转换。\n- 整合共享的转换逻辑，减少代码重复。\n\n### Bedrock 请求优化器\n\n为 AWS Bedrock 提供商新增 PRE-SEND 阶段请求优化器，以提升兼容性和性能。\n\n- 引入 PRE-SEND 思考 + 缓存注入优化器 (#1301，感谢 @keithyt06)。\n\n### OpenClaw 配置增强\n\nC","2026-03-09T14:00:54",{"id":160,"version":161,"summary_zh":162,"released_at":163},81300,"v3.11.1","# CC Switch v3.11.1\n\n> 恢复部分键字段合并，还原通用配置片段及修复若干Bug\n\n**[中文版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.11.1-zh.md) | [日文版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.11.1-ja.md)**\n\n---\n\n## 概述\n\nCC Switch v3.11.1 是一个热修复版本，它回滚了在 v3.11.0 中引入的 **部分键字段合并** 架构，恢复了经过验证的“完整配置覆盖 + 通用配置片段”机制。此外，还包含多项 UI 和平台兼容性修复。\n\n**发布日期**：2026-02-28\n\n**更新规模**：8 次提交 | 52 个文件变更 | 增加 3,948 行 \u002F 减少 1,411 行\n\n---\n\n## 亮点\n\n- **恢复完整配置覆盖 + 通用配置片段**：由于出现严重数据丢失问题，已回滚部分键字段合并；恢复完整配置快照写入和通用配置片段界面\n- **代理面板改进**：将代理开关移至面板主体内，以便更直观地发现接管选项\n- **主题与紧凑模式修复**：“跟随系统”主题现可自动更新；紧凑模式退出功能恢复正常\n- **Windows 兼容性**：禁用环境检查和一键安装，以避免协议处理程序带来的副作用\n\n---\n\n## 回滚内容\n\n### 恢复完整配置覆盖 + 通用配置片段\n\n回滚了 v3.11.0 中引入的部分键字段合并重构（回滚 commit：992dda5c）。\n\n**为何回滚**：部分键字段合并方案存在三个关键问题：\n1. **切换时数据丢失**：非白名单的自定义字段在提供商切换过程中会被静默丢弃\n2. **永久性后填剥离**：后填会永久从数据库中移除非键字段，导致不可逆的数据损失\n3. **维护负担重**：随着新配置键的不断添加，需要持续维护“键字段”白名单\n\n**恢复的内容**：\n- 提供商切换时的完整配置快照写入（可预测、完全覆盖）\n- 通用配置片段的 UI 和后端命令\n- 6 个前端组件\u002F钩子（3 个组件 + 3 个钩子）\n\n**迁移说明**：\n- 如果您已升级到 v3.11.0，并且提供商的自定义字段丢失，请重新导入配置或手动补充缺失的字段\n- 通用配置片段现已恢复使用——请利用它来定义跨提供商切换时应保持一致的共享配置\n\n---\n\n## 变更内容\n\n- **代理面板布局**：将代理开启\u002F关闭开关由折叠面板头部移至面板内容区域，置于应用接管选项正上方。此举确保用户在启用代理后能立即看到接管配置，从而避免常见错误——仅启用代理而未配置接管功能\n- **OpenCode\u002FOpenClaw 手动导入**：移除了启动时的自动导入功能；空状态现显示“导入当前配置”按钮，与 Claude\u002FCodex\u002FGemini 的行为保持一致\n\n---\n\n## 修复内容\n\n- **“跟随系统”主题无法自动更新**：已交由 Tauri 的原生主题跟踪功能处理（`set_window_theme(None)`）s","2026-02-28T08:23:34",{"id":165,"version":166,"summary_zh":167,"released_at":168},81301,"v3.11.0","# CC Switch v3.11.0\n\n> OpenClaw 支持、会话管理器、备份管理及 50 多项改进\n\n**[中文版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.11.0-zh.md) | [日语版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.11.0-ja.md)**\n\n---\n\n## 概述\n\nCC Switch v3.11.0 是一次重大更新，新增对第五款应用 **OpenClaw** 的全面管理支持，并引入全新的 **会话管理器** 和 **备份管理** 功能。此外，还加入了 **Oh My OpenCode (OMO) 集成**、针对提供商切换的 **部分键字段合并** 架构升级、**设置页面重构** 等诸多改进，使整体体验更加完善。\n\n**发布日期**: 2026-02-26\n\n**更新规模**: 147 次提交 | 274 个文件变更 | +32,179 \u002F -5,467 行代码\n\n---\n\n## 亮点\n\n- **OpenClaw 支持**: 第五款受管应用，提供 13 种提供商预设、Env\u002FTools\u002FAgentsDefaults 配置编辑器以及工作区文件管理功能\n- **会话管理器**: 可跨所有五款应用浏览对话历史，支持目录式导航和会话内搜索\n- **备份管理**: 独立的备份面板，具备可配置策略、定期备份及迁移前自动备份功能\n- **Oh My OpenCode 集成**: 完整的 OMO 配置管理，同时支持 OMO Slim 轻量模式\n- **部分键字段合并（⚠️ 破坏性变更）**: 提供商切换现仅替换与提供商相关的字段，保留其他所有设置；“通用配置片段”功能已被移除\n- **设置页面重构**: 采用 5 标签页布局，代码量减少约 40%\n- **6 种新提供商预设**: AWS Bedrock、SSAI Code、CrazyRouter、AICoding 等\n- **思考预算调节器**: 实现精细化的思考预算控制\n- **主题切换动画**: 圆形展开过渡动画\n- **WebDAV 自动同步**: 自动同步功能，并附带大文件保护机制\n\n---\n\n## 主要特性\n\n### OpenClaw 支持（新增第五款应用）\n\n对 OpenClaw 的全面管理支持，使其成为继 Claude Code、Codex、Gemini CLI 和 OpenCode 之后的第五款受管应用。\n\n- **提供商管理**: 可添加、编辑、切换及删除 OpenClaw 提供商，内置 13 种预设\n- **配置编辑器**: 专门配备 Env（环境变量）、Tools 和 AgentsDefaults 三个面板\n- **工作区面板**: 用于管理 HEARTBEAT\u002FBOOTSTRAP\u002FBOOT 文件及每日记忆\n- **叠加模式**: 支持配置叠加而非覆盖\n- **默认模型按钮**: 一键填充推荐模型；添加提供商时会自动将建议模型注册到白名单中\n- **品牌与交互**: 专属品牌图标，切换应用时带有淡入淡出过渡动画\n- **深度链接支持**: 可通过 URL 导入 OpenClaw 提供商配置\n- **完全国际化**: 全面支持中文、英文和日文\n\n### 会话管理器\n\n全新推出的会话管理器，可用于浏览和搜索对话历史记录。\n\n- 可跨 Claude Code、Codex、Gemini 浏览对话历史","2026-02-26T15:24:57",{"id":170,"version":171,"summary_zh":172,"released_at":173},81302,"v3.10.3","# CC Switch v3.10.3\n\n## 功能发布\n\n> API 格式选择器、定价优化、技能 ZIP 安装及 Linux ARM64 支持\n\n## 新增功能\n\n- **API 格式选择器**：为 Claude 提供商提供通用的 API 格式选择器，取代仅适用于 OpenRouter 的切换按钮。支持 Anthropic Messages（原生）和 OpenAI Chat Completions 格式。\n- **API 格式预设**：允许预设提供商为第三方代理服务指定 API 格式（anthropic 或 openai_chat）。\n- **定价配置增强**：支持按提供商设置成本倍数、定价模型来源（请求\u002F响应）、请求模型日志记录，并丰富了用量界面（#781，感谢 @yovinchen）。\n- **技能 ZIP 安装**：支持从本地 ZIP 文件直接安装技能，并提供递归扫描功能。\n- **首选终端**：可为各平台选择默认终端应用（macOS：Terminal.app\u002FiTerm2\u002FAlacritty\u002FKitty\u002FGhostty；Windows：cmd\u002FPowerShell\u002FWindows Terminal；Linux：GNOME Terminal\u002FKonsole\u002FXfce4\u002FAlacritty\u002FKitty\u002FGhostty）。\n- **静默启动**：新增选项以防止启动时弹出窗口（#713，感谢 @funnytime75）。\n- **OpenCode API 密钥链接**：为 OpenCode 提供商表单添加 API 密钥链接支持。\n- **OpenCode 环境检查**：通过 Go 路径扫描检测版本，并支持从 GitHub Releases 一键安装。\n- **OpenCode 目录同步**：在目录发生变更时自动将所有提供商同步到实时配置文件中，并支持累加模式。\n- **AICodeMirror 合作伙伴预设**：为所有应用（Claude、Codex、Gemini、OpenCode）添加 AICodeMirror 合作伙伴预设。\n- **NVIDIA NIM 预设**：为 Claude 和 OpenCode 添加新的提供商预设，使用 nvidia.svg 图标。\n- **n1n.ai 预设**：新增提供商预设（#667，感谢 @n1n-api）。\n- **Linux ARM64**：新增对 Linux ARM64 架构的 CI 构建支持。\n\n## 变更内容\n\n- **API 格式迁移**：将 api_format 从 settings_config 迁移到 ProviderMeta，以避免污染 ~\u002F.claude\u002Fsettings.json。\n- **DeepSeek max_tokens**：移除代理转换层中的 max_tokens 限制。\n- **终端函数**：整合冗余的终端启动函数。\n- **Home 目录工具**：将 get_home_dir 整合为单一公共函数。\n- **Kimi\u002FMoonshot**：将提供商预设升级至 k2.5 模型。\n- **更新徽章图标**：将更新徽章上的圆点替换为 ArrowUpCircle 图标。\n\n## 修复内容\n\n- **Codex 404 与超时问题**：修复自定义 base_url 下的 404 错误和连接超时问题；改进 \u002Fv1 前缀处理及系统代理检测功能（#760，感谢 @Darkbluelr）。\n- **代理 URL 构建**：修复 URL 中重复的 \u002Fv1\u002Fv1；将 ?beta=true 参数扩展至 \u002Fv1\u002Fchat\u002Fcompletions 端点。\n- **OpenRouter 兼容模式**：提升向后兼容性，支持数字和字符串类型。\n- **Gemini 可见性**：修正 Gemini 默认可见性为 true（#818，感谢 @zhu-jl18）。\n- **页脚布局**：修正高级设置选项卡中的页脚布局。\n- **Claude 代码检测**：优先使用原生安装路径进行检测。\n- **托盘菜单**：简化标题标签并优化菜单分隔线（#796，感谢 @fchange）。\n- **重复技能**：防止技能重复安装。","2026-01-31T13:36:20",{"id":175,"version":176,"summary_zh":177,"released_at":178},81303,"v3.10.2","# CC Switch v3.10.2\n\n## 补丁发布\n\n> 此维护版本新增了技能同步选项，并包含重要的错误修复。\n\n## 新增功能\n\n- **技能**：添加技能同步方式设置，支持符号链接和复制两种选项\n- **合作伙伴**：新增 RightCode 为官方合作伙伴\n\n## 修复内容\n\n- **提示**：当所有提示均被禁用时，清空提示文件\n- **OpenCode**：在序列化过程中保留额外的模型字段\n- **提供商表单**：编辑 Claude 提供商时，回填模型字段\n\n# CC Switch v3.10.1\n\n## 补丁发布\n\n> 此维护版本针对 Windows 平台进行了重要错误修复，同时优化了用户界面并提升了代码质量。\n\n## 新增功能\n\n- **提供商图标**：更新了 RightCode 提供商图标，视觉设计更加精美\n\n## 变更内容\n\n- **代理整流器**：为提升稳定性，将整流器默认状态改为禁用\n- **窗口设置**：重新排列窗口设置并更新默认值，以改善用户体验\n- **UI 布局**：将应用图标折叠阈值由 3 个增加至 4 个\n- **代码质量**：使用 `#[derive(Default)]` 简化了 `RectifierConfig` 的实现\n\n## 修复内容\n\n- **Windows 平台**：\n  - 修复了在 Windows 上执行后终端窗口立即关闭的问题\n  - 修正了 OpenCode 配置路径在 Windows 上的解析问题\n- **UI 改进**：\n  - 修复了 ProviderIcon 颜色验证问题，避免出现黑色图标\n  - 统一了各面板的布局内边距，使间距更加一致\n  - 修复了面板内容与页眉约束对齐的问题\n\n# CC Switch v3.10.0\n\n> OpenCode 支持、全局代理、Claude 整流器及多应用体验增强\n\n**[中文版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.10.0-zh.md) | [日语版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.10.0-ja.md)**\n\n---\n\n## 概述\n\nCC Switch v3.10.0 引入了 OpenCode 支持，使其成为第四款受管理的 CLI 应用程序。本次发布还带来了全局代理设置、Claude 整流器（用于修复思考签名以提高与第三方 API 的兼容性）、增强的健康检查功能、按提供商配置等功能，以及对多应用工作流程和终端体验的全面改进。\n\n**发布日期**：2026年1月21日\n\n---\n\n## 亮点\n\n- OpenCode 支持：全面管理提供商、MCP 服务器和技能，并在首次启动时自动导入\n- 全局代理：可为所有出站网络请求配置统一代理\n- Claude 整流器：用于修复思考签名，以更好地兼容第三方 API\n- 增强的健康检查：可配置提示信息及兼容 CLI 的请求格式\n- 按提供商配置：支持持久化的提供商特定配置\n- 应用可见性控制：可自由显示或隐藏应用，并同步更新托盘菜单\n- 终端改进：提供针对不同提供商的专用终端按钮、fnm 路径支持以及跨平台安全启动\n- WSL 工具检测：可在 WSL 环境中检测工具版本，并加强安全性\n\n---\n\n## 主要功能","2026-01-24T14:28:33",{"id":180,"version":181,"summary_zh":182,"released_at":183},81304,"v3.10.1","# CC Switch v3.10.1\n\n## 补丁发布\n\n> 本次维护版本包含针对 Windows 平台的重要 bug 修复、UI 改进以及代码质量提升。\n\n## 新增功能\n\n- **提供商图标**：更新了 RightCode 提供商图标，视觉设计更加优化\n\n## 变更内容\n\n- **代理整流器**：为提升稳定性，将整流器的默认状态改为禁用\n- **窗口设置**：重新排列了窗口设置，并更新了默认值，以改善用户体验\n- **UI 布局**：将应用图标折叠阈值由 3 个增加至 4 个\n- **代码质量**：使用 `#[derive(Default)]` 简化了 `RectifierConfig` 的实现\n\n## 修复内容\n\n- **Windows 平台**：\n  - 修复了在 Windows 上执行后终端窗口立即关闭的问题\n  - 修正了 OpenCode 配置路径在 Windows 上的解析问题\n- **UI 改进**：\n  - 修复了 ProviderIcon 颜色验证问题，避免出现黑色图标\n  - 统一了所有面板的布局内边距，使间距更加一致\n  - 修复了面板内容与页眉约束对齐的问题\n\n# CC Switch v3.10.0\n\n> OpenCode 支持、全局代理、Claude 整流器及多应用体验增强\n\n**[中文版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.10.0-zh.md) | [日文版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.10.0-ja.md)**\n\n---\n\n## 概述\n\nCC Switch v3.10.0 引入了 OpenCode 支持，使其成为第四款受管理的 CLI 应用程序。本次发布还带来了全局代理设置、Claude 整流器（用于修复思考签名以提高与第三方 API 的兼容性）、增强的健康检查功能、按提供商配置等功能，以及对多应用工作流程和终端体验的全面改进。\n\n**发布日期**：2026年1月21日\n\n---\n\n## 亮点\n\n- OpenCode 支持：全面管理提供商、MCP 服务器和 Skills，并在首次启动时自动导入\n- 全局代理：可为所有出站网络请求配置统一的代理\n- Claude 整流器：用于修复思考签名，以更好地兼容第三方 API\n- 增强的健康检查：支持可配置的提示信息和兼容 CLI 的请求格式\n- 按提供商配置：支持持久化的提供商特定配置\n- 应用可见性控制：可自由显示或隐藏应用，并同步更新托盘菜单\n- 终端改进：提供提供商专用的终端按钮、fnm 路径支持以及跨平台的安全启动功能\n- WSL 工具检测：可在 WSL 环境中检测工具版本，并加强安全性\n\n---\n\n## 主要特性\n\n### OpenCode 支持（新增第四款应用）\n\n- 完整的 OpenCode 提供商管理：添加、编辑、切换、删除\n- MCP 服务器管理：与 Claude\u002FCodex\u002FGemini 采用统一架构\n- Skills 支持：OpenCode 同样可以使用 Skills 功能\n- 首次启动自动导入：检测到现有 OpenCode 配置时会自动导入\n- 全面国际化：支持中文、英文和日文 (#695)\n\n### 全局代理\n\n- 为所有出站","2026-01-23T02:51:44",{"id":185,"version":186,"summary_zh":187,"released_at":188},81305,"v3.10.0","# CC Switch v3.10.0\n\n> OpenCode 支持、全局代理、Claude 修复器及多应用体验增强\n\n**[中文版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.10.0-zh.md) | [日语版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.10.0-ja.md)**\n\n---\n\n## 概述\n\nCC Switch v3.10.0 新增了 OpenCode 支持，使其成为第四款受管理的 CLI 应用程序。本次发布还带来了全局代理设置、Claude 修复器（用于修复思考签名以提高与第三方 API 的兼容性）、增强的健康检查功能、按提供商配置以及许多其他重要特性，同时还对多应用工作流和终端体验进行了全面优化。\n\n**发布日期**: 2026-01-21\n\n---\n\n## 亮点\n\n- OpenCode 支持：完整管理提供商、MCP 服务器和 Skills，并在首次启动时自动导入\n- 全局代理：为所有出站网络请求配置统一的代理\n- Claude 修复器：用于改善与第三方 API 兼容性的思考签名修复工具\n- 增强的健康检查：可配置提示信息及与 CLI 兼容的请求格式\n- 按提供商配置：支持持久化的提供商特定配置\n- 应用可见性控制：可自由显示或隐藏应用，并同步更新托盘菜单\n- 终端改进：提供针对不同提供商的专用终端按钮、fnm 路径支持以及跨平台安全启动\n- WSL 工具检测：在 WSL 环境中检测工具版本，并加强安全性\n\n---\n\n## 主要特性\n\n### OpenCode 支持（新增第四款应用）\n\n- 完整的 OpenCode 提供商管理：添加、编辑、切换、删除\n- MCP 服务器管理：与 Claude\u002FCodex\u002FGemini 采用统一架构\n- Skills 支持：OpenCode 也可使用 Skills 功能\n- 首次启动时自动导入：检测到现有 OpenCode 配置时会自动导入\n- 全面国际化：支持中文、英文和日文 (#695)\n\n### 全局代理\n\n- 为所有出站网络请求配置统一代理 (#596，感谢 @yovinchen)\n- 支持 HTTP\u002FHTTPS 代理协议\n- 适用于需要通过代理访问外部 API 的网络环境\n\n### Claude 修复器（思考签名修复工具）\n\n- 自动修复 Claude API 的思考签名 (#595，感谢 @yovinchen)\n- 解决部分第三方 API 网关返回的不兼容思考块格式问题\n- 可在高级设置中启用或禁用\n\n### 增强的健康检查\n\n- 可配置自定义提示信息，用于流式健康检查 (#623，感谢 @yovinchen)\n- 支持与 CLI 兼容的请求格式，以便更好地模拟实际使用场景\n- 提高故障检测的准确性\n\n### 按提供商配置\n\n- 支持为每个提供商单独保存配置 (#663，感谢 @yovinchen)\n- 持久化配置：重启后仍保留提供商特定设置\n- 适用于不同提供商需要不同配置的场景\n\n### 应用可见性控制\n\n- 可自由显示或隐藏任何应用（Gemini 已隐藏 b","2026-01-22T03:02:16",{"id":190,"version":191,"summary_zh":192,"released_at":193},81306,"v3.9.1","# CC Switch v3.9.1\r\n\r\n\r\n## Bug Fixes\r\n\r\n  Panic\u002FCrash Fixes (#560)\r\n\r\n  - Proxy port conflict: Changed default port from 5000 to 15721 (5000 conflicts with AirPlay Receiver on macOS 12+)\r\n  - UTF-8 boundary panics: Fixed multiple locations where byte slicing on multi-byte characters (Chinese, emoji) could cause panics:\r\n    - API key preview\r\n    - Request body log truncation\r\n    - masked_key \u002F masked_access_token functions\r\n    - HTTP response truncation in usage_script\r\n  - Unwrap\u002Fexpect replacements: Added graceful error handling for HTTP client init, response body builder, SystemTime edge cases, and JSON operations\r\n  - SOCKS proxy support: Added reqwest socks feature\r\n\r\n##  Other Fixes\r\n\r\n  - fix(windows): Correct window title and remove extra titlebar spacing\r\n  - fix(presets): Rename AiGoCode to AIGoCode (capitalization)\r\n\r\n##  New Features\r\n\r\n  - feat(logging): Add crash logging and improve log management (#562)\r\n  - feat(presets): Add AiGoCode icon and partner promotion\r\n\r\n##  CI\u002FBuild\r\n\r\n  - fix(ci): Temporarily remove Flatpak build due to persistent libdbusmenu\u002Flibayatana dependency issues in GNOME SDK 46\r\n\r\n\r\n# CC Switch v3.9.0\r\n\r\n> Local API Proxy, Auto Failover, Universal Provider, and a more complete multi-app workflow\r\n\r\n**[中文版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.9.0-zh.md) | [日本語版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.9.0-ja.md)**\r\n\r\n---\r\n\r\n## Overview\r\n\r\nCC Switch v3.9.0 is the stable release of the v3.9 beta series (`3.9.0-1`, `3.9.0-2`, `3.9.0-3`).\r\nIt introduces a local API proxy with per-app takeover, automatic failover, universal providers, and many stability and UX improvements across Claude Code, Codex, and Gemini CLI.\r\n\r\n**Release Date**: 2026-01-07\r\n\r\n---\r\n\r\n## Highlights\r\n\r\n- Local API Proxy for Claude Code \u002F Codex \u002F Gemini CLI\r\n- Auto Failover with circuit breaker and per-app failover queues\r\n- Universal Provider: one shared config synced across apps (ideal for API gateways like NewAPI)\r\n- Skills improvements: multi-app support, unified management with SSOT + React Query\r\n- Common config snippets: extract reusable snippets from the editor or the current provider\r\n- MCP import: import MCP servers from installed apps\r\n- Usage improvements: auto-refresh, cache hit\u002Fcreation metrics, and timezone fixes\r\n- Linux packaging: RPM and Flatpak artifacts\r\n\r\n---\r\n\r\n## Major Features\r\n\r\n### Local API Proxy\r\n\r\n- Runs a local high-performance HTTP proxy server (Axum-based)\r\n- Supports Claude Code, Codex, and Gemini CLI with a unified proxy\r\n- Per-app takeover: you can independently decide which app routes through the proxy\r\n- Live config takeover: backs up and redirects the CLI live config to the local proxy when takeover is enabled\r\n- Monitoring: request logging and usage statistics for easier debugging and cost tracking\r\n- Error request logging: keep detailed logs for failed proxy requests to simplify debugging (#401, thanks @yovinchen)\r\n\r\n### Auto Failover (Circuit Breaker)\r\n\r\n- Automatically detects provider failures and triggers protection (circuit breaker)\r\n- Automatically switches to a backup provider when the current one is unhealthy\r\n- Tracks provider health in real time, and keeps independent failover queues per app\r\n- When failover is disabled, timeout\u002Fretry related settings no longer affect normal request flow\r\n\r\n### Skills Management\r\n\r\n- Multi-app Skills support for Claude Code and Codex, with smoother migration from older skill layouts (#365, #378, thanks @yovinchen)\r\n- Unified Skills management architecture (SSOT + React Query) for more consistent state and refresh behavior\r\n- Better discovery UX and performance:\r\n  - Skip hidden directories during discovery\r\n  - Faster discovery with long-lived caching for discoverable skills\r\n  - Clear loading indicators and more discoverable header actions (import\u002Frefresh)\r\n  - Fix wrong skill repo branch (#505, thanks @kjasn)\r\n\r\n### Universal Provider\r\n\r\n- Add a shared provider configuration that can sync to Claude\u002FCodex\u002FGemini (#348, thanks @Calcium-Ion)\r\n- Designed for API gateways that support multiple protocols (e.g., NewAPI)\r\n- Allows per-app default model mapping under a single provider\r\n\r\n### Common Config Snippets (Claude\u002FCodex\u002FGemini)\r\n\r\n- Maintain a reusable \"common config\" snippet and merge\u002Fappend it into providers that enable it\r\n- New extraction workflow:\r\n  - Extract from the editor content (what you are currently editing)\r\n  - Or extract from the current active provider when the editor content is not provided\r\n- Codex extraction is safer:\r\n  - Removes provider-specific sections like `model_provider`, `model`, and the entire `model_providers` table\r\n  - Preserves `base_url` under `[mcp_servers.*]` so MCP configs are not accidentally broken\r\n\r\n### MCP Management\r\n\r\n- Import MCP servers from installed apps\r\n- Improve robustness: skip sync when the target CLI app is not installed; handle invalid Codex `config.toml` gracefully (#461, thanks @majiayu000)\r\n- W","2026-01-09T14:11:17",{"id":195,"version":196,"summary_zh":197,"released_at":198},81307,"v3.9.0","# CC Switch v3.9.0\r\n\r\n> Local API Proxy, Auto Failover, Universal Provider, and a more complete multi-app workflow\r\n\r\n**[中文版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.9.0-zh.md) | [日本語版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.9.0-ja.md)**\r\n\r\n---\r\n\r\n## Overview\r\n\r\nCC Switch v3.9.0 is the stable release of the v3.9 beta series (`3.9.0-1`, `3.9.0-2`, `3.9.0-3`).\r\nIt introduces a local API proxy with per-app takeover, automatic failover, universal providers, and many stability and UX improvements across Claude Code, Codex, and Gemini CLI.\r\n\r\n**Release Date**: 2026-01-07\r\n\r\n---\r\n\r\n## Highlights\r\n\r\n- Local API Proxy for Claude Code \u002F Codex \u002F Gemini CLI\r\n- Auto Failover with circuit breaker and per-app failover queues\r\n- Universal Provider: one shared config synced across apps (ideal for API gateways like NewAPI)\r\n- Skills improvements: multi-app support, unified management with SSOT + React Query\r\n- Common config snippets: extract reusable snippets from the editor or the current provider\r\n- MCP import: import MCP servers from installed apps\r\n- Usage improvements: auto-refresh, cache hit\u002Fcreation metrics, and timezone fixes\r\n- Linux packaging: RPM and Flatpak artifacts\r\n\r\n---\r\n\r\n## Major Features\r\n\r\n### Local API Proxy\r\n\r\n- Runs a local high-performance HTTP proxy server (Axum-based)\r\n- Supports Claude Code, Codex, and Gemini CLI with a unified proxy\r\n- Per-app takeover: you can independently decide which app routes through the proxy\r\n- Live config takeover: backs up and redirects the CLI live config to the local proxy when takeover is enabled\r\n- Monitoring: request logging and usage statistics for easier debugging and cost tracking\r\n- Error request logging: keep detailed logs for failed proxy requests to simplify debugging (#401, thanks @yovinchen)\r\n\r\n### Auto Failover (Circuit Breaker)\r\n\r\n- Automatically detects provider failures and triggers protection (circuit breaker)\r\n- Automatically switches to a backup provider when the current one is unhealthy\r\n- Tracks provider health in real time, and keeps independent failover queues per app\r\n- When failover is disabled, timeout\u002Fretry related settings no longer affect normal request flow\r\n\r\n### Skills Management\r\n\r\n- Multi-app Skills support for Claude Code and Codex, with smoother migration from older skill layouts (#365, #378, thanks @yovinchen)\r\n- Unified Skills management architecture (SSOT + React Query) for more consistent state and refresh behavior\r\n- Better discovery UX and performance:\r\n  - Skip hidden directories during discovery\r\n  - Faster discovery with long-lived caching for discoverable skills\r\n  - Clear loading indicators and more discoverable header actions (import\u002Frefresh)\r\n  - Fix wrong skill repo branch (#505, thanks @kjasn)\r\n\r\n### Universal Provider\r\n\r\n- Add a shared provider configuration that can sync to Claude\u002FCodex\u002FGemini (#348, thanks @Calcium-Ion)\r\n- Designed for API gateways that support multiple protocols (e.g., NewAPI)\r\n- Allows per-app default model mapping under a single provider\r\n\r\n### Common Config Snippets (Claude\u002FCodex\u002FGemini)\r\n\r\n- Maintain a reusable \"common config\" snippet and merge\u002Fappend it into providers that enable it\r\n- New extraction workflow:\r\n  - Extract from the editor content (what you are currently editing)\r\n  - Or extract from the current active provider when the editor content is not provided\r\n- Codex extraction is safer:\r\n  - Removes provider-specific sections like `model_provider`, `model`, and the entire `model_providers` table\r\n  - Preserves `base_url` under `[mcp_servers.*]` so MCP configs are not accidentally broken\r\n\r\n### MCP Management\r\n\r\n- Import MCP servers from installed apps\r\n- Improve robustness: skip sync when the target CLI app is not installed; handle invalid Codex `config.toml` gracefully (#461, thanks @majiayu000)\r\n- Windows compatibility: wrap npx\u002Fnpm commands with `cmd \u002Fc` for MCP export\r\n\r\n### Usage & Pricing\r\n\r\n- Usage & pricing improvements: auto-refresh, cache hit\u002Fcreation metrics, timezone handling fixes, and refreshed built-in pricing table (#508, thanks @yovinchen)\r\n- DeepLink support: import usage query configuration via deeplink (#400, thanks @qyinter)\r\n- Model extraction for usage statistics (#455, thanks @yovinchen)\r\n- Usage query credentials can fall back to provider config (#360, thanks @Sirhexs)\r\n\r\n---\r\n\r\n## UX Improvements\r\n\r\n- Provider search filter: quickly find providers by name (#435, thanks @TinsFox)\r\n- Provider icon colors: customize provider icon colors for quicker visual identification (#385, thanks @yovinchen)\r\n- Keyboard shortcut: `Cmd\u002FCtrl + ,` opens Settings (#436, thanks @TinsFox)\r\n- Skip Claude Code first-run confirmation dialog (optional)\r\n- Closable toasts: close buttons for switch toast and all success toasts (#350, thanks @ForteScarlet)\r\n- Update badge navigation: clicking the update badge opens the About tab\r\n- Settings page tab style improvements (#342, thanks @wenyuanw)\r\n- Smoother transitions: fade","2026-01-08T05:00:37",{"id":200,"version":201,"summary_zh":202,"released_at":203},81308,"v3.9.0-3","## CC Switch v3.9.0-3\r\n\r\nv3.9.0-3 更新内容\r\n\r\n  新功能\r\n\r\n  - Universal Provider 通用供应商配置支持\r\n  - 自动故障转移主开关，与代理服务集成\r\n  - 供应商搜索过滤功能\r\n  - 键盘快捷键打开设置 (Command+逗号 \u002F Ctrl+逗号)\r\n  - 小米 MiMo 图标和供应商配置\r\n  - 用量统计模型信息提取\r\n  - 跳过 Claude Code 首次运行确认的选项\r\n  - 面板切换淡入淡出动画\r\n\r\n  问题修复\r\n\r\n  Windows\r\n  - MCP 导出时 npx\u002Fnpm 命令兼容性修复\r\n  - 版本检查时防止终端窗口弹出\r\n\r\n  macOS\r\n  - 开机自启使用 .app 路径，防止终端窗口弹出\r\n\r\n  界面\r\n  - 修复 Dialog\u002FModal 首次点击无法打开的问题\r\n  - 改善暗色模式表单标签对比度\r\n  - 修复视图切换时 header 布局偏移\r\n\r\n  其他\r\n  - 用量统计使用本地时区和健壮的夏令时处理\r\n  - MCP 同步时优雅处理无效的 Codex config.toml\r\n  - 添加 proxy_config 数据库迁移兼容性检查\r\n\r\n  改进\r\n\r\n  - macOS 托盘使用模板图标\r\n  - 移除 titlebar 染色，对齐自定义 header\r\n  - 完善用量面板和设置的国际化\r\n\r\n\r\n## 为防止数据丢失，运行前请务必备份  ~\u002F.cc-switch\u002Fcc-switch.db！！！\r\n## 为防止数据丢失，运行前请务必备份  ~\u002F.cc-switch\u002Fcc-switch.db！！！\r\n## 为防止数据丢失，运行前请务必备份  ~\u002F.cc-switch\u002Fcc-switch.db！！！\r\n## 如果需要运行 v3.8.* 版本，需要将备份的 cc-switch.db 放回原位置\r\n\r\n## ⚠️ **IMPORTANT — Please back up your data before running**\r\n\r\n### To prevent data loss, **make sure to back up `~\u002F.cc-switch\u002Fcc-switch.db` before running the application!**\r\n### (To emphasize: please back up `~\u002F.cc-switch\u002Fcc-switch.db` before running.)\r\n\r\n### If you need to run a **v3.8.*** version later, please restore the backed-up `cc-switch.db` file to its original location.\r\n\r\n\r\n### 代理功能使用说明：\r\nhttps:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Fproxy-guide-zh.md\r\n目前暂时无法代理官方供应商\r\n","2025-12-30T01:15:00",{"id":205,"version":206,"summary_zh":207,"released_at":208},81309,"v3.8.3","# CC Switch v3.8.3\r\n\r\n## Added\r\n\r\n- **macOS tray template icon** - Use system template icon for better dark\u002Flight mode adaptation\r\n- **AiGoCode partner** - Added AiGoCode icon and partner promotion\r\n- **Skip first-run confirmation** - New setting to skip Claude Code first-run confirmation dialog\r\n- **DMXAPI partner** - Added DMXAPI as official partner\r\n- **Provider icons** - Added icons for OpenRouter, LongCat, ModelScope, AiHubMix\r\n\r\n## Fixed\r\n\r\n- **UI header layout** - Fixed content being covered by fixed header (added padding-top)\r\n- **Dark mode visibility** - Improved text visibility in dark mode\r\n- **Azure link** - Corrected Azure website link (#407)\r\n- **Skill installation** - Use directory basename for skill installation path (#358)\r\n- **SQL import refresh** - Refresh all providers immediately after SQL import\r\n- **MCP sync safety** - Skip sync when target CLI app is not installed\r\n\r\n## Changed\r\n\r\n- **Model versions** - Updated model versions for provider presets\r\n- **Provider switch notification** - Removed restart prompt from notification\r\n- **SQL import restriction** - Restrict SQL import to CC Switch exported backups only\r\n- **GLM partner images** - Updated partner banner images\r\n\r\n# CC Switch v3.8.2\r\n\r\n## Changes\r\n\r\n - Fix provider card hover scale animation being clipped\r\n - Update DeepSeek default model from experimental to stable version\r\n\r\n# CC Switch v3.8.1\r\n\r\n###  Bug Fixes\r\n\r\n 1. Linux Scroll Wheel Issue (98084d6)\r\n    - Fixed scroll wheel events being intercepted by DndContext on Linux\u002FUbuntu WebKitGTK\r\n    - Added independent scroll containers to all main pages\r\n 2. Codex Config Updates (a627e1b)\r\n    - Updated default model from gpt-5-codex to gpt-5.1-codex\r\n    - Corrected MiniMax English preset URL\r\n 3. MiniMax URL Corrections (5888c56, c5cadb7)\r\n    - Multiple fixes to apiKeyUrl domain: minimax.io → minimax.com → minimaxi.com\r\n 4. UI Style Fixes\r\n    - Fixed active provider card highlight disappearing when not hovered (526c740)\r\n    - Fixed transparent dialog backgrounds by adding shadcn\u002Fui color mappings (0f333d9)\r\n    - Skills page light mode compatibility fixes (6ac4d16, 2643595)\r\n\r\n### Refactoring\r\n\r\n  1. MCP Modularization (7e6074a)\r\n    - Split 1135-line mcp.rs into focused modules: validation.rs, claude.rs, codex.rs, gemini.rs\r\n    - Extracted tray menu logic from lib.rs to tray.rs\r\n  2. URL Handling Improvement (3bf37cf)\r\n    - Removed automatic trailing slash stripping, giving users full control over URL format\r\n    - Updated i18n hints to instruct users to avoid trailing slashes\r\n  3. Dead Code Removal (75e7f9d)\r\n    - Cleaned up unused functions and imports across multiple modules\r\n\r\n\r\n# CC Switch v3.8.0\r\n\r\n> Persistence Architecture Upgrade, Laying the Foundation for Cloud Sync\r\n\r\n**[中文版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.8.0-zh.md) | [日本語版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.8.0-ja.md)**\r\n\r\n---\r\n\r\n## Overview\r\n\r\nCC Switch v3.8.0 is a major architectural upgrade that restructures the data persistence layer and user interface, laying the foundation for future cloud sync and local proxy features.\r\n\r\n**Release Date**: 2025-11-28\r\n**Commits**: 51 commits since v3.7.1\r\n**Code Changes**: 207 files, +17,297 \u002F -6,870 lines\r\n\r\n---\r\n\r\n## Major Updates\r\n\r\n### Persistence Architecture Upgrade\r\n\r\nMigrated from single JSON file storage to SQLite + JSON dual-layer architecture for hierarchical data management.\r\n\r\n**Architecture Changes**:\r\n\r\n```\r\nv3.7.x (Old)                     v3.8.0 (New)\r\n┌─────────────────┐              ┌─────────────────────────────────┐\r\n│  config.json    │              │  SQLite (Syncable Data)         │\r\n│  ┌───────────┐  │              │  ├─ providers     Provider cfg  │\r\n│  │ providers │  │              │  ├─ mcp_servers   MCP servers   │\r\n│  │ mcp       │  │     ──>      │  ├─ prompts       Prompts       │\r\n│  │ prompts   │  │              │  ├─ skills        Skills        │\r\n│  │ settings  │  │              │  └─ settings      General cfg   │\r\n│  └───────────┘  │              ├─────────────────────────────────┤\r\n└─────────────────┘              │  JSON (Device-level Data)       │\r\n                                 │  └─ settings.json Local settings│\r\n                                 │     ├─ Window position          │\r\n                                 │     ├─ Path overrides           │\r\n                                 │     └─ Current provider ID      │\r\n                                 └─────────────────────────────────┘\r\n```\r\n\r\n**Dual-layer Structure Design**:\r\n\r\n| Layer      | Storage | Data Types                      | Sync Strategy   |\r\n| ---------- | ------- | ------------------------------- | --------------- |\r\n| Cloud Sync | SQLite  | Providers, MCP, Prompts, Skills | Future syncable |\r\n| Device     | JSON    | Window state, local paths       | Stays local     |\r\n\r\n**Technical Implementation**:\r\n\r\n- **Schema Version Management** - Supports database structure upgrade migra","2025-12-24T07:32:27",{"id":210,"version":211,"summary_zh":212,"released_at":213},81310,"v3.9.0-2","## CC Switch v3.9.0-2 测试版\r\n\r\n### 新功能                                                                                                                                                                \r\n                                                                                                                                                                                                                                                                                          \r\n  - **新增供应商图标** - OpenRouter、LongCat、ModelScope、AiHubMix (`4a1a997`)                                                                                                 \r\n                                                                                                                                                                               \r\n  ### 问题修复                                                                                                                                                              \r\n                                                                                                                                                                               \r\n  - **修复 Claude 配置同步** - 同步时保留已存在的 token 字段，避免写回重复 KEY (`8ecb41d`)                                                                                 \r\n  - **修复代理孤儿状态** - 添加 takeover 状态的回退恢复机制 (`3e8f844`)                                                                                                        \r\n  - **修复 SQL 导入** - 导入后立即刷新所有供应商列表 (`b6ff721`)                                                                                                               \r\n  - **限制 SQL 导入来源** - 仅允许导入 CC Switch 导出的备份文件，增强安全性 (`1706c9a`)                                                                                        \r\n  - **修复 Windows 窗口** - 添加最小宽度\u002F高度配置，防止窗口过小 (`64e0cab`)                                                                                                    \r\n  - **修复关于页面 UI** (`5bce6d6`)                                                                                                                                            \r\n                                                                                                                                                                               \r\n  ### 重构                                                                                                                                                                  \r\n                                                                                                                                                                               \r\n  - **OpenRouter 透传模式** -  OpenRouter现在原生支持 Claude Code 格式，暂时注释格式转换逻辑(`c4535c8`)                                                                                               \r\n  - **移除代理全局自动启动功能** - 简化代理启动逻辑，降低复杂度 (`ba59483`)                                                                                                                    \r\n                                                                                                                                                                               \r\n  ### 样式优化                                                                                                                                                              \r\n                                                                                                                                                                               \r\n  - **统一顶栏样式** - 统一 header 工具栏各区块的高度和样式 (`5fe5ed9`)    \r\n\r\n\r\n\r\n## 为防止数据丢失，运行前请务必备份  ~\u002F.cc-switch\u002Fcc-switch.db！！！\r\n## 为防止数据丢失，运行前请务必备份  ~\u002F.cc-switch\u002Fcc-switch.db！！！\r\n## 为防止数据丢失，运行前请务必备份  ~\u002F.cc-switch\u002Fcc-switch.db！！！\r\n## 如果需要运行 v3.8.* 版本，需要将备份的 cc-switch.db 放回原位置\r\n\r\n## ⚠️ **IMPORTANT — Please back up your data before running**\r\n\r\n### To prevent data loss, **make sure to back up `~\u002F.cc-switch\u002Fcc-switch.db` before running the application!**\r\n### (To emphasize: please back up `~\u002F.cc-switch\u002Fcc-switch.db` before running.)\r\n\r\n### If you need to run a **v3.8.*** version later, please restore the backed-up `cc-switch.db` file to its original location.\r\n\r\n\r\n### 代理功能使用说明：\r\nhttps:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Fproxy-guide-zh.md\r\n目前暂时无法代理官方供应商","2025-12-20T10:19:38",{"id":215,"version":216,"summary_zh":217,"released_at":218},81311,"v3.9.0-1","## CC Switch v3.9.0-1 测试版\r\n\r\n## 为防止数据丢失，运行前请务必备份  ~\u002F.cc-switch\u002Fcc-switch.db！！！\r\n## 为防止数据丢失，运行前请务必备份  ~\u002F.cc-switch\u002Fcc-switch.db！！！\r\n## 为防止数据丢失，运行前请务必备份  ~\u002F.cc-switch\u002Fcc-switch.db！！！\r\n### 如果需要运行 v3.8.* 版本，需要将备份的 cc-switch.db 放回原位置\r\n\r\n### 代理功能使用说明：\r\nhttps:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Fproxy-guide-zh.md\r\n目前暂时无法代理官方供应商","2025-12-18T14:11:31",{"id":220,"version":221,"summary_zh":222,"released_at":223},81312,"v3.8.2","# CC Switch v3.8.2\r\n\r\n## Changes\r\n\r\n - Fix provider card hover scale animation being clipped\r\n - Update DeepSeek default model from experimental to stable version\r\n\r\n# CC Switch v3.8.1\r\n\r\n###  Bug Fixes\r\n\r\n 1. Linux Scroll Wheel Issue (98084d6)\r\n    - Fixed scroll wheel events being intercepted by DndContext on Linux\u002FUbuntu WebKitGTK\r\n    - Added independent scroll containers to all main pages\r\n 2. Codex Config Updates (a627e1b)\r\n    - Updated default model from gpt-5-codex to gpt-5.1-codex\r\n    - Corrected MiniMax English preset URL\r\n 3. MiniMax URL Corrections (5888c56, c5cadb7)\r\n    - Multiple fixes to apiKeyUrl domain: minimax.io → minimax.com → minimaxi.com\r\n 4. UI Style Fixes\r\n    - Fixed active provider card highlight disappearing when not hovered (526c740)\r\n    - Fixed transparent dialog backgrounds by adding shadcn\u002Fui color mappings (0f333d9)\r\n    - Skills page light mode compatibility fixes (6ac4d16, 2643595)\r\n\r\n### Refactoring\r\n\r\n  1. MCP Modularization (7e6074a)\r\n    - Split 1135-line mcp.rs into focused modules: validation.rs, claude.rs, codex.rs, gemini.rs\r\n    - Extracted tray menu logic from lib.rs to tray.rs\r\n  2. URL Handling Improvement (3bf37cf)\r\n    - Removed automatic trailing slash stripping, giving users full control over URL format\r\n    - Updated i18n hints to instruct users to avoid trailing slashes\r\n  3. Dead Code Removal (75e7f9d)\r\n    - Cleaned up unused functions and imports across multiple modules\r\n\r\n\r\n# CC Switch v3.8.0\r\n\r\n> Persistence Architecture Upgrade, Laying the Foundation for Cloud Sync\r\n\r\n**[中文版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.8.0-zh.md) | [日本語版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.8.0-ja.md)**\r\n\r\n---\r\n\r\n## Overview\r\n\r\nCC Switch v3.8.0 is a major architectural upgrade that restructures the data persistence layer and user interface, laying the foundation for future cloud sync and local proxy features.\r\n\r\n**Release Date**: 2025-11-28\r\n**Commits**: 51 commits since v3.7.1\r\n**Code Changes**: 207 files, +17,297 \u002F -6,870 lines\r\n\r\n---\r\n\r\n## Major Updates\r\n\r\n### Persistence Architecture Upgrade\r\n\r\nMigrated from single JSON file storage to SQLite + JSON dual-layer architecture for hierarchical data management.\r\n\r\n**Architecture Changes**:\r\n\r\n```\r\nv3.7.x (Old)                     v3.8.0 (New)\r\n┌─────────────────┐              ┌─────────────────────────────────┐\r\n│  config.json    │              │  SQLite (Syncable Data)         │\r\n│  ┌───────────┐  │              │  ├─ providers     Provider cfg  │\r\n│  │ providers │  │              │  ├─ mcp_servers   MCP servers   │\r\n│  │ mcp       │  │     ──>      │  ├─ prompts       Prompts       │\r\n│  │ prompts   │  │              │  ├─ skills        Skills        │\r\n│  │ settings  │  │              │  └─ settings      General cfg   │\r\n│  └───────────┘  │              ├─────────────────────────────────┤\r\n└─────────────────┘              │  JSON (Device-level Data)       │\r\n                                 │  └─ settings.json Local settings│\r\n                                 │     ├─ Window position          │\r\n                                 │     ├─ Path overrides           │\r\n                                 │     └─ Current provider ID      │\r\n                                 └─────────────────────────────────┘\r\n```\r\n\r\n**Dual-layer Structure Design**:\r\n\r\n| Layer      | Storage | Data Types                      | Sync Strategy   |\r\n| ---------- | ------- | ------------------------------- | --------------- |\r\n| Cloud Sync | SQLite  | Providers, MCP, Prompts, Skills | Future syncable |\r\n| Device     | JSON    | Window state, local paths       | Stays local     |\r\n\r\n**Technical Implementation**:\r\n\r\n- **Schema Version Management** - Supports database structure upgrade migrations\r\n- **SQL Import\u002FExport** - `backup.rs` supports SQL dump for cloud storage\r\n- **Transaction Support** - SQLite native transactions ensure data consistency\r\n- **Auto Migration** - Automatically migrates from `config.json` on first launch\r\n\r\n**Modular Refactoring**:\r\n\r\n```\r\ndatabase\u002F\r\n├── mod.rs              Core Database struct and initialization\r\n├── schema.rs           Table definitions, schema version migrations\r\n├── backup.rs           SQL import\u002Fexport, binary snapshot backup\r\n├── migration.rs        JSON → SQLite data migration engine\r\n└── dao\u002F                Data Access Object layer\r\n    ├── providers.rs    Provider CRUD\r\n    ├── mcp.rs          MCP server CRUD\r\n    ├── prompts.rs      Prompts CRUD\r\n    ├── skills.rs       Skills CRUD\r\n    └── settings.rs     Key-value settings storage\r\n```\r\n\r\n---\r\n\r\n### Brand New User Interface\r\n\r\nCompletely redesigned UI providing a more modern visual experience.\r\n\r\n**Visual Improvements**:\r\n\r\n- Redesigned interface layout\r\n- Unified component styles\r\n- Smoother transition animations\r\n- Optimized visual hierarchy\r\n\r\n**Interaction Enhancements**:\r\n\r\n- Redesigned header toolbar\r\n- Unified ConfirmDialog styling\r\n- Disabled overscroll bounce effect o","2025-12-01T14:50:05",{"id":225,"version":226,"summary_zh":227,"released_at":228},81313,"v3.8.1","# CC Switch v3.8.1\r\n\r\n###  Bug Fixes\r\n\r\n 1. Linux Scroll Wheel Issue (98084d6)\r\n    - Fixed scroll wheel events being intercepted by DndContext on Linux\u002FUbuntu WebKitGTK\r\n    - Added independent scroll containers to all main pages\r\n 2. Codex Config Updates (a627e1b)\r\n    - Updated default model from gpt-5-codex to gpt-5.1-codex\r\n    - Corrected MiniMax English preset URL\r\n 3. MiniMax URL Corrections (5888c56, c5cadb7)\r\n    - Multiple fixes to apiKeyUrl domain: minimax.io → minimax.com → minimaxi.com\r\n 4. UI Style Fixes\r\n    - Fixed active provider card highlight disappearing when not hovered (526c740)\r\n    - Fixed transparent dialog backgrounds by adding shadcn\u002Fui color mappings (0f333d9)\r\n    - Skills page light mode compatibility fixes (6ac4d16, 2643595)\r\n\r\n### Refactoring\r\n\r\n  1. MCP Modularization (7e6074a)\r\n    - Split 1135-line mcp.rs into focused modules: validation.rs, claude.rs, codex.rs, gemini.rs\r\n    - Extracted tray menu logic from lib.rs to tray.rs\r\n  2. URL Handling Improvement (3bf37cf)\r\n    - Removed automatic trailing slash stripping, giving users full control over URL format\r\n    - Updated i18n hints to instruct users to avoid trailing slashes\r\n  3. Dead Code Removal (75e7f9d)\r\n    - Cleaned up unused functions and imports across multiple modules\r\n\r\n\r\n# CC Switch v3.8.0\r\n\r\n> Persistence Architecture Upgrade, Laying the Foundation for Cloud Sync\r\n\r\n**[中文版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.8.0-zh.md) | [日本語版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.8.0-ja.md)**\r\n\r\n---\r\n\r\n## Overview\r\n\r\nCC Switch v3.8.0 is a major architectural upgrade that restructures the data persistence layer and user interface, laying the foundation for future cloud sync and local proxy features.\r\n\r\n**Release Date**: 2025-11-28\r\n**Commits**: 51 commits since v3.7.1\r\n**Code Changes**: 207 files, +17,297 \u002F -6,870 lines\r\n\r\n---\r\n\r\n## Major Updates\r\n\r\n### Persistence Architecture Upgrade\r\n\r\nMigrated from single JSON file storage to SQLite + JSON dual-layer architecture for hierarchical data management.\r\n\r\n**Architecture Changes**:\r\n\r\n```\r\nv3.7.x (Old)                     v3.8.0 (New)\r\n┌─────────────────┐              ┌─────────────────────────────────┐\r\n│  config.json    │              │  SQLite (Syncable Data)         │\r\n│  ┌───────────┐  │              │  ├─ providers     Provider cfg  │\r\n│  │ providers │  │              │  ├─ mcp_servers   MCP servers   │\r\n│  │ mcp       │  │     ──>      │  ├─ prompts       Prompts       │\r\n│  │ prompts   │  │              │  ├─ skills        Skills        │\r\n│  │ settings  │  │              │  └─ settings      General cfg   │\r\n│  └───────────┘  │              ├─────────────────────────────────┤\r\n└─────────────────┘              │  JSON (Device-level Data)       │\r\n                                 │  └─ settings.json Local settings│\r\n                                 │     ├─ Window position          │\r\n                                 │     ├─ Path overrides           │\r\n                                 │     └─ Current provider ID      │\r\n                                 └─────────────────────────────────┘\r\n```\r\n\r\n**Dual-layer Structure Design**:\r\n\r\n| Layer      | Storage | Data Types                      | Sync Strategy   |\r\n| ---------- | ------- | ------------------------------- | --------------- |\r\n| Cloud Sync | SQLite  | Providers, MCP, Prompts, Skills | Future syncable |\r\n| Device     | JSON    | Window state, local paths       | Stays local     |\r\n\r\n**Technical Implementation**:\r\n\r\n- **Schema Version Management** - Supports database structure upgrade migrations\r\n- **SQL Import\u002FExport** - `backup.rs` supports SQL dump for cloud storage\r\n- **Transaction Support** - SQLite native transactions ensure data consistency\r\n- **Auto Migration** - Automatically migrates from `config.json` on first launch\r\n\r\n**Modular Refactoring**:\r\n\r\n```\r\ndatabase\u002F\r\n├── mod.rs              Core Database struct and initialization\r\n├── schema.rs           Table definitions, schema version migrations\r\n├── backup.rs           SQL import\u002Fexport, binary snapshot backup\r\n├── migration.rs        JSON → SQLite data migration engine\r\n└── dao\u002F                Data Access Object layer\r\n    ├── providers.rs    Provider CRUD\r\n    ├── mcp.rs          MCP server CRUD\r\n    ├── prompts.rs      Prompts CRUD\r\n    ├── skills.rs       Skills CRUD\r\n    └── settings.rs     Key-value settings storage\r\n```\r\n\r\n---\r\n\r\n### Brand New User Interface\r\n\r\nCompletely redesigned UI providing a more modern visual experience.\r\n\r\n**Visual Improvements**:\r\n\r\n- Redesigned interface layout\r\n- Unified component styles\r\n- Smoother transition animations\r\n- Optimized visual hierarchy\r\n\r\n**Interaction Enhancements**:\r\n\r\n- Redesigned header toolbar\r\n- Unified ConfirmDialog styling\r\n- Disabled overscroll bounce effect on main view\r\n- Improved form validation feedback\r\n\r\n**Compatibility Adjustments**:\r\n\r\n- Downgraded Tailwind CSS from v4 to v3.4 for better browser compatibility\r\n\r\n--","2025-12-01T03:46:46",{"id":230,"version":231,"summary_zh":232,"released_at":233},81314,"v3.8.0","# CC Switch v3.8.0\r\n\r\n> Persistence Architecture Upgrade, Laying the Foundation for Cloud Sync\r\n\r\n**[中文版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.8.0-zh.md) | [日本語版 →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.8.0-ja.md)**\r\n\r\n---\r\n\r\n## Overview\r\n\r\nCC Switch v3.8.0 is a major architectural upgrade that restructures the data persistence layer and user interface, laying the foundation for future cloud sync and local proxy features.\r\n\r\n**Release Date**: 2025-11-28\r\n**Commits**: 51 commits since v3.7.1\r\n**Code Changes**: 207 files, +17,297 \u002F -6,870 lines\r\n\r\n---\r\n\r\n## Major Updates\r\n\r\n### Persistence Architecture Upgrade\r\n\r\nMigrated from single JSON file storage to SQLite + JSON dual-layer architecture for hierarchical data management.\r\n\r\n**Architecture Changes**:\r\n\r\n```\r\nv3.7.x (Old)                     v3.8.0 (New)\r\n┌─────────────────┐              ┌─────────────────────────────────┐\r\n│  config.json    │              │  SQLite (Syncable Data)         │\r\n│  ┌───────────┐  │              │  ├─ providers     Provider cfg  │\r\n│  │ providers │  │              │  ├─ mcp_servers   MCP servers   │\r\n│  │ mcp       │  │     ──>      │  ├─ prompts       Prompts       │\r\n│  │ prompts   │  │              │  ├─ skills        Skills        │\r\n│  │ settings  │  │              │  └─ settings      General cfg   │\r\n│  └───────────┘  │              ├─────────────────────────────────┤\r\n└─────────────────┘              │  JSON (Device-level Data)       │\r\n                                 │  └─ settings.json Local settings│\r\n                                 │     ├─ Window position          │\r\n                                 │     ├─ Path overrides           │\r\n                                 │     └─ Current provider ID      │\r\n                                 └─────────────────────────────────┘\r\n```\r\n\r\n**Dual-layer Structure Design**:\r\n\r\n| Layer      | Storage | Data Types                      | Sync Strategy   |\r\n| ---------- | ------- | ------------------------------- | --------------- |\r\n| Cloud Sync | SQLite  | Providers, MCP, Prompts, Skills | Future syncable |\r\n| Device     | JSON    | Window state, local paths       | Stays local     |\r\n\r\n**Technical Implementation**:\r\n\r\n- **Schema Version Management** - Supports database structure upgrade migrations\r\n- **SQL Import\u002FExport** - `backup.rs` supports SQL dump for cloud storage\r\n- **Transaction Support** - SQLite native transactions ensure data consistency\r\n- **Auto Migration** - Automatically migrates from `config.json` on first launch\r\n\r\n**Modular Refactoring**:\r\n\r\n```\r\ndatabase\u002F\r\n├── mod.rs              Core Database struct and initialization\r\n├── schema.rs           Table definitions, schema version migrations\r\n├── backup.rs           SQL import\u002Fexport, binary snapshot backup\r\n├── migration.rs        JSON → SQLite data migration engine\r\n└── dao\u002F                Data Access Object layer\r\n    ├── providers.rs    Provider CRUD\r\n    ├── mcp.rs          MCP server CRUD\r\n    ├── prompts.rs      Prompts CRUD\r\n    ├── skills.rs       Skills CRUD\r\n    └── settings.rs     Key-value settings storage\r\n```\r\n\r\n---\r\n\r\n### Brand New User Interface\r\n\r\nCompletely redesigned UI providing a more modern visual experience.\r\n\r\n**Visual Improvements**:\r\n\r\n- Redesigned interface layout\r\n- Unified component styles\r\n- Smoother transition animations\r\n- Optimized visual hierarchy\r\n\r\n**Interaction Enhancements**:\r\n\r\n- Redesigned header toolbar\r\n- Unified ConfirmDialog styling\r\n- Disabled overscroll bounce effect on main view\r\n- Improved form validation feedback\r\n\r\n**Compatibility Adjustments**:\r\n\r\n- Downgraded Tailwind CSS from v4 to v3.4 for better browser compatibility\r\n\r\n---\r\n\r\n### Japanese Language Support\r\n\r\nAdded Japanese interface support, expanding internationalization to three languages.\r\n\r\n**Supported Languages**:\r\n\r\n- Simplified Chinese\r\n- English\r\n- Japanese (New)\r\n\r\n---\r\n\r\n## New Features\r\n\r\n### Skills Recursive Scanning\r\n\r\nSkills management system now supports recursive scanning of repository directories, automatically discovering nested skill files.\r\n\r\n**Improvements**:\r\n\r\n- Support for multi-level directory structures\r\n- Automatic discovery of all `SKILL.md` files\r\n- Allow same-named skills from different repositories (using full path for deduplication)\r\n\r\n---\r\n\r\n### Provider Icon Configuration\r\n\r\nProvider presets now support custom icon configuration.\r\n\r\n**Features**:\r\n\r\n- Preset providers include default icons\r\n- Icon settings preserved when duplicating providers\r\n- Custom icon colors\r\n\r\n---\r\n\r\n### Enhanced Form Validation\r\n\r\nProvider forms now include required field validation with friendlier error messages.\r\n\r\n**Improvements**:\r\n\r\n- Real-time validation for required fields\r\n- Unified Toast notifications for validation errors\r\n- Clearer error messages\r\n\r\n---\r\n\r\n### Auto Launch on Startup\r\n\r\nAdded auto-launch functionality supporting Windows, macOS, and Linux platforms.\r\n\r\n**Features**:\r\n\r\n- One-click enable\u002Fdisable in setti","2025-11-28T15:08:45",{"id":235,"version":236,"summary_zh":237,"released_at":238},81315,"v3.7.1","# CC Switch v3.7.1\r\n\r\n> Stability Enhancements and User Experience Improvements\r\n\r\n**[中文更新说明 Chinese Documentation →](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-note-v3.7.1-zh.md)**\r\n\r\n---\r\n\r\n## v3.7.1 Updates\r\n\r\n**Release Date**: 2025-11-22\r\n**Code Changes**: 17 files, +524 \u002F -81 lines\r\n\r\n### Bug Fixes\r\n\r\n- **Fix Third-Party Skills Installation Failure** (#268)\r\n  Fixed installation issues for skills repositories with custom subdirectories, now supports repos like `ComposioHQ\u002Fawesome-claude-skills` with subdirectories\r\n\r\n- **Fix Gemini Configuration Persistence Issue**\r\n  Resolved the issue where settings.json edits in Gemini form were lost when switching providers\r\n\r\n- **Prevent Dialogs from Closing on Overlay Click**\r\n  Added protection against clicking overlay\u002Fbackdrop, preventing accidental form data loss across all 11 dialog components\r\n\r\n### New Features\r\n\r\n- **Gemini Configuration Directory Support** (#255)\r\n  Added Gemini configuration directory option in settings, supports customizing `~\u002F.gemini\u002F` path\r\n\r\n- **ArchLinux Installation Support** (#259)\r\n  Added AUR installation method: `paru -S cc-switch-bin`\r\n\r\n### Improvements\r\n\r\n- **Skills Error Message i18n Enhancement**\r\n  Added 28+ detailed error messages (English & Chinese) with specific resolution suggestions, extended download timeout from 15s to 60s\r\n\r\n- **Code Formatting**\r\n  Applied unified Rust and TypeScript code formatting standards\r\n\r\n### Download\r\n\r\nVisit [Releases](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Freleases\u002Flatest) to download the latest version\r\n\r\n---\r\n\r\n## v3.7.0 Complete Release Notes\r\n\r\n> From Provider Switcher to All-in-One AI CLI Management Platform\r\n\r\n**Release Date**: 2025-11-19\r\n**Commits**: 85 from v3.6.0\r\n**Code Changes**: 152 files, +18,104 \u002F -3,732 lines\r\n\r\n---\r\n\r\n## New Features\r\n\r\n### Gemini CLI Integration\r\n\r\nComplete support for Google Gemini CLI, becoming the third supported application (Claude Code, Codex, Gemini).\r\n\r\n**Core Capabilities**:\r\n\r\n- **Dual-file configuration** - Support for both `.env` and `settings.json` formats\r\n- **Auto-detection** - Automatically detect `GOOGLE_GEMINI_BASE_URL`, `GEMINI_MODEL`, etc.\r\n- **Full MCP support** - Complete MCP server management for Gemini\r\n- **Deep link integration** - Import via `ccswitch:\u002F\u002F` protocol\r\n- **System tray** - Quick-switch from tray menu\r\n\r\n**Provider Presets**:\r\n\r\n- **Google Official** - OAuth authentication support\r\n- **PackyCode** - Partner integration\r\n- **Custom** - Full customization support\r\n\r\n**Technical Implementation**:\r\n\r\n- New backend modules: `gemini_config.rs` (20KB), `gemini_mcp.rs`\r\n- Form synchronization with environment editor\r\n- Dual-file atomic writes\r\n\r\n---\r\n\r\n### MCP v3.7.0 Unified Architecture\r\n\r\nComplete refactoring of MCP management system for cross-application unification.\r\n\r\n**Architecture Improvements**:\r\n\r\n- **Unified panel** - Single interface for Claude\u002FCodex\u002FGemini MCP servers\r\n- **SSE transport** - New Server-Sent Events support\r\n- **Smart parser** - Fault-tolerant JSON parsing\r\n- **Format correction** - Auto-fix Codex `[mcp_servers]` format\r\n- **Extended fields** - Preserve custom TOML fields\r\n\r\n**User Experience**:\r\n\r\n- Default app selection in forms\r\n- JSON formatter for validation\r\n- Improved visual hierarchy\r\n- Better error messages\r\n\r\n**Import\u002FExport**:\r\n\r\n- Unified import from all three apps\r\n- Bidirectional synchronization\r\n- State preservation\r\n\r\n---\r\n\r\n### Claude Skills Management System\r\n\r\n**Approximately 2,000 lines of code** - A complete skill ecosystem platform.\r\n\r\n**GitHub Integration**:\r\n\r\n- Auto-scan skills from GitHub repositories\r\n- Pre-configured repos:\r\n  - `ComposioHQ\u002Fawesome-claude-skills` - Curated collection\r\n  - `anthropics\u002Fskills` - Official Anthropic skills\r\n  - `cexll\u002Fmyclaude` - Community contributions\r\n- Add custom repositories\r\n- Subdirectory scanning support (`skillsPath`)\r\n\r\n**Lifecycle Management**:\r\n\r\n- **Discover** - Auto-detect `SKILL.md` files\r\n- **Install** - One-click to `~\u002F.claude\u002Fskills\u002F`\r\n- **Uninstall** - Safe removal with tracking\r\n- **Update** - Check for updates (infrastructure ready)\r\n\r\n**Technical Architecture**:\r\n\r\n- **Backend**: `SkillService` (526 lines) with GitHub API integration\r\n- **Frontend**: SkillsPage, SkillCard, RepoManager\r\n- **UI Components**: Badge, Card, Table (shadcn\u002Fui)\r\n- **State**: Persistent storage in `config.json`\r\n- **i18n**: 47+ translation keys\r\n\r\n---\r\n\r\n### Prompts Management System\r\n\r\n**Approximately 1,300 lines of code** - Complete system prompt management.\r\n\r\n**Multi-Preset Management**:\r\n\r\n- Create unlimited prompt presets\r\n- Quick switch between presets\r\n- One active prompt at a time\r\n- Delete protection for active prompts\r\n\r\n**Cross-App Support**:\r\n\r\n- **Claude**: `~\u002F.claude\u002FCLAUDE.md`\r\n- **Codex**: `~\u002F.codex\u002FAGENTS.md`\r\n- **Gemini**: `~\u002F.gemini\u002FGEMINI.md`\r\n\r\n**Markdown Editor**:\r\n\r\n- Full-featured CodeMirror 6 integration\r\n- Syntax highlighting\r\n- Dark theme (One Dark)\r\n- Real-time preview\r\n\r\n**Smart Synchronization**","2025-11-22T09:09:47"]