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

安装
----
pip install huace-aigc-oss-proxy-client[all]


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

环境变量（.env）
----------------
OSS_RUSTFS_ENABLED=true
OSS_RUSTFS_ENDPOINT=http://127.0.0.1:9000
OSS_RUSTFS_ACCESS_KEY=minioadmin
OSS_RUSTFS_SECRET_KEY=minioadmin
OSS_RUSTFS_BUCKET=aigc-intranet

OSS_ALIYUN_ENABLED=true
OSS_ALIYUN_ENDPOINT=https://oss-cn-hangzhou.aliyuncs.com
OSS_ALIYUN_ACCESS_KEY_ID=你的AK
OSS_ALIYUN_ACCESS_KEY_SECRET=你的SK
OSS_ALIYUN_BUCKET=你的桶

OSS_DOWNLOAD_PRIORITY=rustfs,aliyun
OSS_UPLOAD_INTRANET_BACKEND=rustfs
OSS_UPLOAD_EXTRANET_BACKEND=aliyun
OSS_KEY_PREFIX=plugin-demo


基本使用
--------
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
# 或 Windows: publish.bat / publish.ps1
