============================================
华策 AIGC OSS Proxy Client - 快速入门
============================================

安装
----
pip install huace-aigc-oss-proxy-client[all]      # 全量
pip install huace-aigc-oss-proxy-client[aliyun]   # 仅阿里云
pip install huace-aigc-oss-proxy-client[rustfs]   # 仅 RustFS / S3
pip install huace-aigc-oss-proxy-client[qiniu]    # 仅七牛


本地 RustFS（开发）
------------------
cd huace-aigc-oss-proxy-client
docker compose -f docker-compose/rustfs/docker-compose.yml up -d

环境变量
--------
cp env.example .env    # Windows: copy env.example .env
# 编辑 .env 填入 AK/SK 等，见 env.example 注释


基本使用
--------
from huace_aigc_oss import OssClient, UploadMode

client = OssClient.from_env()

# 下载：内网优先，失败自动降级阿里云
client.download("task-1/out.wav", "/tmp/out.wav")

# 上传：默认内网 RustFS
client.upload("task-1/out.wav", "/tmp/out.wav")

# 上传：强制外网阿里云
client.upload("task-1/out.wav", "/tmp/out.wav", mode=UploadMode.EXTRANET)

client.exists("task-1/out.wav")


发布到 PyPI
-----------
python build_and_publish.py
