Cc Switch Web

CC开关叉

英语| 中文 | 日本语

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

范围

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

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

截图

官方发布资产

GitHub Release仅发布Web运行时。

运行时默认值

• 网址： 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 
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

许可证

看 许可证.