# 🎉 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` 隐藏启动欢迎信息 |

---

## 📥 立即升级

```bash
pip install --upgrade ap_ds
```

验证安装：
```bash
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)*