qcc 0.5.1

🚀 现代化 Claude Code 配置管理神器 - 零配置启动，多端同步，安全加密，厂商快速配置

🚀 QCC - Quick Claude Config

🌟 现代化 Claude Code 配置管理神器 🌟

零配置启动 • 多端同步 • 安全加密 • 一键部署

---

✨ 核心特性

🎯 智能启动 🚀 零配置体验，3秒智能选择 🔄 自动同步，跨设备无缝切换 💡 智能默认，记住你的使用习惯 🔐 安全可靠 🛡️ 端到端加密存储 🔑 用户自主数据控制 🚫 无中心化存储风险 🔒 敏感信息保护，无硬编码密钥 🌐 代理服务 (v0.4.0 新增) 🔄 本地 HTTP 代理服务器 🎯 多 Endpoint 负载均衡 🛡️ 三级故障转移机制 💚 智能健康检测

☁️ 多端同步 📱 GitHub 跨平台同步 💾 iCloud/OneDrive/Dropbox 本地云盘 🏠 纯本地存储模式 ⚡ 现代架构 📦 支持 uvx 零安装运行 🎨 现代 Python 包管理 🔧 模块化设计，易于扩展 🖥️ Rich 终端UI，跨平台交互体验 🔧 高可用性 (v0.4.0 新增) ⚡ 自动故障转移和恢复 📊 实时性能监控 📋 失败请求队列 🔍 详细日志追踪

---

🎮 快速开始

🌟 零安装体验（推荐）

# 🔥 一行命令，立即体验
curl -LsSf https://astral.sh/uv/install.sh | sh && uvx qcc

💫 首次运行自动完成以下魔法

1. ⬇️ 自动下载最新版本
2. 🔧 智能选择存储后端（GitHub/云盘/本地）
3. 🔐 安全认证（GitHub 设备流，无需本地服务器）
4. ☁️ 创建云存储，安全加密
5. 🔄 同步配置档案
6. 🎯 智能选择配置（3秒超时）
7. 🚀 启动 Claude Code

📦 传统安装

# 🛠️ 使用 uv（推荐）
uv tool install qcc

# 📎 或使用 pip
pip install qcc

---

🎪 厂商快速配置

🌈 一键配置任意 AI 厂商

qcc fc  # 🎭 Fast Config - 厂商配置向导

graph LR
    A[🎯 选择厂商] --> B[🌐 浏览器注册]
    B --> C[🔑 输入 API Key]
    C --> D[✅ 确认配置]
    D --> E[🚀 启动 Claude]
    
    style A fill:#ff6b6b
    style B fill:#4ecdc4
    style C fill:#45b7d1
    style D fill:#f9ca24
    style E fill:#6c5ce7

🎨 支持的厂商（云端实时更新）

• 🏢 Anthropic 官方 - 原生 Claude API
• 🌟 Claude Plus - 第三方增强服务
• 🔄 更多厂商 - 云端配置实时更新

---

🎯 核心命令

🚀 快速操作 # 本地开发测试 uvx --from . qcc # 🌟 智能启动 uvx --from . qcc fc # 🎭 厂商快速配置 uvx --from . qcc init # 🔧 初始化设置 uvx --from . qcc add work # ➕ 添加配置 # 远程安装使用 uvx qcc # 🌟 智能启动 uvx qcc fc # 🎭 厂商快速配置 uvx qcc init # 🔧 初始化设置 uvx qcc add work # ➕ 添加配置

📋 管理命令 # 本地开发测试 uvx --from . qcc list # 📜 查看所有配置 uvx --from . qcc use work # 🎯 使用指定配置 uvx --from . qcc status # 📊 系统状态 uvx --from . qcc sync # 🔄 手动同步 # 远程安装使用 uvx qcc list # 📜 查看所有配置 uvx qcc use work # 🎯 使用指定配置 uvx qcc status # 📊 系统状态 uvx qcc sync # 🔄 手动同步

🛠️ 高级管理

# 本地开发测试
uvx --from . qcc default work       # ⭐ 设置默认配置
uvx --from . qcc config             # ⚙️  配置管理（更改存储方式）
uvx --from . qcc remove old         # 🗑️  删除配置
uvx --from . qcc uninstall          # 🧹 清理本地数据（保留云端）

# 远程安装使用
uvx qcc default work                # ⭐ 设置默认配置
uvx qcc config                      # ⚙️  配置管理（更改存储方式）
uvx qcc remove old                  # 🗑️  删除配置
uvx qcc uninstall                   # 🧹 清理本地数据（保留云端）

