Release notes

[0.5.2] - 2026-04-18

Bug 修复

• UserFavSonglistResponsejsonpath错误 (2c54ebb) by @L-1124
• GetAlbumSongResponse上游返回单个歌曲信息报错 (adbdc40) by @L-1124

功能更新

• (core) 为 ResponsePager 添加 next 与 has_more (0a63a26) by @L-1124

文档更新

• (pagination) 修正分页示例错误 (c310450) by @L-1124

贡献者

• @L-1124
• @renovate[bot][#240](https://github.com/L-1124/QQMusicApi/pull/240)
• @github-actions[bot]

[0.5.1] - 2026-04-13

功能更新

• 获取歌曲文件支持传入歌曲类型 (a2ad367) by @L-1124
• [breaking] 重构歌曲文件获取逻辑，支持获取特殊类型的歌曲文件 (5e31a48) by @L-1124
• 接口请求支持更方便的下一页、换一批请求 (98693f8) by @L-1124 in #235

功能重构

• (login) 优化 MQTT 登录链路并替换 HTTP 重试实现 (244e000) by @L-1124 in #237

文档更新

• (index) 修正首页使用示例 (ebafd9c) by @L-1124
• 添加缺少的模块文档 (376970e) by @L-1124
• 更新 index.md (d8e3668) by @L-1124

贡献者

• @L-1124
• @renovate[bot][#238](https://github.com/L-1124/QQMusicApi/pull/238)
• @github-actions[bot]

[0.5.0] - 2026-04-02

Bug 修复

• (LoginApi) 限制手机验证码登录仅支持手机客户端 (678694d) by @L-1124
• (api) 修正登录与歌手接口平台契约 (3f7f797) by @L-1124
• (client) 修改请求参数构建错误 (d28fe0e) by @L-1124
• (client) 模块属性在同一实例内未能复用 (2250227) by @L-1124
• (examples) 修正下载示例的 CDN 访问 (c24bd00) by @L-1124
• (login) 更正刷新凭证方法命名 (a81b738) by @L-1124
• (login) 明确二维码登录事件流与网络异常行为 (0a348e4) by @L-1124
• (mqtt) 明确断链回调与调试日志语义 (3e07727) by @L-1124
• (song) 修正 DTS_X 文件类型定义 (992fe38) by @L-1124
• (songlist) 修正歌单写接口请求参数 (004feb2) by @L-1124
• (top) 修复排行榜标签参数布尔透传 (afff4fc) by @L-1124
• 更新登录模块以支持平台判断，修复二维码获取错误 (bc1bdfa) by @L-1124
• 修复版本配置不对 (9d71428) by @L-1124
• resolve TypeError with Generic TypedDict on Python < 3.11 (f142965) by @L-1124

Config

• (hooks) 从 pre-commit 迁移到 prek (2821122) by @L-1124

Revert

• (core) 重命名限流异常 (271bc3b) by @L-1124

功能更新

• (Song) 支持 dts:x 音质获取 (5d8011a) by @L-1124
• (album) 补充专辑响应模型 (17cf26d) by @L-1124
• (api) 添加 CDN 调度相关响应模型 (56584ef) by @L-1124
• (client) 添加自动重试能力 (a46c02b) by @L-1124
• (comment) 补充评论响应模型 (9781045) by @L-1124
• (credential) 支持凭证过期判断并完善文档 (754752f) by @L-1124
• (login) 完善刷新参数与过期错误识别 (5049b4e) by @L-1124
• (login) 引入登录会话对象 (84922ea) by @L-1124
• (lyric) 补充歌词响应模型 (946184b) by @L-1124
• (models) 完善封面链接获取 (ded12d6) by @L-1124
• (models) 补充推荐响应模型 (18c1935) by @L-1124
• (models) 新增通用响应基类并支持 JSONPath 字段提取 (36084c6) by @L-1124
• (mv) 新增 MV 响应模型并接入类型化解析 (8c690e3) by @L-1124
• (search) 新增搜索响应模型并接入类型化解析 (ffa12ca) by @L-1124
• (singer) 补充歌手响应模型 (c3697ad) by @L-1124
• (song) 补充歌曲接口模型 (828268d) by @L-1124
• (song) 新增多音质支持（7.1全景声/杜比全景声/NAC/黑胶） (f7296fc) by @L-1124
• (songlist) 补充歌单响应模型 (c289c88) by @L-1124
• (top) 补充排行榜响应模型 (4175d5b) by @L-1124
• (user) 补充用户响应模型 (e1f1b8c) by @L-1124
• (user) 自动为主页和会员接口补占位凭证 (ab53d36) by @L-1124
• (user) 移除 get_euin 和 get_musicid 接口 (4975fdf) by @L-1124
• 自定义qimei获取时设备文件缓存路径 (4a7bc21) by @L-1124

功能重构

• (api) 统一请求架构并重构模块与批处理模型 (7099103) by @L-1124 in #226
• (core) 将 RateLimitError 重命名为 GlobalAuthFailedError (b6b90c5) by @L-1124
• (core) 收敛核心层数据校验与辅助逻辑 (2b7cc32) by @L-1124
• (core) 收敛核心层异常与平台语义 (57de232) by @L-1124
• (login) 重构登录流程模块职责 (969b94c) by @L-1124
• (models) 按测试回退响应模型默认值 (8edca85) by @L-1124
• (models) 统一基础模型别名映射 (d34a7e7) by @L-1124
• (mqtt) 使用 paho-mqtt 重构客户端实现 (644ecee) by @L-1124
• (search) 统一搜索类型枚举 (37fddf8) by @L-1124
• (song) 调整歌曲取链参数支持 (d7d4ab6) by @L-1124
• (song) 去除歌曲链接分组与自动拼接并调整示例 (04624fd) by @L-1124
• (tests) 重构测试文件 (62fac87) by @L-1124

文档更新

• (license) 切换 GPL 协议说明 (45c74ad) by @L-1124
• (models) 完善模型注释 (c893f9d) by @L-1124
• 更新文档配置文件说明 (d42966a) by @L-1124
• 更新文档 (9a13de2) by @L-1124
• 更新 README.md.修正图像链接，优化格式和内容，增强可读性 (7a42d6f) by @L-1124
• 添加评论 API 文档并更新用户 API 文档注释 (618bf5a) by @L-1124

贡献者

• @L-1124
• @github-actions[bot]

[0.4.1] - 2025-12-28

文档更新

• 更新文档和代码注释 (62d41ee) by @L-1124

贡献者

• @github-actions[bot]
• @L-1124

[0.4.0] - 2025-12-27

Bug 修复

• 优先从 purl 获取歌曲链接并更新 ct 参数 (3ccc5da) by @jinzhongjia in #219

功能更新

• 添加获取时刻评论的功能并且修改API返回为原始数据 (3c7f6ef) by @L-1124
• 删除API缓存功能 (36b04f7) by @L-1124
• 支持QQ音乐APP扫码登录 (9f8c855) by @L-1124

功能重构

• 移除 API 请求中的 exclude_params 参数 (59694d3) by @L-1124
• 优化 ApiRequest Cookies 管理 (34a5876) by @L-1124

文档更新

• Update README links and image sources (7c09d07) by @L-1124
• 更新 README.md (ebf3347) by @L-1124

贡献者

• @github-actions[bot]
• @L-1124
• @jinzhongjia #219
• @renovate[bot][#190](https://github.com/L-1124/QQMusicApi/pull/190)

[0.3.6] - 2025-08-22

Bug 修复

• (comment) 获取歌曲热评时页码错误 (b8d2d3d) by @L-1124
• 错误地将歌曲链接缓存 (eec0100) by @L-1124

功能更新

• (comment) 获取推荐评论 (f4b1eda) by @L-1124
• (comment) 获取歌曲最新评论 (1ae5875) by @L-1124
• 获取歌曲评论数量 (f484e7f) by @L-1124
• 获取雷达推荐歌曲 (04b5923) by @L-1124
• 支持获取推荐歌单，推荐新歌 (460be11) by @L-1124
• 升级加密算法 (2f01428) by @L-1124
• 支持主页推荐，猜你喜欢获取 (64469cc) by @L-1124

文档更新

• (contributing) 更新贡献文档 (e834b32) by @L-1124
• 修改文档错误 (a01cf0f) by @L-1124

贡献者

• @github-actions[bot]
• @L-1124
• @renovate[bot][#188](https://github.com/L-1124/QQMusicApi/pull/188)

[0.3.5] - 2025-07-29

Bug 修复

• (login) “限制设备数量”导致无法登录时无任何提示 (faeca45) by @L-1124
• 修复请求可变参数错误 (0b3dea8) by @L-1124
• update qq qrlogin module/method (f24adb8) by @aynakeya in #178
• 'RequestGroup' 返回数据序号错误 (17fbd53) by @L-1124

功能更新

• 添加获取精彩评论（歌曲热评）的能力 (99947c8) by @Aas-ee in #161

文档更新

• (comment) 增加歌曲热评返回参数注释 (418b032) by @Aas-ee in #164

贡献者

• @github-actions[bot]
• @L-1124
• @renovate[bot][#167](https://github.com/L-1124/QQMusicApi/pull/167)
• @aynakeya #178
• @Aas-ee #164

[0.3.4] - 2025-03-20

Bug 修复

• is_expired 和 can_refresh 判断错误 (a28a473) by @L-1124
• modify fields to filter of get_friend (660ca49) by @aurora0x27 in #151
• credential 未强制为关键字参数 (147ab2d) by @L-1124

功能重构

• 重构 Web Port Parser (1cfb62d) by @L-1124

文档更新

• Web Port 文档 (ffc8842) by @L-1124

贡献者

• @github-actions[bot]
• @L-1124
• @aurora0x27 #151
• @renovate[bot][#142](https://github.com/L-1124/QQMusicApi/pull/142)

[0.3.3] - 2025-03-15

Bug 修复

• (songlist) 第一次获取最大歌曲量 (a3bc27e) by @liuhangbin in #147
• 修复设置全局Session未生效 (73e8cba) by @L-1124
• 部分API使用缓存 (cd58f01) by @L-1124
• 修复get_singer_list_index返回为空报错 (f9993a9) by @L-1124
• Docker 运行出错 (47295db) by @L-1124
• 修复qimei请求失败 (0a781dd) by @L-1124

功能更新

• (Songlist) 添加歌单处理函数 (49eeafd) by @liuhangbin in #144
• 添加日志记录功能以跟踪Session的创建、设置和清除 (d89e046) by @L-1124
• 优化返回注释 (0f5da78) by @L-1124

文档更新

• 更新 README.md (ef6c07c) by @L-1124
• 修改 changelog 生成规则 (da3e829) by @L-1124

贡献者

• @github-actions[bot]
• @L-1124
• @liuhangbin #147

[0.3.2] - 2025-03-02

Bug 修复

• comm 参数未合并 (d8cac55) by @L-1124

贡献者

• @github-actions[bot]
• @L-1124

[0.3.1] - 2025-03-02

Bug 修复

• Cookies 导入为 Credential 时错误 (30e40e3) by @L-1124
• RequsetGroup 请求数量过多报错 (ff2c65b) by @L-1124
• RequestGroup 解析数据错误 (257f28f) by @L-1124

功能更新

• (singer) 添加获取全部歌曲，专辑，MV调用 (fe48011) by @liuhangbin in #140
• 默认开启 Http2 (b6ea59e) by @L-1124
• 手动清除API缓存 (4ad301f) by @L-1124
• 优先通过 Credential 字段判断是否过期 (e6dd11d) by @L-1124
• 使用 OrJson 加快 json 解析 (fe1c430) by @L-1124

性能优化

• (singer) 优化请求性能 (4245dd9) by @L-1124

文档更新

• 补充代理配置 (9977ec9) by @L-1124
• 更新文档 (c4312ae) by @L-1124

贡献者

• @L-1124
• @github-actions[bot]
• @renovate[bot][#132](https://github.com/L-1124/QQMusicApi/pull/132)
• @liuhangbin #140

[0.3.0] - 2025-02-23

Bug 修复

• (singer) 修复地区代码错误 (03023cf) by @liuhangbin in #127
• 命名错误 (20d8c27) by @L-1124

功能更新

• (Singer) 支持根据首字母来过滤歌手列表 (61af369) by @liuhangbin in #129
• (song) add get_fav_num function (ad3b4e5) by @liuhangbin in #135
• 支持 Docker 部署 (0e81cbc) by @L-1124
• 新增 get_singer_list_index 歌手列表查询 (803b486) by @liguobao in #124
• 缓存功能 (4db7ac8) by @L-1124
• 支持 WEB API (2ed9199) by @L-1124

功能重构

• 重构 Python API (fc917df) by @L-1124 in #110

性能优化

• 优化Session获取 (e77e87f) by @L-1124

文档更新

• API 编写指南 (dff5819) by @L-1124

贡献者

• @L-1124
• @github-actions[bot]
• @liuhangbin #135
• @liguobao #124
• @renovate[bot][#118](https://github.com/L-1124/QQMusicApi/pull/118)

[0.2.2] - 2025-01-25

Bug 修复

• 逐字歌词丢失换行符 (6a5072e) by @L-1124

贡献者

• @github-actions[bot]
• @L-1124

[0.2.1] - 2025-01-04

Bug 修复

• 修复扫码登录报错 (bc4d272) by @L-1124

功能更新

• [breaking] 不再支持 Python 3.9 (4d51d23) by @L-1124

文档更新

• 修改字体链接 (9bd6ea2) by @L-1124

贡献者

• @L-1124
• @github-actions[bot]
• @renovate[bot][#99](https://github.com/L-1124/QQMusicApi/pull/99)

[0.2.0] - 2024-12-28

Bug 修复

• (deps) update dependency cryptography to v44 (eb2cf36) by @renovate[bot] in #81
• (search) 修复搜索singer报错,audio_album无结果 (c3ac3c3) by @L-1124
• logging 不生效 (0118697) by @L-1124
• QQ 刷新 Credential 失败 (2901a0c) by @L-1124

功能更新

• (credential) 从字符串创建 Credential (025cb30) by @L-1124
• 支持加密接口 (768a3f3) by @L-1124
• 使用Session管理请求 (7485870) by @L-1124 in #87

功能重构

• 重构utils.utils为utils.common (8a99daf) by @L-1124
• 重构 QIMEI 获取 (7f0aa0f) by @L-1124

构建配置

• 更新 ruff 配置 (b81311b) by @L-1124
• 从 PDM 迁移到 UV (804c992) by @L-1124 in #78
• Update pdm.lock (e977b5b) by @github-actions[bot] in #76

贡献者

• @L-1124
• @github-actions[bot]
• @renovate[bot][#91](https://github.com/L-1124/QQMusicApi/pull/91)

[0.1.11] - 2024-11-10

Bug 修复

• 单次获取歌曲链接过多报错 (e366f6d) by @L-1124

贡献者

• @L-1124
• @github-actions[bot]

[0.1.10] - 2024-11-09

功能更新

• 支持 logging (35e94ca) by @L-1124 in #73

构建配置

• Update pdm.lock (299299b) by @github-actions[bot] in #74

贡献者

• @L-1124
• @github-actions[bot][#74](https://github.com/L-1124/QQMusicApi/pull/74)

[0.1.9] - 2024-10-26

Bug 修复

• MVApi 注释错误 (0ace5cf) by @L-1124
• 修复获取逐字歌词未解析问题 (26929f2) by @L-1124 in #67

功能更新

• 支持获取专辑封面链接 (7fe9644) by @L-1124

功能重构

• (LoginApi) [breaking] 重构 LoginApi (9244c0e) by @L-1124

文档更新

• 自动生成 Release Notes (5b3dfa6) by @L-1124
• 更新 Readme (485d988) by @L-1124
• Update exceptions.md (a86f4a1) by @L-1124

构建配置

• 更新依赖版本 (1a42f97) by @L-1124

贡献者

• @L-1124
• @github-actions[bot]

[0.1.8] - 2024-10-05

功能更新

• get_song_urls 更好的 Typing Hints (02a62f5) by @L-1124 in #62
• 支持 UserApi (7a99429) by @L-1124 in #59
• 支持检测凭证是否过期 (3a2b011) by @L-1124 in #61
• 支持在事件循环已经运行时同步执行异步代码 (b8190f5) by @L-1124 in #60
• 支持 ogg 640kbps 获取 (fe1660e) by @L-1124 in #58

功能重构

• 重构 ApiException (11298e9) by @L-1124 in #64

贡献者

• @L-1124

[0.1.7] - 2024-09-15

功能更新

• 支持 LyricApi (a5534b5) by @L-1124 in #56
• 支持获取 OGG 320kbps (7d66486) by @L-1124 in #55
• 支持获取加密和试听文件 (bb6cf81) by @L-1124 in #51

文档更新

• 简化贡献文档 (3bae431) by @L-1124 in #54

贡献者

• @L-1124 #57

[0.1.6] - 2024-08-25

Bug 修复

• 注释错误 (0afd820) by @L-1124

功能更新

• 迁移到 httpx (99fb2d9) by @L-1124

功能重构

• 重构 Api 代码 (9e63a1e) by @L-1124

文档更新

• 优化贡献文档 (68c23c3) by @L-1124
• 更新贡献指南 (d04053b) by @L-1124

贡献者

• @L-1124 #48

[0.1.5] - 2024-08-03

Bug 修复

• 未使用上下文管理器时报错 (bc647fa) by @L-1124
• 修复一些小错误 (1fc449a) by @L-1124
• v0.1.4 未包含库文件 (7963f54) by @L-1124

功能更新

• 增加对 albumId 的支持 (d81de7f) by @L-1124

文档更新

• 更新 readme (a454e21) by @L-1124

贡献者

• @L-1124

[0.1.4] - 2024-07-28

构建配置

• 更新 pyproject.toml (aad543b) by @L-1124

贡献者

• @L-1124 #41

[0.1.3] - 2024-07-27

文档更新

• 更完善的 API 文档 (2f62297) by @L-1124 in #38

构建配置

• 迁移依赖管理工具为 PDM (9262b5c) by @L-1124 in #35

贡献者

• @L-1124

[0.1.2] - 2024-07-21

Bug 修复

• 部分类型错误 (f188f6e) by @L-1124
• Fatal error on SSL transport (81a00c7) by @L-1124
• python3.9 union syntax (4475513) by @L-1124
• Api传入Credential无效 (eb1fe62) by @L-1124

功能更新

• (login) 添加报错信息，优化二维码获取 (721546f) by @L-1124
• 更好的错误输出 (05ea8fe) by @L-1124
• 懒获取QIMEI36 (218a740) by @L-1124

功能重构

• 重构 LoginApi 代码 (a44d5ab) by @L-1124 in #33
• 重构代码 (9b17bf6) by @L-1124 in #22

性能优化

• 优化 LoginApi (bcdae55) by @L-1124
• 优化 TopApi (46a1965) by @L-1124

构建配置

• 移除不必要的开发依赖 (3d1dd29) by @L-1124

贡献者

• @L-1124 #34

[0.1.1] - 2024-07-14

Bug 修复

• 修改错误注释 (1a36d71) by @L-1124 in #21
• import issue (cd72cd7) by @L-1124

功能更新

• (SingerApi) 添加 SingerApi Api (506faaa) by @L-1124
• (SongApi) 歌曲Api支持传入Credential (07e7a09) by @L-1124
• (SongApi) 增加获取 Album, Singer (606a163) by @L-1124
• Singer API (b137846) by @L-1124 in #13
• 支持 __repr__ 和 __str__ (7959f85) by @L-1124
• 增加获取歌手列表 API (ae00447) by @L-1124
• add Singer API data (dd641e5) by @L-1124

性能优化

• 优化获取多个歌曲播放链接性能 (2168c07) by @L-1124 in #14

文档更新

• update readme (203c264) by @L-1124
• 添加 API 文档 (b2d2a8e) by @L-1124
• 更新 TODO (5b72d8d) by @L-1124

贡献者

• @L-1124 #21

[0.1.0] - 2024-06-07

Init

• 初始化 main 分支 (352c814) by @L-1124

功能更新

• add Top API (6785b4b) by @L-1124
• add MV API (016f40b) by @L-1124
• add Album API (e827510) by @L-1124
• add Songlist API (5c9b045) by @L-1124
• add Login API (480656e) by @L-1124
• add Song API (6be6382) by @L-1124
• add Search API (7e71614) by @L-1124

功能重构

• some functions directly return Class Song (40e2c11) by @L-1124

构建配置

• update pyproject.toml (6320fdb) by @L-1124

贡献者

• @L-1124