qcc 0.3.3

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

🚀 QCC - Quick Claude Config

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

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

---

✨ 核心特性

🎯 智能启动 🚀 零配置体验，3秒智能选择 🔄 自动同步，跨设备无缝切换 💡 智能默认，记住你的使用习惯 🔐 安全可靠 🛡️ 端到端加密存储 🔑 用户自主数据控制 🚫 无中心化存储风险 🔒 敏感信息保护，无硬编码密钥

☁️ 多端同步 📱 GitHub 跨平台同步 💾 iCloud/OneDrive/Dropbox 本地云盘 🏠 纯本地存储模式 ⚡ 现代架构 📦 支持 uvx 零安装运行 🎨 现代 Python 包管理 🔧 模块化设计，易于扩展 🖥️ Rich 终端UI，跨平台交互体验

---

🎮 快速开始

🌟 零安装体验（推荐）

# 🔥 一行命令，立即体验
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 - 第三方增强服务
• 🔄 更多厂商 - 云端配置实时更新

---

🎯 核心命令

🚀 快速操作 qcc # 🌟 智能启动 qcc fc # 🎭 厂商快速配置 qcc init # 🔧 初始化设置 qcc add work # ➕ 添加配置

📋 管理命令 qcc list # 📜 查看所有配置 qcc use work # 🎯 使用指定配置 qcc status # 📊 系统状态 qcc sync # 🔄 手动同步

🛠️ 高级管理

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

---

🏗️ 存储后端

🌐 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             │
├─────────────────────────────────────┤
│  🎭 Providers (New!)               │
│   ├── 🌐 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 测试本地包

# 🔬 运行单元测试
source venv/bin/activate
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 - 自由使用，欢迎贡献！

---

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

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