# py-123pan-client

**123云盘开放平台 (123Pan Open Platform) 非官方 Python SDK**

基于 `httpx` 和 `pydantic` 构建，提供现代化、类型安全且易于使用的接口封装。支持自动鉴权、智能断点续传、大文件上传、直链管理、离线下载等核心功能。

## ✨ 特性

- **🔐 自动鉴权**：自动管理 Access Token 生命周期，过期自动刷新，开发者无需操心。
- **🚀 智能上传**：
    - 小文件 (<100MB) 自动使用单步上传。
    - 大文件自动切换为分片上传 (Chunked Upload)，支持秒传检测。
    - 自动计算 MD5，内存占用低（流式处理）。
- **⚡ 高性能**：底层使用 `httpx`，支持 HTTP/2 (依赖服务端支持)，为未来异步化预留空间。
- **📦 类型安全**：所有请求与响应均通过 `Pydantic` 模型验证，提供完美的 IDE 代码补全体验。
- **🛠 全功能覆盖**：文件管理、分享管理（含付费分享）、离线下载、直链加速、开发者安全配置。

## 📦 安装

推荐使用 `uv` 或 `pip` 进行安装：

```bash
# 使用 pip
pip install py-123pan-client

# 或者使用 uv (推荐)
uv add py-123pan-client