Release Notes

[0.8.2] - 2026-10-05

Dep-bump

• (deps) update dependencies via uv lock --upgrade (70723ae) by @L-1124

功能更新

• (singer) 歌手主页 Tab 接口支持专辑分类筛选与视频标签扩展参数 (e36aa2c) by @L-1124
• (singer) 歌手歌曲、专辑、MV 及主页 Tab 接口支持排序参数 (182da5f) by @L-1124

功能重构

• (singer) 结构化歌手主页 Tab 响应模型 (399efda) by @L-1124
• (web) 收敛纯转发路由至 endpoint 形式 (d28a46f) by @L-1124
• (web) 清理路由 DSL 死代码与冗余 overload (557892d) by @L-1124
• (web) 移除 loguru 依赖与自定义访问日志中间件 (ed153ed) by @L-1124

贡献者

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

[0.8.1] - 2026-10-04

Bug 修复

• (core) 为传输层增加默认请求超时 (86a2716) by @L-1124
• (web) 手机验证码路由改为 POST 提交 (b714255) by @L-1124
• (web) 参数校验失败响应返回错误详情 (dee7e18) by @L-1124

功能更新

• (core) 新增 Credential.is_valid 并收编登录态判断 (415b3ae) by @L-1124
• (core) 补充 py.typed 类型标记 (2136321) by @L-1124

功能重构

• (web) 复用 Credential.is_valid 移除重复登录态判断 (f8ec18d) by @L-1124

文档更新

• 修正刷新凭证示例与 Web 服务启动说明 (83e743b) by @L-1124

贡献者

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

[0.8.0] - 2026-10-04

Bug 修复

• (core) 修复请求分页提取器的参数克隆冲突 (e74d00b) by @L-1124
• (tests) 修复 disable_parse 移除后的测试残留并清理装饰性框线 (39fc259) by @L-1124
• (web) 未捕获异常统一返回 JSON 形状的 500 响应 (95e5ab4) by @L-1124
• (web) 屏蔽上游 5xx 异常细节并修正凭证快照的阻塞调用 (2d384b0) by @L-1124
• (web) 修复池凭证过期判定与刷新未同锁导致的重复登录 (4426508) by @L-1124
• (web) 修复调用方 Cookie 凭证被刷新并写回共享池的问题 (4aeab21) by @L-1124

功能更新

• (core) Android comm 参数补充注入 traceid (84cc613) by @L-1124
• (core) 提升全局 Android 协议版本为 20.9.0.8 (6ce5d7e) by @L-1124
• (core) 引入声明式 Endpoint 与无客户端网关 (116e7fd) by @L-1124 in #304
• (core) 优化 comm 参数与设备标识语义 (072011a) by @L-1124
• (core) 解耦设备缓存并完善并发控制 (2eb66c4) by @L-1124
• (core) [breaking] 引入统一请求内核与显式流式读取 (bc09d1c) by @L-1124 in #303
• (device) 完善 Android 设备档案生成 (4c67b50) by @L-1124
• (device) 优化设备生成与 QIMEI 参数 (f207f82) by @L-1124
• (sound_power) 新增音响力与听歌榜模块及 Web 路由 (514fc3f) by @L-1124
• (web) 缓存未命中引入请求合并与上游失败标记熔断 (807421d) by @L-1124

功能重构

