QSDE：下一代 Python 异步下载引擎发布

场景一：极速批量下载 (带 UI)

适合爬虫、资源下载器等场景。

import asyncio
from QSDE import QSDEngine, DownloadTask, HashAlgorithm

async def Main():
    # 初始化引擎：开启 UI，设置 8 并发
    Engine = QSDEngine(MaxConcurrency=8, EnableUI=True)

    # 定义任务列表
    Tasks = [
        DownloadTask(
            Url="https://proof.ovh.net/files/10Mb.dat",
            SavePath="downloads/game_asset_1.dat",
            # 可选：SHA256 校验，不匹配自动重试
            ExpectedHash="...",
            HashAlgo=HashAlgorithm.SHA256
        ),
        DownloadTask(
            Url="https://proof.ovh.net/files/1Mb.dat",
            SavePath="downloads/config.json"
        )
    ]

    # 一行代码启动，自动接管所有异常处理
    await Engine.StartBatchDownload(Tasks)

if __name__ == "__main__":
    asyncio.run(Main())

场景二：集成到 PyQt/PySide (静默模式)

QSDE 提供了优雅的 PascalCase 风格 API，非常符合企业级开发习惯。

async def RunInBackground():
    # 关闭内置 UI，进入 API 模式
    Engine = QSDEngine(EnableUI=False)

    # 动态配置网络环境（支持运行时修改！）
    Engine.SetNetworkConfig(
        Proxy="http://127.0.0.1:7890",
        UserAgent="MyApp/2.0",
        TimeOut=60
    )

    # 挂载回调函数
    def OnProgress(Finished, Total):
        print(f"当前进度: {Finished}/{Total}")
        # 在这里发射 Qt 信号，更新 GUI 进度条

    def OnByteProgress(Filename, ChunkSize, TotalBytes):
        # 实时网速计算
        pass

    Engine.SetCallbacks(OnTotalProgress=OnProgress)

    # 开始下载
    Result = await Engine.StartBatchDownload(Tasks)
    print(f"成功: {Result['success']}, 失败: {Result['failed']}")

🧩 设计哲学：PascalCase 与 规范化

QSDE 在代码风格上追求极致的规范。我们全库采用 PascalCase (大驼峰) 命名法，这在 Python 开源界独树一帜，旨在提供更清晰的语义边界，让代码读起来像散文一样优雅。

# 感受一下这优雅的调用风格
Engine.SetRuntimeConfig(MaxConcurrency=32)
Engine.CancelAll()

🔗 开源地址与获取

QSDE v1.0.0 完整源码现已托管至 GitHub，采用宽松的 Apache 2.0 协议开源。无论你是个人学习，还是用于商业项目（如开发游戏启动器），都可以免费使用。

GitHub 仓库地址（包含完整源码、文档与 Demo）：

👉 https://github.com/Qustellar/QSDE