致谢 — 本项目借鉴了 cc-switch、claude-code-hub、code-switch-R 等优秀开源项目。
| 痛点 | AIO Coding Hub 的解决方案 |
|---|---|
| 每个 CLI 都要单独配置 API | 统一网关 — 所有 CLI 走 127.0.0.1 本机入口 |
| 上游不稳定时请求失败 | 智能 Failover — 自动切换供应商，熔断保护 |
| 不知道用了多少 Token 和花了多少钱 | 全链路可观测 — Trace 追踪、用量统计、花费估算 |
| 不同项目需要不同的 Prompts / MCP 配置 | 工作区隔离 — 按项目管理 CLI 配置，一键切换 |
- 单一入口代理 Claude Code / Codex / Gemini CLI 请求
- 自定义模型名称映射
- SSE / JSON 响应自动修复
- 多供应商优先级排序 + 自动故障转移
- 熔断器模式（可配置阈值与恢复时间）
- Sticky Session 保持会话粘滞
- Token 用量统计（按 CLI / 供应商 / 模型维度）
- 花费估算 + 模型价格自动同步
- 请求 Trace 与实时控制台日志
- 热力图与缓存趋势图
- 按项目隔离 Prompts、MCP、Skill 配置
- 工作区对比、克隆、切换与回滚
- 配置自动同步到各 CLI
- 从 Git 仓库发现并安装 Skill
- 仓库管理、过滤、排序
- 关联工作区批量管理
- Claude Code 设置直接编辑
- Codex config.toml 代码编辑器
- 环境变量冲突检测
- 本地 Session 历史浏览（项目 → 会话 → 消息）
- 多维度验证模板（Token 截断、Extended Thinking 等）
- 跨供应商签名验证
- 批量验证 + 历史记录
- 自动更新、开机自启、单实例
- 数据导入 / 导出 / 清空
- WSL 环境支持
前往 Releases 下载对应平台安装包：
| 平台 | 官方发布安装包 |
|---|---|
| Windows x64 | .msi / -portable.zip |
| macOS Intel | .zip |
| macOS Apple Silicon | .zip |
| Linux x64 | .deb / .AppImage / -wayland.AppImage |
官方支持矩阵只覆盖上表 4 个目标。mac:universal 和 win:arm64 只保留本地构建命令，不进入 Release 产物和 latest.json。
Linux Arch / Wayland 用户
推荐：AUR 软件包（使用系统库，兼容性最好）
paru -S aio-coding-hub-bin
# 或
yay -S aio-coding-hub-binAppImage 用户
应用在 Wayland 下启动时会自动检测并注入 WEBKIT_DISABLE_COMPOSITING_MODE=1 以避免 EGL 冲突崩溃（见 issue #93）。
若仍遇到白屏，可改用 Release 中附带的 *-wayland.AppImage（已剥离内置 EGL/Mesa 库，使用系统版本）：
# 或者手动对已有 AppImage 进行重打包
./scripts/repack-linux-appimage-wayland.sh aio-coding-hub-linux-amd64.AppImagemacOS 安全提示
若遇到"无法打开 / 来源未验证"提示：
sudo xattr -cr /Applications/"AIO Coding Hub.app"前置条件
通用要求： Node.js 18+、pnpm、Rust 1.90+
Windows： Microsoft C++ Build Tools（勾选"使用 C++ 的桌面开发"）
macOS： xcode-select --install
Linux (Ubuntu/Debian)：
sudo apt-get update
sudo apt-get install -y libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelfgit clone https://github.com/dyndynjyxa/aio-coding-hub.git
cd aio-coding-hub
pnpm install
# 开发模式
pnpm tauri:dev
# 构建（当前平台）
pnpm tauri:build
# 指定平台| 分类 | 命令 | 说明 |
|---|---|---|
| 官方支持 | pnpm tauri:build:win:x64 |
Windows x64；官方支持；进入 Release / updater 矩阵 |
| 官方支持 | pnpm tauri:build:mac:x64 |
macOS Intel；官方支持；进入 Release / updater 矩阵 |
| 官方支持 | pnpm tauri:build:mac:arm64 |
macOS Apple Silicon；官方支持；进入 Release / updater 矩阵 |
| 官方支持 | pnpm tauri:build:linux:x64 |
Linux x64；官方支持；进入 Release / updater 矩阵 |
| 本地构建 | pnpm tauri:build:mac:universal |
macOS Universal；仅本地构建；不进入官方发布 / updater 矩阵 |
| 本地构建 | pnpm tauri:build:win:arm64 |
Windows ARM64；仅本地构建；不进入官方发布 / updater 矩阵 |
上表中的“官方支持”会进入 GitHub Release 和自动更新；“本地构建”只保留脚本，不承诺发布和更新。
1. 供应商页 → 添加上游（官方 API / 自建代理 / 公司网关）
2. 首页 → 打开目标 CLI 的"代理"开关
3. 终端发起请求 → 在控制台 / 用量页查看 Trace 与统计
验证网关运行：
curl http://127.0.0.1:37123/health
# {"status":"ok"}| 层级 | 技术 |
|---|---|
| 前端 | React 19 · TypeScript · Tailwind CSS · Vite |
| 状态管理 | TanStack Query · React Hooks |
| 桌面框架 | Tauri 2 |
| 后端 | Rust · Axum (HTTP Gateway) |
| 数据库 | SQLite (rusqlite) |
| 测试 | Vitest · Testing Library · MSW · Cargo Test |
pnpm check:precommit # 快速预提交检查（前端 + Rust check）
pnpm check:precommit:full # 完整检查（格式 + clippy）
pnpm check:prepush # 覆盖率 + 后端测试 + clippy
pnpm test:unit # 前端单元测试
pnpm tauri:test # 后端测试- 公网部署 / 远程访问 / 多租户
- 企业级 RBAC 权限管理
本项目定位为 单机桌面工具 + 本地网关，所有数据保存在本机。
欢迎提交 Issue 和 PR！采用 Conventional Commits 规范。
feat(ui): add usage heatmap
fix(gateway): handle timeout correctly
docs: update installation guide