代码切换工具

用于本地定制和持续开发的代码切换工具,支持多种代码配置管理和Web运行时发布。

  • by cp-yu
  • Rust
  • 本地部署
  • 47 星标
  • 更新于
在 GitHub 查看 cp-yu/cc-switch-web

使用说明

CC开关叉

英语| 中文 | 日本语

这个分叉使Web运行时成为GitHub Release的唯一官方交付成果。

范围

此分叉用于本地定制和持续开发。当前的代码库提供:

  • Claude Code、Codex、Gemini、OpenCode和OpenClaw的配置管理
  • MCP、提示、技能、代理、故障转移和使用相关功能
  • 官方版本的单一二进制Web运行时
  • Tauri桌面代码保存在仓库中,仅供本地开发使用

截图

主界面 添加提供者

官方发布资产

GitHub Release仅发布Web运行时。

平台 资产 运行
Windows x86_64 cc-switch-web-v{version}-windows-x86_64.exe ./cc-switch-web-v{version}-windows-x86_64.exe
Linux x86_64 cc-switch-web-v{version}-linux-x86_64-ubuntu20.04 chmod +x ./cc-switch-web-v{version}-linux-x86_64-ubuntu20.04 && ./cc-switch-web-v{version}-linux-x86_64-ubuntu20.04

运行时默认值

  • 网址: http://127.0.0.1:17666
  • 端口覆盖: CC_SWITCH_PORT=8080
  • 主机覆盖: CC_SWITCH_HOST=0.0.0.0
  • Linux兼容性基线:Ubuntu 20.04+

平台说明

  • Windows:运行 .exe 直接在PowerShell或命令提示符中。
  • Linux:官方资产基于Ubuntu 20.04构建,以保持明确的最低支持基线。

本地开发

需求

  • Node.js 18+
  • pnpm 8+或npm
  • 锈蚀1.85+
  • Tauri CLI 2.8+仅用于桌面本地开发

常用命令

# Install dependencies
pnpm install

# Web development
pnpm dev:server
pnpm dev:web

# Type checking
pnpm typecheck

# Frontend unit tests
pnpm test:unit

# Build Web frontend (default build target)
pnpm build

# Desktop packaging when needed
pnpm build:desktop

本地Web启动

./start-web.sh

然后打开:

http://localhost:17666

停止服务:

./stop-web.sh

运行时文件被写入 ./.run/web/ 默认情况下:

  • 日志: backend.log
  • pid: backend.pid

要覆盖运行时目录,请执行以下操作:

CC_SWITCH_RUNTIME_DIR=/tmp/cc-switch-web ./start-web.sh

手动Web构建

pnpm build
cargo build --release --manifest-path crates/server/Cargo.toml
./crates/server/target/release/cc-switch-web

本地Linux版本奇偶校验构建

./build-web-release.sh

此脚本发出 release-web/cc-switch-web-v{version}-linux-x86_64-ubuntu20.04.

发布工作流

先在发布提交中进行所需的更改,然后运行帮助程序:

git add <your-files>
pnpm release:cut -- 3.12.6 --push

助手在提交和标记创建之前同步这些版本文件:

  • package.json
  • src-tauri/Cargo.toml
  • src-tauri/tauri.conf.json

仅更新版本字段:

pnpm release:sync-version -- 3.12.6

技术栈

  • 前端:React 18、TypeScript、Vite、TailwindCSS、TanStack查询
  • 后端:Tauri 2、Rust、tokio、serde
  • 测试:vitest、MSW、@测试库/react

项目布局

src/                 frontend code
src-tauri/           Tauri desktop backend
crates/server/       web server
crates/core/         shared core logic
tests/               frontend tests
assets/              screenshots and assets
docs/                supplementary documentation

许可证

看 许可证.