🖥️ Web UI 管理界面 (v0.5.0 新增)

# 生产模式（推荐日常使用）
uvx qcc web start                       # 启动 Web UI
uvx qcc web status                      # 查看状态
uvx qcc web stop                        # 停止（自动清理代理和配置）

# 开发模式（推荐代码开发）
uvx qcc web start --dev                 # 前后端热重载
uvx qcc web stop --keep-proxy          # 保持代理运行
uvx qcc web stop --keep-config         # 保持配置不还原

特性：

• 🎨 现代化 React + TypeScript 界面
• ⚡ 一键启动，自动构建
• 🔥 开发模式支持前后端热重载
• 🧹 停止时自动清理（代理 + 配置）
• 📊 实时监控和管理

🌐 代理服务命令 (v0.4.0 新增)

🎯 Endpoint 管理 # 本地开发测试 uvx --from . qcc endpoint add <config> # ➕ 添加 endpoint uvx --from . qcc endpoint list <config> # 📜 查看 endpoints uvx --from . qcc endpoint remove <config> <id> # 🗑️ 删除 endpoint # 远程安装使用 uvx qcc endpoint add production # ➕ 添加 endpoint uvx qcc endpoint list production # 📜 查看 endpoints uvx qcc endpoint remove production 1 # 🗑️ 删除 endpoint 🔄 优先级管理 # 本地开发测试 uvx --from . qcc priority set <config> <level> # ⚙️ 设置优先级 uvx --from . qcc priority list # 📊 查看优先级 uvx --from . qcc priority switch <config> # 🔄 手动切换 uvx --from . qcc priority history # 📖 切换历史 # 远程安装使用 uvx qcc priority set production primary # ⚙️ 设置主配置 uvx qcc priority set backup secondary # ⚙️ 设置次配置 uvx qcc priority list # 📊 查看优先级

🏥 健康检测 # 本地开发测试 uvx --from . qcc health test # 🧪 执行健康测试 uvx --from . qcc health status # 📊 查看健康状态 uvx --from . qcc health metrics # 📈 查看性能指标 # 远程安装使用 uvx qcc health test -v # 🧪 详细测试 uvx qcc health status # 📊 健康状态 uvx qcc health metrics # 📈 性能指标 🚀 代理服务器 # 本地开发测试 uvx --from . qcc proxy start # ▶️ 启动代理 uvx --from . qcc proxy stop # ⏹️ 停止代理 uvx --from . qcc proxy status # 📊 查看状态 uvx --from . qcc proxy logs # 📋 查看日志 # 远程安装使用 uvx qcc proxy start # ▶️ 启动代理服务 uvx qcc proxy status # 📊 查看代理状态 uvx qcc queue status # 📋 查看失败队列

---

🏗️ 存储后端

🌐 GitHub	☁️ 云盘同步	🏠 本地存储
🔄 全平台通用	📱 平台特定	🔒 完全私有
🛡️ 设备流认证	📁 文件同步	💾 本地缓存
🌍 随处可用	⚡ 快速同步	🚫 无需网络

🌟 GitHub 跨平台

• 🔐 安全认证：设备流，无需本地服务器
• 🌍 全平台：Windows、macOS、Linux 通用
• 📊 数据主权：存储在你的 GitHub 账户

📁 智能云盘检测

• 🍎 macOS：自动检测 iCloud Drive
• 🪟 Windows：自动检测 OneDrive
• 🐧 Linux：自动检测 Dropbox

🏠 本地模式

• 🔒 完全私有：无云端同步
• 📂 本地存储：~/.fastcc/
• 🚀 极速启动：无网络依赖

---

🛡️ 安全架构

graph TD
    A[🔑 用户数据] --> B[🔐 端到端加密]
    B --> C[☁️ 用户自有存储]
    C --> D[🛡️ 零信任架构]
    
    E[🚫 无中心化数据库] --> F[🔒 本地文件权限 600]
    F --> G[🔐 OAuth 设备流]
    G --> H[✅ 完全安全]
    
    style A fill:#ff6b6b
    style B fill:#4ecdc4
    style C fill:#45b7d1
    style D fill:#6c5ce7
    style E fill:#f9ca24
    style F fill:#26de81
    style G fill:#fd79a8
    style H fill:#00b894

---

🏛️ 系统架构

