QKKDecrypt | QQ 酷狗酷我网易云音乐解密工具

项目已衍生出agent版本，详情请点击 TriAgent
TriAgent目前处于开发版，可能会不稳定

项目定位

QKKDecrypt 是一个面向本地文件处理场景的桌面/控制台工具集：

• 控制台版本：批处理、自动化、脚本化操作
• UI 版本：面向普通用户的桌面工作台
• 架构保持三层：Presentation / Application / Infrastructure

当前仓库源码统一按 GPLv3 发布；UI 路线采用 PySide6 + QFluentWidgets 的非商业 GPLv3 路线持续重构。

分支说明

• main
  • 控制台版本
  • 薄入口 main.py
  • 打包形态：onefile
• main-ui
  • PySide6 桌面 UI 版本
  • 保留无边框、Win10/11 风格、亚克力效果与动态进度反馈
  • 打包形态：onedir + _internal + setup

当前支持的平台

• QQ音乐
  • 运行期解密
  • 需要 QQ 音乐进程配合
• 酷我音乐
  • 运行期解密
  • 需要酷我进程配合
• 酷狗音乐
  • 文件级离线解密
• 网易云音乐
  • 文件级离线解密

UI 路线

UI 版本继续使用 PySide6，并逐步引入 QFluentWidgets 做导航、卡片和桌面风格控件，目标体验参考 Steam++：

• 左侧导航栏
• 页面分区明确
• 设置页面独立
• 小窗口/辅助页独立
• 无边框桌面体验
• 动态进度反馈与现代化状态提示

打包

npm run package

默认会构建：

• QKKDecrypt.exe
• QKKDecrypt-UI-setup.exe

合规与风险边界

以下内容是工程合规说明，不构成法律意见。

你应当只在这些前提下使用本项目

• 仅处理你本人拥有合法访问权限的本地文件
• 自行确认你的使用行为符合所在地法律、版权规则、平台协议和组织政策
• 不要把本项目用于批量分发、倒卖、牟利或规避付费授权

项目不承诺这些事情

• 不承诺适用于所有地区、所有平台规则、所有用途
• 不承诺一定符合你所在地区的合规要求
• 不承诺任何特定商业用途可直接使用
• 不为用户的侵权、违约或违规使用承担责任

对外发布建议口径

如果你二次分发、改包或转载，请至少保留下列表达：

本项目按 GPLv3 发布，仅面向学习、研究与本地文件处理场景。使用者应仅处理自己拥有合法访问权限的文件，并自行确认其行为符合适用法律、版权规则及平台协议。项目作者不对非法或违规用途负责。

第三方组件说明

请同时阅读：

• THIRD_PARTY_LICENSES.md

当前需要特别注意：

• PySide6
• PySide6-Fluent-Widgets
• FFmpeg
• 其他运行期依赖和打包依赖

致谢

• QQ 音乐解密模型思路参考项目：
  • qqmusic_decrypt
• 网易云音乐解密模型参考 ncmdump 相关实现思路
• 其他平台相关逻辑以学习、研究和兼容性验证为目的持续整理

许可证

本仓库源码按 GNU GPL v3 发布：

• LICENSE

如果你计划进行商业使用、闭源分发或接入额外第三方组件，请先自行完成完整的许可证核验和风险评估。