🎉 ap_ds v3.0.0 LTS 发布公告
发布日期：2026年3月22日
这是一个里程碑式的版本
v3.0.0 是 ap_ds 历史上第一个长期支持版本（LTS）。经过多年的打磨、广泛的实际测试和内部资源管理的彻底重构，我们自豪地推出这个适合关键任务应用、企业部署和个人项目的稳定版本。
为什么选择 LTS？
稳定性、长期可预测性是开发者构建产品、系统和服务的核心需求。v3.0.0 LTS 承诺提供五年的维护支持，包括：
- ✅ 安全更新
- ✅ 关键错误修复
- ✅ 免费技术支持
您可以放心地在 ap_ds 上构建应用，无需担心意外的 API 变更或废弃。
🚀 v3.0.0 LTS 的核心改进
1. 确定性资源清理
解决的问题： 旧版本依赖 Python 的 __del__ 析构函数释放 SDL2 资源，但在某些解释器关闭或异常发生时，资源可能无法正确释放。
解决方案： 使用 atexit 注册显式清理函数，保证所有 SDL2 资源（音频设备、通道、缓存）在程序退出时被正确释放。
2. 哈希验证下载（安全加固）
解决的问题： 旧版本在 SSL 证书验证失败时会回退到未验证的连接，存在理论上的安全风险。
解决方案： 每个下载的 SDL2 库文件都经过硬编码 SHA-256 哈希值验证：
- 哈希匹配 → 使用文件
- 哈希不匹配 → 拒绝并重试
这提供了密码学级别的安全保障，防止中间人攻击和文件篡改。
3. 完整的测试覆盖
在以下环境中通过全部测试：
| 平台 | 架构 | 版本 |
|---|---|---|
| Windows | x86_64 | 7 / 10 / 11 |
| macOS | Intel / Apple Silicon | 10.15 – 14 |
| Linux | x86_64 / ARM64 | Ubuntu 20.04/22.04, Debian 11, Fedora 38, Arch |
| 嵌入式 | ARM64 | Orange Pi 4 Pro, Raspberry Pi 5 |
测试结果： 零内存泄漏，无回归错误。
4. 五年技术支持（2026-2031）
- 开始日期： 2026年3月22日
- 结束日期： 2031年3月22日
在此期间，提供：
- 安全补丁
- 关键错误修复
- 免费技术支持（7个工作日内响应）
5. 100% 向后兼容
- 公共 API 与 v2.x 完全兼容
- 现有代码无需修改即可运行
- 升级只需：
pip install --upgrade ap_ds
📦 版本维护与支持策略
LTS 标识
v3.0.0 LTS 及其后续的 v3.0.x 系列（包括 3.0.0、3.0.1、3.0.2 等）被官方指定为 APDSLTS001 支持计划覆盖的版本。
支持期限： 2031年3月22日 23:59:59 UTC
版本分支说明
| 版本系列 | 类型 | 支持 | 特性 |
|---|---|---|---|
| v3.0.x (APDSLTS001) | LTS | ✅ 5年支持 | 仅错误修复和安全补丁，无新功能 |
| v3.1.x 及以上 | 常规版本 | ❌ 无长期支持 | 包含新功能、性能优化、API扩展 |
⚠️ 重要版本信息
| 版本 | 状态 | 说明 |
|---|---|---|
| v3.0.0 LTS | ✅ 当前稳定版 | 推荐所有用户使用 |
| v2.4.2 | ⚠️ 开发事故 | 仅供好奇，不要用于生产 |
| v2.4.1 | ✅ 稳定 | 已被 v3.0.0 LTS 取代 |
| v2.4.0 | ✅ 稳定 | 已被 v3.0.0 LTS 取代 |
| v2.2.0 - v2.3.2 | ❌ 已撤回 | 存在严重跨平台 bug |
🔧 环境变量
| 变量 | 默认值 | 说明 |
|---|---|---|
AP_DS_WAV_THRESHOLD |
6 |
WAV 文件阈值（秒），≥阈值时支持 seek |
AP_DS_HIDE_SUPPORT_PROMPT |
未设置 | 设为 1 隐藏启动欢迎信息 |
📥 立即升级
pip install --upgrade ap_ds
验证安装：
python -c "import ap_ds; print(ap_ds.__version__)" # 应显示 3.0.0
🔗 官方资源
| 资源 | 链接 |
|---|---|
| 项目主页 | https://apds.top |
| 主仓库 (GitCode) | https://gitcode.com/dvsxt/ap_ds |
| 国内镜像 (Gitee) | https://gitee.com/dssxt/ap_ds |
| PyPI | https://pypi.org/project/ap_ds/ |
| 作者博客 | https://dvsx.top |
📧 联系与支持
- 技术问题： GitCode Issues / Gitee Issues
- 授权咨询： me@dvsyun.top 或 dvs6666@163.com
- 响应时间： 标准咨询 7 个工作日，紧急问题 48 小时
感谢您使用 ap_ds！
—— Dvs (DvsXT)