🏗️ QCC 模块化架构
┌─────────────────────────────────────┐
│  🎮 CLI Interface (Click)          │
├─────────────────────────────────────┤
│  🧠 Core Logic                     │
│   ├── 📋 ConfigManager             │
│   ├── 👤 ConfigProfile             │
│   ├── 🎯 PriorityManager (v0.4.0) │
│   └── 🔄 FailoverManager (v0.4.0) │
├─────────────────────────────────────┤
│  🌐 Proxy Services (v0.4.0 新增)   │
│   ├── 🚀 ProxyServer               │
│   ├── ⚖️  LoadBalancer             │
│   ├── 💚 HealthMonitor             │
│   ├── 📋 FailureQueue              │
│   └── 📊 WeightAdjuster            │
├─────────────────────────────────────┤
│  🎭 Providers                      │
│   ├── 🌐 ProvidersManager          │
│   └── 🔗 Browser Integration       │
├─────────────────────────────────────┤
│  💾 Storage Backends               │
│   ├── 🐙 GitHub (OAuth/Simple)     │
│   ├── ☁️  Cloud Files              │
│   └── 🏠 Local Storage             │
├─────────────────────────────────────┤
│  🔐 Security & Utils               │
│   ├── 🔑 Cryptography              │
│   ├── 🔐 OAuth Authentication      │
│   └── 🎨 UI Components             │
└─────────────────────────────────────┘

🎯 设计原则

• 🔌 插件化：存储后端可扩展
• 🛡️ 安全第一：端到端加密，用户数据自主
• 🎨 用户友好：智能默认，最少交互
• 🚀 现代化：支持 uvx，零安装体验

---

🔧 开发指南

🏗️ 开发环境

# 🚀 快速搭建开发环境
git clone https://github.com/lghguge520/qcc.git
cd qcc

# 📦 创建虚拟环境（必须使用 virtualenv，命名为 venv）
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 📥 安装开发依赖
pip install -e ".[dev]"

# 🧪 运行开发版本
python -m fastcc.cli --help

🧪 测试套件

# ⚠️ 重要：必须先测试再发布，使用 uvx 进行测试
uvx --from . qcc --help               # 使用 uvx 测试本地包（推荐）

# 🔬 运行单元测试
pytest tests/ -v

# 🎯 单个测试文件
pytest tests/test_providers.py -v     # 厂商配置测试
pytest tests/test_fc_command.py -v    # FC 命令测试
pytest tests/test_simplified_fc.py -v # 简化流程测试

📦 构建发布

# ⚠️ 发布前必须完成测试
# 1️⃣ 使用 uvx 测试
uvx --from . qcc --help

# 2️⃣ 构建包
pip install build twine
python -m build

# 3️⃣ 发布到 PyPI
python -m twine upload dist/*

---

🎨 配置文件

📁 文件	📍 位置	📝 说明
💾 本地缓存	~/.fastcc/cache.json	配置档案缓存
🔑 GitHub Token	~/.fastcc/github_token.json	认证令牌
⚙️ Claude 设置	~/.claude/settings.json	Claude Code 配置

---

📋 系统要求

🐍 Python	📦 依赖	🖥️ 平台
3.7+	click, requests, cryptography, rich, prompt_toolkit	Windows, macOS, Linux

---

🤝 贡献指南

🎉 欢迎贡献！ 🎉

🐛 报告问题 • 💡 功能建议 • 🔀 提交 PR

---

📄 开源协议

MIT License - 自由使用，欢迎贡献！

---

📚 详细文档

命令参考手册

• 📖 CLI 命令参考 - 所有可用命令的完整参考（基于当前实现）

v0.5.0 Web UI 文档

想了解更多关于 v0.5.0 Web UI 的详细信息？查看完整文档：

• 🚀 快速开始 - Web UI 安装和使用指南
• ⚡ 一键启动 - 开发模式和生产模式详解
• 🧹 自动清理 - 停止时的自动清理功能
• 🔧 开发模式 - 前后端热重载测试文档

快速参考:

• 📝 快速参考卡片 - 常用命令速查

v0.4.0 代理服务文档

想了解更多关于 v0.4.0 代理服务的详细信息？查看完整文档：

• 📖 开发计划 - 完整的技术设计和实现方案
• ✅ 完成报告 - 开发完成情况和使用指南
• 📘 使用示例 - 详细的使用场景和示例
• 🧪 测试指南 - 测试方法和验证步骤

核心功能文档:

• 🔄 自动故障转移机制
• 🔧 Endpoint 配置复用
• 💚 智能健康检测

注意: docs/tasks 中的文档描述的是设计规划，部分功能可能与当前实现有差异。请以 CLI 命令参考 为准。

更多文档请查看 docs/tasks 目录。

---

🌟 如果这个项目对你有帮助，请给个 Star！⭐

让 AI 配置管理变得简单而优雅 ✨