• (album) 迁移 AlbumApi 端点至 @cgi_endpoint 并更新 Web 路由 (7522cea) by @L-1124
• (comment) 迁移 CommentApi 端点至 @cgi_endpoint 并更新 Web 路由 (1565743) by @L-1124
• (core) 让 CgiRequestData.param 默认为空字典并移除冗余空参数 (55f7b01) by @L-1124
• (core) 彻底移除 disable_parse 选项并更新端点声明范式文档 (5cf1a06) by @L-1124
• (core) 彻底分离端点元数据与运行期覆盖契约 (46a1a2e) by @L-1124
• (core) 为端点装饰器增加分页类型重载与通用契约校验 (f443e65) by @L-1124
• (lyric) 迁移 LyricApi 端点至 @cgi_endpoint 并更新 Web 路由 (e12ae87) by @L-1124
• (modules) 为各模块端点声明 item_type 与 pager 契约并清理测试 (8308052) by @L-1124
• (mv) 迁移 MvApi 端点至 @cgi_endpoint 并更新 Web 路由 (d2e383c) by @L-1124
• (recommend) 迁移 RecommendApi 端点至 @cgi_endpoint 并更新 Web 路由 (b97c043) by @L-1124
• (search) 迁移 SearchApi 端点至 @cgi_endpoint 并更新 Web 路由 (25fe3eb) by @L-1124
• (singer) [breaking] 移除 get_name_special_display 并合并至 get_info (e293aa3) by @L-1124
• (singer) 迁移 SingerApi 端点至 @cgi_endpoint 并更新 Web 路由 (79af270) by @L-1124
• (song) 迁移 SongApi 端点至 @cgi_endpoint 并更新 Web 路由 (8c08868) by @L-1124
• (songlist) 迁移 SonglistApi 端点至 @cgi_endpoint 并更新 Web 路由 (ba50d18) by @L-1124
• (top) 迁移 TopApi 端点至 @cgi_endpoint 并更新 Web 路由 (e2a1fee) by @L-1124
• (user) 迁移 UserApi 端点至 @cgi_endpoint 并更新 Web 路由 (49921f6) by @L-1124
• (web) [breaking] 优化 web 端参数声明，减少冗余 (ba95861) by @L-1124
• (web) 在路由注册器中增加 Web 模块白名单校验 (9b0bc65) by @L-1124

性能优化

• (qimei) 优化设备特征计算与静态参数缓存 (e19fdf2) by @L-1124

文档更新

• (coding) 补充声明式端点撰写指南并更新架构概览与调用流程 (866bffb) by @L-1124
• (examples) 新增音响力查询与听歌时长上报示例 (a408059) by @L-1124

贡献者

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

[0.7.3] - 2026-09-13

Bug 修复

• (song) 恢复 get_song_urls 的 mid 数量上限校验 (c358c77) by @L-1124

功能更新

• (singer) 新增歌手名称透明 PNG 接口及演示 (3740170) by @Lincb522 in #302

贡献者

• @L-1124
• @Lincb522 #302
• @github-actions[bot]

[0.7.2] - 2026-08-05

Bug 修复

• (routing) 修复 add_api_route tags 参数类型不匹配 (ee98436) by @L-1124

功能更新

• (search) 为 quick_search/complete/get_hotkey 添加响应模型 (b97549f) by @L-1124
• (singer) 支持 get_desc 接口详细数据控制参数 (8a8c7f1) by @L-1124

功能重构

• (core) [breaking] 统一请求调度引擎 (8b71333) by @L-1124 in #301

文档更新

• 更新 lyric.py 中的错误 docstring (8ec78ce) by @L-1124

贡献者

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

[0.7.1] - 2026-08-02

Bug 修复

• (Song) 移除 SongApi 中不必要的参数说明 (e4b02c7) by @L-1124
• (web) 使用 context.credential 修复 adapter 凭证读取 KeyError (261326e) by @L-1124
• (web) 修复 404 响应不符合 RESTful 规范的问题 (9658bd5) by @L-1124
• (web) 修复 Web 模块代码质量与性能问题 (329f822) by @L-1124

Dep-bump

• (deps) update dependencies via uv lock --upgrade (943ed52) by @L-1124

功能更新

• (comment) 支持设置评论业务类型与子类型 (ea6095c) by @L-1124
• (lyric) 支持获取 AI 歌词词典 (44e81f0) by @L-1124
• (lyric) 支持获取多风格翻译歌词 (43d6429) by @L-1124
• (lyric) 支持获取助唱标注歌词及信息 (3166fea) by @L-1124
• (search) 支持彩铃搜索类型 RINGTONE 与彩铃文件类型 RingSongFileType (6c2118c) by @L-1124
• (search) 类型搜索支持选择器 (e097442) by @L-1124
• (web) 引入 AuthPolicy.OPTIONAL 并对齐 SDK 凭证策略 (ea29202) by @L-1124
• (web) 优化枚举参数在 OpenAPI 文档中的说明展示 (075a1ed) by @L-1124
• (web) 支持 list[BaseModel] 类型的 JSON Query 参数解析 (9dd26ee) by @L-1124

