ai-toolbox

AI Toolbox

个人 AI 工具箱 - 一站式管理 AI 编程助手配置

简介

AI Toolbox 是一个跨平台桌面应用，旨在帮助开发者高效管理各类 AI 编程助手的配置。支持 Windows、macOS 和 Linux。

主要功能

• OpenCode 配置管理 - 可视化管理 OpenCode 的供应商和模型配置，支持列表页快速启停
• Oh My OpenAgent / Oh My OpenCode Slim 插件配置管理 - 可视化管理 Oh My OpenAgent 及 Oh My OpenCode Slim 插件的配置
• Claude Code 配置管理 - 一键切换 Claude Code 的官方订阅/自定义 API 供应商配置，支持动态获取模型列表、全局 Prompt 和插件管理
• Codex 配置管理 - 管理 OpenAI Codex CLI 的官方账号/自定义渠道、模型映射、全局 Prompt、插件和会话历史
• Gemini CLI 配置管理 - 管理 Gemini CLI 的官方账号/自定义渠道、.env / settings.json、全局 Prompt 和用量信息
• OpenClaw 配置管理 - 管理 OpenClaw 的模型、供应商、配置文件路径和会话记录
• Pi 配置管理 - 管理 Pi CLI 的模型、供应商、扩展、Prompt 和运行时配置
• 本机代理网关 - 提供统一本机代理入口，支持 Claude Code / Codex / Gemini CLI 接管、协议转换、故障切换、请求日志、用量统计和模型价格管理
• Image 工作台 - 管理图片生成/编辑渠道，创建图片任务，保存历史记录和生成资产
• MCP 服务器管理 - 集中管理 MCP（Model Context Protocol）服务器配置，支持导入/导出、收藏、分组和多工具同步
• Skills 技能管理 - 管理 Skills 中央仓库，支持从 Git 仓库/本地目录安装，按工具启停同步，自定义工具和分组管理
• 会话管理 - 浏览、搜索、重命名、导入、导出和删除 OpenCode / Claude Code / Codex / Gemini CLI / OpenClaw / Pi 会话
• WSL 同步 - 将 Windows 端的各种 CLI 配置、MCP 和 Skills 配置同步到 WSL 环境，支持自动同步和自定义映射
• SSH 同步 - 将本机配置、MCP 和 Skills 同步到远程 SSH 主机，支持连接管理、路径映射和手动同步
• 供应商管理 - 统一管理多个 AI 供应商（OpenAI、Anthropic、自定义代理等）
• 系统托盘 - 通过系统托盘快速切换各模块的供应商、模型、Prompt、MCP 和 Skills 启用状态，无需打开主窗口
• 数据备份 - 支持本地备份、WebDAV 云端备份、GitHub/Gitee 私有仓库备份、自动备份、可选备份加密（密码保存在本机系统凭据库）、自定义备份项、图片资产备份和敏感文件过滤
• 主题切换 - 支持亮色/暗色/跟随系统主题
• 多语言 - 支持中文和英文界面
• 自动更新检查 - 启动时自动检查新版本

截图

OpenCode 和 Oh My OpenAgent / Oh My OpenCode Slim 插件配置管理

Claude Code / Codex 配置管理

MCP 服务器管理 / Skills 技能管理

设置页面 / WSL 同步

下载安装

前往 Releases 页面下载适合您系统的安装包：

macOS 也可以通过 Homebrew 安装、升级和卸载：

brew tap coulsontl/ai-toolbox https://github.com/coulsontl/ai-toolbox
brew install --cask coulsontl/ai-toolbox/ai-toolbox
sudo xattr -rd com.apple.quarantine /Applications/AI\ Toolbox.app

brew upgrade --cask coulsontl/ai-toolbox/ai-toolbox
brew uninstall --cask coulsontl/ai-toolbox/ai-toolbox
# 可选：不再需要此 tap 时移除
brew untap coulsontl/ai-toolbox

说明：

• 当前 Cask 暂时直接托管在本仓库，因此首次需要使用带仓库 URL 的 brew tap。
• 后续发布新版本后，仓库中的 Casks/ai-toolbox.rb 会由 release workflow 自动更新，brew upgrade 即可获取新版本。

Windows 也可以通过 Scoop 安装、升级和卸载：

scoop bucket add ai-toolbox https://github.com/coulsontl/ai-toolbox
scoop install ai-toolbox/ai-toolbox

# 升级：先刷新 bucket 拿到新 manifest，再升级应用
scoop update
scoop update ai-toolbox
scoop uninstall ai-toolbox
# 可选：不再需要此 bucket 时移除
scoop bucket rm ai-toolbox

说明：

• 当前 bucket 暂时直接托管在本仓库，因此首次需要使用带仓库 URL 的 scoop bucket add。
• 后续发布新版本后，仓库中的 bucket/ai-toolbox.json 会由 release workflow 自动更新，scoop update ai-toolbox 即可获取新版本。
• 通过 Scoop 安装时，应用内自动更新不可用，请使用 scoop update ai-toolbox 升级。

技术栈

项目结构

…

开发指南

前置要求

• Node.js 18+
• pnpm 9+
• Rust 1.86+
• 参考 Tauri 前置要求

安装依赖

pnpm install

启动开发服务器

pnpm tauri dev

构建生产版本

pnpm tauri build

代码检查

# TypeScript 类型检查
pnpm tsc --noEmit

# Rust 代码检查
cd tauri && cargo check

功能模块

数据存储

使用 SQLite 作为本地主数据库，并通过 JSONB 表保存各模块配置。旧版本 SurrealDB 数据会在启动时执行一次性导入，导入完成后主数据以 SQLite 为准。

设计原则

• 本地优先：所有数据存储在本地，保护隐私
• 服务层 API：前端通过服务层与后端交互，不直接使用 localStorage
• 灵活备份：支持本地 ZIP、WebDAV 云端备份、自动备份、自定义备份项和外部配置文件备份

数据表

贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 提交 Pull Request

推荐 IDE 配置

• VS Code
• Tauri 插件
• rust-analyzer

License

MIT

Acknowledgments

• skills-hub
• cc-switch
• linux.do
• axonhub