From 537391ed0318810c0c068201fedda7f22f9f3ea1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=B2=81=E6=A0=91=E4=BA=BA?= Date: Wed, 21 Oct 2026 11:40:55 +0900 Subject: [PATCH] docs: update README and FAQ for QQ Music client key requirements - Revised README to clarify that QQ Music PC client versions 19.57 to 22.76 require importing a key file extracted using qmpc-mmkv-cli. - Updated issue template to reflect the same changes regarding key file requirements for Windows clients. - Modified FAQ to specify that only versions 19.51 or lower do not require a key, while versions 19.57 to 22.76 do. - Enhanced instructions for obtaining the key file in the PC instructions panel. --- .gitea/ISSUE_TEMPLATE/50-qqmusic.yaml | 4 +++- README.MD | 2 +- docs/faq_zh-hans.md | 2 +- .../settings/panels/QMCv2/InstructionsPC.tsx | 15 +++++++++++---- 4 files changed, 16 insertions(+), 7 deletions(-) diff --git a/.gitea/ISSUE_TEMPLATE/50-qqmusic.yaml b/.gitea/ISSUE_TEMPLATE/50-qqmusic.yaml index f2b8603..ae871e2 100644 --- a/.gitea/ISSUE_TEMPLATE/50-qqmusic.yaml +++ b/.gitea/ISSUE_TEMPLATE/50-qqmusic.yaml @@ -7,7 +7,9 @@ body: value: | ### Windows 客户端 - 目前 Windows 客户端仅支持 19.51 或更低版本下载的歌曲文件。 + 目前 Windows 客户端支持 19.57 至 22.76（目前最新版）下载的歌曲文件，但需要导入由 [qmpc-mmkv-cli](https://git.um-react.app/um/qmpc-mmkv/releases) 提取的密钥文件 `qmpc-mmkv-v1.mmkv`。 + + 使用 19.51 或更低版本下载的歌曲文件无需密钥。 * [web.archive.org 镜像](https://web.archive.org/web/2023/https://dldir1v6.qq.com/music/clntupate/QQMusic_Setup_1951.exe) * [通过 Telegram 下载](https://t.me/um_lsr_ch/24) diff --git a/README.MD b/README.MD index 6e39fc8..89dfafc 100644 --- a/README.MD +++ b/README.MD @@ -40,7 +40,7 @@ - [x] 蜻蜓 FM (`.qta`) - 需要提取设备 ID。 -[^qm-key-pc]: QQ 音乐的 PC 客户端仅支持 v19.51 或更低版本。 +[^qm-key-pc]: QQ 音乐的 PC 客户端（v19.57 至 v22.76）需要导入由 [qmpc-mmkv-cli](https://git.um-react.app/um/qmpc-mmkv/releases) 提取的密钥文件 `qmpc-mmkv-v1.mmkv`。 [^qm-key-android]: QQ 音乐的安卓客户端支持需要获取超级管理员权限后提取密钥数据库并导入后使用。 diff --git a/docs/faq_zh-hans.md b/docs/faq_zh-hans.md index 9002cbc..e427af8 100644 --- a/docs/faq_zh-hans.md +++ b/docs/faq_zh-hans.md @@ -10,7 +10,7 @@ #### 2、检查您的平台。 -日前，仅 Windows 客户端 v19.43 或以下版本下载的歌曲无需密钥，其余平台的官方正式版本均需要提取密钥。 +日前，Windows 客户端 v19.57 至 v22.76（目前最新版）下载的歌曲需要导入由 [qmpc-mmkv-cli](https://git.um-react.app/um/qmpc-mmkv/releases) 提取的密钥文件 `qmpc-mmkv-v1.mmkv`；v19.51 或更低版本下载的歌曲无需密钥。其余平台的官方正式版本均需要提取密钥。 > iOS 用户提取歌曲困难，建议换用电脑操作；Android 用户提取密钥需要 root，也建议用电脑操作。 diff --git a/src/features/settings/panels/QMCv2/InstructionsPC.tsx b/src/features/settings/panels/QMCv2/InstructionsPC.tsx index c897077..64bd701 100644 --- a/src/features/settings/panels/QMCv2/InstructionsPC.tsx +++ b/src/features/settings/panels/QMCv2/InstructionsPC.tsx @@ -3,6 +3,7 @@ import { HiWord } from '~/components/HelpText/HiWord'; import NoopExecutable from './assets/noop.exe?base64'; import NoopExecutableSource from './assets/noop.asm.txt?base64'; +const QMPC_MMKV_RELEASES_URL = 'https://git.um-react.app/um/qmpc-mmkv/releases'; const PC_CLIENT_URL = 'https://web.archive.org/web/2023/https://dldir1v6.qq.com/music/clntupate/QQMusic_Setup_1951.exe'; const PC_CLIENT_TG_URL = 'https://t.me/um_lsr_ch/24'; @@ -10,14 +11,20 @@ export function InstructionsPC() { return ( <>

- 使用 19.57 或更高版本下载的歌曲文件 + 使用 19.57 至 22.76下载的歌曲文件 需要导入密钥。 -
- 目前未公开密钥获取方式，因此不支持。

- 使用 19.51 或更低版本下载的歌曲文件 + 请从{' '} + + qmpc-mmkv-cli + {' '} + 获取工具，提取密钥文件 qmpc-mmkv-v1.mmkv 后在本页导入。 +

+ +

+ 使用 19.51 或更低版本下载的歌曲文件 无需密钥。