功能重构

• (core) [breaking] 重构并统一分页体系 (cb41e16) by @L-1124 in #299
• (core) [breaking] 移除未使用的 JCE 协议支持 (dca6c7c) by @L-1124
• (lyric) [breaking] 统一 song_id 为 songid (e6d2a0b) by @L-1124
• (web) 引入 Adapter 注册表机制解耦路由声明 (8b573c6) by @L-1124

文档更新

• (api) 补充缺失的 API 模块和数据模型文档映射 (8fe6095) by @L-1124

贡献者

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

[0.7.0] - 2026-07-22

Bug 修复

• fix retry import path (75d0693) by @L-1124

功能更新

• (lyric) 支持指定特殊歌曲类型(song_type)查询歌词 (1b0aae0) by @L-1124
• (song) [breaking] 重构歌曲查询支持 SongQueryInfo 与 Web POST 批量路由 (4cbb2c6) by @L-1124

贡献者

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

[0.6.9] - 2026-07-12

Bug 修复

• (web) 修复凭据刷新异常捕获过宽与 ETag 缓存机制形同虚设的问题 (305a063) by @L-1124
• (web) 修复配置账号由于重置逻辑缺陷被永久标记失效与流式响应并发槽位泄露 (56f3034) by @L-1124
• (web) 避免将 credential 对象盲目混入参数导致 SDK 签名报错 (fc8b32c) by @L-1124
• (web) 修复 KeyedLock finalizer 泄漏与 Redis 序列化 Pydantic 模型问题 (5440a5e) by @L-1124
• (web) 修正 songlist 创建与删除路由的 HTTP 方法 (43c9ce6) by @L-1124
• (web) 修复凭据刷新锁与限流器的内存泄漏 (c5ed6a3) by @L-1124
• (web) 修复 search 路由声明中 Any 导致的类型检查错误 (d1aea06) by @L-1124
• (web) 修复返回 bool 类型时生成的文档和数据格式问题 (af8550d) by @L-1124

功能更新

• (web) 添加 UserApi 的DisLike和favor api (b1aa67d) by @L-1124
• 新增新碟上架 / MV 分类 / 收藏专辑 / 收藏歌曲接口与推荐新歌地区筛选 (520c92b) by @jinzhongjia in #284

功能重构

• (web) 收敛配置修改与硬编码路径到配置层 (0e5950c) by @L-1124
• (web) 抽取统一的 refresh_and_store 方法消除重复，并补全重试刷新失败时的无效标记逻辑 (a4a0729) by @L-1124
• (web) 移除 songlist 的动态 getattr 分发以恢复类型安全与修复潜在凭据 KeyError (c1030e1) by @L-1124

性能优化

• (web) 启用 SQLite WAL 模式并延迟反序列化随机凭据 (7d01994) by @L-1124
• (web) 缓存路由参数解析以避免重复的 SDK 签名内省 (61cc5a5) by @L-1124
• (web) 抽取 app 为会话级 fixture 以大幅降低测试耗时 (6d13b50) by @L-1124
• (web) 移除缓存层与响应中不必要的双重序列化 (bbc865c) by @L-1124

贡献者

• @L-1124
• @jinzhongjia #284
• @github-actions[bot]

[0.6.8] - 2026-07-01

Bug 修复

• (web) 禁用 FastAPI 默认按别名响应，使 JSON 输出与 Python 原生变量名保持一致 (32459a5) by @L-1124

功能更新

