0.5.2

Reviewed-on: https://git.unlock-music.dev/um/um-react/pulls/92

.dockerignore

@@ -0,0 +1,3 @@
+dist
+node_modules
+*.log

.eslintignore

@@ -1,3 +0,0 @@
-dist/
-node_modules/
-coverage/

.eslintrc.cjs

@@ -1,27 +0,0 @@
-/* eslint-env node */
-
-module.exports = {
-  root: true,
-  env: { browser: true, es2020: true },
-  extends: [
-    'eslint:recommended',
-    'plugin:@typescript-eslint/recommended',
-    'plugin:react-hooks/recommended',
-    'prettier',
-  ],
-  parser: '@typescript-eslint/parser',
-  parserOptions: { ecmaVersion: 'latest', sourceType: 'module' },
-  plugins: ['react-refresh'],
-  rules: {
-    'react-refresh/only-export-components': 'warn',
-    '@typescript-eslint/no-unused-vars': [
-      'error',
-      {
-        varsIgnorePattern: '^_',
-        argsIgnorePattern: '^_',
-        destructuredArrayIgnorePattern: '^_',
-        ignoreRestSiblings: true,
-      },
-    ],
-  },
-};

.gitea/ISSUE_TEMPLATE/50-qqmusic-android.yaml

@@ -0,0 +1,46 @@
+name: QQ 音乐 (安卓)
+about: 解密使用「QQ 音乐」的「安卓」客户端下载的文件失败时选择该项。
+title: '[QQ音乐]: 请填写标题'
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ### 安卓客户端
+
+        你的手机需要 root 权限。注意 root 可能会导致手机保修失效，操作不当可能会导致手机变砖。
+
+        请参考 [um-react](https://um-react.netlify.app/) 上方的答疑区域获取说明。
+
+        此外请使用 Chrome 或 Firefox 浏览器，而非系统自带的浏览器或轻量浏览器，如 Via 浏览器。
+
+        ---
+
+        如果你确定你的客户端版本符合上述描述，并遇到了问题，请继续填写下面的表单。
+
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: 错误描述
+      description: |
+        请详细描述你遇到的问题，例如下载使用的客户端、提供下载后的文件、操作步骤、错误提示等你认为会帮助修正错误的信息。
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: 相关日志
+      description: 如果有相关日志，请附上。浏览器日志可以通过 F12 打开开发者工具，在 Console 选项卡中查看。
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: 检查清单
+      description: 请检查下方的快速检查清单，确保你已经完成了所有步骤。
+      options:
+        - label: 我有填写一个简单易懂的标题
+          required: true
+        - label: 我有阅读上方的说明
+          required: true
+        - label: 我有阅读 um-react 的答疑部分
+          required: true
+        - label: 我的安卓设备已获得 root 权限
+          required: true

.gitea/ISSUE_TEMPLATE/50-qqmusic.yaml

@@ -0,0 +1,68 @@
+name: QQ 音乐 (Windows/Mac)
+about: 解密使用「QQ 音乐」的「Windows」或「Mac」客户端下载的文件失败时选择该项。
+title: '[QQ音乐]: 请填写标题'
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ### Windows 客户端
+
+        目前 Windows 客户端仅支持 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)
+
+        安装好客户端后可以加装更新屏蔽更新：
+
+        * [通过 Telegram 下载](https://t.me/um_lsr_ch/6)
+
+        ### Mac 客户端
+
+        目前 Mac 客户端仅支持 v8.8.0 或更低版本下载的歌曲文件。
+
+        * [web.archive.org 镜像](https://web.archive.org/web/20230903/https://dldir1.qq.com/music/clntupate/mac/QQMusicMac_Mgr.dmg)
+        * [通过 Telegram 下载](https://t.me/um_lsr_ch/21)
+
+        安装好客户端后可以加装更新屏蔽更新：
+
+        * [屏蔽更新](https://t.me/um_lsr_ch/29)
+
+        ---
+
+        如果你确定你的客户端版本符合上述描述，并遇到了问题，请继续填写下面的表单。
+
+  - type: dropdown
+    id: platform
+    attributes:
+      label: 平台
+      description: 你使用的客户端平台是…
+      options:
+        - Windows
+        - Mac
+    validations:
+      required: true
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: 错误描述
+      description: |
+        请详细描述你遇到的问题，例如下载使用的客户端、提供下载后的文件、操作步骤、错误提示等你认为会帮助修正错误的信息。
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: 相关日志
+      description: 如果有相关日志，请附上。浏览器日志可以通过 F12 打开开发者工具，在 Console 选项卡中查看。
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: 检查清单
+      description: 请检查下方的快速检查清单，确保你已经完成了所有步骤。
+      options:
+        - label: 我有填写一个简单易懂的标题
+          required: true
+        - label: 我有阅读上方的说明
+          required: true
+        - label: 我有阅读 um-react 的答疑部分
+          required: true

.gitea/ISSUE_TEMPLATE/53-kuwo-android.yaml

@@ -0,0 +1,51 @@
+name: 酷我音乐 (安卓)
+about: 解密使用「酷我音乐」的「安卓」客户端下载的文件失败时选择该项。
+title: '[酷我音乐]: 请填写标题'
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ### 酷我音乐 - 安卓客户端
+
+        你的手机需要 root 权限。注意 root 可能会导致手机保修失效，操作不当可能会导致手机变砖。
+
+        请参考 [um-react](https://um-react.netlify.app/) 上方的答疑区域获取说明。
+
+        此外请使用 Chrome 或 Firefox 浏览器，而非系统自带的浏览器或轻量浏览器，如 Via 浏览器。
+
+        ※ 如果你使用酷我音乐的是所谓“破解版”，你的问题会被忽略。
+        已知部分“第三方魔改”会破坏密钥写出过程，请从官方渠道安装酷我音乐。
+
+        ---
+
+        如果你确定你的客户端版本符合上述描述，并遇到了问题，请继续填写下面的表单。
+
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: 错误描述
+      description: |
+        请详细描述你遇到的问题，例如下载使用的客户端、提供下载后的文件、操作步骤、错误提示等你认为会帮助修正错误的信息。
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: 相关日志
+      description: 如果有相关日志，请附上。浏览器日志可以通过 F12 打开开发者工具，在 Console 选项卡中查看。
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: 检查清单
+      description: 请检查下方的快速检查清单，确保你已经完成了所有步骤。
+      options:
+        - label: 我有填写一个简单易懂的标题
+          required: true
+        - label: 我有阅读上方的说明
+          required: true
+        - label: 我有阅读 um-react 的答疑部分
+          required: true
+        - label: 我的安卓设备已获得 root 权限
+          required: true
+        - label: 我能使用官方渠道下载的酷我音乐客户端复现该问题
+          required: true

.gitea/ISSUE_TEMPLATE/99-default.md

@@ -0,0 +1,4 @@
+---
+name: '其它'
+about: '如果你遇到的问题不符合上述模板的描述，请选择此项。'
+---

.gitea/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

.gitea/workflows/build.yaml

@@ -17,16 +17,20 @@ jobs:
             - args: [--frozen-lockfile, --strict-peer-dependencies]
       - name: Build
         run: pnpm build
-      - name: Prepare for deployment
+      - name: Pack Win64
         run: |
           python3 -m zipfile -c um-react.zip dist/.
-          cp um-react.zip dist/"release-${GITHUB_SHA}.zip"
+          ./scripts/make-win64.sh
-          python3 -m zipfile -c um-react-site.zip dist/.
       - name: Publish Artifact
         uses: christopherhx/gitea-upload-artifact@v4
         with:
           name: site
           path: dist/
+      - name: Prepare for deployment
+        run: |
+          cp um-react.zip dist/"release-${GITHUB_SHA}.zip"
+          cp win64/dist/*.zip dist/"release-${GITHUB_SHA}-win64.zip"
+          python3 -m zipfile -c um-react-site.zip dist/.
       - name: Deploy
         env:
           NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }}

.gitignore

@@ -32,3 +32,7 @@ dist-ssr
 /um-react*.exe
 
 /win64/
+
+# Python
+*.py[cod]
+__pycache__

.npmrc

@@ -1,3 +1,3 @@
-use-node-version=22.12.0
+use-node-version=24.7.0
 engine-strict=true
-@unlock-music:registry=https://git.unlock-music.dev/api/packages/um/npm/
+@unlock-music:registry=https://git.um-react.app/api/packages/um/npm/

.vscode/extensions.json

@@ -1,11 +1,9 @@
 {
   "recommendations": [
-    "editorconfig.editorconfig",
+    "bradlc.vscode-tailwindcss",
     "dbaeumer.vscode-eslint",
+    "editorconfig.editorconfig",
     "esbenp.prettier-vscode",
-    "christian-kohler.path-intellisense",
+    "foxundermoon.shell-format"
-    "txava.region-marker",
-    "foxundermoon.shell-format",
-    "jock.svg"
   ]
 }

Dockerfile

@@ -0,0 +1,25 @@
+FROM node:22-slim AS build
+ENV PNPM_HOME="/p"
+ENV PATH="$PNPM_HOME:$PATH"
+WORKDIR /app
+
+RUN corepack enable pnpm \
+    && apt-get update \
+    && apt-get install -y --no-install-recommends git \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY package.json pnpm-lock.yaml .npmrc ./
+RUN pnpm exec true
+COPY . .
+RUN pnpm install --frozen-lockfile
+
+ARG GIT_COMMIT=
+ARG GIT_COMMIT_FULL=
+
+RUN pnpm build
+
+FROM caddy:latest
+COPY --from=build /app/dist /srv/um-react
+EXPOSE 80
+CMD ["caddy", "file-server", "--root", "/srv/um-react"]

README.MD

@@ -1,6 +1,6 @@
 # Unlock Music 音乐解锁 (React)
 
-[![Build Status](https://ci.unlock-music.dev/api/badges/um/um-react/status.svg)](https://ci.unlock-music.dev/um/um-react)
+[![Build Status](https://git.um-react.app/um/um-react/actions/workflows/build.yaml/badge.svg)][um-react-actions]
 
 - 在浏览器中解锁加密的音乐文件。 Unlock encrypted music file in the browser.
   - 查看[原基于 Vue 的 Unlock Music 项目][um-vue]
@@ -13,11 +13,11 @@
 > **WARNING**
 > 在本站 fork 不会起到备份的作用，只会浪费服务器储存空间。如无必要请勿 fork 该仓库。
 
-[授权协议]: https://git.unlock-music.dev/um/um-react/src/branch/main/LICENSE
+[授权协议]: https://git.um-react.app/um/um-react/src/branch/main/LICENSE
-[um-vue]: https://git.unlock-music.dev/um/web
+[um-vue]: https://git.um-react.app/um/web
-[unlock-music/cli]: https://git.unlock-music.dev/um/cli
+[unlock-music/cli]: https://git.um-react.app/um/cli
 [`@unlock_music_chat`]: https://t.me/unlock_music_chat
-[um-react-actions]: https://git.unlock-music.dev/um/um-react/actions
+[um-react-actions]: https://git.um-react.app/um/um-react/actions?workflow=build.yaml
 
 ⚠️ 手机端浏览器支持有限，请使用最新版本的 Chrome 或 Firefox 官方浏览器。
 
@@ -32,7 +32,8 @@
 - [x] 网易云音乐 (`.ncm`)
 - [x] 虾米音乐 (`.xm`)
 - [x] 酷我音乐 (`.kwm`)
-- [x] 酷狗音乐 (`.kgm` / `.vpr`)
+- [x] 酷狗音乐 (`.kgm` / `.vpr` / `.kgg`)
+  - PC / 安卓客户端的 `kgg` 文件需要提供密钥数据库。
 - [x] 喜马拉雅 (`.x2m` / `.x3m` / `.xm`)
 - [x] 咪咕音乐格式 (`.mg3d`)
 - [x] 蜻蜓 FM (`.qta`)
@@ -54,9 +55,36 @@
 
 遇到解密出错的情况，请一并携带错误信息（诊断信息）并简单描述错误的重现过程。
 
-待实现的算法支持可[追踪 `crypto` 标签](https://git.unlock-music.dev/um/um-react/issues?labels=67)。
+待实现的算法支持可[追踪 `crypto` 标签](https://git.um-react.app/um/um-react/issues?labels=67)。
 
-[project-issues]: https://git.unlock-music.dev/um/um-react/issues/new
+[project-issues]: https://git.um-react.app/um/um-react/issues/new
+
+## 使用 Docker 构建、部署 (Linux)
+
+首先克隆仓库并进入目录：
+
+```sh
+git clone https://git.um-react.app/um/um-react.git
+cd um-react
+```
+
+构建 Docker 镜像：
+
+```sh
+docker build \
+  -t um-react \
+  --build-arg GIT_COMMIT_FULL="$(git describe --long --dirty --tags --always)" \
+  --build-arg GIT_COMMIT="$(git rev-parse --short HEAD)" \
+  .
+```
+
+在后台运行 Docker 容器：
+
+```sh
+docker run -d -p 8080:80 --name um-react um-react
+```
+
+然后访问 `http://localhost:8080` 即可。
 
 ## 开发相关
 
@@ -87,13 +115,15 @@
 
 ## 相关项目
 
-- [Unlock Music (Web)](https://git.unlock-music.dev/um/web) - 原始项目
+- [Unlock Music (Web)](https://git.um-react.app/um/web) - 原始项目
-- [Unlock Music (Cli)](https://git.unlock-music.dev/um/cli) - 命令行批量处理版
+- [Unlock Music (Cli)](https://git.um-react.app/um/cli) - 命令行批量处理版
+- [lib_um_crypto_rust](https://git.um-react.app/um/lib_um_crypto_rust) - 项目引入的解密算法实现
+  - [NPM 包](https://git.um-react.app/um/-/packages/npm/@unlock-music%2Fcrypto)
 - [um-react (Electron 前端)](https://github.com/CarlGao4/um-react-electron) - 使用 Electron 框架封装的本地可执行文件。
-  - [GitHub 下载](https://github.com/CarlGao4/um-react-electron/releases/latest) | [仓库镜像](https://git.unlock-music.dev/CarlGao4/um-react-electron)
+  - [GitHub 下载](https://github.com/CarlGao4/um-react-electron/releases/latest)
-- [um-react-wry](https://git.unlock-music.dev/um/um-react-wry) - 使用 WRY 框架封装的 Win64 单文件 (
+- [um-react-wry](https://git.um-react.app/um/um-react-wry) - 使用 WRY 框架封装的 Win64 单文件 (
   需要[安装 Edge WebView2 运行时][webview2_redist]，Win10+ 操作系统自带)
-  - [本地下载](https://git.unlock-music.dev/um/um-react/releases/latest) | 寻找文件名为 `um-react-win64-` 开头的附件
+  - [本地下载](https://git.um-react.app/um/um-react/releases/latest) | 寻找文件名为 `um-react-win64-` 开头的附件
 
 [webview2_redist]: https://go.microsoft.com/fwlink/p/?LinkId=2124703
 

docs/develop-with-um_crypto.zh.md

@@ -16,7 +16,7 @@
 
 - 进入上层目录：`cd ..`
 - 克隆 `lib_um_crypto_rust` 仓库
-  - `git clone https://git.unlock-music.dev/um/lib_um_crypto_rust.git`
+  - `git clone https://git.um-react.app/um/lib_um_crypto_rust.git`
 - 进入 SDK 目录：`cd lib_um_crypto_rust ; cd um_wasm_loader`
 - 安装所有 Node 以来：`pnpm i`
 - 构建：`pnpm build`

docs/faq_zh-hans.md

@@ -69,7 +69,7 @@
 
 - WSA 可以参考 [MagiskOnWSALocal](https://github.com/LSPosed/MagiskOnWSALocal) 的说明操作。
 - 雷电模拟器可以在「模拟器设置」 → 「其他设置」中启用 root 特权。
-  ![雷电模拟器 其他设置](../src/faq/assets/ld_settings_misc.webp)
+  ![雷电模拟器 其他设置](../src/faq/assets/ld_settings_misc@2x.webp)
 
 ### Via 等浏览器无法正常解密/下载
 
@@ -87,10 +87,6 @@
 - 无法下载解密后内容
 - 下载的文件名错误
 
-### 新版解锁网站没有批量下载
-
-目前没有做。抱歉。
-
 ## 仍有问题？
 
 欢迎进入[Telegram 交流群](https://t.me/unlock_music_chat)，一起探讨。

eslint.config.mjs

@@ -0,0 +1,43 @@
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+import reactRefresh from 'eslint-plugin-react-refresh';
+import reactHooks from 'eslint-plugin-react-hooks';
+import eslintConfigPrettier from 'eslint-config-prettier/flat';
+import globals from 'globals';
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  tseslint.configs.recommended,
+  reactRefresh.configs.recommended,
+  reactHooks.configs['recommended-latest'],
+  eslintConfigPrettier,
+
+  {
+    rules: {
+      'react-refresh/only-export-components': 'warn',
+
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          varsIgnorePattern: '^_',
+          argsIgnorePattern: '^_',
+          destructuredArrayIgnorePattern: '^_',
+          ignoreRestSiblings: true,
+        },
+      ],
+    },
+  },
+
+  {
+    ignores: ['**/dist/', '**/node_modules/', '**/coverage/'],
+  },
+
+  {
+    files: ['scripts/*.mjs'],
+    languageOptions: {
+      globals: {
+        ...globals.node,
+      },
+    },
+  },
+);

index.html

@@ -1,8 +1,8 @@
-<!DOCTYPE html>
+<!doctype html>
 <html lang="zh-cmn-Hans-CN">
   <head>
     <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no" />
     <title>音乐解锁 - Unlock Music</title>
 
     <meta name="description" content="音乐解锁 - Unlock Music" />
@@ -10,6 +10,7 @@
     <link rel="apple-touch-icon" href="/pwa-512x512.png" sizes="512x512" />
     <meta name="theme-color" content="#4DBA87" />
   </head>
+
   <body>
     <main id="root"></main>
     <script type="module" src="/src/main.tsx"></script>

package.json

@@ -1,12 +1,12 @@
 {
   "name": "um-react",
   "private": true,
-  "version": "0.3.3",
+  "version": "0.5.2",
   "type": "module",
   "scripts": {
     "start": "vite",
     "build": "tsc -p tsconfig.prod.json && vite build && pnpm build:finalize",
-    "build:finalize": "node scripts/write-version.mjs && node scripts/minify-mjs.mjs",
+    "build:finalize": "node scripts/write-version.mjs",
     "lint": "eslint src --ext ts,tsx --report-unused-disable-directives --max-warnings 0",
     "format": "prettier -w .",
     "test": "vitest run",
@@ -17,58 +17,62 @@
     "prepare": "simple-git-hooks"
   },
   "dependencies": {
-    "@chakra-ui/anatomy": "^2.3.4",
+    "@reduxjs/toolkit": "^2.9.0",
-    "@chakra-ui/icons": "^2.2.4",
+    "@unlock-music/crypto": "^0.1.12",
-    "@chakra-ui/react": "^2.10.4",
+    "classnames": "^2.5.1",
-    "@emotion/react": "^11.14.0",
+    "nanoid": "^5.1.5",
-    "@emotion/styled": "^11.14.0",
+    "radash": "^12.1.1",
-    "@reduxjs/toolkit": "^2.5.0",
+    "react": "^19.1.1",
-    "@unlock-music/crypto": "0.1.2",
+    "react-dom": "^19.1.1",
-    "framer-motion": "^11.14.4",
+    "react-dropzone": "^14.3.8",
-    "nanoid": "^5.0.9",
+    "react-icons": "^5.5.0",
-    "radash": "^12.1.0",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
-    "react-dropzone": "^14.3.5",
-    "react-icons": "^5.4.0",
-    "react-promise-suspense": "^0.3.4",
     "react-redux": "^9.2.0",
-    "react-syntax-highlighter": "^15.6.1",
+    "react-router": "^7.8.2",
-    "sass": "^1.83.0",
+    "react-syntax-highlighter": "^15.6.6",
-    "sql.js": "^1.12.0"
+    "react-toastify": "^11.0.5",
+    "sql.js": "^1.13.0"
   },
   "devDependencies": {
-    "@rollup/plugin-replace": "^6.0.1",
+    "@eslint/js": "^9.35.0",
-    "@testing-library/jest-dom": "^6.6.3",
+    "@rollup/plugin-replace": "^6.0.2",
-    "@testing-library/react": "^16.1.0",
+    "@tailwindcss/vite": "^4.1.13",
-    "@testing-library/user-event": "^14.5.2",
+    "@testing-library/jest-dom": "^6.8.0",
-    "@types/node": "^22.10.2",
+    "@testing-library/react": "^16.3.0",
-    "@types/react": "^18.3.16",
+    "@testing-library/user-event": "^14.6.1",
-    "@types/react-dom": "^18.3.5",
+    "@types/node": "^24.3.1",
+    "@types/react": "^19.1.12",
+    "@types/react-dom": "^19.1.9",
     "@types/react-syntax-highlighter": "^15.5.13",
     "@types/sql.js": "^1.4.9",
-    "@typescript-eslint/eslint-plugin": "^8.18.0",
+    "@types/wicg-file-system-access": "^2023.10.6",
-    "@typescript-eslint/parser": "^8.18.0",
+    "@typescript-eslint/eslint-plugin": "^8.42.0",
-    "@vitejs/plugin-react": "^4.3.4",
+    "@typescript-eslint/parser": "^8.42.0",
-    "@vitest/coverage-v8": "^2.1.8",
+    "@vitejs/plugin-react": "^5.0.2",
-    "@vitest/ui": "^2.1.8",
+    "@vitest/coverage-v8": "^3.2.4",
-    "eslint": "^8.57.1",
+    "@vitest/ui": "^3.2.4",
-    "eslint-config-prettier": "^9.1.0",
+    "daisyui": "^5.1.8",
-    "eslint-plugin-react-hooks": "^4.6.2",
+    "eslint": "^9.35.0",
-    "eslint-plugin-react-refresh": "^0.4.16",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-react-hooks": "^5.2.0",
+    "eslint-plugin-react-refresh": "^0.4.20",
+    "globals": "^16.3.0",
     "husky": "^9.1.7",
-    "jsdom": "^25.0.1",
+    "jsdom": "^26.1.0",
-    "lint-staged": "^15.2.11",
+    "lint-staged": "^16.1.6",
-    "prettier": "^3.4.2",
+    "prettier": "^3.6.2",
-    "rollup": "^4.28.1",
+    "rollup": "^4.50.1",
-    "simple-git-hooks": "^2.11.1",
+    "sass": "^1.92.1",
-    "terser": "^5.37.0",
+    "simple-git-hooks": "^2.13.1",
-    "typescript": "^5.7.2",
+    "tailwindcss": "^4.1.13",
-    "vite": "^5.4.11",
+    "terser": "^5.44.0",
-    "vite-plugin-pwa": "^0.20.5",
+    "typescript": "^5.9.2",
-    "vite-plugin-top-level-await": "^1.4.4",
+    "typescript-eslint": "^8.42.0",
-    "vite-plugin-wasm": "^3.3.0",
+    "vite": "^7.1.5",
-    "vitest": "^2.1.8",
+    "vite-plugin-pwa": "^1.0.3",
+    "vite-plugin-top-level-await": "^1.6.0",
+    "vite-plugin-wasm": "^3.5.0",
+    "vitest": "^3.2.4",
+    "workbox-build": "^7.3.0",
     "workbox-window": "^7.3.0"
   },
   "lint-staged": {
@@ -86,13 +90,17 @@
   },
   "pnpm": {
     "patchedDependencies": {
-      "@rollup/plugin-terser": "patches/@rollup__plugin-terser.patch",
       "sql.js": "patches/sql.js.patch"
     },
     "overrides": {
-      "rollup-plugin-terser": "npm:@rollup/plugin-terser@0.4.3",
       "sourcemap-codec": "npm:@jridgewell/sourcemap-codec@1.4.15"
-    }
+    },
+    "onlyBuiltDependencies": [
+      "@swc/core",
+      "@tailwindcss/oxide",
+      "esbuild",
+      "simple-git-hooks"
+    ]
   },
-  "packageManager": "pnpm@9.12.1+sha512.e5a7e52a4183a02d5931057f7a0dbff9d5e9ce3161e33fa68ae392125b79282a8a8a470a51dfc8a0ed86221442eb2fb57019b0990ed24fab519bf0e1bc5ccfc4"
+  "packageManager": "pnpm@10.15.1"
 }

patches/sql.js.patch

@@ -1,11 +1,23 @@
 diff --git a/dist/sql-wasm.js b/dist/sql-wasm.js
-index b16cee5c3cbdf523f9beae920258094ae7fcbd0f..ae67be7145625c60995c5044860e87d6144a8837 100644
+index 6ef6c1f54a368431b22dea4da123f1341b4a1780..8dd8a53cefa7779f0556eb1038be35ad547beabb 100644
 --- a/dist/sql-wasm.js
 +++ b/dist/sql-wasm.js
-@@ -187,3 +187,6 @@ else if (typeof define === 'function' && define['amd']) {
+@@ -173,16 +173,5 @@ if(0<K)Sa=Yc;else{if(f.preRun)for("function"==typeof f.preRun&&(f.preRun=[f.preR
- else if (typeof exports === 'object'){
+   return initSqlJsPromise;
-     exports["Module"] = initSqlJs;
+ } // The end of our initSqlJs function
- }
+ 
-+
+-// This bit below is copied almost exactly from what you get when you use the MODULARIZE=1 flag with emcc
+-// However, we don't want to use the emcc modularization. See shell-pre.js
+-if (typeof exports === 'object' && typeof module === 'object'){
+-    module.exports = initSqlJs;
+-    // This will allow the module to be used in ES6 or CommonJS
+-    module.exports.default = initSqlJs;
+-}
+-else if (typeof define === 'function' && define['amd']) {
+-    define([], function() { return initSqlJs; });
+-}
+-else if (typeof exports === 'object'){
+-    exports["Module"] = initSqlJs;
+-}
 +var module;
 +export default initSqlJs;

public/_redirects

@@ -0,0 +1,2 @@
+# Support SPA routing in Netlify
+/* /index.html 200

scripts/make-win64.sh

@@ -4,7 +4,7 @@
 
 pushd "$(dirname "${BASH_SOURCE[0]}")/../"
 
-WRY_VER="0.1.1"
+WRY_VER="0.1.2"
 
 mkdir -p win64/{deps,dist}
 dl_file() {
@@ -26,8 +26,8 @@ ZIP_NAME="um-react-win64-${APP_VERSION}.zip"
     -r um-react.zip \
     -o "win64/dist/${EXE_NAME}"
 
-touch -d 1970-01-01T00:00:00Z "win64/dist/${EXE_NAME}"
+touch -d 1980-01-01T00:00:00Z "win64/dist/${EXE_NAME}"
-zip -9oX "win64/dist/${ZIP_NAME}" -- "win64/dist/${EXE_NAME}"
+zip -9oXj "win64/dist/${ZIP_NAME}" -- "win64/dist/${EXE_NAME}"
 echo "[Build OK] 'win64/dist/${ZIP_NAME}'."
 
 popd

scripts/write-version.mjs

@@ -7,8 +7,13 @@ import { execSync } from 'node:child_process';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
-const commitHash = execSync('git rev-parse --short HEAD').toString('utf-8').trim();
+let commitHash = process.env.GIT_COMMIT || 'unknown';
+try {
+  commitHash = execSync('git rev-parse --short HEAD').toString('utf-8').trim();
+} catch (e) {
+  console.error('Failed to get commit hash:', e);
+}
 
 const pkgJson = JSON.parse(readFileSync(__dirname + '/../package.json', 'utf-8'));
-const pkgVer = `${pkgJson.version ?? 'unknown'}-${commitHash ?? 'unknown'}` + '\n';
+const pkgVer = `${pkgJson.version ?? 'unknown'}-${commitHash}` + '\n';
 writeFileSync(__dirname + '/../dist/version.txt', pkgVer, 'utf-8');

src/App.css

@@ -0,0 +1,76 @@
+@import 'tailwindcss';
+
+@plugin "daisyui" {
+  themes: dracula --prefersdark;
+}
+
+/* theme: https://daisyui.com/theme-generator/#theme=eJx1kuFupCAUhV-FmGyym1TCBQHt2zB67Zg6MAFNu2323ZdhGkdH_Annu9dzjnwX1lyweC1OZjS2xa54KcrSm26YQxlwxHZyPsqMSo-XtdgPOHZZ5eQ-t_dh-MLtMr7VHrsewsn5Dm80XD_TRYfX6Xw7p5N1Q8CfU-tG58vQnjFFGYe385Sgu3AyAUtgLErufWzPv5v6F2GE_Xlm-JpRkaGMAeG1okLLHS3WNL_TinBVUSlgR7fOTminZYKznQeL8-TNuCBCHyG7bZlEg-3dolfJHzRN9CepEvWaDHPbYggLLO-wrAjIGEo1a_jDeDvYtwVWqSfQDZE1FbBZjN6n__2z9haH8koSrqng8tnsPlQaYFARLiuqWJUxfTTEgYBSFEBkzOfri0OcNJJyrXchDr0JAjHMJvXVDxfj_z4aYqkhqAnUFdVPMTBu7jI4j0-JA9V8E8DE0CsXElKl0Tco2giZsXGUNbYKNYv7s24Op-IDYozWOuNqPyPSjOC3jjSkVjvszTxGZvIzvhRXjz36ED_5Xrz2Zgz47z_whE0z */
+@plugin "daisyui/theme" {
+  name: 'balanced';
+  default: true;
+  prefersdark: false;
+  color-scheme: 'light';
+  --color-base-100: oklch(98% 0 0);
+  --color-base-200: oklch(96% 0.001 286.375);
+  --color-base-300: oklch(92% 0.006 264.531);
+  --color-base-content: oklch(20% 0 0);
+  --color-primary: oklch(60% 0.118 184.704);
+  --color-primary-content: oklch(98% 0.014 180.72);
+  --color-secondary: oklch(60% 0.126 221.723);
+  --color-secondary-content: oklch(98% 0.019 200.873);
+  --color-accent: oklch(51% 0.222 16.935);
+  --color-accent-content: oklch(93% 0.032 17.717);
+  --color-neutral: oklch(37% 0 0);
+  --color-neutral-content: oklch(98% 0 0);
+  --color-info: oklch(42% 0.199 265.638);
+  --color-info-content: oklch(97% 0.014 254.604);
+  --color-success: oklch(52% 0.154 150.069);
+  --color-success-content: oklch(97% 0.021 166.113);
+  --color-warning: oklch(66% 0.179 58.318);
+  --color-warning-content: oklch(98% 0.022 95.277);
+  --color-error: oklch(57% 0.245 27.325);
+  --color-error-content: oklch(97% 0.013 17.38);
+  --radius-selector: 0.5rem;
+  --radius-field: 0.5rem;
+  --radius-box: 0.5rem;
+  --size-selector: 0.25rem;
+  --size-field: 0.25rem;
+  --border: 1px;
+  --depth: 1;
+  --noise: 1;
+}
+@theme {
+  --font-display:
+    system-ui, Sarasa UI SC, Source Han Sans CN, Noto Sans CJK SC, sans-serif, Apple Color Emoji, Segoe UI Emoji;
+  --font-mono:
+    ui-monospace, Consolas, Sarasa Mono CJK SC, Sarasa UI SC, Source Han Sans CN, Noto Sans CJK SC, Microsoft YaHei UI,
+    monospace, Apple Color Emoji, Segoe UI Emoji;
+}
+
+#root {
+  display: flex;
+  flex-direction: column;
+  height: 100vh;
+  display: flex;
+  flex-direction: column;
+}
+
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+  &:hover > a[data-anchor] {
+    opacity: 0.75;
+  }
+}
+
+#downloadAll {
+  position: absolute;
+  right: 0.5em;
+  bottom: 72px;
+  width: 48px;
+  height: 48px;
+  margin: 10px;
+}

src/__tests__/sanity-check.test.tsx

@@ -16,6 +16,7 @@ test('should be able to render App', async () => {
   await waitFor(() => screen.getByTestId('sdk-version'));
 
   // Quick sanity check of known strings.
-  expect(screen.getByText(/在浏览器内对文件进行解锁/i)).toBeInTheDocument();
+  expect(screen.getByText(/音乐解锁/i)).toBeInTheDocument();
-  expect(screen.getByText(/UnlockMusic 团队/i)).toBeInTheDocument();
+  expect(screen.getByText(/Unlock Music/i)).toBeInTheDocument();
+  expect(screen.getByText(/MIT/i)).toBeInTheDocument();
 });

src/components/AddKey.tsx

@@ -0,0 +1,49 @@
+import type { RefObject } from 'react';
+import { MdAdd, MdDeleteForever, MdFileUpload } from 'react-icons/md';
+
+export interface AddKeyProps {
+  addKey: () => void;
+  importKeyFromFile?: () => void;
+  clearKeys?: () => void;
+  refContainer?: RefObject<HTMLElement | null>;
+}
+
+export function AddKey({ addKey, refContainer, importKeyFromFile, clearKeys }: AddKeyProps) {
+  const scrollToLastKey = () => {
+    const container = refContainer?.current;
+    if (container) {
+      const inputs = container.querySelectorAll('input[data-name="key-input--name"]');
+      const lastInput = inputs[inputs.length - 1] as HTMLInputElement | null;
+      if (lastInput) {
+        lastInput.focus({ preventScroll: true });
+        lastInput.scrollIntoView({
+          behavior: 'smooth',
+          block: 'center',
+        });
+      }
+    }
+  };
+
+  const handleAddKey = () => {
+    addKey();
+    setTimeout(scrollToLastKey);
+  };
+
+  return (
+    <div className="flex flex-row justify-between items-center">
+      <div className="join">
+        <button type="button" className="join-item btn flex items-center gap-2" onClick={handleAddKey}>
+          <MdAdd className="text-lg" /> 添加一条
+        </button>
+        <button type="button" className="join-item btn flex items-center gap-2" onClick={importKeyFromFile}>
+          <MdFileUpload className="text-lg" />
+          导入数据库…
+        </button>
+        <button type="button" className="join-item btn flex items-center gap-2 btn-error" onClick={clearKeys}>
+          <MdDeleteForever className="text-lg" />
+          清空密钥
+        </button>
+      </div>
+    </div>
+  );
+}

src/components/AndroidADBPullInstruction/AdbInstructionTemplate.tsx

@@ -0,0 +1,59 @@
+import { CodeHighlight } from '../CodeHighlight';
+import { ExtLink } from '../ExtLink';
+import PowerShellAdbDumpCommandTemplate from './adb_dump.ps1?raw';
+import ShellAdbDumpCommandTemplate from './adb_dump.sh?raw';
+import { applyTemplate } from '~/util/applyTemplate';
+
+export interface AdbInstructionTemplateProps {
+  dir: string;
+  file: string;
+  platform: 'win32' | 'linux';
+}
+
+const URL_USB_DEBUGGING = 'https://developer.android.com/studio/debug/dev-options?hl=zh-cn#Enable-debugging';
+
+const LANGUAGE_MAP = {
+  win32: { language: 'ps1', template: PowerShellAdbDumpCommandTemplate },
+  linux: { language: 'sh', template: ShellAdbDumpCommandTemplate },
+};
+
+export function AdbInstructionTemplate({ dir, file, platform }: AdbInstructionTemplateProps) {
+  const { language, template } = LANGUAGE_MAP[platform];
+  const command = applyTemplate(template, { dir, file });
+
+  return (
+    <ol className="list-decimal pl-4">
+      <li>
+        <p>
+          确保 <code>adb</code> 命令可用。
+        </p>
+
+        {platform === 'win32' && (
+          <div>
+            <span>
+              💡 如果没有，可以
+              <ExtLink href="https://scoop.sh/#/apps?q=adb">使用 Scoop 安装</ExtLink>。
+            </span>
+          </div>
+        )}
+      </li>
+      <li>启动终端，进入 PowerShell 环境。</li>
+      <li>
+        在手机<ExtLink href={URL_USB_DEBUGGING}>启用 USB 调试</ExtLink>
+      </li>
+      <li>将安卓设备连接到电脑。</li>
+      <li>
+        <p>粘贴执行下述代码执行。若设备提示「是否允许 USB 调试」或「超级用户请求」，选择允许：</p>
+        <CodeHighlight language={language}>{command}</CodeHighlight>
+        <br />※ 安卓模拟器可能需要额外操作，如
+        <ExtLink className="text-nowrap" href="https://g.126.fm/04jewvw">
+          网易 MuMu 模拟器
+        </ExtLink>
+        需要提前使用 <code>adb connect ...</code> 指令连接模拟器。详细请参考官方说明文档并调整上述脚本。
+      </li>
+      <li>
+        提交当前目录下的 <code>{file}</code> 文件。
+      </li>
+    </ol>
+  );
+}

src/components/AndroidADBPullInstruction/AndroidADBPullInstruction.tsx

@@ -1,171 +1,73 @@
-import {
-  Accordion,
-  AccordionButton,
-  AccordionIcon,
-  AccordionItem,
-  AccordionPanel,
-  Box,
-  Code,
-  Heading,
-  ListItem,
-  OrderedList,
-  Text,
-  chakra,
-} from '@chakra-ui/react';
-import { ExternalLinkIcon } from '@chakra-ui/icons';
-import { Light as SyntaxHighlighter } from 'react-syntax-highlighter';
-import hljsStyleGitHub from 'react-syntax-highlighter/dist/esm/styles/hljs/github';
-
-import PowerShellAdbDumpCommandTemplate from './adb_dump.ps1?raw';
-import ShellAdbDumpCommandTemplate from './adb_dump.sh?raw';
 import { ExtLink } from '../ExtLink';
-
+import { Ruby } from '../Ruby';
-const applyTemplate = (tpl: string, values: Record<string, unknown>) => {
+import { useId } from 'react';
-  return tpl.replace(/\{\{\s*(\w+)\s*\}\}/g, (_, key) => (Object.hasOwn(values, key) ? String(values[key]) : '<nil>'));
+import { RootExplorerGuide } from './RootExplorerGuide';
-};
+import { AdbInstructionTemplate } from './AdbInstructionTemplate';
+import { HiWord } from '../HelpText/HiWord';
 
 export interface AndroidADBPullInstructionProps {
   dir: string;
   file: string;
 }
 
+const URL_AMAZE = 'https://github.com/TeamAmaze/AmazeFileManager/releases/latest';
+const URL_MT2 = 'https://mt2.cn/download/';
+
 export function AndroidADBPullInstruction({ dir, file }: AndroidADBPullInstructionProps) {
-  const psAdbDumpCommand = applyTemplate(PowerShellAdbDumpCommandTemplate, { dir, file });
+  const androidInstructionId = useId();
-  const shAdbDumpCommand = applyTemplate(ShellAdbDumpCommandTemplate, { dir, file });
 
   return (
     <>
-      <Text>
+      <p>
-        你需要
+        你需要<Ruby caption="root">超级管理员</Ruby>访问权限来访问安卓应用的私有数据。
-        <ruby>
+      </p>
-          超级管理员
+      <p>
-          <rp> (</rp>
-          <rt>
-            <code>root</code>
-          </rt>
-          <rp>)</rp>
-        </ruby>
-        访问权限来访问安卓应用的私有数据。
-      </Text>
-      <Text>
         ⚠️ 请注意，获取管理员权限通常意味着你的安卓设备
-        <chakra.span color="red.400">将失去保修资格</chakra.span>。
+        <HiWord>将失去保修资格</HiWord>。
-      </Text>
+      </p>
 
-      <Accordion allowToggle mt="2">
+      <div className="join join-vertical bg-base-100 mt-2 max-w-full">
-        <AccordionItem>
+        <div className="collapse collapse-arrow join-item border-base-300 border">
-          <Heading as="h3" size="md">
+          <input type="radio" name={androidInstructionId} />
-            <AccordionButton>
+          <div className="collapse-title font-semibold">在安卓手机端操作</div>
-              <Box as="span" flex="1" textAlign="left">
+          <div className="collapse-content text-sm min-w-0">
-                在安卓手机端操作
+            <ol className="list-decimal pl-4">
-              </Box>
+              <li>
-              <AccordionIcon />
+                启动支持 <code>root</code> 特权的文件浏览器，如 <ExtLink href={URL_AMAZE}>Amaze 文件浏览器</ExtLink>、
-            </AccordionButton>
+                <ExtLink href={URL_MT2}>MT 管理器</ExtLink> 等。
-          </Heading>
+              </li>
-          <AccordionPanel pb={4}>
+              <li>
-            <OrderedList>
+                ※ 记得启用 root 特权！
-              <ListItem>
+                <RootExplorerGuide />
-                <Text>
+              </li>
-                  启动具有 <Code>root</Code> 特权的文件浏览器
+              <li>
-                </Text>
+                <p>
-              </ListItem>
+                  访问 <code>{dir}/</code> 目录。
-              <ListItem>
+                </p>
-                <Text>
+                <p>※ 从侧边栏选择根目录开始。</p>
-                  访问 <Code>{dir}/</Code> 目录。
+              </li>
-                </Text>
+              <li>
-              </ListItem>
+                将文件 <code>{file}</code> 复制到浏览器可访问的目录（例如下载目录）。
-              <ListItem>
+              </li>
-                <Text>
+              <li>提交该数据库文件。</li>
-                  将文件 <Code>{file}</Code> 复制到浏览器可访问的目录。
+            </ol>
-                  <br />
+          </div>
-                  （例如下载目录）
+        </div>
-                </Text>
+        <div className="collapse collapse-arrow join-item border-base-300 border">
-              </ListItem>
+          <input type="radio" name={androidInstructionId} />
-              <ListItem>
+          <div className="collapse-title font-semibold">在 PC 端操作（使用 ADB / PowerShell）</div>
-                <Text>提交该数据库文件。</Text>
+          <div className="collapse-content text-sm min-w-0">
-              </ListItem>
+            <AdbInstructionTemplate dir={dir} file={file} platform="win32" />
-            </OrderedList>
+          </div>
-          </AccordionPanel>
+        </div>
-        </AccordionItem>
+        <div className="collapse collapse-arrow join-item border-base-300 border">
-
+          <input type="radio" name={androidInstructionId} />
-        <AccordionItem>
+          <div className="collapse-title font-semibold">在 Linux / Mac 系统下操作（使用 ADB / Shell）</div>
-          <Heading as="h3" size="md">
+          <div className="collapse-content text-sm min-w-0">
-            <AccordionButton>
+            <AdbInstructionTemplate dir={dir} file={file} platform="linux" />
-              <Box as="span" flex="1" textAlign="left">
+          </div>
-                在 PC 端操作（ADB / PowerShell）
+        </div>
-              </Box>
+      </div>
-              <AccordionIcon />
-            </AccordionButton>
-          </Heading>
-          <AccordionPanel pb={4}>
-            <OrderedList>
-              <ListItem>
-                <Text>
-                  确保 <Code>adb</Code> 命令可用。
-                </Text>
-                <Text>
-                  💡 如果没有，可以
-                  <ExtLink href="https://scoop.sh/#/apps?q=adb">
-                    使用 Scoop 安装 <ExternalLinkIcon />
-                  </ExtLink>
-                  。
-                </Text>
-              </ListItem>
-              <ListItem>
-                <Text>启动终端并进入 PowerShell 7 环境。</Text>
-              </ListItem>
-              <ListItem>
-                <Text>将安卓设备连接到电脑，并允许调试。</Text>
-              </ListItem>
-              <ListItem>
-                <Text>粘贴执行下述代码。若设备提示「超级用户请求」请允许：</Text>
-                <SyntaxHighlighter language="ps1" style={hljsStyleGitHub}>
-                  {psAdbDumpCommand}
-                </SyntaxHighlighter>
-              </ListItem>
-              <ListItem>
-                <Text>
-                  提交当前目录下的 <Code>{file}</Code> 文件。
-                </Text>
-              </ListItem>
-            </OrderedList>
-          </AccordionPanel>
-        </AccordionItem>
-
-        <AccordionItem>
-          <Heading as="h3" size="md">
-            <AccordionButton>
-              <Box as="span" flex="1" textAlign="left">
-                在 Linux / Mac 系统下操作（ADB / Shell）
-              </Box>
-              <AccordionIcon />
-            </AccordionButton>
-          </Heading>
-          <AccordionPanel pb={4}>
-            <OrderedList>
-              <ListItem>
-                <Text>
-                  确保 <Code>adb</Code> 命令可用。
-                </Text>
-              </ListItem>
-              <ListItem>
-                <Text>将安卓设备连接到电脑，并允许调试。</Text>
-              </ListItem>
-              <ListItem>
-                <Text>粘贴执行下述代码。若设备提示「超级用户请求」请允许：</Text>
-                <SyntaxHighlighter language="bash" style={hljsStyleGitHub}>
-                  {shAdbDumpCommand}
-                </SyntaxHighlighter>
-              </ListItem>
-              <ListItem>
-                <Text>
-                  提交当前目录下的 <Code>{file}</Code> 文件。
-                </Text>
-              </ListItem>
-            </OrderedList>
-          </AccordionPanel>
-        </AccordionItem>
-      </Accordion>
     </>
   );
 }

src/components/AndroidADBPullInstruction/RootExplorerGuide.tsx

@@ -0,0 +1,64 @@
+import { FiMenu, FiMoreVertical } from 'react-icons/fi';
+import { Header5 } from '../HelpText/Headers';
+import { Ruby } from '../Ruby';
+import { VQuote } from '../HelpText/VQuote';
+
+export function RootExplorerGuide() {
+  return (
+    <div className="@container inline-flex flex-col items-start w-full pl-4">
+      <div className="flex flex-col items-start gap-4 @md:flex-row">
+        <div>
+          <Header5 className="[&]:mt-0 [&]:pt-0">Amaze 文件浏览器</Header5>
+          <ul className="ml-2 list-disc list-inside">
+            <li>
+              <div className="inline-flex items-center gap-1">
+                点触主界面左上角的 <FiMenu /> 打开侧边栏
+              </div>
+            </li>
+            <li>
+              滑动到最底端，点触
+              <VQuote>
+                <Ruby caption="Settings">设置</Ruby>
+              </VQuote>
+            </li>
+            <li>
+              点触
+              <VQuote>
+                <Ruby caption="Behaviour">行为</Ruby>
+              </VQuote>
+            </li>
+            <li>
+              找到
+              <VQuote>
+                <Ruby caption="Advanced">高级</Ruby>
+              </VQuote>
+              ，勾选
+              <VQuote>
+                <Ruby caption="Root Explorer">根目录浏览器</Ruby>
+              </VQuote>
+            </li>
+          </ul>
+        </div>
+        <div>
+          <Header5 className="[&]:mt-0 [&]:pt-0">MT 管理器</Header5>
+          <ul className="ml-2 list-disc list-inside">
+            <li>
+              <div className="inline-flex items-center gap-1">
+                点触主界面左上角的 <FiMenu /> 打开侧边栏
+              </div>
+            </li>
+            <li>
+              <div className="inline-flex items-center">
+                点触侧边栏右上方的 <FiMoreVertical className="ml-1" />
+                ，点触<VQuote>设置</VQuote>
+              </div>
+            </li>
+            <li>
+              勾选<VQuote>请求 Root 权限</VQuote>
+            </li>
+          </ul>
+        </div>
+      </div>
+    </div>
+  );
+}

src/components/AppRoot.tsx

@@ -1,57 +1,78 @@
 import { useEffect } from 'react';
+import { BrowserRouter, NavLink, Route, Routes } from 'react-router';
 import { MdSettings, MdHome, MdQuestionAnswer } from 'react-icons/md';
-import { ChakraProvider, Tabs, TabList, TabPanels, Tab, TabPanel, Icon, chakra } from '@chakra-ui/react';
 
 import { MainTab } from '~/tabs/MainTab';
 import { SettingsTab } from '~/tabs/SettingsTab';
 
 import { Provider } from 'react-redux';
-import { theme } from '~/theme';
 import { persistSettings } from '~/features/settings/persistSettings';
 import { setupStore } from '~/store';
 import { Footer } from '~/components/Footer';
 import { FaqTab } from '~/tabs/FaqTab';
+import { SETTINGS_TABS } from '~/features/settings/settingsTabs';
+import { Bounce, ToastContainer } from 'react-toastify';
+import { SettingsHome } from '~/features/settings/SettingsHome';
+import { FAQ_PAGES } from '~/faq/FAQPages';
+import { FaqHome } from '~/faq/FaqHome';
 
 // Private to this file only.
 const store = setupStore();
 
+const tabClassNames = ({ isActive }: { isActive: boolean }) => `mb-[-2px] tab ${isActive ? 'tab-active' : ''}`;
+
 export function AppRoot() {
   useEffect(() => persistSettings(store), []);
 
   return (
-    <ChakraProvider theme={theme}>
+    <BrowserRouter>
       <Provider store={store}>
-        <Tabs flex={1} minH={0} display="flex" flexDir="column">
+        <div role="tablist" className="tabs tabs-border w-full justify-center border-b-2 border-base-200 box-content">
-          <TabList justifyContent="center">
+          <NavLink to="/" role="tab" className={tabClassNames}>
-            <Tab>
+            <MdHome />
-              <Icon as={MdHome} mr="1" />
+            应用
-              <chakra.span>应用</chakra.span>
+          </NavLink>
-            </Tab>
+          <NavLink to="/settings" role="tab" className={tabClassNames}>
-            <Tab>
+            <MdSettings />
-              <Icon as={MdSettings} mr="1" />
+            设置
-              <chakra.span>设置</chakra.span>
+          </NavLink>
-            </Tab>
+          <NavLink to="/questions" role="tab" className={tabClassNames}>
-            <Tab>
+            <MdQuestionAnswer />
-              <Icon as={MdQuestionAnswer} mr="1" />
+            答疑
-              <chakra.span>答疑</chakra.span>
+          </NavLink>
-            </Tab>
+        </div>
-          </TabList>
 
-          <TabPanels overflow="auto" minW={0} flexDir="column" flex={1} display="flex">
+        <main className="flex-1 flex justify-center min-h-0 overflow-auto">
-            <TabPanel>
+          <Routes>
-              <MainTab />
+            <Route path="/" Component={MainTab} />
-            </TabPanel>
+            <Route path="/settings" Component={SettingsTab}>
-            <TabPanel flex={1} display="flex">
+              <Route index Component={SettingsHome} />
-              <SettingsTab />
+              {Object.entries(SETTINGS_TABS).map(([key, { Tab }]) => (
-            </TabPanel>
+                <Route key={key} path={key} Component={Tab} />
-            <TabPanel>
+              ))}
-              <FaqTab />
+            </Route>
-            </TabPanel>
+            <Route path="/questions" Component={FaqTab}>
-          </TabPanels>
+              <Route index Component={FaqHome} />
-        </Tabs>
+              {FAQ_PAGES.map(({ id, Component }) => (
+                <Route key={id} path={id} Component={Component} />
+              ))}
+            </Route>
+          </Routes>
+        </main>
+
+        <ToastContainer
+          position="bottom-center"
+          autoClose={5000}
+          newestOnTop
+          closeOnClick={false}
+          pauseOnFocusLoss
+          draggable
+          theme="colored"
+          transition={Bounce}
+        />
 
         <Footer />
       </Provider>
-    </ChakraProvider>
+    </BrowserRouter>
   );
 }

src/components/CodeHighlight.tsx

@@ -0,0 +1,10 @@
+import { Light as SyntaxHighlighter, type SyntaxHighlighterProps } from 'react-syntax-highlighter';
+import hljsStyleGitHub from 'react-syntax-highlighter/dist/esm/styles/hljs/github';
+
+export function CodeHighlight({ children, ...props }: SyntaxHighlighterProps) {
+  return (
+    <SyntaxHighlighter style={hljsStyleGitHub} {...props}>
+      {children}
+    </SyntaxHighlighter>
+  );
+}

src/components/Dialog.tsx

@@ -0,0 +1,40 @@
+import { useEffect, useRef } from 'react';
+
+export interface DialogProps {
+  closeButton?: boolean;
+  backdropClose?: boolean;
+  title?: React.ReactNode;
+  children: React.ReactNode;
+  show: boolean;
+  onClose: () => void;
+}
+
+export function Dialog({ closeButton, backdropClose, title, children, show, onClose }: DialogProps) {
+  const refModel = useRef<HTMLDialogElement>(null);
+  useEffect(() => {
+    if (show) {
+      refModel.current?.showModal();
+    } else {
+      refModel.current?.close();
+    }
+  }, [show]);
+
+  return (
+    <dialog ref={refModel} className="modal">
+      <div className="modal-box">
+        {closeButton && (
+          <form method="dialog" onSubmit={onClose}>
+            <button className="btn btn-sm btn-circle btn-ghost absolute right-2 top-2">✕</button>
+          </form>
+        )}
+        <h3 className="font-bold text-lg pb-3">{title}</h3>
+        {children}
+      </div>
+      {backdropClose && (
+        <form method="dialog" className="modal-backdrop" onSubmit={onClose}>
+          <button>close</button>
+        </form>
+      )}
+    </dialog>
+  );
+}

src/components/DownloadAll.tsx

@@ -0,0 +1,84 @@
+import { DecryptedAudioFile, ProcessState, selectFiles } from '~/features/file-listing/fileListingSlice';
+import { FaDownload } from 'react-icons/fa';
+import { useAppSelector } from '~/hooks';
+import { toast } from 'react-toastify';
+
+export function DownloadAll() {
+  const files = useAppSelector(selectFiles);
+  const onClickDownloadAll = async () => {
+    console.time('DownloadAll'); //开始计时
+    const fileCount = Object.keys(files).length;
+    if (fileCount === 0) {
+      toast.warning('未添加文件');
+      return;
+    }
+
+    //判断所有文件是否处理完成
+    const allComplete = Object.values(files).every((file) => file.state !== ProcessState.PROCESSING);
+    if (!allComplete) {
+      toast.warning('请等待所有文件解密完成');
+      return;
+    }
+
+    //过滤处理失败的文件
+    const completeFiles = Object.values(files).filter((file) => file.state === ProcessState.COMPLETE);
+
+    //开始下载
+    let dir: FileSystemDirectoryHandle | undefined;
+    try {
+      dir = await window.showDirectoryPicker({ mode: 'readwrite' });
+    } catch (e) {
+      console.error(e);
+      if (e instanceof Error && e.name === 'AbortError') {
+        return;
+      }
+    }
+    toast.warning('开始下载，请稍候');
+
+    const promises = Object.values(completeFiles).map(async (file) => {
+      console.log(`开始下载: ${file.fileName}`);
+      try {
+        if (dir) {
+          await DownloadNew(dir, file);
+        } else {
+          await DownloadOld(file);
+        }
+        console.log(`成功下载: ${file.fileName}`);
+      } catch (e) {
+        console.error(`下载失败: ${file.fileName}`, e);
+        toast.error(`出现错误: ${e}`);
+        throw e;
+      }
+    });
+    await Promise.allSettled(promises).then((f) => {
+      const success = f.filter((result) => result.status === 'fulfilled').length;
+      if (success === fileCount) {
+        toast.success(`成功下载: ${success}/${fileCount}首`);
+      } else {
+        toast.warning(`成功下载: ${success}/${fileCount}首`);
+      }
+    });
+    console.timeEnd('DownloadAll'); //停止计时
+  };
+
+  return (
+    <button className="btn btn-primary" id="downloadAll" onClick={onClickDownloadAll} title="下载全部">
+      <FaDownload />
+    </button>
+  );
+}
+
+async function DownloadNew(dir: FileSystemDirectoryHandle, file: DecryptedAudioFile) {
+  const fileHandle = await dir.getFileHandle(file.cleanName + '.' + file.ext, { create: true });
+  const writable = await fileHandle.createWritable();
+  await fetch(file.decrypted).then((res) => res.body?.pipeTo(writable));
+}
+
+async function DownloadOld(file: DecryptedAudioFile) {
+  const a = document.createElement('a');
+  a.href = file.decrypted;
+  a.download = file.cleanName + '.' + file.ext;
+  document.body.append(a);
+  a.click();
+  a.remove();
+}

src/components/ExtLink.tsx

@@ -1,12 +1,15 @@
 import type { AnchorHTMLAttributes } from 'react';
-import { ExternalLinkIcon } from '@chakra-ui/icons';
+import { FiExternalLink } from 'react-icons/fi';
-import { Link } from '@chakra-ui/react';
 
-export function ExtLink({ children, ...props }: AnchorHTMLAttributes<HTMLAnchorElement>) {
+export type ExtLinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {
+  icon?: boolean;
+};
+
+export function ExtLink({ className, icon = true, children, ...props }: ExtLinkProps) {
   return (
-    <Link isExternal {...props} rel="noreferrer noopener nofollow">
+    <a rel="noreferrer noopener nofollow" target="_blank" className={`link ${className}`} {...props}>
       {children}
-      <ExternalLinkIcon />
+      {icon && <FiExternalLink className="inline size-sm ml-1" />}
-    </Link>
+    </a>
   );
 }

src/components/FileInput.tsx

@@ -1,5 +1,5 @@
+import classnames from 'classnames';
 import { useDropzone } from 'react-dropzone';
-import { Box } from '@chakra-ui/react';
 
 export interface FileInputProps {
   onReceiveFiles: (files: File[]) => void;
@@ -14,30 +14,19 @@ export function FileInput({ children, onReceiveFiles }: FileInputProps) {
   });
 
   return (
-    <Box
+    <div
       {...getRootProps()}
-      w="100%"
+      className={classnames(
-      maxW={480}
+        'w-full max-w-xl border rounded-lg transition duration-500 p-6 border-base-300 mx-auto',
-      borderWidth="1px"
+        'cursor-pointer flex flex-col items-center bg-base-200 hover:border-gray-400 hover:bg-gray-50 hover:dark:bg-gray-800',
-      borderRadius="lg"
+        {
-      transitionDuration="0.5s"
+          'bg-blue-50 dark:bg-blue-900 border-blue-700': isDragActive,
-      p="6"
+        },
-      cursor="pointer"
+      )}
-      display="flex"
+      tabIndex={0}
-      flexDir="column"
-      alignItems="center"
-      _hover={{
-        borderColor: 'gray.400',
-        bg: 'gray.50',
-      }}
-      {...(isDragActive && {
-        bg: 'blue.50',
-        borderColor: 'blue.700',
-      })}
     >
       <input {...getInputProps()} />
-
       {children}
-    </Box>
+    </div>
   );
 }

src/components/FilePathBlock.tsx

@@ -1,10 +1,9 @@
-import { Code, Text } from '@chakra-ui/react';
+import type { ReactNode } from 'react';
-import React from 'react';
 
-export function FilePathBlock({ children }: { children: React.ReactNode }) {
+export function FilePathBlock({ children }: { children: ReactNode }) {
   return (
-    <Text as="pre" whiteSpace="pre-wrap" wordBreak="break-all">
+    <pre className="whitespace-pre-wrap break-all">
-      <Code>{children}</Code>
+      <code>{children}</code>
-    </Text>
+    </pre>
   );
 }

src/components/Footer.tsx

@@ -1,45 +1,32 @@
-import { Center, Flex, Link, Text } from '@chakra-ui/react';
-import { Suspense } from 'react';
 import { SDKVersion } from './SDKVersion';
 import { CurrentYear } from './CurrentYear';
 
 export function Footer() {
+  const appVersionShort = '__APP_VERSION_SHORT__';
   return (
-    <Center
+    <footer className="flex flex-col text-center p-4 bg-base-200">
-      fontSize="sm"
+      <p className="flex flex-row justify-center items-center h-[1em]">
-      textAlign="center"
+        <a className="link link-info mr-1" href="https://git.um-react.app/um/um-react">
-      bottom="0"
-      w="full"
-      pt="3"
-      pb="3"
-      borderTop="1px solid"
-      borderColor="gray.300"
-      bg="gray.100"
-      color="gray.800"
-      flexDir="column"
-      flexShrink={0}
-    >
-      <Flex as={Text}>
-        <Link href="https://git.unlock-music.dev/um/um-react" isExternal>
           音乐解锁
-        </Link>
+        </a>
-        {' (__APP_VERSION_SHORT__'}
+        (
-        <Suspense>
+        <a
-          <SDKVersion />
+          title="使用 MIT 授权协议"
-        </Suspense>
+          className="link link-info"
-        {') - 移除已购音乐的加密保护。'}
+          href="https://git.um-react.app/um/um-react/src/branch/main/LICENSE"
-      </Flex>
+        >
-      <Text>
+          MIT
+        </a>
+        , v{appVersionShort}
+        <SDKVersion />)
+      </p>
+      <p>
         {'© 2019 - '}
-        <CurrentYear />{' '}
+        <CurrentYear />
-        <Link href="https://git.unlock-music.dev/um" isExternal>
+        <a className="ml-1 link link-info" href="https://git.um-react.app/um">
-          UnlockMusic 团队
+          Unlock Music
-        </Link>
+        </a>
-        {' | '}
+      </p>
-        <Link href="https://git.unlock-music.dev/um/um-react/src/branch/main/LICENSE" isExternal>
+    </footer>
-          使用 MIT 授权协议
-        </Link>
-      </Text>
-    </Center>
   );
 }

src/components/HelpText/HeaderAnchor.tsx

@@ -0,0 +1,9 @@
+import { RiLink } from 'react-icons/ri';
+
+export function HeaderAnchor({ id }: { id: string }) {
+  return (
+    <a href={`#${id}`} data-anchor={id} className="absolute -left-6 opacity-10 transition-opacity duration-200">
+      <RiLink className="max-h-[.75em]" />
+    </a>
+  );
+}

src/components/HelpText/Headers.tsx

@@ -1,5 +1,5 @@
-import { Heading } from '@chakra-ui/react';
 import React from 'react';
+import { HeaderAnchor } from './HeaderAnchor';
 
 export interface HeaderProps {
   children: React.ReactNode;
@@ -7,36 +7,39 @@ export interface HeaderProps {
   className?: string;
 }
 
+const commonHeaderClasses = 'relative flex items-center pt-3 pb-1 font-bold';
+
+export function Header2({ children, className, id }: HeaderProps) {
+  return (
+    <h2 id={id} className={`${commonHeaderClasses} text-3xl border-b border-base-300 ${className}`}>
+      {id && <HeaderAnchor id={id} />}
+      {children}
+    </h2>
+  );
+}
 export function Header3({ children, className, id }: HeaderProps) {
   return (
-    <Heading
+    <h3 id={id} className={`${commonHeaderClasses} text-2xl border-b border-base-300 ${className}`}>
-      as="h3"
+      {id && <HeaderAnchor id={id} />}
-      id={id}
-      className={className}
-      pt={3}
-      pb={1}
-      borderBottom={'1px solid'}
-      borderColor="gray.300"
-      color="gray.800"
-      size="lg"
-    >
       {children}
-    </Heading>
+    </h3>
   );
 }
 
 export function Header4({ children, className, id }: HeaderProps) {
   return (
-    <Heading as="h4" id={id} className={className} pt={3} pb={1} color="gray.700" size="md">
+    <h4 id={id} className={`${commonHeaderClasses} text-xl ${className}`}>
+      {id && <HeaderAnchor id={id} />}
       {children}
-    </Heading>
+    </h4>
   );
 }
 
 export function Header5({ children, className, id }: HeaderProps) {
   return (
-    <Heading as="h5" id={id} className={className} pt={3} pb={1} color="gray.700" size="sm">
+    <h5 id={id} className={`${commonHeaderClasses} text-lg ${className}`}>
+      {id && <HeaderAnchor id={id} />}
       {children}
-    </Heading>
+    </h5>
   );
 }

src/components/HelpText/HiWord.tsx

@@ -1,9 +1,3 @@
-import { Mark } from '@chakra-ui/react';
+export function HiWord({ className = '', children }: { className?: string; children: React.ReactNode }) {
-
+  return <mark className={`bg-orange-100 rounded-md px-2 mx-1 ${className}`}>{children}</mark>;
-export function HiWord({ children }: { children: React.ReactNode }) {
-  return (
-    <Mark bg="orange.100" borderRadius={5} px={2} mx={1}>
-      {children}
-    </Mark>
-  );
 }

src/components/HelpText/VQuote.tsx

@@ -1,13 +1,9 @@
-import { chakra, css } from '@chakra-ui/react';
-
-const cssUnselectable = css({ pointerEvents: 'none', userSelect: 'none' });
-
 export function VQuote({ children }: { children: React.ReactNode }) {
   return (
     <>
-      <chakra.span css={cssUnselectable}>「</chakra.span>
+      <span className="select-none">「</span>
       {children}
-      <chakra.span css={cssUnselectable}>」</chakra.span>
+      <span className="select-none">」</span>
     </>
   );
 }

src/components/ImageFigure.tsx

@@ -0,0 +1,43 @@
+import classNames from 'classnames';
+import { useRef } from 'react';
+
+export interface ImageFigureProps {
+  srcSet: string;
+  alt: string;
+  className?: string;
+  loading?: 'lazy' | 'eager';
+  children?: React.ReactNode;
+}
+export function ImageFigure({ alt, srcSet, children, className, loading }: ImageFigureProps) {
+  const refDialog = useRef<HTMLDialogElement>(null);
+
+  return (
+    <figure className={classNames(className, 'inline-flex flex-col items-center')}>
+      <img
+        className={`rounded-md cursor-pointer border border-base-300 max-h-48`}
+        loading={loading}
+        srcSet={srcSet}
+        alt={alt}
+        onClick={() => refDialog?.current?.showModal()}
+      />
+      {children && <figcaption className="text-sm text-base-content/70">{children}</figcaption>}
+
+      <dialog ref={refDialog} className="modal text-left">
+        <div className="modal-box max-w-[50vw]">
+          <form method="dialog">
+            <button className="btn btn-sm btn-circle btn-ghost absolute right-2 top-2">✕</button>
+          </form>
+          <h3 className="font-bold text-lg">查看图片</h3>
+
+          <figure className="flex flex-col justify-center text-center">
+            <img srcSet={srcSet} alt={alt} />
+            {children && <figcaption className="text-sm text-base-content/70">{children}</figcaption>}
+          </figure>
+        </div>
+        <form method="dialog" className="modal-backdrop">
+          <button>关闭</button>
+        </form>
+      </dialog>
+    </figure>
+  );
+}

src/components/ImportSecretModal.tsx

@@ -1,15 +1,4 @@
-import {
+import { useEffect, useRef } from 'react';
-  Center,
-  Flex,
-  Modal,
-  ModalBody,
-  ModalCloseButton,
-  ModalContent,
-  ModalHeader,
-  ModalOverlay,
-  Tabs,
-  Text,
-} from '@chakra-ui/react';
 
 import { FileInput } from '~/components/FileInput';
 
@@ -18,31 +7,43 @@ export interface ImportSecretModalProps {
   children: React.ReactNode;
   show: boolean;
   onClose: () => void;
-  onImport: (file: File) => void;
+  onImport: (file: File) => void | Promise<void>;
 }
 
 export function ImportSecretModal({ clientName, children, show, onClose, onImport }: ImportSecretModalProps) {
-  const handleFileReceived = (files: File[]) => onImport(files[0]);
+  const handleFileReceived = (files: File[]) => {
+    const promise = onImport(files[0]);
+    if (promise instanceof Promise) {
+      promise.catch((err) => {
+        console.error('could not import: ', err);
+      });
+    }
+    return promise;
+  };
+
+  const refModel = useRef<HTMLDialogElement>(null);
+  useEffect(() => {
+    if (show) {
+      refModel.current?.showModal();
+    } else {
+      refModel.current?.close();
+    }
+  }, [show]);
 
   return (
-    <Modal isOpen={show} onClose={onClose} closeOnOverlayClick={false} scrollBehavior="inside" size="xl">
+    <dialog ref={refModel} className="modal">
-      <ModalOverlay />
+      <div className="modal-box">
-      <ModalContent>
+        <form method="dialog" onSubmit={() => onClose()}>
-        <ModalHeader>从文件导入密钥</ModalHeader>
+          <button className="btn btn-sm btn-circle btn-ghost absolute right-2 top-2">✕</button>
-        <ModalCloseButton />
+        </form>
-        <Flex as={ModalBody} gap={2} flexDir="column" flex={1}>
+        <h3 className="font-bold text-lg">从文件导入密钥</h3>
-          <Center>
+        <div className="py-4 flex flex-col gap-2 flex-1">
-            <FileInput onReceiveFiles={handleFileReceived}>拖放或点我选择含有密钥的数据库文件</FileInput>
+          <FileInput onReceiveFiles={handleFileReceived}>拖放或点我选择含有密钥的数据库文件</FileInput>
-          </Center>
 
-          <Text as="div" mt={2}>
+          <div className="mt-2">选择你的{clientName && <>「{clientName}」</>}客户端平台以查看对应说明：</div>
-            选择你的{clientName && <>「{clientName}」</>}客户端平台以查看对应说明：
+          <div>{children}</div>
-          </Text>
+        </div>
-          <Flex as={Tabs} variant="enclosed" flexDir="column" flex={1} minH={0}>
+      </div>
-            {children}
+    </dialog>
-          </Flex>
-        </Flex>
-      </ModalContent>
-    </Modal>
   );
 }

src/components/InfoModal.tsx

@@ -0,0 +1,25 @@
+import { Dialog } from '~/components/Dialog.tsx';
+import React, { useState } from 'react';
+
+interface InfoModalProps {
+  title?: React.ReactNode;
+  description?: React.ReactNode;
+  children?: React.ReactNode;
+}
+
+export function InfoModal(props: InfoModalProps) {
+  const { title, description, children } = props;
+
+  const [showModal, setShowModal] = useState(false);
+  return (
+    <div>
+      <button className="btn btn-info btn-sm" type="button" onClick={() => setShowModal(true)}>
+        {children || '这是什么?'}
+      </button>
+
+      <Dialog closeButton backdropClose show={showModal} onClose={() => setShowModal(false)} title={title}>
+        {description}
+      </Dialog>
+    </div>
+  );
+}

src/components/InstructionsTabs.tsx

@@ -0,0 +1,39 @@
+import classNames from 'classnames';
+import React, { Fragment, useId } from 'react';
+
+export type InstructionTab = {
+  id: string | number;
+  label: React.ReactNode;
+  content: React.ReactNode;
+};
+
+export interface InstructionsTabsProps {
+  tabs: InstructionTab[];
+  limitHeight?: boolean;
+}
+
+export function InstructionsTabs({ limitHeight = false, tabs }: InstructionsTabsProps) {
+  const id = useId();
+  return (
+    <div className={classNames('tabs tabs-lift pb-4 mt-2', { 'max-h-[32rem]': limitHeight })}>
+      {tabs.map(({ id: _tabId, label, content }, index) => (
+        <Fragment key={_tabId}>
+          <label className="tab dark:[--tab-border-color:#555]">
+            <input type="radio" name={id} defaultChecked={index === 0} />
+            {label}
+          </label>
+          <div
+            className={classNames(
+              'tab-content border-base-300 dark:border-[#555] bg-base-100 px-4 py-2 overflow-y-auto',
+              {
+                'max-h-[30rem]': limitHeight,
+              },
+            )}
+          >
+            {content}
+          </div>
+        </Fragment>
+      ))}
+    </div>
+  );
+}

src/components/Key/MacCommandKey.tsx

@@ -1,15 +1,12 @@
-import { Icon, Kbd } from '@chakra-ui/react';
 import { BsCommand } from 'react-icons/bs';
+import { Ruby } from '../Ruby';
 
-export function MacCommandKey() {
+export function MacCommandKey({ className }: { className?: string }) {
   return (
-    <ruby>
+    <Ruby caption="command" className={className}>
-      <Kbd>
+      <kbd className="kbd">
-        <Icon as={BsCommand} />
+        <BsCommand className="text-sm" />
-      </Kbd>
+      </kbd>
-      <rp> (</rp>
+    </Ruby>
-      <rt>command</rt>
-      <rp>)</rp>
-    </ruby>
   );
 }

src/components/Key/ShiftKey.tsx

@@ -1,15 +1,12 @@
-import { Icon, Kbd } from '@chakra-ui/react';
 import { BsShift } from 'react-icons/bs';
+import { Ruby } from '../Ruby';
 
-export function ShiftKey() {
+export function ShiftKey({ className }: { className?: string }) {
   return (
-    <ruby>
+    <Ruby caption="shift" className={className}>
-      <Kbd>
+      <kbd className="kbd">
-        <Icon as={BsShift} />
+        <BsShift className="text-sm" />
-      </Kbd>
+      </kbd>
-      <rp> (</rp>
+    </Ruby>
-      <rt>shift</rt>
-      <rp>)</rp>
-    </ruby>
   );
 }

src/components/KeyInput.tsx

@@ -0,0 +1,112 @@
+import { PiFileAudio } from 'react-icons/pi';
+import { MdDelete, MdVpnKey } from 'react-icons/md';
+import type { ReactNode } from 'react';
+
+export interface KeyInputProps {
+  sequence: number;
+
+  name: string;
+  value: string;
+  isValidKey?: boolean;
+  onSetName: (name: string) => void;
+  onSetValue: (value: string) => void;
+  onDelete: () => void;
+
+  quality?: string;
+  onSetQuality?: (quality: string) => void;
+
+  nameLabel?: ReactNode;
+  valueLabel?: ReactNode;
+  qualityLabel?: ReactNode;
+
+  namePlaceholder?: string;
+  valuePlaceholder?: string;
+  qualityPlaceholder?: string;
+}
+
+export function KeyInput(props: KeyInputProps) {
+  const {
+    nameLabel,
+    valueLabel,
+    qualityLabel,
+    namePlaceholder,
+    qualityPlaceholder,
+    valuePlaceholder,
+    sequence,
+    name,
+    quality,
+    value,
+    onSetName,
+    onSetValue,
+    onDelete,
+    onSetQuality,
+    isValidKey,
+  } = props;
+
+  return (
+    <li className="list-row items-center">
+      <div className="flex items-center justify-center w-8 h-8 text-sm font-bold text-gray-500 bg-gray-200 rounded-full">
+        {sequence}
+      </div>
+
+      <div className="join join-vertical flex-1">
+        <div className="flex">
+          <label className="input w-full rounded-tl-md last:rounded-tr-md">
+            <span className="cucursor-default inline-flex items-center gap-1 select-none">
+              {nameLabel || (
+                <>
+                  文件 <PiFileAudio />
+                </>
+              )}
+            </span>
+            <input
+              type="text"
+              className="font-mono"
+              placeholder={namePlaceholder}
+              value={name}
+              onChange={(e) => onSetName(e.target.value)}
+              data-name="key-input--name"
+            />
+          </label>
+          {onSetQuality && (
+            <label className="input min-w-0 max-w-[10rem] ml-[-1px] rounded-tr-md">
+              <span className="cucursor-default inline-flex items-center gap-1 select-none">
+                {qualityLabel || '音质'}
+              </span>
+              <input
+                type="text"
+                className="font-mono"
+                placeholder={qualityPlaceholder}
+                value={quality}
+                onChange={(e) => onSetQuality(e.target.value)}
+              />
+            </label>
+          )}
+        </div>
+        <label className="input w-full rounded-bl-md rounded-br-md mt-[-1px]">
+          <span className="cursor-default inline-flex items-center gap-1 select-none">
+            {valueLabel || (
+              <>
+                密钥 <MdVpnKey />
+              </>
+            )}
+          </span>
+          <input
+            type="text"
+            className="font-mono"
+            placeholder={valuePlaceholder}
+            value={value}
+            onChange={(e) => onSetValue(e.target.value)}
+          />
+          <span className={isValidKey ? 'text-green-600' : 'text-red-600'}>
+            <code>{value.length || '?'}</code>
+          </span>
+        </label>
+      </div>
+
+      <button type="button" className="btn btn-error btn-sm px-1 btn-outline" onClick={onDelete}>
+        <MdDelete className="size-6" />
+      </button>
+    </li>
+  );
+}

src/components/KeyListContainer.tsx

@@ -0,0 +1,21 @@
+import type { ReactNode, RefObject } from 'react';
+
+export interface KeyListContainerProps {
+  keys: unknown[];
+  children?: ReactNode;
+  ref?: RefObject<HTMLDivElement | null>;
+}
+
+export function KeyListContainer({ keys, children, ref }: KeyListContainerProps) {
+  const count = keys.length;
+  return (
+    <div ref={ref} className="flex grow min-h-0 pr-4 pt-3">
+      {count > 0 && (
+        <ul className="list bg-base-100 rounded-box shadow-sm border border-base-300 w-full min-h-0 overflow-auto">
+          {children}
+        </ul>
+      )}
+      {count === 0 && <p>还没有添加密钥。</p>}
+    </div>
+  );
+}

src/components/ProjectIssue.tsx

@@ -1,4 +1,4 @@
-import { Link } from '@chakra-ui/react';
+import { ExtLink } from './ExtLink';
 
 export interface ProjectIssueProps {
   id: number | string;
@@ -7,9 +7,9 @@ export interface ProjectIssueProps {
 
 export function ProjectIssue({ id, title }: ProjectIssueProps) {
   return (
-    <Link isExternal target="_blank" href={`https://git.unlock-music.dev/um/um-react/issues/${id}`}>
+    <ExtLink target="_blank" href={`https://git.um-react.app/um/um-react/issues/${id}`}>
       {`#${id}`}
       {title && ` - ${title}`}
-    </Link>
+    </ExtLink>
   );
 }

src/components/Ruby.tsx

@@ -0,0 +1,20 @@
+import React from 'react';
+
+export interface RubyProps {
+  caption: React.ReactNode;
+  children: React.ReactNode;
+  className?: string;
+}
+
+export function Ruby(props: RubyProps) {
+  const { caption, children, ...rest } = props;
+
+  return (
+    <ruby {...rest}>
+      {children}
+      <rp>(</rp>
+      <rt>{caption}</rt>
+      <rp>)</rp>
+    </ruby>
+  );
+}

src/components/SDKVersion.tsx

@@ -1,33 +1,41 @@
-import { InfoOutlineIcon } from '@chakra-ui/icons';
+import { MdInfoOutline } from 'react-icons/md';
-import { Tooltip, VStack, Text, Flex } from '@chakra-ui/react';
 import { workerClientBus } from '~/decrypt-worker/client';
 import { DECRYPTION_WORKER_ACTION_NAME } from '~/decrypt-worker/constants';
-
+import { useEffect, useRef, useState } from 'react';
-import usePromise from 'react-promise-suspense';
 
 const getSDKVersion = async (): Promise<string> => {
   return workerClientBus.request(DECRYPTION_WORKER_ACTION_NAME.VERSION, null);
 };
 
 export function SDKVersion() {
-  const sdkVersion = usePromise(getSDKVersion, []);
+  const refDialog = useRef<HTMLDialogElement>(null);
+  const [sdkVersion, setSdkVersion] = useState('...');
+  useEffect(() => {
+    getSDKVersion().then(setSdkVersion);
+  }, []);
 
   return (
-    <Flex as="span" pl="1" alignItems="center" data-testid="sdk-version">
+    <>
-      <Tooltip
+      <span className="btn btn-ghost inline-flex p-0" onClick={() => refDialog.current?.showModal()}>
-        hasArrow
+        <MdInfoOutline />
-        placement="top"
+      </span>
-        label={
+
-          <VStack>
+      <dialog ref={refDialog} className="modal text-left">
-            <Text>App: __APP_VERSION__</Text>
+        <div className="modal-box">
-            <Text>SDK: {sdkVersion}</Text>
+          <form method="dialog">
-          </VStack>
+            <button className="btn btn-sm btn-circle btn-ghost absolute right-2 top-2">✕</button>
-        }
+          </form>
-        bg="gray.300"
+          <h3 className="font-bold text-lg">详细信息</h3>
-        color="black"
+
-      >
+          <p>App: __APP_VERSION__</p>
-        <InfoOutlineIcon />
+          <p>
-      </Tooltip>
+            SDK: <span data-testid="sdk-version">{sdkVersion}</span>
-    </Flex>
+          </p>
+        </div>
+        <form method="dialog" className="modal-backdrop">
+          <button>关闭</button>
+        </form>
+      </dialog>
+    </>
   );
 }

src/components/SelectFile.tsx

@@ -1,5 +1,4 @@
-import { Box, Text } from '@chakra-ui/react';
+import { FiUnlock } from 'react-icons/fi';
-import { UnlockIcon } from '@chakra-ui/icons';
 
 import { useAppDispatch } from '~/hooks';
 import { addNewFile, processFile } from '~/features/file-listing/fileListingSlice';
@@ -12,7 +11,7 @@ export function SelectFile() {
     console.debug(
       'react-dropzone/onDropAccepted(%o, %o)',
       files.length,
-      files.map((x) => x.name)
+      files.map((x) => x.name),
     );
 
     for (const file of files) {
@@ -26,7 +25,7 @@ export function SelectFile() {
           id: fileId,
           blobURI,
           fileName,
-        })
+        }),
       );
       dispatch(processFile({ fileId }));
     }
@@ -34,19 +33,13 @@ export function SelectFile() {
 
   return (
     <FileInput multiple onReceiveFiles={handleFileReceived}>
-      <Box pb={3}>
+      <FiUnlock className="size-8 mb-4" />
-        <UnlockIcon boxSize={8} />
+      <p className="text-center">
-      </Box>
-      <Text as="div" textAlign="center">
         拖放或
-        <Text as="span" color="teal.400">
+        <span className="text-teal-700 font-semibold">点我选择</span>
-          点我选择
-        </Text>
         需要解密的文件
-        <Text fontSize="sm" opacity="50%">
+      </p>
-          在浏览器内对文件进行解锁，零上传
+      <p className="text-sm opacity-50 m-0">在浏览器内对文件进行解锁，零上传</p>
-        </Text>
-      </Text>
     </FileInput>
   );
 }

src/decrypt-worker/Deciphers.ts

@@ -25,7 +25,7 @@ export interface DecipherNotOK {
 export interface DecipherOK {
   status: Status.OK;
   message?: string;
-  data: Uint8Array;
+  data: Uint8Array<ArrayBuffer>;
   overrideExtension?: string;
   cipherName: string;
 }

src/decrypt-worker/constants.ts

@@ -2,6 +2,7 @@ export enum DECRYPTION_WORKER_ACTION_NAME {
   DECRYPT = 'DECRYPT',
   FIND_QMC_MUSICEX_NAME = 'FIND_QMC_MUSICEX_NAME',
   KUWO_PARSE_HEADER = 'KUWO_PARSE_HEADER',
+  KUGOU_PARSE_HEADER = 'KUGOU_PARSE_HEADER',
   QINGTING_FM_GET_DEVICE_KEY = 'QINGTING_FM_GET_DEVICE_KEY',
   VERSION = 'VERSION',
 }

src/decrypt-worker/decipher/KugouMusic.ts

@@ -1,16 +1,18 @@
 import { DecipherInstance, DecipherOK, DecipherResult, Status } from '~/decrypt-worker/Deciphers';
-import { KuGou } from '@unlock-music/crypto';
+import { KuGou, KuGouHeader } from '@unlock-music/crypto';
 import type { DecryptCommandOptions } from '~/decrypt-worker/types.ts';
 import { chunkBuffer } from '~/decrypt-worker/util/buffer.ts';
 
 export class KugouMusicDecipher implements DecipherInstance {
   cipherName = 'Kugou';
 
-  async decrypt(buffer: Uint8Array, _options: DecryptCommandOptions): Promise<DecipherResult | DecipherOK> {
+  async decrypt(buffer: Uint8Array, options: DecryptCommandOptions): Promise<DecipherResult | DecipherOK> {
     let kgm: KuGou | undefined;
+    let kgmHdr: KuGouHeader | undefined;
 
     try {
-      kgm = KuGou.from_header(buffer.subarray(0, 0x400));
+      kgmHdr = new KuGouHeader(buffer.subarray(0, 0x400));
+      kgm = KuGou.fromHeaderV5(kgmHdr, options.kugouKey);
 
       const audioBuffer = new Uint8Array(buffer.subarray(0x400));
       for (const [block, offset] of chunkBuffer(audioBuffer)) {
@@ -23,6 +25,7 @@ export class KugouMusicDecipher implements DecipherInstance {
         data: audioBuffer,
       };
     } finally {
+      kgmHdr?.free();
       kgm?.free();
     }
   }

src/decrypt-worker/decipher/Transparent.ts

@@ -3,7 +3,7 @@ import { DecipherInstance, DecipherOK, DecipherResult, Status } from '~/decrypt-
 export class TransparentDecipher implements DecipherInstance {
   cipherName = 'none';
 
-  async decrypt(buffer: Uint8Array): Promise<DecipherResult | DecipherOK> {
+  async decrypt(buffer: Uint8Array<ArrayBuffer>): Promise<DecipherResult | DecipherOK> {
     return {
       cipherName: 'None',
       status: Status.OK,

src/decrypt-worker/types.ts

@@ -2,6 +2,7 @@ export interface DecryptCommandOptions {
   fileName: string;
   qmc2Key?: string;
   kwm2key?: string;
+  kugouKey?: string;
   qingTingAndroidKey?: string;
 }
 
@@ -24,6 +25,15 @@ export type ParseKuwoHeaderResponse = null | {
   qualityId: number;
 };
 
+export interface ParseKugouHeaderPayload {
+  blobURI: string;
+}
+
+export type ParseKugouHeaderResponse = null | {
+  version: number;
+  audioHash: string;
+};
+
 export interface GetQingTingFMDeviceKeyPayload {
   product: string;
   device: string;

src/decrypt-worker/util/audioType.ts

@@ -24,3 +24,17 @@ export function isDataLooksLikeAudio(buffer: Uint8Array): boolean {
   detectResult.free();
   return ok;
 }
+
+const AudioMimeType: Record<string, string> = {
+  mp3: 'audio/mpeg',
+  flac: 'audio/flac',
+  m4a: 'audio/mp4',
+  ogg: 'audio/ogg',
+  wma: 'audio/x-ms-wma',
+  wav: 'audio/x-wav',
+  dff: 'audio/x-dff',
+};
+
+export function getMimeTypeFromExt(ext: string) {
+  return AudioMimeType[ext] || 'application/octet-stream';
+}

src/decrypt-worker/util/buffer.ts

@@ -1,7 +1,6 @@
-export const toArrayBuffer = async (src: Blob | ArrayBuffer | Uint8Array<ArrayBufferLike>) =>
+export const toArrayBuffer = async (src: Blob | BlobPart) => (src instanceof Blob ? await src.arrayBuffer() : src);
-  src instanceof Blob ? await src.arrayBuffer() : src;
+export const toBlob = (src: Blob | BlobPart, mimeType?: string) =>
-export const toBlob = (src: Blob | ArrayBuffer | Uint8Array<ArrayBufferLike>) =>
+  src instanceof Blob ? src : new Blob([src], { type: mimeType ?? 'application/octet-stream' });
-  src instanceof Blob ? src : new Blob([src]);
 
 export function* chunkBuffer(buffer: Uint8Array, blockLen = 4096): Generator<[Uint8Array, number], void> {
   const len = buffer.byteLength;

src/decrypt-worker/worker.ts

@@ -6,6 +6,7 @@ import { workerDecryptHandler } from './worker/decrypt.ts';
 import { workerParseMusicExMediaName } from './worker/qmcv2_parser.ts';
 import { workerGetQtfmDeviceKey } from '~/decrypt-worker/worker/qtfm_device_key.ts';
 import { workerParseKuwoHeader } from '~/decrypt-worker/worker/kuwo_header_parse.ts';
+import { workerParseKugouHeader } from '~/decrypt-worker/worker/kugou_parse_header.ts';
 
 const bus = new WorkerServerBus();
 onmessage = bus.onmessage;
@@ -14,4 +15,5 @@ bus.addEventHandler(DECRYPTION_WORKER_ACTION_NAME.DECRYPT, workerDecryptHandler)
 bus.addEventHandler(DECRYPTION_WORKER_ACTION_NAME.FIND_QMC_MUSICEX_NAME, workerParseMusicExMediaName);
 bus.addEventHandler(DECRYPTION_WORKER_ACTION_NAME.VERSION, getUmcVersion);
 bus.addEventHandler(DECRYPTION_WORKER_ACTION_NAME.KUWO_PARSE_HEADER, workerParseKuwoHeader);
+bus.addEventHandler(DECRYPTION_WORKER_ACTION_NAME.KUGOU_PARSE_HEADER, workerParseKugouHeader);
 bus.addEventHandler(DECRYPTION_WORKER_ACTION_NAME.QINGTING_FM_GET_DEVICE_KEY, workerGetQtfmDeviceKey);

src/decrypt-worker/worker/decrypt.ts

@@ -6,7 +6,7 @@ import { DecipherFactory, DecipherInstance, Status } from '~/decrypt-worker/Deci
 import { UnsupportedSourceFile } from '~/decrypt-worker/util/DecryptError.ts';
 import { ready as umCryptoReady } from '@unlock-music/crypto';
 import { go } from '~/util/go.ts';
-import { detectAudioExtension } from '~/decrypt-worker/util/audioType.ts';
+import { getMimeTypeFromExt, detectAudioExtension } from '~/decrypt-worker/util/audioType.ts';
 
 class DecryptCommandHandler {
   private readonly label: string;
@@ -31,6 +31,7 @@ class DecryptCommandHandler {
       const [result, error] = await go(this.tryDecryptWith(decipher));
       if (!error) {
         if (result) {
+          console.debug(`[${decipher.cipherName}] Decryption OK`);
           return result;
         }
         errors.push(`${decipher.cipherName}: no response`);
@@ -75,7 +76,7 @@ class DecryptCommandHandler {
       audioExt = 'm4a';
     }
 
-    return { decrypted: URL.createObjectURL(toBlob(result.data)), ext: audioExt };
+    return { decrypted: URL.createObjectURL(toBlob(result.data, getMimeTypeFromExt(audioExt))), ext: audioExt };
   }
 }
 

src/decrypt-worker/worker/kugou_parse_header.ts

@@ -0,0 +1,23 @@
+import {
+  ParseKugouHeaderPayload, ParseKugouHeaderResponse,
+
+} from '~/decrypt-worker/types.ts';
+import { KuGouHeader } from '@unlock-music/crypto';
+
+export const workerParseKugouHeader = async ({ blobURI }: ParseKugouHeaderPayload): Promise<ParseKugouHeaderResponse> => {
+  const blob = await fetch(blobURI, { headers: { Range: 'bytes=0-1023' } }).then((r) => r.blob());
+  const arrayBuffer = await blob.arrayBuffer();
+  const buffer = new Uint8Array(arrayBuffer.slice(0, 0x400));
+
+  let kwm : KuGouHeader | undefined;
+
+  try {
+    kwm = new KuGouHeader(buffer);
+    const { version, audioHash } = kwm;
+    return { version, audioHash };
+  } catch {
+    return null;
+  } finally {
+    kwm?.free();
+  }
+}

src/decrypt-worker/worker/kuwo_header_parse.ts

@@ -1,7 +1,7 @@
-import { FetchMusicExNamePayload, ParseKuwoHeaderResponse } from '~/decrypt-worker/types.ts';
+import {  ParseKuwoHeaderPayload, ParseKuwoHeaderResponse } from '~/decrypt-worker/types.ts';
 import { KuwoHeader } from '@unlock-music/crypto';
 
-export const workerParseKuwoHeader = async ({ blobURI }: FetchMusicExNamePayload): Promise<ParseKuwoHeaderResponse> => {
+export const workerParseKuwoHeader = async ({ blobURI }: ParseKuwoHeaderPayload): Promise<ParseKuwoHeaderResponse> => {
   const blob = await fetch(blobURI, { headers: { Range: 'bytes=0-1023' } }).then((r) => r.blob());
   const arrayBuffer = await blob.arrayBuffer();
 

src/faq/AndroidEmulatorFAQ.tsx

@@ -0,0 +1,75 @@
+import { ExtLink } from '~/components/ExtLink';
+import { Header2, Header3, Header4 } from '~/components/HelpText/Headers';
+import { VQuote } from '~/components/HelpText/VQuote';
+import { RiErrorWarningLine } from 'react-icons/ri';
+
+import LdPlayerSettingsMisc2x from './assets/ld_settings_misc@2x.webp';
+import MumuSettingsMisc2x from './assets/mumu_settings_misc@2x.webp';
+import { ImageFigure } from '~/components/ImageFigure';
+
+export function AndroidEmulatorFAQ() {
+  return (
+    <>
+      <Header2>安卓模拟器</Header2>
+      <p className="mb-2">目前市面上主流的可以很方便 root 的安卓模拟器有两个：</p>
+
+      <ul className="list-disc pl-6 mb-2">
+        <li>
+          <ExtLink href="https://mumu.163.com/">网易 MuMu 模拟器（安卓 12）</ExtLink> - Hyper-V 兼容较好
+        </li>
+        <li>
+          <ExtLink href="https://www.ldmnq.com/">雷电模拟器（安卓 9）</ExtLink>
+        </li>
+      </ul>
+
+      <p className="mb-2">上述两款模拟器均包含广告，使用时请注意。</p>
+
+      <div className="my-2 alert alert-warning">
+        <RiErrorWarningLine className="text-lg" />
+        <p>
+          根据应用的风控策略，使用模拟器登录的账号<strong>有可能会导致账号被封锁</strong>。
+        </p>
+      </div>
+      <p className="mb-2">读者在使用前请自行评估风险。</p>
+
+      <Header3 id="enable-root">启用 root</Header3>
+      <p className="mb-2">上述的两款模拟器都有提供比较直接的启用 root 的方法。</p>
+
+      <Header4 id="root-mumu">网易 MuMu 模拟器</Header4>
+      <ul className="list-disc pl-6">
+        <li>
+          打开<VQuote>设置中心</VQuote>
+        </li>
+        <li>
+          选择<VQuote>其他</VQuote>
+        </li>
+        <li>
+          勾选<VQuote>开启手机Root权限</VQuote>
+        </li>
+      </ul>
+      <div>
+        <ImageFigure className="ml-2" alt="网易木木模拟器设置界面" loading="lazy" srcSet={`${MumuSettingsMisc2x} 2x`}>
+          网易木木模拟器设置界面
+        </ImageFigure>
+      </div>
+
+      <Header4 id="root-ld">雷电模拟器</Header4>
+      <ul className="list-disc pl-6">
+        <li>
+          打开<VQuote>模拟器设置</VQuote>
+        </li>
+        <li>
+          选择<VQuote>其他</VQuote>
+        </li>
+        <li>
+          设置<VQuote>ROOT 权限</VQuote>为<VQuote>开启</VQuote>状态
+        </li>
+      </ul>
+      <div>
+        <ImageFigure className="ml-2" alt="雷电模拟器设置界面" loading="lazy" srcSet={`${LdPlayerSettingsMisc2x} 2x`}>
+          雷电模拟器设置界面
+        </ImageFigure>
+      </div>
+    </>
+  );
+}

src/faq/FAQAbout.tsx

@@ -0,0 +1,45 @@
+import { Header2, Header3 } from '~/components/HelpText/Headers';
+import { FaRust } from 'react-icons/fa';
+
+export function FAQAboutProject() {
+  return (
+    <div className="flex flex-col gap-4">
+      <Header2>关于项目</Header2>
+
+      <Header3 id="failed">um-react 是什么</Header3>
+      <p>
+        um-react 是由
+        <a className="mx-1 link link-info" href="https://git.um-react.app/um">
+          Unlock Music
+        </a>
+        基于 React 框架制作的一款用于移除已购音乐的加密保护的小工具，使用
+        <a className="mx-1 link link-info" href="https://git.um-react.app/um/um-react/src/branch/main/LICENSE">
+          MIT
+        </a>
+        授权协议。
+      </p>
+      <p>
+        它的解密核心由 <FaRust className="inline" />
+        <a className="mx-1 link link-info" href="https://git.um-react.app/um/lib_um_crypto_rust">
+          <code>lib_um_crypto_rust</code>
+        </a>
+        驱动，使用
+        <a
+          className="mx-1 link link-info"
+          href="https://git.um-react.app/um/lib_um_crypto_rust/src/branch/main/LICENSE_MIT"
+        >
+          MIT
+        </a>
+        +
+        <a
+          className="mx-1 link link-info"
+          href="https://git.um-react.app/um/lib_um_crypto_rust/src/branch/main/LICENSE_APACHE"
+        >
+          Apache
+        </a>
+        双协议。
+      </p>
+      <p>这意味着你可以自由地使用、修改和分发这个软件，但请注意遵守相应的授权协议。</p>
+    </div>
+  );
+}

src/faq/FAQPages.tsx

@@ -0,0 +1,22 @@
+import type { ComponentType } from 'react';
+import { QQMusicFAQ } from './QQMusicFAQ';
+import { KuwoFAQ } from './KuwoFAQ';
+import { KugouFAQ } from './KugouFAQ';
+import { OtherFAQ } from './OtherFAQ';
+import { AndroidEmulatorFAQ } from './AndroidEmulatorFAQ';
+import { FAQAboutProject } from './FAQAbout';
+
+export type FAQEntry = {
+  id: string;
+  name: string;
+  Component: ComponentType;
+};
+
+export const FAQ_PAGES: FAQEntry[] = [
+  { id: 'qqmusic', name: 'QQ 音乐', Component: QQMusicFAQ },
+  { id: 'kuwo', name: '酷我音乐', Component: KuwoFAQ },
+  { id: 'kugou', name: '酷狗音乐', Component: KugouFAQ },
+  { id: 'android-emu', name: '安卓模拟器', Component: AndroidEmulatorFAQ },
+  { id: 'other', name: '其它问题', Component: OtherFAQ },
+  { id: 'about', name: '关于项目', Component: FAQAboutProject },
+];

src/faq/FaqHome.tsx

@@ -0,0 +1,15 @@
+import { ExtLink } from '~/components/ExtLink';
+import { Header2 } from '~/components/HelpText/Headers';
+
+export function FaqHome() {
+  return (
+    <div className="flex flex-col gap-4">
+      <Header2>答疑</Header2>
+      <p>从目录选择一项来查看相关说明。</p>
+      <p>
+        也欢迎造访
+        <ExtLink href={'https://t.me/unlock_music_chat'}>“音乐解锁-交流” 交流群</ExtLink> 进行交流。
+      </p>
+    </div>
+  );
+}

src/faq/KugouFAQ.tsx

@@ -0,0 +1,25 @@
+import { Header2, Header3 } from '~/components/HelpText/Headers';
+import { SegmentKeyImportInstructions } from './SegmentKeyImportInstructions';
+import { KugouAllInstructions } from '~/features/settings/panels/Kugou/KugouAllInstructions.tsx';
+import { RiErrorWarningLine } from 'react-icons/ri';
+
+export function KugouFAQ() {
+  return (
+    <>
+      <Header2>酷狗音乐</Header2>
+      <Header3 id="failed">解锁失败</Header3>
+      <p className="mb-2">
+        酷狗现在对部分用户推送了 <code>kgg</code> 加密格式（安卓、Windows 客户端）。
+      </p>
+      <p className="mb-2">根据平台不同，你需要提取密钥数据库。</p>
+
+      <div className="alert alert-warning mb-2">
+        <RiErrorWarningLine className="size-6" />
+        <p>安卓用户提取密钥需要 root 权限，或注入文件提供器。</p>
+      </div>
+
+      <Header3 id="keys">导入密钥</Header3>
+      <SegmentKeyImportInstructions tab="酷狗密钥" clientInstructions={<KugouAllInstructions />} />
+    </>
+  );
+}

src/faq/KuwoFAQ.tsx

@@ -1,52 +1,47 @@
-import { Alert, AlertIcon, Container, Flex, List, ListItem, Text } from '@chakra-ui/react';
+import { Header2, Header3 } from '~/components/HelpText/Headers';
-import { Header4 } from '~/components/HelpText/Headers';
 import { VQuote } from '~/components/HelpText/VQuote';
 import { SegmentTryOfficialPlayer } from './SegmentTryOfficialPlayer';
 import { HiWord } from '~/components/HelpText/HiWord';
 import { KWMv2AllInstructions } from '~/features/settings/panels/KWMv2/KWMv2AllInstructions';
 import { SegmentKeyImportInstructions } from './SegmentKeyImportInstructions';
+import { RiErrorWarningLine } from 'react-icons/ri';
 
 export function KuwoFAQ() {
   return (
     <>
-      <Header4>解锁失败</Header4>
+      <Header2>酷我音乐</Header2>
-      <List spacing={2}>
+      <Header3 id="failed">解锁失败</Header3>
-        <ListItem>
+      <SegmentTryOfficialPlayer />
-          <SegmentTryOfficialPlayer />
+      <p className="mb-2">
-        </ListItem>
+        日前，仅<HiWord>手机客户端</HiWord>下载的
-        <ListItem>
+        <VQuote>
-          <Text>
+          <strong>至臻全景声</strong>
-            日前，仅<HiWord>手机客户端</HiWord>下载的
+        </VQuote>
-            <VQuote>
+        及
-              <strong>至臻全景声</strong>
+        <VQuote>
-            </VQuote>
+          <strong>至臻母带</strong>
-            及
+        </VQuote>
-            <VQuote>
+        音质的音乐文件采用新版加密。
-              <strong>至臻母带</strong>
+      </p>
-            </VQuote>
+      <p className="mb-2">其他音质目前不需要提取密钥。</p>
-            {'音质的音乐文件采用新版加密。'}
+      <p className="mb-2">PC平台暂未推出使用新版加密的音质。</p>
-          </Text>
-          <Text>其他音质目前不需要提取密钥。</Text>
-          <Text>PC平台暂未推出使用新版加密的音质。</Text>
 
-          <Container p={2}>
+      <Header3 id="keys">导入密钥</Header3>
-            <Alert status="warning" borderRadius={5}>
+      <div className="alert alert-warning my-2">
-              <AlertIcon />
+        <RiErrorWarningLine className="text-2xl" />
-              <Flex flexDir="column">
+        <div>
-                <Text>安卓用户提取密钥需要 root 权限，或注入文件提供器。</Text>
+          <p>安卓用户提取密钥需要 root 权限，或注入文件提供器。</p>
-                <Text>
+          <p>
-                  <strong>注意</strong>：已知部分第三方修改版会破坏密钥写入功能，导致无法提取密钥。
+            <strong className="pr-2">注意</strong>已知部分第三方修改版会破坏密钥写入功能，导致无法提取密钥。
-                </Text>
+          </p>
-                <Text>
+          <p>
-                  <strong>注意</strong>：项目组不提倡使用、也不提供第三方修改版。使用前请自行评估风险。
+            <strong className="pr-2">注意</strong>
-                </Text>
+            项目组不提倡使用、也不提供第三方修改版。使用前请自行评估风险。请开通会员支持正版音乐。
-              </Flex>
+          </p>
-            </Alert>
+        </div>
-          </Container>
+      </div>
 
-          <SegmentKeyImportInstructions tab="KWMv2 密钥" clientInstructions={<KWMv2AllInstructions />} />
+      <SegmentKeyImportInstructions tab="KWMv2 密钥" clientInstructions={<KWMv2AllInstructions />} />
-        </ListItem>
-      </List>
     </>
   );
 }

src/faq/OtherFAQ.tsx

@@ -1,139 +1,99 @@
-import { Alert, AlertIcon, Code, Container, Flex, Img, ListItem, Text, UnorderedList } from '@chakra-ui/react';
 import { ExtLink } from '~/components/ExtLink';
-import { Header4 } from '~/components/HelpText/Headers';
+import { Header2, Header3, Header4 } from '~/components/HelpText/Headers';
-import { VQuote } from '~/components/HelpText/VQuote';
+
-import { ProjectIssue } from '~/components/ProjectIssue';
+import { NavLink } from 'react-router';
-import LdPlayerSettingsScreen from './assets/ld_settings_misc.webp';
 
 export function OtherFAQ() {
   return (
     <>
-      <Header4>解密后没有封面等信息</Header4>
+      <Header2>其它问题</Header2>
-      <Text>该项目进行解密处理。如果加密前的资源没有内嵌元信息或封面，解密的文件也没有。</Text>
+      <Header3 id="metadata">解密后没有封面等信息</Header3>
-      <Text>请使用第三方工具进行编辑或管理元信息。</Text>
+      <p>该项目进行解密处理。如果加密前的资源没有内嵌元信息或封面，解密的文件也没有。</p>
+      <p>请使用第三方工具进行编辑或管理元信息。</p>
 
-      <Header4>批量下载</Header4>
+      <Header3 id="android-browsers">安卓: 浏览器支持说明</Header3>
-      <Text>
+      <p>⚠️ 手机端浏览器支持有限，请使用最新版本的 Chrome 或 Firefox 官方浏览器。</p>
-        {'暂时没有实现，不过你可以在 '}
+      <div className="flex flex-col md:flex-row gap-2 md:gap-8">
-        <ProjectIssue id={34} title="[UI] 全部下载功能" />
+        <div>
-        {' 以及 '}
+          <Header4>已知有问题的浏览器</Header4>
-        <ProjectIssue id={43} title="批量下载" />
+          <ul className="list-disc list-inside pl-2">
-        {' 追踪该问题。'}
+            <li>Via 浏览器</li>
-      </Text>
+            <li>夸克浏览器</li>
+            <li>UC 浏览器</li>
+          </ul>
+        </div>
 
-      <Header4>安卓: 浏览器支持说明</Header4>
+        <div>
-      <Text>⚠️ 手机端浏览器支持有限，请使用最新版本的 Chrome 或 Firefox 官方浏览器。</Text>
+          <Header4>可能会遇到的问题包括</Header4>
-      <Text>已知有问题的浏览器：</Text>
+          <ul className="list-disc list-inside pl-2">
-      <UnorderedList>
+            <li>网页白屏</li>
-        <ListItem>Via 浏览器</ListItem>
+            <li>无法下载解密后内容</li>
-        <ListItem>夸克浏览器</ListItem>
+            <li>下载的文件名错误</li>
-        <ListItem>UC 浏览器</ListItem>
+          </ul>
-      </UnorderedList>
+        </div>
-      <Text>可能会遇到的问题包括：</Text>
+      </div>
-      <UnorderedList>
-        <ListItem>网页白屏</ListItem>
-        <ListItem>无法下载解密后内容</ListItem>
-        <ListItem>下载的文件名错误</ListItem>
-      </UnorderedList>
 
-      <Header4>安卓: root 相关说明</Header4>
+      <Header3 id="android-root">安卓 root</Header3>
-      <Text>
+      <p>
         对安卓设备获取 root 特权通常会破坏系统的完整性并导致部分功能无法使用。
-        例如部分厂商的安卓设备会在解锁后丧失保修资格，或导致无法使用 NFC 移动支付功能等限制。
+        例如部分厂商的安卓设备会在解锁后丧失保修资格，或导致无法使用 NFC 移动支付等限制。
-      </Text>
+      </p>
-      <Text>如果希望不破坏系统完整性，你可以考虑使用模拟器。</Text>
+      <p className="my-2">
-      <Text>
+        如果希望不破坏系统完整性，你可以考虑在电脑上使用
-        目前常见的带有 root 特权支持的的安卓模拟器方案，分别是雷电模拟器（※ 官方版有内置广告）和微软在 Windows 11
+        <NavLink className="link link-info" to="/questions/android-emu">
-        开始支援的
+          安卓模拟器
-        <ExtLink href="https://learn.microsoft.com/zh-cn/windows/android/wsa/">
+        </NavLink>
-          <ruby>
-            适用于 Android™ 的 Windows 子系统 (WSA)
-            <rp> (</rp>
-            <rt>
-              <code>Windows Subsystem for Android</code>
-            </rt>
-            <rp>)</rp>
-          </ruby>
-        </ExtLink>
         。
-      </Text>
+      </p>
 
-      <Container p={2}>
+      <Header3 id="projects">相关项目</Header3>
-        <Alert status="warning" borderRadius={5}>
+      <ul className="list-disc pl-6">
-          <AlertIcon />
+        <li>
-          <Flex flexDir="column">
+          <p>
-            <Text>
+            <ExtLink className="mr-2" href="https://github.com/CarlGao4/um-react-electron">
-              <strong>注意</strong>：根据应用的风控策略，使用模拟器登录的账号<strong>有可能会导致账号被封锁</strong>
-              {'；使用前请自行评估风险。'}
-            </Text>
-          </Flex>
-        </Alert>
-      </Container>
-
-      <UnorderedList>
-        <ListItem>
-          <Text>
-            {'WSA 可以参考 '}
-            <ExtLink href="https://github.com/LSPosed/MagiskOnWSALocal">MagiskOnWSALocal</ExtLink>
-            {' 的说明操作。'}
-          </Text>
-        </ListItem>
-        <ListItem>
-          <Text>
-            雷电模拟器可以在<VQuote>模拟器设置</VQuote> → <VQuote>其他设置</VQuote>中启用 root 特权。
-          </Text>
-          <Img borderRadius={5} border="1px solid #ccc" src={LdPlayerSettingsScreen}></Img>
-        </ListItem>
-      </UnorderedList>
-
-      <Header4>相关项目</Header4>
-      <UnorderedList>
-        <ListItem>
-          <Text>
-            <ExtLink href="https://github.com/CarlGao4/um-react-electron">
               <strong>
-                <Code>um-react-electron</Code>
+                <code>um-react-electron</code>
               </strong>
             </ExtLink>
-            ：利用 Electron 框架打包的本地版，提供适用于 Windows、Linux 和 Mac 平台的可执行文件。
+            利用 Electron 框架打包的本地版，提供适用于 Windows、Linux 和 Mac 平台的可执行文件。
-          </Text>
+          </p>
-          <UnorderedList>
+          <ul className="list-disc pl-6">
-            <ListItem>
+            <li>
-              <Text>
+              <p>
                 <ExtLink href="https://github.com/CarlGao4/um-react-electron/releases/latest">GitHub 下载</ExtLink>
-              </Text>
+              </p>
-            </ListItem>
+            </li>
-          </UnorderedList>
+          </ul>
-        </ListItem>
+        </li>
-        <ListItem>
+        <li>
-          <Text>
+          <p>
-            <ExtLink href="https://git.unlock-music.dev/um/um-react-wry">
+            <ExtLink className="mr-2" href="https://git.um-react.app/um/um-react-wry">
               <strong>
-                <Code>um-react-wry</Code>
+                <code>um-react-wry</code>
               </strong>
             </ExtLink>
-            : 使用 WRY 框架封装的 Win64 单文件（需要
+            使用 WRY 框架封装的 Win64 单文件（需要
             <ExtLink href="https://go.microsoft.com/fwlink/p/?LinkId=2124703">安装 Edge WebView2 运行时</ExtLink>
             {'，Win10+ 操作系统自带）'}
-          </Text>
+          </p>
-          <UnorderedList>
+          <ul className="list-disc pl-6">
-            <ListItem>
+            <li>
-              <Text>
+              <p>
-                <ExtLink href="https://git.unlock-music.dev/um/um-react/releases/latest">仓库下载</ExtLink>
+                <ExtLink href="https://git.um-react.app/um/um-react/releases/latest">仓库下载</ExtLink>
                 {' | 寻找文件名为 '}
-                <Code>um-react-win64-</Code> 开头的附件
+                <code>um-react-win64-</code> 开头的附件
-              </Text>
+              </p>
-            </ListItem>
+            </li>
-          </UnorderedList>
+          </ul>
-        </ListItem>
+        </li>
-      </UnorderedList>
+      </ul>
 
-      <Header4>有更多问题？</Header4>
+      <Header3 id="more-questions">有更多问题？</Header3>
-      <Text>
+      <p className="flex flex-row gap-1">
-        {'欢迎进入 '}
+        欢迎加入
-        <ExtLink href={'https://t.me/unlock_music_chat'}>Telegram “音乐解锁-交流” 交流群</ExtLink>
+        <ExtLink href={'https://t.me/unlock_music_chat'}>“音乐解锁-交流” 交流群</ExtLink>
-        {' 一起探讨。'}
+        一起讨论。
-      </Text>
+      </p>
     </>
   );
 }

src/faq/QQMusicFAQ.tsx

@@ -1,159 +1,25 @@
-import { Accordion, AccordionButton, AccordionIcon, AccordionItem, AccordionPanel, Box } from '@chakra-ui/react';
+import { Header2, Header3 } from '~/components/HelpText/Headers';
-import { Alert, AlertIcon, Container, Flex, ListItem, Text, UnorderedList } from '@chakra-ui/react';
-import { Header4 } from '~/components/HelpText/Headers';
 import { SegmentTryOfficialPlayer } from './SegmentTryOfficialPlayer';
-import { SegmentKeyImportInstructions } from './SegmentKeyImportInstructions';
+import { QMCv2QQMusicAllInstructions } from '~/features/settings/panels/QMCv2/QMCv2QQMusicAllInstructions';
-import { ExtLink } from '~/components/ExtLink';
-import { AndroidADBPullInstruction } from '~/components/AndroidADBPullInstruction/AndroidADBPullInstruction';
-import { InstructionsIOS } from '~/features/settings/panels/QMCv2/InstructionsIOS';
-import { InstructionsMac } from '~/features/settings/panels/QMCv2/InstructionsMac';
 
 export function QQMusicFAQ() {
   return (
     <>
-      <Header4>解锁失败</Header4>
+      <Header2>QQ 音乐</Header2>
+      <Header3 id="failed">解锁失败</Header3>
       <SegmentTryOfficialPlayer />
-      <Text>重复下载同一首的歌曲不重复扣下载配额，但是同一首歌的两个版本会重复扣下载配额，请仔细分辨。</Text>
+      <p className="mb-2">新版本的 QQ 音乐客户端下载的文件通常都需要导入密钥数据库。</p>
-      <Text>
+      <p className="mb-2">每一个资源（即一首歌的某个音质）都有独立的密钥，下载音乐时会被写出到密钥数据库中。</p>
+      <p className="mb-2">因此若是解密失败，很有可能是因为你需要导入密钥，或降级客户端。</p>
+
+      <Header3 id="about-download">关于下载</Header3>
+      <p>重复下载同一首的歌曲不重复扣下载配额，但是同一首歌的两个版本会重复扣下载配额，请仔细分辨。</p>
+      <p className="my-2">
         部分平台获取的加密文件未包含密钥。选择你<strong>下载文件时</strong>使用的客户端来查看说明。
-      </Text>
+      </p>
-      <Accordion allowToggle my={2}>
-        <AccordionItem>
-          <h2>
-            <AccordionButton>
-              <Box as="span" flex="1" textAlign="left">
-                Windows
-              </Box>
-              <AccordionIcon />
-            </AccordionButton>
-          </h2>
-          <AccordionPanel pb={4}>
-            <Text>
-              目前 Windows 客户端 19.51 或更低版本下载的歌曲文件无需密钥，其余平台的官方正式版本均需要提取密钥。
-            </Text>
-            <Text>你可以通过下方的链接获取 QQ 音乐 Windows 客户端 v19.51 的安装程序：</Text>
-            <UnorderedList pl={3}>
-              <ListItem>
-                <Text>
-                  <ExtLink href="https://dldir1v6.qq.com/music/clntupate/QQMusic_Setup_1951.exe">
-                    <code>qq.com</code> 官方下载地址（推荐）
-                  </ExtLink>
-                </Text>
-              </ListItem>
-              <ListItem>
-                <Text>
-                  <ExtLink href="https://web.archive.org/web/2023/https://dldir1v6.qq.com/music/clntupate/QQMusic_Setup_1951.exe">
-                    <code>Archive.org</code> 存档
-                  </ExtLink>
-                </Text>
-              </ListItem>
-            </UnorderedList>
-          </AccordionPanel>
-        </AccordionItem>
 
-        <AccordionItem>
+      <Header3 id="keys-or-downgrade">导入密钥或降级客户端</Header3>
-          <h2>
+      <QMCv2QQMusicAllInstructions />
-            <AccordionButton>
-              <Box as="span" flex="1" textAlign="left">
-                Mac
-              </Box>
-              <AccordionIcon />
-            </AccordionButton>
-          </h2>
-          <AccordionPanel pb={4}>
-            <Container p={2}>
-              <Alert status="warning" borderRadius={5}>
-                <AlertIcon />
-                <Flex flexDir="column">
-                  <Text>Mac 需要降级到 8.8.0 或以下版本。</Text>
-                  <Text>
-                    <ExtLink href="https://web.archive.org/web/20230903/https://dldir1.qq.com/music/clntupate/mac/QQMusicMac_Mgr.dmg">
-                      <code>Archive.org</code> 存档
-                    </ExtLink>
-                  </Text>
-                </Flex>
-              </Alert>
-            </Container>
-
-            <SegmentKeyImportInstructions
-              tab="QMCv2 密钥"
-              keyInstructionText="查看密钥提取说明："
-              clientInstructions={
-                <Box p={2}>
-                  <InstructionsMac />
-                </Box>
-              }
-            />
-          </AccordionPanel>
-        </AccordionItem>
-
-        <AccordionItem>
-          <h2>
-            <AccordionButton>
-              <Box as="span" flex="1" textAlign="left">
-                安卓 (Android)
-              </Box>
-              <AccordionIcon />
-            </AccordionButton>
-          </h2>
-          <AccordionPanel pb={4}>
-            <Container p={2}>
-              <Alert status="warning" borderRadius={5}>
-                <AlertIcon />
-                <Flex flexDir="column">
-                  <Text>安卓提取密钥需要 root 特权，建议用电脑操作。</Text>
-                </Flex>
-              </Alert>
-            </Container>
-
-            <Text>QQ 音乐官方版本需要提取密钥才能解密。</Text>
-            <Text>
-              你也可以尝试使用【QQ 音乐简洁版】或 OEM 定制版（如小米、魅族定制版）。简洁、定制版本目前不需要提取密钥。
-            </Text>
-
-            <SegmentKeyImportInstructions
-              tab="QMCv2 密钥"
-              keyInstructionText="查看密钥提取说明："
-              clientInstructions={
-                <Box p={2}>
-                  <AndroidADBPullInstruction dir="/data/data/com.tencent.qqmusic/databases" file="player_process_db" />
-                </Box>
-              }
-            />
-          </AccordionPanel>
-        </AccordionItem>
-
-        <AccordionItem>
-          <h2>
-            <AccordionButton>
-              <Box as="span" flex="1" textAlign="left">
-                iOS (iPhone, iPad)
-              </Box>
-              <AccordionIcon />
-            </AccordionButton>
-          </h2>
-          <AccordionPanel pb={4}>
-            <Container p={2}>
-              <Alert status="warning" borderRadius={5}>
-                <AlertIcon />
-                <Flex flexDir="column">
-                  <Text>iOS 用户提取歌曲困难，建议换用电脑操作；</Text>
-                </Flex>
-              </Alert>
-            </Container>
-
-            <SegmentKeyImportInstructions
-              tab="QMCv2 密钥"
-              keyInstructionText="查看密钥提取说明："
-              clientInstructions={
-                <Box p={2}>
-                  <InstructionsIOS />
-                </Box>
-              }
-            />
-          </AccordionPanel>
-        </AccordionItem>
-      </Accordion>
     </>
   );
 }

src/faq/SegmentAddKeyDropdown.tsx

@@ -1,24 +1,13 @@
-import { Flex, IconButton } from '@chakra-ui/react';
+import { MdFileUpload } from 'react-icons/md';
-import { MdExpandMore } from 'react-icons/md';
-import { HiWord } from '~/components/HelpText/HiWord';
-import { VQuote } from '~/components/HelpText/VQuote';
 
 export function SegmentAddKeyDropdown() {
   return (
-    <Flex as="span" alignItems="center" flexWrap="wrap">
+    <span className="inline-flex items-center flex-wrap">
-      按下<VQuote>添加一条密钥</VQuote>按钮
+      按下
-      <HiWord>右侧</HiWord>的
+      <button type="button" className="btn flex items-center gap-2">
-      <IconButton
+        <MdFileUpload className="text-lg" />
-        colorScheme="purple"
+        导入数据库…
-        variant="outline"
+      </button>
-        size="sm"
+    </span>
-        icon={<MdExpandMore />}
-        ml="2"
-        borderTopLeftRadius={0}
-        borderBottomLeftRadius={0}
-        pointerEvents="none"
-        aria-label="下拉按钮"
-      />
-    </Flex>
   );
 }

src/faq/SegmentKeyImportInstructions.tsx

@@ -1,9 +1,7 @@
-import { Flex, Icon, ListItem, OrderedList, Tabs, Text } from '@chakra-ui/react';
 import { SegmentTopNavSettings } from './SegmentTopNavSettings';
 import { VQuote } from '~/components/HelpText/VQuote';
 import { SegmentAddKeyDropdown } from './SegmentAddKeyDropdown';
 import React from 'react';
-import { MdFileUpload } from 'react-icons/md';
 
 export interface SegmentKeyImportInstructionsProps {
   clientInstructions: React.ReactNode;
@@ -18,32 +16,22 @@ export function SegmentKeyImportInstructions({
 }: SegmentKeyImportInstructionsProps) {
   return (
     <>
-      <Text>导入密钥可以参考下面的步骤：</Text>
+      <p className="mt-2">导入密钥可以参考下面的步骤：</p>
-      <OrderedList>
+      <ol className="list-decimal pl-5">
-        <ListItem>
+        <li>
           <SegmentTopNavSettings />
-        </ListItem>
+        </li>
-        <ListItem>
+        <li>
           设定区域选择<VQuote>{tab}</VQuote>
-        </ListItem>
+        </li>
-        <ListItem>
+        <li>
           <SegmentAddKeyDropdown />
-        </ListItem>
+        </li>
-        <ListItem>
+        <li>
-          <Flex flexDir="row" alignItems="center">
+          <p className="mb-2">{keyInstructionText}</p>
-            {'选择 '}
+          {clientInstructions}
-            <VQuote>
+        </li>
-              <Icon as={MdFileUpload} boxSize={5} mr={2} /> 从文件导入密钥…
+      </ol>
-            </VQuote>
-          </Flex>
-        </ListItem>
-        <ListItem>
-          <Text>{keyInstructionText}</Text>
-          <Tabs display="flex" flexDir="column" border="1px solid" borderColor="gray.300" borderRadius={5}>
-            {clientInstructions}
-          </Tabs>
-        </ListItem>
-      </OrderedList>
     </>
   );
 }

src/faq/SegmentTryOfficialPlayer.tsx

@@ -1,12 +1,10 @@
-import { Alert, AlertIcon, Container } from '@chakra-ui/react';
+import { RiErrorWarningLine } from 'react-icons/ri';
 
-export function SegmentTryOfficialPlayer() {
+export function SegmentTryOfficialPlayer({ className = '' }: { className?: string }) {
   return (
-    <Container p={2} my={2} pt={0}>
+    <div className={`alert alert-warning my-2 ${className}`}>
-      <Alert status="info" borderRadius={5}>
+      <RiErrorWarningLine className="text-2xl" />
-        <AlertIcon />
+      <p>尝试用下载音乐的设备播放一次看看，如果官方客户端都无法播放，那解锁肯定会失败哦。</p>
-        尝试用下载音乐的设备播放一次看看，如果官方客户端都无法播放，那解锁肯定会失败哦。
+    </div>
-      </Alert>
-    </Container>
   );
 }

src/features/file-listing/AlbumImage.tsx

@@ -1,24 +0,0 @@
-import { Box, Image } from '@chakra-ui/react';
-import noCoverFallbackImageURL from '~/assets/no-cover.svg';
-
-interface AlbumImageProps {
-  url?: string;
-  name?: string;
-}
-
-export function AlbumImage({ name, url }: AlbumImageProps) {
-  const coverAlternativeText = name ? `${name} 的专辑封面` : '专辑封面';
-
-  return (
-    <Box w="160px" h="160px" m="auto">
-      <Image
-        border="2px solid"
-        borderColor="gray.400"
-        borderRadius="50%"
-        objectFit="cover"
-        src={url || noCoverFallbackImageURL}
-        alt={coverAlternativeText}
-      />
-    </Box>
-  );
-}

src/features/file-listing/FileError.tsx

@@ -1,5 +1,6 @@
-import { Box, Button, chakra, Collapse, Text, useDisclosure } from '@chakra-ui/react';
+import { toast } from 'react-toastify';
 import { DecryptErrorType } from '~/decrypt-worker/util/DecryptError';
+import { applyTemplate } from '~/util/applyTemplate';
 
 export interface FileErrorProps {
   error: null | string;
@@ -7,33 +8,55 @@ export interface FileErrorProps {
 }
 
 const errorMap = new Map<string | null | DecryptErrorType, string>([
-  [DecryptErrorType.UNSUPPORTED_FILE, '尚未支持的文件格式'],
+  [DecryptErrorType.UNSUPPORTED_FILE, '不支持的文件类型'],
 ]);
 
+const ERROR_TEMPLATE = `解密错误：{{summary}}
+
+详细错误信息：
+\`\`\`text
+{{error}}
+\`\`\`
+
+<!-- 报告错误时请提交上述【全部内容】 -->
+`;
+
 export function FileError({ error, code }: FileErrorProps) {
-  const { isOpen, onToggle } = useDisclosure();
+  const summary = errorMap.get(code) ?? '未知错误';
-  const errorSummary = errorMap.get(code) ?? '未知错误';
+
+  const copyError = () => {
+    if (error) {
+      navigator.clipboard
+        .writeText(applyTemplate(ERROR_TEMPLATE, { summary, error }))
+        .then(() => {
+          toast.success('错误信息已复制到剪贴板');
+        })
+        .catch((e) => {
+          toast.error(`复制错误信息失败: ${e}`);
+        });
+    }
+  };
 
   return (
-    <Box>
+    <>
-      <Text>
+      <p>
-        <chakra.span>
+        解密错误：
-          解密错误：
+        <span className="text-red-600">{summary}</span>
-          <chakra.span color="red.700">{errorSummary}</chakra.span>
+      </p>
-        </chakra.span>
-        {error && (
-          <Button ml="2" onClick={onToggle} type="button">
-            诊断信息
-          </Button>
-        )}
-      </Text>
       {error && (
-        <Collapse in={isOpen} animateOpacity>
+        <div className="collapse border-error border w-full text-left my-2 py-0">
-          <Box as="pre" display="inline-block" mt="2" px="4" py="2" bg="red.100" color="red.800" rounded="md">
+          <input className="[&&&]:py-2 [&&&]:min-h-[1.5rem]" type="checkbox" />
-            {error}
+          <div className="collapse-title font-semibold text-center [&&&]:min-h-[1.5rem] [&&&]:py-2">详细错误信息</div>
-          </Box>
+          <div className="collapse-content text-sm overflow-hidden">
-        </Collapse>
+            <pre className="overflow-x-auto w-full">{error}</pre>
+            <p className="mt-2 text-center">
+              <button type="button" className="btn btn-secondary" onClick={copyError}>
+                复制
+              </button>
+            </p>
+          </div>
+        </div>
       )}
-    </Box>
+    </>
   );
 }

src/features/file-listing/FileListing.tsx

@@ -1,5 +1,3 @@
-import { VStack } from '@chakra-ui/react';
-
 import { selectFiles } from './fileListingSlice';
 import { useAppSelector } from '~/hooks';
 import { FileRow } from './FileRow';
@@ -8,10 +6,10 @@ export function FileListing() {
   const files = useAppSelector(selectFiles);
 
   return (
-    <VStack>
+    <div className="flex flex-row flex-wrap gap-8">
       {Object.entries(files).map(([id, file]) => (
         <FileRow key={id} id={id} file={file} />
       ))}
-    </VStack>
+    </div>
   );
 }

src/features/file-listing/FileRow.tsx

@@ -1,24 +1,7 @@
-import { useRef } from 'react';
-import {
-  Box,
-  Button,
-  Card,
-  CardBody,
-  Collapse,
-  GridItem,
-  Link,
-  VStack,
-  Wrap,
-  WrapItem,
-  useDisclosure,
-} from '@chakra-ui/react';
-import { FileRowResponsiveGrid } from './FileRowResponsiveGrid';
 import { DecryptedAudioFile, deleteFile, ProcessState } from './fileListingSlice';
 import { useAppDispatch } from '~/hooks';
-import { AnimationDefinition } from 'framer-motion';
-import { AlbumImage } from './AlbumImage';
-import { SongMetadata } from './SongMetadata';
 import { FileError } from './FileError';
+import classNames from 'classnames';
 
 interface FileRowProps {
   id: string;
@@ -26,90 +9,46 @@ interface FileRowProps {
 }
 
 export function FileRow({ id, file }: FileRowProps) {
-  const { isOpen, onClose } = useDisclosure({ defaultIsOpen: true });
   const dispatch = useAppDispatch();
   const isDecrypted = file.state === ProcessState.COMPLETE;
-  const metadata = file.metadata;
 
-  const nameWithoutExt = file.fileName.replace(/\.[a-z\d]{3,6}$/, '');
+  const decryptedName = file.cleanName + '.' + file.ext;
-  const decryptedName = nameWithoutExt + '.' + file.ext;
-
-  const audioPlayerRef = useRef<HTMLAudioElement>(null);
-  const togglePlay = () => {
-    const player = audioPlayerRef.current;
-    if (!player) {
-      return;
-    }
-
-    if (player.paused) {
-      player.play();
-    } else {
-      player.pause();
-    }
-  };
-
-  const onCollapseAnimationComplete = (definition: AnimationDefinition) => {
-    if (definition === 'exit') {
-      dispatch(deleteFile({ id }));
-    }
-  };
 
   return (
-    <Collapse
+    <div className="card bg-base-100 dark:bg-gray-700 shadow-sm w-full md:w-[30%] " data-testid="file-row">
-      in={isOpen}
+      <div className="card-body items-center text-center px-2">
-      animateOpacity
+        <h2 className="card-title max-w-full whitespace-nowrap flex gap-0" data-testid="audio-meta-song-name">
-      unmountOnExit
+          <span className="grow overflow-hidden text-ellipsis" title={decryptedName}>
-      startingHeight={0}
+            {file.cleanName}
-      onAnimationComplete={onCollapseAnimationComplete}
+          </span>
-      style={{ width: '100%', padding: '0.25rem' }}
+          {isDecrypted && file.ext && <div className="ml-2 badge badge-accent">{file.ext}</div>}
-    >
+        </h2>
-      <Card w="full" data-testid="file-row">
-        <CardBody>
-          <FileRowResponsiveGrid>
-            <GridItem area="cover">
-              <AlbumImage name={metadata?.album} url={metadata?.cover} />
-            </GridItem>
-            <GridItem area="title">
-              <Box w="full" as="h4" fontWeight="semibold" mt="1" textAlign={{ base: 'center', md: 'left' }}>
-                <span data-testid="audio-meta-song-name">{metadata?.name ?? nameWithoutExt}</span>
-              </Box>
-            </GridItem>
-            <GridItem area="meta">
-              {isDecrypted && metadata && <SongMetadata metadata={metadata} />}
-              {file.state === ProcessState.ERROR && <FileError error={file.errorMessage} code={file.errorCode} />}
-            </GridItem>
-            <GridItem area="action" alignSelf="center">
-              <VStack>
-                {file.decrypted && <audio controls autoPlay={false} src={file.decrypted} ref={audioPlayerRef} />}
 
-                <Wrap>
+        <div className="w-full grow">
-                  {isDecrypted && (
+          {file.state === ProcessState.ERROR && <FileError error={file.errorMessage} code={file.errorCode} />}
-                    <>
+          {isDecrypted && (
-                      <WrapItem>
+            <audio className="w-full" aria-disabled={!file.decrypted} controls autoPlay={false} src={file.decrypted} />
-                        <Button type="button" onClick={togglePlay}>
+          )}
-                          播放/暂停
+        </div>
-                        </Button>
+
-                      </WrapItem>
+        <div className="card-actions justify-end">
-                      <WrapItem>
+          <a
-                        {file.decrypted && (
+            href={file.decrypted}
-                          <Link href={file.decrypted} download={decryptedName}>
+            download={decryptedName}
-                            <Button as="span">下载</Button>
+            title={`下载: ${decryptedName}`}
-                          </Link>
+            className={classNames('btn', {
-                        )}
+              'btn-primary': file.decrypted,
-                      </WrapItem>
+              'cursor-not-allowed pointer-events-none': !file.decrypted,
-                    </>
+            })}
-                  )}
+            data-testid="audio-download"
-                  <WrapItem>
+          >
-                    <Button type="button" onClick={onClose}>
+            下载
-                      删除
+          </a>
-                    </Button>
+          <button type="button" className="btn btn-error" onClick={() => dispatch(deleteFile({ id }))}>
-                  </WrapItem>
+            删除
-                </Wrap>
+          </button>
-              </VStack>
+        </div>
-            </GridItem>
+      </div>
-          </FileRowResponsiveGrid>
+    </div>
-        </CardBody>
-      </Card>
-    </Collapse>
   );
 }

src/features/file-listing/FileRowResponsiveGrid.tsx

@@ -1,27 +0,0 @@
-import { Grid, chakra } from '@chakra-ui/react';
-
-export const FileRowResponsiveGrid = chakra(Grid, {
-  baseStyle: {
-    gridTemplateAreas: {
-      base: `
-        "cover"
-        "title"
-        "meta"
-        "action"
-      `,
-      md: `
-        "cover title action"
-        "cover meta  action"
-      `,
-    },
-    gridTemplateRows: {
-      base: 'repeat(auto-fill)',
-      md: 'min-content 1fr',
-    },
-    gridTemplateColumns: {
-      base: '1fr',
-      md: '160px 1fr',
-    },
-    gap: 3,
-  },
-});

src/features/file-listing/SongMetadata.tsx

@@ -1,22 +0,0 @@
-import { Box, Text } from '@chakra-ui/react';
-import type { AudioMetadata } from './fileListingSlice';
-
-export interface SongMetadataProps {
-  metadata: AudioMetadata;
-}
-
-export function SongMetadata({ metadata }: SongMetadataProps) {
-  return (
-    <Box>
-      <Text>
-        专辑: <span data-testid="audio-meta-album-name">{metadata.album}</span>
-      </Text>
-      <Text>
-        艺术家: <span data-testid="audio-meta-song-artist">{metadata.artist}</span>
-      </Text>
-      <Text>
-        专辑艺术家: <span data-testid="audio-meta-album-artist">{metadata.albumArtist}</span>
-      </Text>
-    </Box>
-  );
-}

src/features/file-listing/__tests__/FileListing.test.tsx

@@ -14,5 +14,5 @@ test('should be able to render a list of 3 items', () => {
   });
 
   expect(screen.getAllByTestId('file-row')).toHaveLength(3);
-  expect(screen.getByText('Für Alice')).toBeInTheDocument();
+  expect(screen.getByText('ready')).toBeInTheDocument();
 });

src/features/file-listing/__tests__/FileRow.test.tsx

@@ -3,22 +3,15 @@ import { untouchedFile } from './__fixture__/file-list';
 import { FileRow } from '../FileRow';
 import { completedFile } from './__fixture__/file-list';
 
-test('should render no metadata when unavailable', () => {
+test('should render basic title (ready)', () => {
   renderWithProviders(<FileRow id="file://ready" file={untouchedFile} />);
 
   expect(screen.getAllByTestId('file-row')).toHaveLength(1);
   expect(screen.getByTestId('audio-meta-song-name')).toHaveTextContent('ready');
-  expect(screen.queryByTestId('audio-meta-album-name')).toBeFalsy();
-  expect(screen.queryByTestId('audio-meta-song-artist')).toBeFalsy();
-  expect(screen.queryByTestId('audio-meta-album-artist')).toBeFalsy();
 });
 
-test('should render metadata when file has been processed', () => {
+test('should render basic title (done)', () => {
   renderWithProviders(<FileRow id="file://done" file={completedFile} />);
 
   expect(screen.getAllByTestId('file-row')).toHaveLength(1);
-  expect(screen.getByTestId('audio-meta-song-name')).toHaveTextContent('Für Alice');
-  expect(screen.getByTestId('audio-meta-album-name')).toHaveTextContent("NOW That's What I Call Cryptography 2023");
-  expect(screen.getByTestId('audio-meta-song-artist')).toHaveTextContent('Jixun');
-  expect(screen.getByTestId('audio-meta-album-artist')).toHaveTextContent('Cipher Lovers');
 });

src/features/file-listing/__tests__/__fixture__/file-list.ts

@@ -1,6 +1,7 @@
 import { DecryptedAudioFile, ProcessState } from '../../fileListingSlice';
 
 export const untouchedFile: DecryptedAudioFile = {
+  cleanName: 'ready',
   fileName: 'ready.bin',
   raw: 'blob://localhost/file-a',
   decrypted: '',
@@ -13,6 +14,7 @@ export const untouchedFile: DecryptedAudioFile = {
 
 export const completedFile: DecryptedAudioFile = {
   fileName: 'hello-b.bin',
+  cleanName: 'hello-b',
   raw: 'blob://localhost/file-b',
   decrypted: 'blob://localhost/file-b-decrypted',
   ext: 'flac',
@@ -30,6 +32,7 @@ export const completedFile: DecryptedAudioFile = {
 
 export const fileWithError: DecryptedAudioFile = {
   fileName: 'hello-c.bin',
+  cleanName: 'hello-c',
   raw: 'blob://localhost/file-c',
   decrypted: 'blob://localhost/file-c-decrypted',
   ext: 'flac',

src/features/file-listing/fileListingSlice.ts

@@ -6,12 +6,20 @@ import { DECRYPTION_WORKER_ACTION_NAME, type DecryptionResult } from '~/decrypt-
 import type {
   DecryptCommandOptions,
   FetchMusicExNamePayload,
+  ParseKugouHeaderPayload,
+  ParseKugouHeaderResponse,
   ParseKuwoHeaderPayload,
   ParseKuwoHeaderResponse,
 } from '~/decrypt-worker/types';
 import { decryptionQueue, workerClientBus } from '~/decrypt-worker/client';
 import { DecryptErrorType } from '~/decrypt-worker/util/DecryptError';
-import { selectKWMv2Key, selectQMCv2KeyByFileName, selectQtfmAndroidKey } from '../settings/settingsSelector';
+import {
+  selectKugouKey,
+  selectKWMv2Key,
+  selectQMCv2KeyByFileName,
+  selectQtfmAndroidKey,
+} from '../settings/settingsSelector';
+import { cleanFilename } from '~/util/cleanFilename';
 
 export enum ProcessState {
   QUEUED = 'QUEUED',
@@ -35,6 +43,7 @@ export interface AudioMetadata {
 
 export interface DecryptedAudioFile {
   fileName: string;
+  cleanName: string;
   raw: string; // blob uri
   ext: string;
   decrypted: string; // blob uri
@@ -70,7 +79,7 @@ export const processFile = createAsyncThunk<
     thunkAPI.dispatch(setFileAsProcessing({ id: fileId }));
   };
 
-  const [qmcv2MusicExMediaFile, kuwoHdr] = await Promise.all([
+  const [qmcv2MusicExMediaFile, kuwoHdr, kugouHdr] = await Promise.all([
     workerClientBus.request<string, FetchMusicExNamePayload>(DECRYPTION_WORKER_ACTION_NAME.FIND_QMC_MUSICEX_NAME, {
       blobURI: file.raw,
     }),
@@ -78,12 +87,17 @@ export const processFile = createAsyncThunk<
       DECRYPTION_WORKER_ACTION_NAME.KUWO_PARSE_HEADER,
       { blobURI: file.raw },
     ),
+    workerClientBus.request<ParseKugouHeaderResponse, ParseKugouHeaderPayload>(
+      DECRYPTION_WORKER_ACTION_NAME.KUGOU_PARSE_HEADER,
+      { blobURI: file.raw },
+    ),
   ]);
 
   const options: DecryptCommandOptions = {
     fileName: file.fileName,
     qmc2Key: selectQMCv2KeyByFileName(state, qmcv2MusicExMediaFile || file.fileName),
     kwm2key: selectKWMv2Key(state, kuwoHdr),
+    kugouKey: selectKugouKey(state, kugouHdr),
     qingTingAndroidKey: selectQtfmAndroidKey(state),
   };
   return decryptionQueue.add({ id: fileId, blobURI: file.raw, options }, onPreProcess);
@@ -96,6 +110,7 @@ export const fileListingSlice = createSlice({
     addNewFile: (state, { payload }: PayloadAction<{ id: string; fileName: string; blobURI: string }>) => {
       state.files[payload.id] = {
         fileName: payload.fileName,
+        cleanName: cleanFilename(payload.fileName),
         raw: payload.blobURI,
         decrypted: '',
         ext: '',

src/features/nav/ResponsiveNav.tsx

@@ -0,0 +1,29 @@
+export interface ResponsiveNavProps {
+  navigationClassName?: string;
+  navigation?: React.ReactNode;
+
+  className?: string;
+
+  contentClassName?: string;
+  children?: React.ReactNode;
+}
+
+export function ResponsiveNav({
+  className = '',
+  navigationClassName = '',
+  contentClassName = '',
+  children,
+  navigation,
+}: ResponsiveNavProps) {
+  return (
+    <div
+      className={`@container/nav grow grid grid-cols-1 grid-rows-[auto_1fr] md:grid-rows-1 md:grid-cols-[10rem_1fr] ${className}`}
+    >
+      {/* Sidebar */}
+      <aside className={`bg-base-100 md:p-4 md:block ${navigationClassName}`}>{navigation}</aside>
+
+      {/* Main content */}
+      <div className={`p-4 grow ${contentClassName}`}>{children}</div>
+    </div>
+  );
+}

src/features/nav/TabNavLink.tsx

@@ -0,0 +1,21 @@
+import classNames from 'classnames';
+import type { RefAttributes } from 'react';
+import { NavLink, type NavLinkProps } from 'react-router';
+
+const tabClassNames = ({ isActive }: { isActive: boolean }) =>
+  classNames(
+    'link inline-flex text-nowrap mb-[-2px] no-underline w-full',
+    'border-b-2 md:border-b-0 md:border-r-2',
+    'tab md:grow',
+    {
+      'tab-active bg-accent/10 border-accent': isActive,
+    },
+  );
+
+export function TabNavLink({ children, ...props }: NavLinkProps & RefAttributes<HTMLAnchorElement>) {
+  return (
+    <NavLink className={tabClassNames} role="tab" {...props}>
+      {children}
+    </NavLink>
+  );
+}

src/features/settings/Settings.tsx

@@ -1,161 +1,75 @@
-import {
-  Box,
-  Button,
-  Center,
-  chakra,
-  Flex,
-  HStack,
-  Icon,
-  IconButton,
-  Menu,
-  MenuButton,
-  MenuItem,
-  MenuList,
-  Portal,
-  Spacer,
-  Tab,
-  TabList,
-  TabPanel,
-  TabPanels,
-  Tabs,
-  Text,
-  useBreakpointValue,
-  useToast,
-  VStack,
-} from '@chakra-ui/react';
-import { PanelQMCv2Key } from './panels/PanelQMCv2Key';
-import { useState } from 'react';
-import { MdExpandMore, MdMenu, MdOutlineSettingsBackupRestore } from 'react-icons/md';
 import { useAppDispatch, useAppSelector } from '~/hooks';
 import { commitStagingChange, discardStagingChanges } from './settingsSlice';
-import { PanelKWMv2Key } from './panels/PanelKWMv2Key';
 import { selectIsSettingsNotSaved } from './settingsSelector';
-import { PanelQingTing } from './panels/PanelQingTing';
+import { Outlet } from 'react-router';
-
+import { SETTINGS_TABS } from '~/features/settings/settingsTabs.tsx';
-const TABS: { name: string; Tab: () => JSX.Element }[] = [
+import { MdOutlineSettingsBackupRestore } from 'react-icons/md';
-  { name: 'QMCv2 密钥', Tab: PanelQMCv2Key },
+import { toast } from 'react-toastify';
-  { name: 'KWMv2 密钥', Tab: PanelKWMv2Key },
+import { ResponsiveNav } from '../nav/ResponsiveNav';
-  { name: '蜻蜓 FM', Tab: PanelQingTing },
+import { TabNavLink } from '../nav/TabNavLink';
-  {
-    name: '其它／待定',
-    Tab: () => <Text>这里空空如也～</Text>,
-  },
-];
 
 export function Settings() {
-  const toast = useToast();
   const dispatch = useAppDispatch();
-  const isLargeWidthDevice =
-    useBreakpointValue({
-      base: false,
-      lg: true,
-    }) ?? false;
 
-  const [tabIndex, setTabIndex] = useState(0);
-  const handleTabChange = (idx: number) => {
-    setTabIndex(idx);
-  };
   const handleResetSettings = () => {
     dispatch(discardStagingChanges());
 
-    toast({
+    toast.info(() => (
-      status: 'info',
+      <div>
-      title: '未储存的设定已舍弃',
+        <h3 className="text-lg font-bold">未储存的设定已舍弃</h3>
-      description: '已还原到更改前的状态。',
+        <p className="text-sm">已还原到更改前的状态。</p>
-      isClosable: true,
+      </div>
-    });
+    ));
   };
   const handleApplySettings = () => {
     dispatch(commitStagingChange());
-    toast({
+    toast.success('设定已应用');
-      status: 'success',
-      title: '设定已应用',
-      isClosable: true,
-    });
   };
   const isSettingsNotSaved = useAppSelector(selectIsSettingsNotSaved);
 
   return (
-    <Flex flexDir="column" flex={1}>
+    <div className="flex flex-col flex-1 container w-full">
-      <Menu>
+      <ResponsiveNav
-        <MenuButton
+        className="grow h-full overflow-auto"
-          as={Button}
+        contentClassName="flex flex-col overflow-auto"
-          leftIcon={<MdMenu />}
+        navigationClassName="overflow-x-auto pb-[2px] md:pb-0 h-full items-start [&]:md:flex"
-          rightIcon={<MdExpandMore />}
+        navigation={
-          colorScheme="gray"
+          <div role="tablist" className="tabs gap-1 flex-nowrap md:flex-col grow items-center">
-          variant="outline"
+            {Object.entries(SETTINGS_TABS).map(([id, { name }]) => (
-          w="full"
+              <TabNavLink key={id} to={`/settings/${id}`}>
-          flexShrink={0}
-          hidden={isLargeWidthDevice}
-          mb="4"
-        >
-          {TABS[tabIndex].name}
-        </MenuButton>
-        <Portal>
-          <MenuList w="100px">
-            {TABS.map(({ name }, i) => (
-              <MenuItem key={name} onClick={() => setTabIndex(i)}>
                 {name}
-              </MenuItem>
+              </TabNavLink>
             ))}
-          </MenuList>
+          </div>
-        </Portal>
+        }
-      </Menu>
-
-      <Tabs
-        orientation={isLargeWidthDevice ? 'vertical' : 'horizontal'}
-        align="start"
-        variant="line-i"
-        display="flex"
-        flex={1}
-        index={tabIndex}
-        onChange={handleTabChange}
       >
-        <TabList hidden={!isLargeWidthDevice} minW="8em" width="8em" textAlign="right" justifyContent="center">
+        <Outlet />
-          {TABS.map(({ name }) => (
+      </ResponsiveNav>
-            <Tab key={name}>{name}</Tab>
-          ))}
-        </TabList>
 
-        <TabPanels>
+      <footer className="flex flex-row gap-2 w-full p-2 border-t border-base-200 bg-base-100">
-          {TABS.map(({ name, Tab }) => (
+        <div className="grow inline-flex items-center">
-            <Flex as={TabPanel} flex={1} flexDir="column" h="100%" key={name}>
+          {isSettingsNotSaved ? (
-              <Flex h="100%" flex={1} minH={0}>
+            <span>
-                <Tab />
+              有未储存的更改，<span className="text-red-600">设定将在保存后生效</span>
-              </Flex>
+            </span>
+          ) : (
+            <span className="text-base-700">设定将在保存后生效</span>
+          )}
+        </div>
 
-              <VStack mt="4" alignItems="flex-start" w="full">
+        <div className="flex flex-row gap-2">
-                <Flex flexDir="row" gap="2" w="full">
+          <button
-                  <Center>
+            className="btn btn-sm btn-ghost text-error"
-                    {isSettingsNotSaved ? (
+            onClick={handleResetSettings}
-                      <Box color="gray">
+            title="放弃未储存的更改，将设定还原未储存前的状态。"
-                        有未储存的更改{' '}
+          >
-                        <chakra.span color="red" wordBreak="keep-all">
+            <MdOutlineSettingsBackupRestore className="size-4" />
-                          设定将在保存后生效
+          </button>
-                        </chakra.span>
+          <button className="btn btn-sm btn-primary" onClick={handleApplySettings}>
-                      </Box>
+            保存
-                    ) : (
+          </button>
-                      <Box color="gray">设定将在保存后生效</Box>
+        </div>
-                    )}
+      </footer>
-                  </Center>
+    </div>
-                  <Spacer />
-                  <HStack gap="2" justifyContent="flex-end">
-                    <IconButton
-                      icon={<Icon as={MdOutlineSettingsBackupRestore} />}
-                      onClick={handleResetSettings}
-                      colorScheme="red"
-                      variant="ghost"
-                      title="放弃未储存的更改，将设定还原未储存前的状态。"
-                      aria-label="放弃未储存的更改"
-                    />
-                    <Button onClick={handleApplySettings}>保存</Button>
-                  </HStack>
-                </Flex>
-              </VStack>
-            </Flex>
-          ))}
-        </TabPanels>
-      </Tabs>
-    </Flex>
   );
 }

src/features/settings/SettingsHome.tsx

@@ -0,0 +1,8 @@
+export function SettingsHome() {
+  return (
+    <div className="flex flex-col gap-4">
+      <h1 className="text-2xl font-bold">设置</h1>
+      <p>在这里你可以设置应用的基本配置。</p>
+    </div>
+  );
+}

src/features/settings/keyFormats.ts

@@ -14,6 +14,7 @@ export function productionKeyToStaging<S, P extends Record<string, unknown>>(
   }
   return result;
 }
+
 export function stagingKeyToProduction<S, P>(src: S[], toKey: (s: S) => keyof P, toValue: (s: S) => P[keyof P]): P {
   return objectify(src, toKey, toValue) as P;
 }
@@ -41,7 +42,6 @@ export const qmc2ProductionToStaging = (
 };
 
 // KWMv2 (KuWo)
-
 export interface StagingKWMv2Key {
   id: string;
   /**
@@ -64,7 +64,7 @@ export const parseKwm2ProductionKey = (key: string): null | { rid: string; quali
 
   return { rid, quality };
 };
-export const kwm2StagingToProductionKey = (key: StagingKWMv2Key) => `${key.rid}-${key.quality.replace(/[\D]/g, '')}`;
+export const kwm2StagingToProductionKey = (key: StagingKWMv2Key) => `${key.rid}-${key.quality.replace(/\D/g, '')}`;
 export const kwm2StagingToProductionValue = (key: StagingKWMv2Key) => key.ekey;
 export const kwm2ProductionToStaging = (
   key: keyof ProductionKWMv2Keys,
@@ -78,3 +78,21 @@ export const kwm2ProductionToStaging = (
 
   return { id: nanoid(), rid, quality, ekey: value };
 };
+
+// KuGou (kgg, kgm v5)
+export interface StagingKugouKey {
+  id: string;
+  audioHash: string;
+  ekey: string;
+}
+
+export type ProductionKugouKey = Record<string /* audioHash */, string /* ekey */>;
+export const kugouStagingToProductionKey = (key: StagingKugouKey) => key.audioHash.normalize();
+export const kugouStagingToProductionValue = (key: StagingKugouKey) => key.ekey.normalize();
+export const kugouProductionToStaging = (
+  key: keyof ProductionKugouKey,
+  value: ProductionKugouKey[keyof ProductionKugouKey],
+): null | StagingKugouKey => {
+  if (typeof value !== 'string') return null;
+  return { id: nanoid(), audioHash: key.normalize(), ekey: value };
+};

src/features/settings/panels/KWMv2/InstructionsIOS.tsx

@@ -1,33 +1,28 @@
-import { Code, ListItem, OrderedList, Text, chakra } from '@chakra-ui/react';
+import { HiWord } from '~/components/HelpText/HiWord';
-
-const KUWO_IOS_DIR = '/var/mobile/Containers/Data/Application/<酷我数据目录>/mmkv';
 
 export function InstructionsIOS() {
   return (
     <>
-      <Text>你需要越狱来访问 iOS 应用的私有数据。</Text>
+      <p>你需要越狱来访问 iOS 应用的私有数据。</p>
-      <Text>
+      <p>
         ⚠️ 请注意，越狱通常意味着你的设备
-        <chakra.span color="red.400">将失去保修资格</chakra.span>。
+        <span className="text-red-600">将失去保修资格</span>。
-      </Text>
+      </p>
-      <OrderedList>
+      <ol className="list-decimal pl-6">
-        <ListItem>
+        <li>
-          <Text>
+          访问设备的这个目录：
-            访问设备的这个目录：
+          <br />
-            <Code wordBreak="break-word">{KUWO_IOS_DIR}</Code>
+          <code className="break-words">
-          </Text>
+            /var/mobile/Containers/Data/Application/<HiWord className="text-nowrap">{'<酷我数据目录>'}</HiWord>/mmkv
-        </ListItem>
+          </code>
-        <ListItem>
+        </li>
-          <Text>
+        <li>
-            提取密钥数据库文件 <Code>kw_ekey</Code> 至浏览器可访问的目录，如下载目录。
+          提取密钥数据库文件 <code>kw_ekey</code> 至浏览器可访问的目录，如下载目录。
-          </Text>
+        </li>
-        </ListItem>
+        <li>
-        <ListItem>
+          提交刚刚提取的 <code>kw_ekey</code> 密钥数据库。
-          <Text>
+        </li>
-            提交刚刚提取的 <Code>kw_ekey</Code> 密钥数据库。
+      </ol>
-          </Text>
-        </ListItem>
-      </OrderedList>
     </>
   );
 }

src/features/settings/panels/KWMv2/InstructionsPC.tsx

@@ -1,9 +1,3 @@
-import { Text } from '@chakra-ui/react';
-
 export function InstructionsPC() {
-  return (
+  return <p>使用 Windows 客户端下载的文件不需要导入密钥。</p>;
-    <>
-      <Text>使用 Windows 客户端下载的文件不需要导入密钥。</Text>
-    </>
-  );
 }

src/features/settings/panels/KWMv2/KWMv2AllInstructions.tsx

@@ -1,30 +1,16 @@
-import { Tab, TabList, TabPanel, TabPanels } from '@chakra-ui/react';
 import { AndroidADBPullInstruction } from '~/components/AndroidADBPullInstruction/AndroidADBPullInstruction';
 import { InstructionsPC } from './InstructionsPC';
 import { InstructionsIOS } from './InstructionsIOS';
+import { InstructionsTabs, InstructionTab } from '~/components/InstructionsTabs';
 
 export function KWMv2AllInstructions() {
-  return (
+  const ANDROID_DIR = '/data/data/cn.kuwo.player/files/mmkv';
-    <>
+  const ANDROID_FILE = 'cn.kuwo.player.mmkv.defaultconfig';
-      <TabList>
+  const tabs: InstructionTab[] = [
-        <Tab>安卓</Tab>
+    { id: 'android', label: '安卓', content: <AndroidADBPullInstruction dir={ANDROID_DIR} file={ANDROID_FILE} /> },
-        <Tab>iOS</Tab>
+    { id: 'ios', label: 'iOS', content: <InstructionsIOS /> },
-        <Tab>Windows</Tab>
+    { id: 'windows', label: 'Windows', content: <InstructionsPC /> },
-      </TabList>
+  ];
-      <TabPanels flex={1} overflow="auto">
+
-        <TabPanel>
+  return <InstructionsTabs tabs={tabs} />;
-          <AndroidADBPullInstruction
-            dir="/data/data/cn.kuwo.player/files/mmkv"
-            file="cn.kuwo.player.mmkv.defaultconfig"
-          />
-        </TabPanel>
-        <TabPanel>
-          <InstructionsIOS />
-        </TabPanel>
-        <TabPanel>
-          <InstructionsPC />
-        </TabPanel>
-      </TabPanels>
-    </>
-  );
 }

src/features/settings/panels/KWMv2/KWMv2EKeyItem.tsx

@@ -1,81 +1,41 @@
-import {
+import { PiFileAudio, PiHash } from 'react-icons/pi';
-  HStack,
-  Icon,
-  IconButton,
-  Input,
-  InputGroup,
-  InputLeftElement,
-  InputRightElement,
-  ListItem,
-  Text,
-  VStack,
-} from '@chakra-ui/react';
-import { MdDelete, MdVpnKey } from 'react-icons/md';
 import { kwm2DeleteKey, kwm2UpdateKey } from '../../settingsSlice';
 import { useAppDispatch } from '~/hooks';
 import { memo } from 'react';
 import { StagingKWMv2Key } from '../../keyFormats';
+import { KeyInput } from '~/components/KeyInput';
 
 export const KWMv2EKeyItem = memo(({ id, ekey, quality, rid, i }: StagingKWMv2Key & { i: number }) => {
   const dispatch = useAppDispatch();
 
-  const updateKey = (prop: keyof StagingKWMv2Key, e: React.ChangeEvent<HTMLInputElement>) =>
+  const ekeyLen = ekey.length;
-    dispatch(kwm2UpdateKey({ id, field: prop, value: e.target.value }));
+  const isValidEKey = ekeyLen === 364 || ekeyLen === 704;
-  const deleteKey = () => dispatch(kwm2DeleteKey({ id }));
 
   return (
-    <ListItem mt={0} pt={2} pb={2} _even={{ bg: 'gray.50' }}>
+    <KeyInput
-      <HStack>
+      name={rid}
-        <Text w="2em" textAlign="center">
+      quality={quality}
-          {i + 1}
+      value={ekey}
-        </Text>
+      isValidKey={isValidEKey}
-
+      onSetName={(value) => dispatch(kwm2UpdateKey({ id, field: 'rid', value }))}
-        <VStack flex={1}>
+      onSetQuality={(value) => dispatch(kwm2UpdateKey({ id, field: 'quality', value }))}
-          <HStack flex={1} w="full">
+      onSetValue={(value) => dispatch(kwm2UpdateKey({ id, field: 'ekey', value }))}
-            <Input
+      onDelete={() => dispatch(kwm2DeleteKey({ id }))}
-              variant="flushed"
+      sequence={i + 1}
-              placeholder="资源 ID"
+      nameLabel={
-              value={rid}
+        <>
-              onChange={(e) => updateKey('rid', e)}
+          ID
-              type="number"
+          <PiHash className="hidden md:inline-block" />
-              maxW="8em"
+        </>
-            />
+      }
-            <Input
+      qualityLabel={
-              variant="flushed"
+        <>
-              placeholder="音质格式"
+          质量 <PiFileAudio className="hidden md:inline-block" />
-              value={quality}
+        </>
-              onChange={(e) => updateKey('quality', e)}
+      }
-              flex={1}
+      namePlaceholder="音频哈希。不建议手动填写。"
-            />
+      qualityPlaceholder="比特率 ID"
-          </HStack>
+      valuePlaceholder="密钥，通常包含 364 或 704 位字符，没有空格。"
-
+    />
-          <InputGroup size="xs">
-            <InputLeftElement pr="2">
-              <Icon as={MdVpnKey} />
-            </InputLeftElement>
-            <Input
-              variant="flushed"
-              placeholder="密钥，通常包含 364 或 704 位字符，没有空格。"
-              value={ekey}
-              onChange={(e) => updateKey('ekey', e)}
-            />
-            <InputRightElement>
-              <Text pl="2" color={ekey.length ? 'green.500' : 'red.500'}>
-                <code>{ekey.length || '?'}</code>
-              </Text>
-            </InputRightElement>
-          </InputGroup>
-        </VStack>
-
-        <IconButton
-          aria-label="删除该密钥"
-          icon={<Icon as={MdDelete} boxSize={6} />}
-          variant="ghost"
-          colorScheme="red"
-          type="button"
-          onClick={deleteKey}
-        />
-      </HStack>
-    </ListItem>
   );
 });

src/features/settings/panels/Kugou/InstructionsPC.tsx

@@ -0,0 +1,48 @@
+import { RiFileCopyLine } from 'react-icons/ri';
+import { toast } from 'react-toastify';
+import { ExtLink } from '~/components/ExtLink';
+import { FilePathBlock } from '~/components/FilePathBlock.tsx';
+
+export function InstructionsPC() {
+  const DB_PATH = '%APPDATA%\\KuGou8\\KGMusicV3.db';
+  const copyDbPathToClipboard = () => {
+    navigator.clipboard
+      .writeText(DB_PATH)
+      .then(() => {
+        toast.success('已复制到剪贴板');
+      })
+      .catch((err) => {
+        toast.error(`复制失败，请手动复制\n${err}`);
+      });
+  };
+
+  return (
+    <>
+      <p>
+        酷狗的 Windows 客户端使用魔改的
+        <ExtLink className="link-info px-1" href="https://www.zetetic.net/sqlcipher/">
+          SQLCipher
+        </ExtLink>
+        来加密储存密钥。
+      </p>
+      <p>该密钥数据库通常位于下述路径：</p>
+      <FilePathBlock>{DB_PATH}</FilePathBlock>
+
+      <h3 className="font-bold text-xl mt-4">导入密钥</h3>
+      <ol className="list-decimal pl-6">
+        <li>
+          <button className="btn btn-sm btn-outline btn-accent mr-2" onClick={copyDbPathToClipboard}>
+            <RiFileCopyLine className="text-xl" />
+            <span>复制</span>
+          </button>
+          <code>KGMusicV3.db</code> 文件路径
+        </li>
+        <li>点击上方的「文件选择区域」，打开「文件选择框」</li>
+        <li>
+          在「文件名」输入框中粘贴之前复制的 <code>KGMusicV3.db</code> 文件路径
+        </li>
+        <li>按下「回车键」确认。</li>
+      </ol>
+    </>
+  );
+}