Metadata-Version: 2.4
Name: qcc
Version: 0.2.1
Summary: 🚀 现代化 Claude Code 配置管理神器 - 零配置启动，多端同步，安全加密，厂商快速配置
Project-URL: Homepage, https://github.com/lghguge520/qcc
Project-URL: Repository, https://github.com/lghguge520/qcc.git
Project-URL: Issues, https://github.com/lghguge520/qcc/issues
Author: QCC Team
License-Expression: MIT
Keywords: ai,anthropic,claude,cli,config,fast-config,provider,qcc
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development
Classifier: Topic :: Utilities
Requires-Python: >=3.7
Requires-Dist: click>=8.0.0
Requires-Dist: cryptography>=3.4.0
Requires-Dist: requests>=2.25.0
Provides-Extra: dev
Requires-Dist: black; extra == 'dev'
Requires-Dist: flake8; extra == 'dev'
Requires-Dist: mypy; extra == 'dev'
Requires-Dist: pytest>=6.0; extra == 'dev'
Description-Content-Type: text/markdown

# 🚀 QCC - Quick Claude Config

<div align="center">

[![Python](https://img.shields.io/badge/Python-3.7+-blue.svg)](https://python.org)
[![PyPI](https://img.shields.io/pypi/v/qcc.svg)](https://pypi.org/project/qcc/)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![Code Style](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

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

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

</div>

---

## ✨ 核心特性

<table>
<tr>
<td width="50%">

### 🎯 **智能启动**
- 🚀 零配置体验，3秒智能选择
- 🔄 自动同步，跨设备无缝切换
- 💡 智能默认，记住你的使用习惯

### 🔐 **安全可靠**
- 🛡️ 端到端加密存储
- 🔑 用户自主数据控制
- 🚫 无中心化存储风险

</td>
<td width="50%">

### ☁️ **多端同步**
- 📱 GitHub 跨平台同步
- 💾 iCloud/OneDrive/Dropbox 本地云盘
- 🏠 纯本地存储模式

### ⚡ **现代架构**
- 📦 支持 `uvx` 零安装运行
- 🎨 现代 Python 包管理
- 🔧 模块化设计，易于扩展

</td>
</tr>
</table>

---

## 🎮 快速开始

### 🌟 零安装体验（推荐）

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

<details>
<summary>💫 首次运行自动完成以下魔法</summary>

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

</details>

### 📦 传统安装

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

# 📎 或使用 pip
pip install qcc
```

---

## 🎪 厂商快速配置

### 🌈 一键配置任意 AI 厂商

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

<div align="center">

```mermaid
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
```

</div>

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

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

---

## 🎯 核心命令

<table>
<tr>
<td width="50%">

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

</td>
<td width="50%">

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

</td>
</tr>
</table>

### 🛠️ 高级管理

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

---

## 🏗️ 存储后端

<div align="center">

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

</div>

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

### 📁 智能云盘检测
- 🍎 **macOS**：自动检测 iCloud Drive
- 🪟 **Windows**：自动检测 OneDrive
- 🐧 **Linux**：自动检测 Dropbox

### 🏠 本地模式
- 🔒 **完全私有**：无云端同步
- 📂 **本地存储**：`~/.fastcc/`
- 🚀 **极速启动**：无网络依赖

---

## 🛡️ 安全架构

<div align="center">

```mermaid
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
```

</div>

---

## 🏛️ 系统架构

<div align="center">

```
🏗️ 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             │
└─────────────────────────────────────┘
```

</div>

### 🎯 设计原则

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

---

## 🔧 开发指南

### 🏗️ 开发环境

```bash
# 🚀 快速搭建开发环境
git clone <repository>
cd qcc
python -m venv fastcc_env
source fastcc_env/bin/activate  # Windows: fastcc_env\Scripts\activate

# 📦 安装开发依赖
pip install -e .

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

### 🧪 测试套件

```bash
# 🔬 运行测试
source fastcc_test_env/bin/activate

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

# 🎪 全部测试
python3 -m pytest tests/ -v
```

### 📦 构建发布

```bash
# 🔨 构建包
pip install build twine
python -m build

# 🚀 发布到 PyPI
python -m twine upload dist/*
```

---

## 🎨 配置文件

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

---

## 📋 系统要求

<div align="center">

| 🐍 Python | 📦 依赖 | 🖥️ 平台 |
|-----------|---------|---------|
| **3.7+** | click, requests, cryptography | Windows, macOS, Linux |

</div>

---

## 🤝 贡献指南

<div align="center">

🎉 **欢迎贡献！** 🎉

[🐛 报告问题](../../issues) • [💡 功能建议](../../issues) • [🔀 提交 PR](../../pulls)

</div>

---

## 📄 开源协议

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

---

<div align="center">

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

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

</div>