• (core) 新增 SignatureRequiredError 错误码 2000 处理 (a73313a) by @L-1124
• (core) _ensure_session 添加 24h 保活机制 (2290a32) by @L-1124
• (helper) 新增辅助功能接口 (eb0c40c) by @L-1124
• (login) 支持登出API (73f2a7e) by @L-1124
• (lyric) [breaking] 彻底移除 crypt 字段，隐式处理加密状态 (80edc40) by @L-1124
• (lyric) [breaking] 移除 decrypt 方法，改为默认解密 (24949c4) by @L-1124
• (song) 添加特殊歌曲文件类型 TRY_OGG_640 (fef7e8c) by @L-1124
• (user) 新增收藏/取消收藏歌单 API (7865434) by @jinzhongjia in #281
• (user) 新增 FeedbackBlack 黑名单 API (4340554) by @L-1124
• (web) 启用 FastAPI 内置 Swagger UI 和 ReDoc，更新文档地址说明 (a3245ad) by @L-1124
• (web) 重构 Dockerfile 为多阶段构建，修复非 root 用户 uv 缓存权限问题 (00e16a3) by @L-1124

功能重构

• (core) 移除 _session_cache 冗余缓存，简化会话验证逻辑 (0b12b9d) by @L-1124
• (models) [breaking] 将所有模型中的 alias 统一替换为 validation_alias，隔离序列化字段名 (c611b91) by @L-1124
• (modules) 移除冗余的 _require_login 调用，统一使用 require_login 参数 (1a666f4) by @L-1124
• (modules) 将 _require_login 收敛到 _build_request 的 require_login 参数中 (d1a92ca) by @L-1124

文档更新

• (coding) 更新需登录接口的编码规范，使用 require_login 参数替代 _require_login (9e56215) by @L-1124
• (dislike) 更新不喜欢列表项和响应数据的文档说明 (5dbf711) by @L-1124
• (login) 更新二维码和手机验证码登录状态的文档注释 (f31d4d0) by @L-1124
• (readme) 添加 DeepWiki 相关链接 (fcea758) by @L-1124

贡献者

• @L-1124
• @jinzhongjia #281
• @github-actions[bot]

[0.6.7] - 2026-06-17

功能更新

• (login) 新增登录异常子类和错误码映射 (0ef9645) by @jinzhongjia in #269
• (qimei) 增加 24 小时过期重新获取逻辑 (05aed29) by @L-1124
• (web) 添加 has_sheet 路由 (9e7a143) by @L-1124

文档更新

• (coding) 重写 API 编写指南，补充开发细节 (9db46de) by @L-1124
• 为固定请求平台的 API 补充 docstring 说明 (aba712e) by @L-1124
• 完善快速开始文档并新增多篇核心教程 (d6143cd) by @L-1124

贡献者

• @L-1124
• @jinzhongjia #269
• @github-actions[bot]
• @renovate[bot]

[0.6.6] - 2026-06-13

Bug 修复

• (song) 修复 get_sheet 获取无曲谱歌曲时触发异常的问题 (f47a643) by @L-1124
• (web) 修复评论适配器与凭证锁内存泄漏，优化基础设施 (66a6cc4) by @L-1124

Revert

• (models) 回退 BaseModel 额外字段处理策略为 extra='ignore' (f6691e0) by @L-1124

功能更新

• (client) 支持 zzc 请求签名 (eb4eb66) by @L-1124
• (core) 支持在使用 allow_error_codes 放行时强制解析模型 (fac2a71) by @L-1124
• (core) 支持通过 override_comm 彻底替代通用请求载荷 (72edb4f) by @L-1124
• (song) 添加新的曲谱相关 API和相关示例 (9c461db) by @L-1124
• (song) 支持 HasSheetMusic 接口检查歌曲是否有曲谱 (94723ff) by @L-1124
• (web) 补充 requirements.txt (d806214) by @L-1124

性能优化

• (qrc) 优化自定义 3DES 解密性能并补充测试 (0b808a5) by @L-1124

构建配置

• (web) 在 Dockerfile 运行命令中添加 --no-sync 防止容器运行期同步 dev 依赖 (cf1fbc5) by @L-1124

贡献者

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

[0.6.5] - 2026-06-12

Bug 修复

• (core) 开启 allow_incoming_cookies=False 防止上下请求的 cookies 污染 (1cd1b69) by @L-1124
• (login) Platform.WEB 的 check_expired 总是返回 True (f0b4533) by @L-1124

贡献者

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

[0.6.4] - 2026-06-12

Bug 修复

• (models) 修复没有 musickey 时误判为 QQ 登录的问题 (9b122a7) by @L-1124

功能更新

• (models) 修改 BaseModel 的 model_config 设置，允许额外字段 (12a2334) by @L-1124

贡献者

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

[0.6.3] - 2026-06-12

Bug 修复

• (models) 修复 jsonpath 通配字段单条解包与收藏 MV subcode 别名不匹配 (b31f802) by @jinzhongjia in #259
• (tests) 修复 handle_unavailable_api_errors fixture 无法正确捕获测试执行期异常并跳过的问题 (412d6cf) by @L-1124

功能更新

• (user) get_vip_info 响应模型补充会员身份字段 (6504373) by @jinzhongjia in #258

功能重构

• (models) field_validator → Annotated + BeforeValidator (5505ed1) by @L-1124

贡献者

• @L-1124
• @jinzhongjia #259
• @github-actions[bot]

[0.6.2] - 2026-06-08

Bug 修复

• (core) 将 niquests 网络异常转换为NetworkError抛出" (ff659c5) by @L-1124
• (core) 修复 ANDROID 会话初始化的循环依赖和缓存失效问题 (4f9be43) by @L-1124
• (recommend) 更新获取猜你喜欢推荐接口，支持传入 Credential, 添加 uid 字段到版本策略 (81062d0) by @L-1124

功能更新

• (core) 添加 getSession 匿名会话初始化和设备 OpenUDID 持久化 (9a4532e) by @L-1124
• (web) 补充评论增删路由及推荐认证支持 (08c9137) by @L-1124

功能重构

• (web) 重构日志系统 (20fe8c6) by @L-1124
• (web) 统一代码风格与日志惰性求值 (4ba0bf0) by @L-1124
• (web) 补齐路由辅助函数与应用入口类型注解 (080b2fe) by @L-1124
• (web/routing) 补齐路由类型与参数校验器类型注解 (bcedc66) by @L-1124

贡献者

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

[0.6.1] - 2026-05-20

Bug 修复

• 传入的platform不生效 (b19bec5) by @L-1124

功能更新

• (comment) 支持添加评论和删除评论功能 (dc5f568) by @L-1124
• (private-message) 新增私信接口模块 (0ce6c77) by @L-1124

贡献者

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

[0.6.0] - 2026-05-09

Bug 修复

• (login) 修改手机验证码鉴权参数类型为字符串 (5cfebc6) by @L-1124

功能更新

• (client) 添加连接重试机制参数 (38134a7) by @L-1124
• (core) [breaking] 移除 RequestGroup，支持 Client.gather 批量并发请求，重构请求速率限制参数 (632b6a8) by @L-1124
• (web) 添加 Docker 支持 (b6f4dfc) by @L-1124
• (web) 添加 Web 服务路由 (154d714) by @L-1124 in #247
• [breaking] 不再支持配置 Client 部分参数并且修改并且初始化参数名 (c4a7001) by @L-1124

功能重构

• (algorithms) [breaking] 移除 Web 端请求签名模块 (21b3179) by @L-1124
• (core) 重构 API 客户端, 迁移 httpx → niquests (fc4f1b7) by @L-1124
• (exception) [breaking] 重构异常体系 (3f7ef32) by @L-1124

贡献者

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

[0.5.3] - 2026-05-01

Bug 修复

• (song) 传递歌曲链接请求凭证 (8667e8c) by @L-1124
• 模型字段类型出现int | str (ed2e450) by @L-1124
• 手机登录没有正常返回验证链接 (3f69c5d) by @L-1124
• [breaking] 拼写错误及其他问题 (6bd129e) by @Copilot in #242

功能更新

• (api) 统一分页参数，暴露搜索一致性参数 (a3d3a5d) by @L-1124
• (login) 细化登录异常体系并修正请求参数 (fb9d2e6) by @L-1124 in #245

贡献者

• @L-1124
• @Copilot #242
• @github-actions[bot]

[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