refactor: major package updates

chore: minor package updates
docs: update highlight styling
2025-11-28 11:33:02 +00:00 · 2025-10-16 01:00:38 +09:00 · 2025-10-15 23:15:00 +09:00 · 2025-10-15 23:12:47 +09:00 · 2025-10-15 23:10:19 +09:00 · 2025-10-15 23:10:12 +09:00
166 changed files with 6769 additions and 5290 deletions
--- a/.dockerignore
+++ b/.dockerignore
@@ -0,0 +1,3 @@
+dist
+node_modules
+*.log
--- a/.eslintignore
+++ b/.eslintignore
@@ -1,3 +0,0 @@
-dist/
-node_modules/
-coverage/
--- a/.eslintrc.cjs
+++ b/.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,
-      },
-    ],
-  },
-};
--- a/.gitea/ISSUE_TEMPLATE/50-qqmusic-android.yaml
+++ b/.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
--- a/.gitea/ISSUE_TEMPLATE/50-qqmusic.yaml
+++ b/.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
--- a/.gitea/ISSUE_TEMPLATE/53-kuwo-android.yaml
+++ b/.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
--- a/.gitea/ISSUE_TEMPLATE/99-default.md
+++ b/.gitea/ISSUE_TEMPLATE/99-default.md
@@ -0,0 +1,4 @@
+---
+name: '其它'
+about: '如果你遇到的问题不符合上述模板的描述，请选择此项。'
+---
--- a/.gitea/ISSUE_TEMPLATE/config.yml
+++ b/.gitea/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1 @@
+blank_issues_enabled: false
--- a/.gitea/workflows/build.yaml
+++ b/.gitea/workflows/build.yaml
@@ -17,16 +17,48 @@ 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"
-          python3 -m zipfile -c um-react-site.zip dist/.
+          ./scripts/make-win64.sh
      - name: Publish Artifact
        uses: christopherhx/gitea-upload-artifact@v4
        with:
          name: site
          path: dist/
+      - name: Create Release Package
+        if: startsWith(github.ref, 'refs/tags/')
+        run: |
+          VERSION=${GITHUB_REF#refs/tags/v}
+          mkdir release/
+          python3 -m zipfile -c "release/um-react-${VERSION}.zip" dist/.
+          cp win64/dist/*.zip "release/um-react-win64-${VERSION}.zip"
+      - name: Create Draft Release
+        if: startsWith(github.ref, 'refs/tags/')
+        uses: akkuman/gitea-release-action@v1
+        with:
+          draft: true
+          files: |
+            release/um-react-*.zip
+          body: |
+            上个版本：[v0.0.0](https://git.um-react.app/um/um-react/releases/tag/v0.0.0)
+
+            ## 🐛 修正
+
+            - 修正内容
+
+            ## ✨ 新增
+
+            - 新增内容
+
+            ## 🔧 维护
+
+            - 维护内容
+      - 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 }}
--- a/.gitignore
+++ b/.gitignore
@@ -32,3 +32,7 @@ dist-ssr
 /um-react*.exe

 /win64/
+
+# Python
+*.py[cod]
+__pycache__
--- a/.npmrc
+++ b/.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/
--- a/.vscode/extensions.json
+++ b/.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",
-    "txava.region-marker",
-    "foxundermoon.shell-format",
-    "jock.svg"
+    "foxundermoon.shell-format"
  ]
 }
--- a/25
+++ b/25
@@ -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"]
--- a/README.MD
+++ b/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]
@@ -10,16 +10,17 @@
 - CI 自动构建已经部署，可以在 [Actions][um-react-actions] 寻找对应的<ruby>构建产物<rp>(</rp><rt>Artifact</rt><rp>)</rp> </ruby>下载。
 - [常见问题参考](./docs/faq_zh-hans.md)

-> **WARNING**
+> [!WARNING]
 > 在本站 fork 不会起到备份的作用，只会浪费服务器储存空间。如无必要请勿 fork 该仓库。

-[授权协议]: https://git.unlock-music.dev/um/um-react/src/branch/main/LICENSE
-[um-vue]: https://git.unlock-music.dev/um/web
-[unlock-music/cli]: https://git.unlock-music.dev/um/cli
+[授权协议]: https://git.um-react.app/um/um-react/src/branch/main/LICENSE
+[um-vue]: https://git.um-react.app/um/web
+[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 官方浏览器。
+> [!TIP]
+> 手机端浏览器支持有限，请使用最新版本的 Chrome 或 Firefox 官方浏览器。

 ## 支持的格式

@@ -31,32 +32,68 @@
  - Mac 客户端 (`.mflach` 等) [^qm-key-mac]
 - [x] 网易云音乐 (`.ncm`)
 - [x] 虾米音乐 (`.xm`)
- [x] 酷我音乐 (`.kwm`)
- [x] 酷狗音乐 (`.kgm` / `.vpr`)
+- [x] 酷我音乐 (`.kwm` / `.mflac`) [^kuwo-key-android]
+- [x] 酷狗音乐 (`.kgm` / `.vpr` / `.kgg`)
+  - PC / 安卓客户端[^kgg-android]的 `kgg` 文件需要提供密钥数据库。
 - [x] 喜马拉雅 (`.x2m` / `.x3m` / `.xm`)
 - [x] 咪咕音乐格式 (`.mg3d`)
 - [x] 蜻蜓 FM (`.qta`)
- [ ] ~~<ruby>QQ 音乐海外版<rt>JOOX Music</rt></ruby> (`.ofl_en`)~~
+  - 需要提取设备 ID。

-[^qm-key-pc]: PC 客户端仅支持 v19.43 或更低版本。
+[^qm-key-pc]: QQ 音乐的 PC 客户端仅支持 v19.51 或更低版本。

-[^qm-key-android]: 需要获取超级管理员权限后提取密钥数据库，并导入后使用。
+[^qm-key-android]: QQ 音乐的安卓客户端支持需要获取超级管理员权限后提取密钥数据库并导入后使用。

-[^qm-key-ios]: 需要越狱获取密钥数据库，或对设备进行完整备份后提取密钥数据库，并导入后使用。
+[^qm-key-ios]: QQ 音乐 iOS 客户端支持需要越狱获取密钥数据库，或对设备进行完整备份后提取密钥数据库并导入后使用。

-[^qm-key-mac]: 需要导入密钥数据库。
+[^qm-key-mac]: QQ 音乐 Mac 客户端支持需要导入密钥数据库，目前支持 v8.8.0 及 v10.7.1。
+
+[^kgg-android]: 酷狗音乐的安卓客户端支持需要获取超级管理员权限后提取密钥数据库并导入后使用。
+
+[^kuwo-key-android]: 酷我音乐的安卓客户端下载的 AI 升频文件需要获取超级管理员权限后提取密钥数据库并导入后使用。

 ## 错误报告

 有不支持的格式？请提交样本（加密文件）与客户端信息版本信息（如系统版本、下载渠道），或一并上传其安装包到[仓库的问题追踪区][project-issues]。

-⚠️ 如果文件太大，请上传到不需要登入下载的网盘，如 [mega.nz](https://mega.nz)、[OneDrive](https://www.onedrive.com/) 等。
+> [!NOTE]
+> 如果文件太大，请上传到不需要登入下载的网盘，如 [mega.nz](https://mega.nz)、[OneDrive](https://www.onedrive.com/) 等。

 遇到解密出错的情况，请一并携带错误信息（诊断信息）并简单描述错误的重现过程。

-待实现的算法支持可[追踪 `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 构建、部署
+
+首先克隆仓库并进入目录：
+
+```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` 即可。
+
+> [!NOTE]
+> 项目不支持运行在子目录下。

 ## 开发相关

@@ -64,7 +101,8 @@

 ### 解密库开发

-⚠️ 如果只是进行前端方面的更改，你可以跳过该节。
+> [!TIP]
+> 如果只是进行前端方面的更改，你可以跳过该节。

 请参考文档「[面向 `@unlock-music/crypto` 开发](./docs/develop-with-um_crypto.zh.md)」。

@@ -87,13 +125,15 @@

 ## 相关项目

- [Unlock Music (Web)](https://git.unlock-music.dev/um/web) - 原始项目
- [Unlock Music (Cli)](https://git.unlock-music.dev/um/cli) - 命令行批量处理版
+- [Unlock Music (Web)](https://git.um-react.app/um/web) - 原始项目
+- [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)
- [um-react-wry](https://git.unlock-music.dev/um/um-react-wry) - 使用 WRY 框架封装的 Win64 单文件 (
+  - [GitHub 下载](https://github.com/CarlGao4/um-react-electron/releases/latest)
+- [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

--- a/docs/develop-with-um_crypto.zh.md
+++ b/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`
--- a/docs/faq_zh-hans.md
+++ b/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)，一起探讨。
--- a/eslint.config.mjs
+++ b/eslint.config.mjs
@@ -0,0 +1,54 @@
+import eslint from '@eslint/js';
+import { defineConfig } from 'eslint/config';
+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 defineConfig(
+  eslint.configs.recommended,
+  tseslint.configs.recommendedTypeChecked,
+  reactRefresh.configs.recommended,
+  reactHooks.configs.flat.recommended,
+  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,
+      },
+    },
+  },
+
+  {
+    languageOptions: {
+      parserOptions: {
+        projectService: {
+          allowDefaultProject: ['*.mjs', 'src/*.mjs', 'scripts/*.mjs'],
+        },
+      },
+    },
+  },
+);
--- a/index.html
+++ b/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>
--- a/package.json
+++ b/package.json
@@ -1,12 +1,12 @@
 {
  "name": "um-react",
  "private": true,
-  "version": "0.3.3",
+  "version": "0.6.0",
  "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,64 @@
    "prepare": "simple-git-hooks"
  },
  "dependencies": {
-    "@chakra-ui/anatomy": "^2.3.4",
-    "@chakra-ui/icons": "^2.2.4",
-    "@chakra-ui/react": "^2.10.4",
-    "@emotion/react": "^11.14.0",
-    "@emotion/styled": "^11.14.0",
-    "@reduxjs/toolkit": "^2.5.0",
-    "@unlock-music/crypto": "0.1.2",
-    "framer-motion": "^11.14.4",
-    "nanoid": "^5.0.9",
-    "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",
+    "@reduxjs/toolkit": "^2.9.0",
+    "@unlock-music/crypto": "^0.1.12",
+    "classnames": "^2.5.1",
+    "nanoid": "^5.1.6",
+    "radash": "^12.1.1",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "react-dropzone": "^14.3.8",
+    "react-icons": "^5.5.0",
    "react-redux": "^9.2.0",
-    "react-syntax-highlighter": "^15.6.1",
-    "sass": "^1.83.0",
-    "sql.js": "^1.12.0"
+    "react-router": "^7.9.4",
+    "react-syntax-highlighter": "^15.6.6",
+    "react-toastify": "^11.0.5",
+    "sql.js": "^1.13.0"
  },
  "devDependencies": {
-    "@rollup/plugin-replace": "^6.0.1",
-    "@testing-library/jest-dom": "^6.6.3",
-    "@testing-library/react": "^16.1.0",
-    "@testing-library/user-event": "^14.5.2",
-    "@types/node": "^22.10.2",
-    "@types/react": "^18.3.16",
-    "@types/react-dom": "^18.3.5",
+    "@eslint/js": "^9.37.0",
+    "@rollup/plugin-replace": "^6.0.2",
+    "@tailwindcss/vite": "^4.1.14",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.0",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/node": "^24.7.2",
+    "@types/react": "^19.2.2",
+    "@types/react-dom": "^19.2.2",
    "@types/react-syntax-highlighter": "^15.5.13",
    "@types/sql.js": "^1.4.9",
-    "@typescript-eslint/eslint-plugin": "^8.18.0",
-    "@typescript-eslint/parser": "^8.18.0",
-    "@vitejs/plugin-react": "^4.3.4",
-    "@vitest/coverage-v8": "^2.1.8",
-    "@vitest/ui": "^2.1.8",
-    "eslint": "^8.57.1",
-    "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-react-hooks": "^4.6.2",
-    "eslint-plugin-react-refresh": "^0.4.16",
+    "@types/tar-stream": "^3.1.4",
+    "@types/wicg-file-system-access": "^2023.10.7",
+    "@typescript-eslint/eslint-plugin": "^8.46.1",
+    "@typescript-eslint/parser": "^8.46.1",
+    "@vitejs/plugin-react": "^5.0.4",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/ui": "^3.2.4",
+    "daisyui": "^5.3.2",
+    "eslint": "^9.37.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-react-hooks": "^7.0.0",
+    "eslint-plugin-react-refresh": "^0.4.24",
+    "globals": "^16.4.0",
    "husky": "^9.1.7",
-    "jsdom": "^25.0.1",
-    "lint-staged": "^15.2.11",
-    "prettier": "^3.4.2",
-    "rollup": "^4.28.1",
-    "simple-git-hooks": "^2.11.1",
-    "terser": "^5.37.0",
-    "typescript": "^5.7.2",
-    "vite": "^5.4.11",
-    "vite-plugin-pwa": "^0.20.5",
-    "vite-plugin-top-level-await": "^1.4.4",
-    "vite-plugin-wasm": "^3.3.0",
-    "vitest": "^2.1.8",
+    "jsdom": "^27.0.0",
+    "lint-staged": "^16.2.4",
+    "prettier": "^3.6.2",
+    "rollup": "^4.52.4",
+    "sass": "^1.93.2",
+    "simple-git-hooks": "^2.13.1",
+    "tailwindcss": "^4.1.14",
+    "tar-stream": "^3.1.7",
+    "terser": "^5.44.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.46.1",
+    "vite": "^7.1.10",
+    "vite-plugin-pwa": "^1.1.0",
+    "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 +92,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"
 }
--- a/patches/sql.js.patch
+++ b/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']) {
- else if (typeof exports === 'object'){
-     exports["Module"] = initSqlJs;
- }
-+
+@@ -173,16 +173,5 @@ if(0<K)Sa=Yc;else{if(f.preRun)for("function"==typeof f.preRun&&(f.preRun=[f.preR
+   return initSqlJsPromise;
+ } // 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;
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
--- a/public/_redirects
+++ b/public/_redirects
@@ -0,0 +1,2 @@
+# Support SPA routing in Netlify
+/* /index.html 200
--- a/scripts/make-win64.sh
+++ b/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}"
-zip -9oX "win64/dist/${ZIP_NAME}" -- "win64/dist/${EXE_NAME}"
+touch -d 1980-01-01T00:00:00Z "win64/dist/${EXE_NAME}"
+zip -9oXj "win64/dist/${ZIP_NAME}" -- "win64/dist/${EXE_NAME}"
 echo "[Build OK] 'win64/dist/${ZIP_NAME}'."

 popd
--- a/scripts/write-version.mjs
+++ b/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');
--- a/src/App.css
+++ b/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;
+}
--- a/src/tests/sanity-check.test.tsx
+++ b/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(/UnlockMusic 团队/i)).toBeInTheDocument();
+  expect(screen.getByText(/音乐解锁/i)).toBeInTheDocument();
+  expect(screen.getByText(/Unlock Music/i)).toBeInTheDocument();
+  expect(screen.getByText(/MIT/i)).toBeInTheDocument();
 });
--- a/src/components/AddKey.tsx
+++ b/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>
+  );
+}
--- a/src/components/AndroidADBPullInstruction/AdbInstructionTemplate.tsx
+++ b/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>
+  );
+}
--- a/src/components/AndroidADBPullInstruction/AndroidADBPullInstruction.tsx
+++ b/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';
-
-const applyTemplate = (tpl: string, values: Record<string, unknown>) => {
-  return tpl.replace(/\{\{\s*(\w+)\s*\}\}/g, (_, key) => (Object.hasOwn(values, key) ? String(values[key]) : '<nil>'));
-};
+import { Ruby } from '../Ruby';
+import { useId } from 'react';
+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 shAdbDumpCommand = applyTemplate(ShellAdbDumpCommandTemplate, { dir, file });
+  const androidInstructionId = useId();

  return (
    <>
-      <Text>
-        你需要
-        <ruby>
-          超级管理员
-          <rp> (</rp>
-          <rt>
-            <code>root</code>
-          </rt>
-          <rp>)</rp>
-        </ruby>
-        访问权限来访问安卓应用的私有数据。
-      </Text>
-      <Text>
+      <p>
+        你需要<Ruby caption="root">超级管理员</Ruby>访问权限来访问安卓应用的私有数据。
+      </p>
+      <p>
        ⚠️ 请注意，获取管理员权限通常意味着你的安卓设备
-        <chakra.span color="red.400">将失去保修资格</chakra.span>。
-      </Text>
+        <HiWord>将失去保修资格</HiWord>。
+      </p>

-      <Accordion allowToggle mt="2">
-        <AccordionItem>
-          <Heading as="h3" size="md">
-            <AccordionButton>
-              <Box as="span" flex="1" textAlign="left">
-                在安卓手机端操作
-              </Box>
-              <AccordionIcon />
-            </AccordionButton>
-          </Heading>
-          <AccordionPanel pb={4}>
-            <OrderedList>
-              <ListItem>
-                <Text>
-                  启动具有 <Code>root</Code> 特权的文件浏览器
-                </Text>
-              </ListItem>
-              <ListItem>
-                <Text>
-                  访问 <Code>{dir}/</Code> 目录。
-                </Text>
-              </ListItem>
-              <ListItem>
-                <Text>
-                  将文件 <Code>{file}</Code> 复制到浏览器可访问的目录。
-                  <br />
-                  （例如下载目录）
-                </Text>
-              </ListItem>
-              <ListItem>
-                <Text>提交该数据库文件。</Text>
-              </ListItem>
-            </OrderedList>
-          </AccordionPanel>
-        </AccordionItem>
-
-        <AccordionItem>
-          <Heading as="h3" size="md">
-            <AccordionButton>
-              <Box as="span" flex="1" textAlign="left">
-                在 PC 端操作（ADB / PowerShell）
-              </Box>
-              <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>
+      <div className="join join-vertical bg-base-100 mt-2 max-w-full">
+        <div className="collapse collapse-arrow join-item border-base-300 border">
+          <input type="radio" name={androidInstructionId} />
+          <div className="collapse-title font-semibold">在安卓手机端操作</div>
+          <div className="collapse-content text-sm min-w-0">
+            <ol className="list-decimal pl-4">
+              <li>
+                启动支持 <code>root</code> 特权的文件浏览器，如 <ExtLink href={URL_AMAZE}>Amaze 文件浏览器</ExtLink>、
+                <ExtLink href={URL_MT2}>MT 管理器</ExtLink> 等。
+              </li>
+              <li>
+                ※ 记得启用 root 特权！
+                <RootExplorerGuide />
+              </li>
+              <li>
+                <p>
+                  访问 <code>{dir}/</code> 目录。
+                </p>
+                <p>※ 从侧边栏选择根目录开始。</p>
+              </li>
+              <li>
+                将文件 <code>{file}</code> 复制到浏览器可访问的目录（例如下载目录）。
+              </li>
+              <li>提交该数据库文件。</li>
+            </ol>
+          </div>
+        </div>
+        <div className="collapse collapse-arrow join-item border-base-300 border">
+          <input type="radio" name={androidInstructionId} />
+          <div className="collapse-title font-semibold">在 PC 端操作（使用 ADB / PowerShell）</div>
+          <div className="collapse-content text-sm min-w-0">
+            <AdbInstructionTemplate dir={dir} file={file} platform="win32" />
+          </div>
+        </div>
+        <div className="collapse collapse-arrow join-item border-base-300 border">
+          <input type="radio" name={androidInstructionId} />
+          <div className="collapse-title font-semibold">在 Linux / Mac 系统下操作（使用 ADB / Shell）</div>
+          <div className="collapse-content text-sm min-w-0">
+            <AdbInstructionTemplate dir={dir} file={file} platform="linux" />
+          </div>
+        </div>
+      </div>
    </>
  );
 }
--- a/src/components/AndroidADBPullInstruction/RootExplorerGuide.tsx
+++ b/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">
+            <li>
+              <div className="inline-flex items-center flex-wrap">
+                点触主界面左上角的 <FiMenu className="m-1" /> 打开侧边栏
+              </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">
+            <li>
+              <div className="inline-flex items-center flex-wrap">
+                点触主界面左上角的 <FiMenu className="m-1" /> 打开侧边栏
+              </div>
+            </li>
+            <li>
+              <div className="inline-flex items-center flex-wrap">
+                点触侧边栏右上方的 <FiMoreVertical className="ml-1" />
+                弹出菜单，点触<VQuote>设置</VQuote>
+              </div>
+            </li>
+            <li>
+              勾选<VQuote>请求 Root 权限</VQuote>
+            </li>
+          </ul>
+        </div>
+      </div>
+    </div>
+  );
+}
--- a/src/components/AppRoot.tsx
+++ b/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">
-          <TabList justifyContent="center">
-            <Tab>
-              <Icon as={MdHome} mr="1" />
-              <chakra.span>应用</chakra.span>
-            </Tab>
-            <Tab>
-              <Icon as={MdSettings} mr="1" />
-              <chakra.span>设置</chakra.span>
-            </Tab>
-            <Tab>
-              <Icon as={MdQuestionAnswer} mr="1" />
-              <chakra.span>答疑</chakra.span>
-            </Tab>
-          </TabList>
+        <div role="tablist" className="tabs tabs-border w-full justify-center border-b-2 border-base-200 box-content">
+          <NavLink to="/" role="tab" className={tabClassNames}>
+            <MdHome />
+            应用
+          </NavLink>
+          <NavLink to="/settings" role="tab" className={tabClassNames}>
+            <MdSettings />
+            设置
+          </NavLink>
+          <NavLink to="/questions" role="tab" className={tabClassNames}>
+            <MdQuestionAnswer />
+            答疑
+          </NavLink>
+        </div>

-          <TabPanels overflow="auto" minW={0} flexDir="column" flex={1} display="flex">
-            <TabPanel>
-              <MainTab />
-            </TabPanel>
-            <TabPanel flex={1} display="flex">
-              <SettingsTab />
-            </TabPanel>
-            <TabPanel>
-              <FaqTab />
-            </TabPanel>
-          </TabPanels>
-        </Tabs>
+        <main className="flex-1 flex justify-center min-h-0 overflow-auto">
+          <Routes>
+            <Route path="/" Component={MainTab} />
+            <Route path="/settings" Component={SettingsTab}>
+              <Route index Component={SettingsHome} />
+              {Object.entries(SETTINGS_TABS).map(([key, { Tab }]) => (
+                <Route key={key} path={key} Component={Tab} />
+              ))}
+            </Route>
+            <Route path="/questions" Component={FaqTab}>
+              <Route index Component={FaqHome} />
+              {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>
  );
 }
--- a/src/components/CodeHighlight.tsx
+++ b/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>
+  );
+}
--- a/src/components/Dialog.tsx
+++ b/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>
+  );
+}
--- a/src/components/DownloadAll.tsx
+++ b/src/components/DownloadAll.tsx
@@ -0,0 +1,90 @@
+import { DecryptedAudioFile, ProcessState, selectFiles } from '~/features/file-listing/fileListingSlice';
+import { FaDownload } from 'react-icons/fa';
+import { useAppSelector } from '~/hooks';
+import { toast } from 'react-toastify';
+import { SimpleQueue } from '~/util/SimpleQueue';
+
+export function DownloadAll() {
+  const files = useAppSelector(selectFiles);
+  const downloadAllAsync = async () => {
+    const fileList = Object.values(files);
+    const fileCount = fileList.length;
+    if (fileCount === 0) {
+      toast.warning('未添加文件');
+      return;
+    }
+
+    // 判断所有文件是否处理完成
+    const allComplete = fileList.every((file) => file.state !== ProcessState.PROCESSING);
+    if (!allComplete) {
+      toast.warning('请等待所有文件解密完成');
+      return;
+    }
+
+    // 过滤处理失败的文件
+    const completeFiles = fileList.filter((file) => file.state === ProcessState.COMPLETE);
+
+    // 准备下载
+    let dir: FileSystemDirectoryHandle | null = null;
+    try {
+      dir = await window.showDirectoryPicker({ mode: 'readwrite' });
+    } catch (e) {
+      if (e instanceof Error && e.name === 'AbortError') {
+        return; // user cancelled
+      }
+      console.error(e);
+    }
+    toast.warning('开始下载，请稍候');
+    const queue = new SimpleQueue(8);
+    const promises = Object.values(completeFiles).map(async (file) => {
+      try {
+        await queue.enter();
+        await downloadFile(file, dir);
+      } catch (e) {
+        console.error(`下载失败: ${file.fileName}`, e);
+        toast.error(`出现错误: ${e as Error}`);
+        throw e;
+      } finally {
+        queue.leave();
+      }
+    });
+
+    const promiseResults = await Promise.allSettled(promises);
+    const success = promiseResults.filter((result) => result.status === 'fulfilled').length;
+    const level = success === fileCount ? 'success' : success === 0 ? 'error' : 'warning';
+    toast[level](`成功下载: ${success}/${fileCount}首`);
+  };
+
+  function onDownloadAll() {
+    downloadAllAsync().catch((e) => {
+      // this should not happen
+      console.error('下载全部出现错误', e);
+    });
+  }
+
+  return (
+    <button className="btn btn-primary" id="downloadAll" onClick={onDownloadAll} title="下载全部">
+      <FaDownload />
+    </button>
+  );
+}
+
+async function downloadFile(file: DecryptedAudioFile, dir: FileSystemDirectoryHandle | null) {
+  if (dir) {
+    const fileHandle = await dir.getFileHandle(file.cleanName + '.' + file.ext, { create: true });
+    const fileStream = await fileHandle.createWritable();
+    try {
+      const res = await fetch(file.decrypted);
+      await res.body?.pipeTo(fileStream);
+    } catch {
+      await fileStream.abort();
+    }
+  } else {
+    const anchor = document.createElement('a');
+    anchor.href = file.decrypted;
+    anchor.download = file.cleanName + '.' + file.ext;
+    document.body.append(anchor);
+    anchor.click();
+    anchor.remove();
+  }
+}
--- a/src/components/DownloadBase64.tsx
+++ b/src/components/DownloadBase64.tsx
@@ -0,0 +1,32 @@
+import type { ReactNode } from 'react';
+import { ExtLink } from './ExtLink';
+import { IoMdArchive } from 'react-icons/io';
+
+export type DownloadBase64Props = {
+  data: string;
+  filename: string;
+  mimetype?: string;
+  className?: string;
+  icon?: ReactNode | true | false;
+  children?: ReactNode;
+};
+
+export function DownloadBase64({
+  className,
+  children,
+  data,
+  filename,
+  icon,
+  mimetype = 'application/octet-stream',
+}: DownloadBase64Props) {
+  return (
+    <ExtLink
+      icon={icon ?? <IoMdArchive className="inline size-sm ml-1" />}
+      className={className ?? 'link-info mx-1'}
+      download={filename}
+      href={`data:${mimetype};base64,${data}`}
+    >
+      {children ?? <code>{filename}</code>}
+    </ExtLink>
+  );
+}
--- a/src/components/ExtLink.tsx
+++ b/src/components/ExtLink.tsx
@@ -1,12 +1,15 @@
-import type { AnchorHTMLAttributes } from 'react';
-import { ExternalLinkIcon } from '@chakra-ui/icons';
-import { Link } from '@chakra-ui/react';
+import type { AnchorHTMLAttributes, ReactNode } from 'react';
+import { FiExternalLink } from 'react-icons/fi';

-export function ExtLink({ children, ...props }: AnchorHTMLAttributes<HTMLAnchorElement>) {
+export type ExtLinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {
+  icon?: ReactNode | true | false;
+};
+
+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 />
-    </Link>
+      {icon === true ? <FiExternalLink className="inline size-sm ml-1" /> : icon}
+    </a>
  );
 }
--- a/src/components/FileInput.tsx
+++ b/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%"
-      maxW={480}
-      borderWidth="1px"
-      borderRadius="lg"
-      transitionDuration="0.5s"
-      p="6"
-      cursor="pointer"
-      display="flex"
-      flexDir="column"
-      alignItems="center"
-      _hover={{
-        borderColor: 'gray.400',
-        bg: 'gray.50',
-      }}
-      {...(isDragActive && {
-        bg: 'blue.50',
-        borderColor: 'blue.700',
-      })}
+      className={classnames(
+        'w-full max-w-xl border rounded-lg transition duration-500 p-6 border-base-300 mx-auto',
+        'cursor-pointer flex flex-col items-center bg-base-200 hover:border-gray-400 hover:bg-gray-50 hover:dark:bg-gray-800',
+        {
+          'bg-blue-50 dark:bg-blue-900 border-blue-700': isDragActive,
+        },
+      )}
+      tabIndex={0}
    >
      <input {...getInputProps()} />
-
      {children}
-    </Box>
+    </div>
  );
 }
--- a/src/components/FilePathBlock.tsx
+++ b/src/components/FilePathBlock.tsx
@@ -1,10 +1,9 @@
-import { Code, Text } from '@chakra-ui/react';
-import React from 'react';
+import type { ReactNode } 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">
-      <Code>{children}</Code>
-    </Text>
+    <pre className="whitespace-pre-wrap break-all">
+      <code>{children}</code>
+    </pre>
  );
 }
--- a/src/components/Footer.tsx
+++ b/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
-      fontSize="sm"
-      textAlign="center"
-      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>
+    <footer className="flex flex-col text-center p-4 bg-base-200">
+      <div className="flex flex-row justify-center items-center h-[1em]">
+        <a className="link link-info mr-1" href="https://git.um-react.app/um/um-react">
          音乐解锁
-        </Link>
-        {' (__APP_VERSION_SHORT__'}
-        <Suspense>
-          <SDKVersion />
-        </Suspense>
-        {') - 移除已购音乐的加密保护。'}
-      </Flex>
-      <Text>
+        </a>
+        (
+        <a
+          title="使用 MIT 授权协议"
+          className="link link-info"
+          href="https://git.um-react.app/um/um-react/src/branch/main/LICENSE"
+        >
+          MIT
+        </a>
+        , v{appVersionShort}
+        <SDKVersion />)
+      </div>
+      <p>
        {'© 2019 - '}
-        <CurrentYear />{' '}
-        <Link href="https://git.unlock-music.dev/um" isExternal>
-          UnlockMusic 团队
-        </Link>
-        {' | '}
-        <Link href="https://git.unlock-music.dev/um/um-react/src/branch/main/LICENSE" isExternal>
-          使用 MIT 授权协议
-        </Link>
-      </Text>
-    </Center>
+        <CurrentYear />
+        <a className="ml-1 link link-info" href="https://git.um-react.app/um">
+          Unlock Music
+        </a>
+      </p>
+    </footer>
  );
 }
--- a/src/components/HelpText/HeaderAnchor.tsx
+++ b/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>
+  );
+}
--- a/src/components/HelpText/Headers.tsx
+++ b/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
-      as="h3"
-      id={id}
-      className={className}
-      pt={3}
-      pb={1}
-      borderBottom={'1px solid'}
-      borderColor="gray.300"
-      color="gray.800"
-      size="lg"
-    >
+    <h3 id={id} className={`${commonHeaderClasses} text-2xl border-b border-base-300 ${className}`}>
+      {id && <HeaderAnchor id={id} />}
      {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>
  );
 }
--- a/src/components/HelpText/HiWord.tsx
+++ b/src/components/HelpText/HiWord.tsx
@@ -1,9 +1,3 @@
-import { Mark } from '@chakra-ui/react';
-
-export function HiWord({ children }: { children: React.ReactNode }) {
-  return (
-    <Mark bg="orange.100" borderRadius={5} px={2} mx={1}>
-      {children}
-    </Mark>
-  );
+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>;
 }
--- a/src/components/HelpText/VQuote.tsx
+++ b/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>
    </>
  );
 }
--- a/src/components/ImageFigure.tsx
+++ b/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>
+  );
+}
--- a/src/components/ImportSecretModal.tsx
+++ b/src/components/ImportSecretModal.tsx
@@ -1,48 +1,51 @@
-import {
-  Center,
-  Flex,
-  Modal,
-  ModalBody,
-  ModalCloseButton,
-  ModalContent,
-  ModalHeader,
-  ModalOverlay,
-  Tabs,
-  Text,
-} from '@chakra-ui/react';
+import { useEffect, useRef } from 'react';

 import { FileInput } from '~/components/FileInput';
+import { InSecretImportModalContext } from '~/context/InSecretImportModal';

 export interface ImportSecretModalProps {
  clientName?: React.ReactNode;
  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 importResult = onImport(files[0]);
+    if (importResult instanceof Promise) {
+      importResult.catch((err) => {
+        console.error('could not import: ', err);
+      });
+    }
+  };
+
+  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">
-      <ModalOverlay />
-      <ModalContent>
-        <ModalHeader>从文件导入密钥</ModalHeader>
-        <ModalCloseButton />
-        <Flex as={ModalBody} gap={2} flexDir="column" flex={1}>
-          <Center>
-            <FileInput onReceiveFiles={handleFileReceived}>拖放或点我选择含有密钥的数据库文件</FileInput>
-          </Center>
+    <dialog ref={refModel} className="modal" onClose={onClose}>
+      <div className="modal-box">
+        <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">从文件导入密钥</h3>
+        <div className="py-4 flex flex-col gap-2 flex-1">
+          <FileInput onReceiveFiles={handleFileReceived}>拖放或点我选择含有密钥的数据库文件</FileInput>

-          <Text as="div" mt={2}>
-            选择你的{clientName && <>「{clientName}」</>}客户端平台以查看对应说明：
-          </Text>
-          <Flex as={Tabs} variant="enclosed" flexDir="column" flex={1} minH={0}>
-            {children}
-          </Flex>
-        </Flex>
-      </ModalContent>
-    </Modal>
+          <div className="mt-2">选择你的{clientName && <>「{clientName}」</>}客户端平台以查看对应说明：</div>
+          <InSecretImportModalContext.Provider value={true}>
+            <div>{children}</div>
+          </InSecretImportModalContext.Provider>
+        </div>
+      </div>
+    </dialog>
  );
 }
--- a/src/components/InfoModal.tsx
+++ b/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>
+  );
+}
--- a/src/components/InstructionsTabs.tsx
+++ b/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>
+  );
+}
--- a/src/components/Key/MacCommandKey.tsx
+++ b/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>
-      <Kbd>
-        <Icon as={BsCommand} />
-      </Kbd>
-      <rp> (</rp>
-      <rt>command</rt>
-      <rp>)</rp>
-    </ruby>
+    <Ruby caption="command" className={className}>
+      <kbd className="kbd">
+        <BsCommand className="text-sm" />
+      </kbd>
+    </Ruby>
  );
 }
--- a/src/components/Key/ShiftKey.tsx
+++ b/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>
-      <Kbd>
-        <Icon as={BsShift} />
-      </Kbd>
-      <rp> (</rp>
-      <rt>shift</rt>
-      <rp>)</rp>
-    </ruby>
+    <Ruby caption="shift" className={className}>
+      <kbd className="kbd">
+        <BsShift className="text-sm" />
+      </kbd>
+    </Ruby>
  );
 }
--- a/src/components/KeyInput.tsx
+++ b/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>
+  );
+}
--- a/src/components/KeyListContainer.tsx
+++ b/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>
+  );
+}
--- a/src/components/ProjectIssue.tsx
+++ b/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>
  );
 }
--- a/src/components/Ruby.tsx
+++ b/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>
+  );
+}
--- a/src/components/SDKVersion.tsx
+++ b/src/components/SDKVersion.tsx
@@ -1,33 +1,41 @@
-import { InfoOutlineIcon } from '@chakra-ui/icons';
-import { Tooltip, VStack, Text, Flex } from '@chakra-ui/react';
+import { MdInfoOutline } from 'react-icons/md';
 import { workerClientBus } from '~/decrypt-worker/client';
 import { DECRYPTION_WORKER_ACTION_NAME } from '~/decrypt-worker/constants';
-
-import usePromise from 'react-promise-suspense';
+import { useEffect, useRef, useState } from 'react';

 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, () => setSdkVersion('N/A'));
+  }, []);

  return (
-    <Flex as="span" pl="1" alignItems="center" data-testid="sdk-version">
-      <Tooltip
-        hasArrow
-        placement="top"
-        label={
-          <VStack>
-            <Text>App: __APP_VERSION__</Text>
-            <Text>SDK: {sdkVersion}</Text>
-          </VStack>
-        }
-        bg="gray.300"
-        color="black"
-      >
-        <InfoOutlineIcon />
-      </Tooltip>
-    </Flex>
+    <>
+      <span className="btn btn-ghost inline-flex p-0" onClick={() => refDialog.current?.showModal()}>
+        <MdInfoOutline />
+      </span>
+
+      <dialog ref={refDialog} className="modal text-left">
+        <div className="modal-box">
+          <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>
+
+          <p>App: __APP_VERSION__</p>
+          <p>
+            SDK: <span data-testid="sdk-version">{sdkVersion}</span>
+          </p>
+        </div>
+        <form method="dialog" className="modal-backdrop">
+          <button>关闭</button>
+        </form>
+      </dialog>
+    </>
  );
 }
--- a/src/components/SelectFile.tsx
+++ b/src/components/SelectFile.tsx
@@ -1,5 +1,4 @@
-import { Box, Text } from '@chakra-ui/react';
-import { UnlockIcon } from '@chakra-ui/icons';
+import { FiUnlock } from 'react-icons/fi';

 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,27 +25,24 @@ export function SelectFile() {
          id: fileId,
          blobURI,
          fileName,
-        })
+        }),
      );
-      dispatch(processFile({ fileId }));
+
+      dispatch(processFile({ fileId })).catch((err) => {
+        console.log(`failed to add file (id=${fileId}, name=${fileName}, err=${err as Error})`);
+      });
    }
  };

  return (
    <FileInput multiple onReceiveFiles={handleFileReceived}>
-      <Box pb={3}>
-        <UnlockIcon boxSize={8} />
-      </Box>
-      <Text as="div" textAlign="center">
+      <FiUnlock className="size-8 mb-4" />
+      <p className="text-center">
        拖放或
-        <Text as="span" color="teal.400">
-          点我选择
-        </Text>
+        <span className="text-teal-700 font-semibold">点我选择</span>
        需要解密的文件
-        <Text fontSize="sm" opacity="50%">
-          在浏览器内对文件进行解锁，零上传
-        </Text>
-      </Text>
+      </p>
+      <p className="text-sm opacity-50 m-0">在浏览器内对文件进行解锁，零上传</p>
    </FileInput>
  );
 }
--- a/src/context/InSecretImportModal.tsx
+++ b/src/context/InSecretImportModal.tsx
@@ -0,0 +1,3 @@
+import { createContext } from 'react';
+
+export const InSecretImportModalContext = createContext<boolean>(false);
--- a/src/decrypt-worker/Deciphers.ts
+++ b/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;
 }
--- a/src/decrypt-worker/constants.ts
+++ b/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',
 }
--- a/src/decrypt-worker/decipher/KugouMusic.ts
+++ b/src/decrypt-worker/decipher/KugouMusic.ts
@@ -1,33 +1,36 @@
 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)) {
        kgm.decrypt(block, offset);
      }

-      return {
+      return Promise.resolve({
        status: Status.OK,
        cipherName: this.cipherName,
        data: audioBuffer,
-      };
+      });
    } finally {
+      kgmHdr?.free();
      kgm?.free();
    }
  }

-  public static make() {
+  public static make(this: void) {
    return new KugouMusicDecipher();
  }
 }
--- a/src/decrypt-worker/decipher/KuwoMusic.ts
+++ b/src/decrypt-worker/decipher/KuwoMusic.ts
@@ -18,18 +18,18 @@ export class KuwoMusicDecipher implements DecipherInstance {
      for (const [block, offset] of chunkBuffer(audioBuffer)) {
        kwm.decrypt(block, offset);
      }
-      return {
+      return Promise.resolve({
        status: Status.OK,
        cipherName: this.cipherName,
        data: audioBuffer,
-      };
+      });
    } finally {
      kwm?.free();
      header?.free();
    }
  }

-  public static make() {
+  public static make(this: void) {
    return new KuwoMusicDecipher();
  }
 }
--- a/src/decrypt-worker/decipher/Migu3d.ts
+++ b/src/decrypt-worker/decipher/Migu3d.ts
@@ -6,22 +6,25 @@ export class Migu3DKeylessDecipher implements DecipherInstance {
  cipherName = 'Migu3D (Keyless)';

  async decrypt(buffer: Uint8Array): Promise<DecipherResult | DecipherOK> {
-    const mg3d = Migu3D.fromHeader(buffer.subarray(0, 0x100));
    const audioBuffer = new Uint8Array(buffer);
+    const mg3d = Migu3D.fromHeader(buffer.subarray(0, 0x100));

-    for (const [block, i] of chunkBuffer(audioBuffer)) {
-      mg3d.decrypt(block, i);
+    try {
+      for (const [block, i] of chunkBuffer(audioBuffer)) {
+        mg3d.decrypt(block, i);
+      }
+    } finally {
+      mg3d.free();
    }
-    mg3d.free();

-    return {
+    return Promise.resolve({
      cipherName: this.cipherName,
      status: Status.OK,
      data: audioBuffer,
-    };
+    });
  }

-  public static make() {
+  public static make(this: void) {
    return new Migu3DKeylessDecipher();
  }
 }
--- a/src/decrypt-worker/decipher/NetEaseCloudMusic.ts
+++ b/src/decrypt-worker/decipher/NetEaseCloudMusic.ts
@@ -26,17 +26,17 @@ export class NetEaseCloudMusicDecipher implements DecipherInstance {
      for (const [block, offset] of chunkBuffer(audioBuffer)) {
        ncm.decrypt(block, offset);
      }
-      return {
+      return Promise.resolve({
        status: Status.OK,
        cipherName: this.cipherName,
        data: audioBuffer,
-      };
+      });
    } finally {
      ncm.free();
    }
  }

-  public static make() {
+  public static make(this: void) {
    return new NetEaseCloudMusicDecipher();
  }
 }
--- a/src/decrypt-worker/decipher/QQMusic.ts
+++ b/src/decrypt-worker/decipher/QQMusic.ts
@@ -19,14 +19,14 @@ export class QQMusicV1Decipher implements DecipherInstance {
    for (const [block, offset] of chunkBuffer(audioBuffer)) {
      decryptQMC1(block, offset);
    }
-    return {
+    return Promise.resolve({
      status: Status.OK,
      cipherName: this.cipherName,
      data: audioBuffer,
-    };
+    });
  }

-  public static create() {
+  public static create(this: void) {
    return new QQMusicV1Decipher();
  }
 }
@@ -62,25 +62,28 @@ export class QQMusicV2Decipher implements DecipherInstance {
      throw new Error('EKey required');
    }

-    const qmc2 = new QMC2(ekey);
    const audioBuffer = buffer.slice(0, buffer.byteLength - footer.size);
-    for (const [block, offset] of chunkBuffer(audioBuffer)) {
-      qmc2.decrypt(block, offset);
+    const qmc2 = new QMC2(ekey);
+    try {
+      for (const [block, offset] of chunkBuffer(audioBuffer)) {
+        qmc2.decrypt(block, offset);
+      }
+    } finally {
+      qmc2.free();
    }
-    qmc2.free();

-    return {
+    return Promise.resolve({
      status: Status.OK,
      cipherName: this.cipherName,
      data: audioBuffer,
-    };
+    });
  }

-  public static createWithUserKey() {
+  public static createWithUserKey(this: void) {
    return new QQMusicV2Decipher(true);
  }

-  public static createWithEmbeddedEKey() {
+  public static createWithEmbeddedEKey(this: void) {
    return new QQMusicV2Decipher(false);
  }
 }
--- a/src/decrypt-worker/decipher/QingTingFM.ts
+++ b/src/decrypt-worker/decipher/QingTingFM.ts
@@ -18,20 +18,23 @@ export class QignTingFMDecipher implements DecipherInstance {
      };
    }

-    const qtfm = new QingTingFM(key, iv);
    const audioBuffer = new Uint8Array(buffer);
-    for (const [block, i] of chunkBuffer(audioBuffer)) {
-      qtfm.decrypt(block, i);
+    const qtfm = new QingTingFM(key, iv);
+    try {
+      for (const [block, i] of chunkBuffer(audioBuffer)) {
+        qtfm.decrypt(block, i);
+      }
+    } finally {
+      qtfm.free();
    }
-
-    return {
+    return Promise.resolve({
      cipherName: this.cipherName,
      status: Status.OK,
      data: audioBuffer,
-    };
+    });
  }

-  public static make() {
+  public static make(this: void) {
    return new QignTingFMDecipher();
  }
 }
--- a/src/decrypt-worker/decipher/Transparent.ts
+++ b/src/decrypt-worker/decipher/Transparent.ts
@@ -3,16 +3,16 @@ import { DecipherInstance, DecipherOK, DecipherResult, Status } from '~/decrypt-
 export class TransparentDecipher implements DecipherInstance {
  cipherName = 'none';

-  async decrypt(buffer: Uint8Array): Promise<DecipherResult | DecipherOK> {
-    return {
+  async decrypt(buffer: Uint8Array<ArrayBuffer>): Promise<DecipherResult | DecipherOK> {
+    return Promise.resolve({
      cipherName: 'None',
      status: Status.OK,
      data: buffer,
      message: 'No decipher applied',
-    };
+    });
  }

-  public static make() {
+  public static make(this: void) {
    return new TransparentDecipher();
  }
 }
--- a/src/decrypt-worker/decipher/XiamiMusic.ts
+++ b/src/decrypt-worker/decipher/XiamiMusic.ts
@@ -6,23 +6,26 @@ export class XiamiDecipher implements DecipherInstance {
  cipherName = 'Xiami (XM)';

  async decrypt(buffer: Uint8Array): Promise<DecipherResult | DecipherOK> {
-    const xm = Xiami.from_header(buffer.subarray(0, 0x10));
-    const { copyPlainLength } = xm;
    const audioBuffer = buffer.slice(0x10);

-    for (const [block] of chunkBuffer(audioBuffer.subarray(copyPlainLength))) {
-      xm.decrypt(block);
+    const xm = Xiami.from_header(buffer.subarray(0, 0x10));
+    try {
+      const { copyPlainLength } = xm;
+      for (const [block] of chunkBuffer(audioBuffer.subarray(copyPlainLength))) {
+        xm.decrypt(block);
+      }
+    } finally {
+      xm.free();
    }
-    xm.free();

-    return {
+    return Promise.resolve({
      cipherName: this.cipherName,
      status: Status.OK,
      data: audioBuffer,
-    };
+    });
  }

-  public static make() {
+  public static make(this: void) {
    return new XiamiDecipher();
  }
 }
--- a/src/decrypt-worker/decipher/Ximalaya.ts
+++ b/src/decrypt-worker/decipher/Ximalaya.ts
@@ -23,18 +23,18 @@ export class XimalayaAndroidDecipher implements DecipherInstance {
    }
    const result = new Uint8Array(buffer);
    result.set(slice, 0);
-    return {
+    return Promise.resolve({
      cipherName: this.cipherName,
      status: Status.OK,
      data: result,
-    };
+    });
  }

-  public static makeX2M() {
+  public static makeX2M(this: void) {
    return new XimalayaAndroidDecipher(decryptX2MHeader, 'X2M');
  }

-  public static makeX3M() {
+  public static makeX3M(this: void) {
    return new XimalayaAndroidDecipher(decryptX3MHeader, 'X3M');
  }
 }
@@ -45,27 +45,31 @@ export class XimalayaPCDecipher implements DecipherInstance {
  async decrypt(buffer: Uint8Array, _options: DecryptCommandOptions): Promise<DecipherResult | DecipherOK> {
    // Detect with first 0x400 bytes
    const headerSize = XmlyPC.getHeaderSize(buffer.subarray(0, 1024));
-    const xm = new XmlyPC(buffer.subarray(0, headerSize));
-    const { audioHeader, encryptedHeaderOffset, encryptedHeaderSize } = xm;
-    const plainAudioDataOffset = encryptedHeaderOffset + encryptedHeaderSize;
-    const plainAudioDataLength = buffer.byteLength - plainAudioDataOffset;
-    const encryptedAudioPart = buffer.slice(encryptedHeaderOffset, plainAudioDataOffset);
-    const encryptedAudioPartLen = xm.decrypt(encryptedAudioPart);
-    const audioSize = audioHeader.byteLength + encryptedAudioPartLen + plainAudioDataLength;
-    xm.free();
+    const xmly = new XmlyPC(buffer.subarray(0, headerSize));

-    const result = new Uint8Array(audioSize);
-    result.set(audioHeader);
-    result.set(encryptedAudioPart, audioHeader.byteLength);
-    result.set(buffer.subarray(plainAudioDataOffset), audioHeader.byteLength + encryptedAudioPartLen);
-    return {
-      status: Status.OK,
-      data: result,
-      cipherName: this.cipherName,
-    };
+    try {
+      const { audioHeader, encryptedHeaderOffset, encryptedHeaderSize } = xmly;
+      const plainAudioDataOffset = encryptedHeaderOffset + encryptedHeaderSize;
+      const plainAudioDataLength = buffer.byteLength - plainAudioDataOffset;
+      const encryptedAudioPart = buffer.slice(encryptedHeaderOffset, plainAudioDataOffset);
+      const encryptedAudioPartLen = xmly.decrypt(encryptedAudioPart);
+      const audioSize = audioHeader.byteLength + encryptedAudioPartLen + plainAudioDataLength;
+
+      const result = new Uint8Array(audioSize);
+      result.set(audioHeader);
+      result.set(encryptedAudioPart, audioHeader.byteLength);
+      result.set(buffer.subarray(plainAudioDataOffset), audioHeader.byteLength + encryptedAudioPartLen);
+      return Promise.resolve({
+        status: Status.OK,
+        data: result,
+        cipherName: this.cipherName,
+      });
+    } finally {
+      xmly.free();
+    }
  }

-  public static make() {
+  public static make(this: void) {
    return new XimalayaPCDecipher();
  }
 }
--- a/src/decrypt-worker/types.ts
+++ b/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;
--- a/src/decrypt-worker/util/audioType.ts
+++ b/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';
+}
--- a/src/decrypt-worker/util/buffer.ts
+++ b/src/decrypt-worker/util/buffer.ts
@@ -1,7 +1,6 @@
-export const toArrayBuffer = async (src: Blob | ArrayBuffer | Uint8Array<ArrayBufferLike>) =>
-  src instanceof Blob ? await src.arrayBuffer() : src;
-export const toBlob = (src: Blob | ArrayBuffer | Uint8Array<ArrayBufferLike>) =>
-  src instanceof Blob ? src : new Blob([src]);
+export const toArrayBuffer = async (src: Blob | BlobPart) => (src instanceof Blob ? await src.arrayBuffer() : src);
+export const toBlob = (src: Blob | BlobPart, mimeType?: string) =>
+  src instanceof Blob ? src : new Blob([src], { type: mimeType ?? 'application/octet-stream' });

 export function* chunkBuffer(buffer: Uint8Array, blockLen = 4096): Generator<[Uint8Array, number], void> {
  const len = buffer.byteLength;
--- a/src/decrypt-worker/util/wasmClass.ts
+++ b/src/decrypt-worker/util/wasmClass.ts
@@ -6,7 +6,7 @@ export function withWasmClass<T extends { free: () => void }, R>(instance: T, cb
    const resp = cb(instance);
    if (resp && isPromise(resp)) {
      isAsync = true;
-      resp.finally(() => instance.free());
+      resp.finally(() => instance.free()).catch(() => {});
    }
    return resp;
  } finally {
--- a/src/decrypt-worker/worker.ts
+++ b/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);
--- a/src/decrypt-worker/worker/decrypt.ts
+++ b/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 };
  }
 }

--- a/src/decrypt-worker/worker/kugou_parse_header.ts
+++ b/src/decrypt-worker/worker/kugou_parse_header.ts
@@ -0,0 +1,22 @@
+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();
+  }
+};
--- a/src/decrypt-worker/worker/kuwo_header_parse.ts
+++ b/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();

--- a/src/decrypt-worker/worker/qtfm_device_key.ts
+++ b/src/decrypt-worker/worker/qtfm_device_key.ts
@@ -11,5 +11,5 @@ export async function workerGetQtfmDeviceKey({
  board,
 }: GetQingTingFMDeviceKeyPayload) {
  const buffer = QingTingFM.getDeviceKey(device, brand, model, product, manufacturer, board);
-  return hex(buffer);
+  return Promise.resolve(hex(buffer));
 }
--- a/src/dummy.mjs
+++ b/src/dummy.mjs
@@ -1,5 +1,5 @@
 // This is a dummy module for vite/rollup to resolve.
 export function createRequire() {
-  import('radash'); // we need to import something, so vite don't complain on build
+  const _ = import('radash'); // we need to import something, so vite don't complain on build
  throw new Error('this is a dummy module. Do not use');
 }
--- a/src/faq/AndroidEmulatorFAQ.tsx
+++ b/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>
+    </>
+  );
+}
--- a/src/faq/FAQAbout.tsx
+++ b/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>
+  );
+}
--- a/src/faq/FAQPages.tsx
+++ b/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 },
+];
--- a/src/faq/FaqHome.tsx
+++ b/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>
+  );
+}
--- a/src/faq/KugouFAQ.tsx
+++ b/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 />} />
+    </>
+  );
+}
--- a/src/faq/KuwoFAQ.tsx
+++ b/src/faq/KuwoFAQ.tsx
@@ -1,52 +1,47 @@
-import { Alert, AlertIcon, Container, Flex, List, ListItem, Text } from '@chakra-ui/react';
-import { Header4 } from '~/components/HelpText/Headers';
+import { Header2, Header3 } 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>
-      <List spacing={2}>
-        <ListItem>
-          <SegmentTryOfficialPlayer />
-        </ListItem>
-        <ListItem>
-          <Text>
-            日前，仅<HiWord>手机客户端</HiWord>下载的
-            <VQuote>
-              <strong>至臻全景声</strong>
-            </VQuote>
-            及
-            <VQuote>
-              <strong>至臻母带</strong>
-            </VQuote>
-            {'音质的音乐文件采用新版加密。'}
-          </Text>
-          <Text>其他音质目前不需要提取密钥。</Text>
-          <Text>PC平台暂未推出使用新版加密的音质。</Text>
+      <Header2>酷我音乐</Header2>
+      <Header3 id="failed">解锁失败</Header3>
+      <SegmentTryOfficialPlayer />
+      <p className="mb-2">
+        日前，仅<HiWord>手机客户端</HiWord>下载的
+        <VQuote>
+          <strong>至臻全景声</strong>
+        </VQuote>
+        及
+        <VQuote>
+          <strong>至臻母带</strong>
+        </VQuote>
+        音质的音乐文件采用新版加密。
+      </p>
+      <p className="mb-2">其他音质目前不需要提取密钥。</p>
+      <p className="mb-2">PC平台暂未推出使用新版加密的音质。</p>

-          <Container p={2}>
-            <Alert status="warning" borderRadius={5}>
-              <AlertIcon />
-              <Flex flexDir="column">
-                <Text>安卓用户提取密钥需要 root 权限，或注入文件提供器。</Text>
-                <Text>
-                  <strong>注意</strong>：已知部分第三方修改版会破坏密钥写入功能，导致无法提取密钥。
-                </Text>
-                <Text>
-                  <strong>注意</strong>：项目组不提倡使用、也不提供第三方修改版。使用前请自行评估风险。
-                </Text>
-              </Flex>
-            </Alert>
-          </Container>
+      <Header3 id="keys">导入密钥</Header3>
+      <div className="alert alert-warning my-2">
+        <RiErrorWarningLine className="text-2xl" />
+        <div>
+          <p>安卓用户提取密钥需要 root 权限，或注入文件提供器。</p>
+          <p>
+            <strong className="pr-2">注意</strong>已知部分第三方修改版会破坏密钥写入功能，导致无法提取密钥。
+          </p>
+          <p>
+            <strong className="pr-2">注意</strong>
+            项目组不提倡使用、也不提供第三方修改版。使用前请自行评估风险。请开通会员支持正版音乐。
+          </p>
+        </div>
+      </div>

-          <SegmentKeyImportInstructions tab="KWMv2 密钥" clientInstructions={<KWMv2AllInstructions />} />
-        </ListItem>
-      </List>
+      <SegmentKeyImportInstructions tab="KWMv2 密钥" clientInstructions={<KWMv2AllInstructions />} />
    </>
  );
 }
--- a/src/faq/OtherFAQ.tsx
+++ b/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 { VQuote } from '~/components/HelpText/VQuote';
-import { ProjectIssue } from '~/components/ProjectIssue';
-import LdPlayerSettingsScreen from './assets/ld_settings_misc.webp';
+import { Header2, Header3, Header4 } from '~/components/HelpText/Headers';
+
+import { NavLink } from 'react-router';

 export function OtherFAQ() {
  return (
    <>
-      <Header4>解密后没有封面等信息</Header4>
-      <Text>该项目进行解密处理。如果加密前的资源没有内嵌元信息或封面，解密的文件也没有。</Text>
-      <Text>请使用第三方工具进行编辑或管理元信息。</Text>
+      <Header2>其它问题</Header2>
+      <Header3 id="metadata">解密后没有封面等信息</Header3>
+      <p>该项目进行解密处理。如果加密前的资源没有内嵌元信息或封面，解密的文件也没有。</p>
+      <p>请使用第三方工具进行编辑或管理元信息。</p>

-      <Header4>批量下载</Header4>
-      <Text>
-        {'暂时没有实现，不过你可以在 '}
-        <ProjectIssue id={34} title="[UI] 全部下载功能" />
-        {' 以及 '}
-        <ProjectIssue id={43} title="批量下载" />
-        {' 追踪该问题。'}
-      </Text>
+      <Header3 id="android-browsers">安卓: 浏览器支持说明</Header3>
+      <p>⚠️ 手机端浏览器支持有限，请使用最新版本的 Chrome 或 Firefox 官方浏览器。</p>
+      <div className="flex flex-col md:flex-row gap-2 md:gap-8">
+        <div>
+          <Header4>已知有问题的浏览器</Header4>
+          <ul className="list-disc pl-8">
+            <li>Via 浏览器</li>
+            <li>夸克浏览器</li>
+            <li>UC 浏览器</li>
+          </ul>
+        </div>

-      <Header4>安卓: 浏览器支持说明</Header4>
-      <Text>⚠️ 手机端浏览器支持有限，请使用最新版本的 Chrome 或 Firefox 官方浏览器。</Text>
-      <Text>已知有问题的浏览器：</Text>
-      <UnorderedList>
-        <ListItem>Via 浏览器</ListItem>
-        <ListItem>夸克浏览器</ListItem>
-        <ListItem>UC 浏览器</ListItem>
-      </UnorderedList>
-      <Text>可能会遇到的问题包括：</Text>
-      <UnorderedList>
-        <ListItem>网页白屏</ListItem>
-        <ListItem>无法下载解密后内容</ListItem>
-        <ListItem>下载的文件名错误</ListItem>
-      </UnorderedList>
+        <div>
+          <Header4>可能会遇到的问题包括</Header4>
+          <ul className="list-disc pl-8">
+            <li>网页白屏</li>
+            <li>无法下载解密后内容</li>
+            <li>下载的文件名错误</li>
+          </ul>
+        </div>
+      </div>

-      <Header4>安卓: root 相关说明</Header4>
-      <Text>
+      <Header3 id="android-root">安卓 root</Header3>
+      <p>
        对安卓设备获取 root 特权通常会破坏系统的完整性并导致部分功能无法使用。
-        例如部分厂商的安卓设备会在解锁后丧失保修资格，或导致无法使用 NFC 移动支付功能等限制。
-      </Text>
-      <Text>如果希望不破坏系统完整性，你可以考虑使用模拟器。</Text>
-      <Text>
-        目前常见的带有 root 特权支持的的安卓模拟器方案，分别是雷电模拟器（※ 官方版有内置广告）和微软在 Windows 11
-        开始支援的
-        <ExtLink href="https://learn.microsoft.com/zh-cn/windows/android/wsa/">
-          <ruby>
-            适用于 Android™ 的 Windows 子系统 (WSA)
-            <rp> (</rp>
-            <rt>
-              <code>Windows Subsystem for Android</code>
-            </rt>
-            <rp>)</rp>
-          </ruby>
-        </ExtLink>
+        例如部分厂商的安卓设备会在解锁后丧失保修资格，或导致无法使用 NFC 移动支付等限制。
+      </p>
+      <p className="my-2">
+        如果希望不破坏系统完整性，你可以考虑在电脑上使用
+        <NavLink className="link link-info" to="/questions/android-emu">
+          安卓模拟器
+        </NavLink>
        。
-      </Text>
+      </p>

-      <Container p={2}>
-        <Alert status="warning" borderRadius={5}>
-          <AlertIcon />
-          <Flex flexDir="column">
-            <Text>
-              <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">
+      <Header3 id="projects">相关项目</Header3>
+      <ul className="list-disc pl-6">
+        <li>
+          <p>
+            <ExtLink className="mr-2" 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 平台的可执行文件。
-          </Text>
-          <UnorderedList>
-            <ListItem>
-              <Text>
+            利用 Electron 框架打包的本地版，提供适用于 Windows、Linux 和 Mac 平台的可执行文件。
+          </p>
+          <ul className="list-disc pl-6">
+            <li>
+              <p>
                <ExtLink href="https://github.com/CarlGao4/um-react-electron/releases/latest">GitHub 下载</ExtLink>
-              </Text>
-            </ListItem>
-          </UnorderedList>
-        </ListItem>
-        <ListItem>
-          <Text>
-            <ExtLink href="https://git.unlock-music.dev/um/um-react-wry">
+              </p>
+            </li>
+          </ul>
+        </li>
+        <li>
+          <p>
+            <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>
-          <UnorderedList>
-            <ListItem>
-              <Text>
-                <ExtLink href="https://git.unlock-music.dev/um/um-react/releases/latest">仓库下载</ExtLink>
+          </p>
+          <ul className="list-disc pl-6">
+            <li>
+              <p>
+                <ExtLink href="https://git.um-react.app/um/um-react/releases/latest">仓库下载</ExtLink>
                {' | 寻找文件名为 '}
-                <Code>um-react-win64-</Code> 开头的附件
-              </Text>
-            </ListItem>
-          </UnorderedList>
-        </ListItem>
-      </UnorderedList>
+                <code>um-react-win64-</code> 开头的附件
+              </p>
+            </li>
+          </ul>
+        </li>
+      </ul>

-      <Header4>有更多问题？</Header4>
-      <Text>
-        {'欢迎进入 '}
-        <ExtLink href={'https://t.me/unlock_music_chat'}>Telegram “音乐解锁-交流” 交流群</ExtLink>
-        {' 一起探讨。'}
-      </Text>
+      <Header3 id="more-questions">有更多问题？</Header3>
+      <p className="flex flex-row gap-1">
+        欢迎加入
+        <ExtLink href={'https://t.me/unlock_music_chat'}>“音乐解锁-交流” 交流群</ExtLink>
+        一起讨论。
+      </p>
    </>
  );
 }
--- a/src/faq/QQMusicFAQ.tsx
+++ b/src/faq/QQMusicFAQ.tsx
@@ -1,159 +1,25 @@
-import { Accordion, AccordionButton, AccordionIcon, AccordionItem, AccordionPanel, Box } from '@chakra-ui/react';
-import { Alert, AlertIcon, Container, Flex, ListItem, Text, UnorderedList } from '@chakra-ui/react';
-import { Header4 } from '~/components/HelpText/Headers';
+import { Header2, Header3 } from '~/components/HelpText/Headers';
 import { SegmentTryOfficialPlayer } from './SegmentTryOfficialPlayer';
-import { SegmentKeyImportInstructions } from './SegmentKeyImportInstructions';
-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';
+import { QMCv2QQMusicAllInstructions } from '~/features/settings/panels/QMCv2/QMCv2QQMusicAllInstructions';

 export function QQMusicFAQ() {
  return (
    <>
-      <Header4>解锁失败</Header4>
+      <Header2>QQ 音乐</Header2>
+      <Header3 id="failed">解锁失败</Header3>
      <SegmentTryOfficialPlayer />
-      <Text>重复下载同一首的歌曲不重复扣下载配额，但是同一首歌的两个版本会重复扣下载配额，请仔细分辨。</Text>
-      <Text>
+      <p className="mb-2">新版本的 QQ 音乐客户端下载的文件通常都需要导入密钥数据库。</p>
+      <p className="mb-2">每一个资源（即一首歌的某个音质）都有独立的密钥，下载音乐时会被写出到密钥数据库中。</p>
+      <p className="mb-2">因此若是解密失败，很有可能是因为你需要导入密钥，或降级客户端。</p>
+
+      <Header3 id="about-download">关于下载</Header3>
+      <p>重复下载同一首的歌曲不重复扣下载配额，但是同一首歌的两个版本会重复扣下载配额，请仔细分辨。</p>
+      <p className="my-2">
        部分平台获取的加密文件未包含密钥。选择你<strong>下载文件时</strong>使用的客户端来查看说明。
-      </Text>
-      <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>
+      </p>

-        <AccordionItem>
-          <h2>
-            <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>
+      <Header3 id="keys-or-downgrade">导入密钥或降级客户端</Header3>
+      <QMCv2QQMusicAllInstructions />
    </>
  );
 }
--- a/src/faq/SegmentAddKeyDropdown.tsx
+++ b/src/faq/SegmentAddKeyDropdown.tsx
@@ -1,24 +1,13 @@
-import { Flex, IconButton } from '@chakra-ui/react';
-import { MdExpandMore } from 'react-icons/md';
-import { HiWord } from '~/components/HelpText/HiWord';
-import { VQuote } from '~/components/HelpText/VQuote';
+import { MdFileUpload } from 'react-icons/md';

 export function SegmentAddKeyDropdown() {
  return (
-    <Flex as="span" alignItems="center" flexWrap="wrap">
-      按下<VQuote>添加一条密钥</VQuote>按钮
-      <HiWord>右侧</HiWord>的
-      <IconButton
-        colorScheme="purple"
-        variant="outline"
-        size="sm"
-        icon={<MdExpandMore />}
-        ml="2"
-        borderTopLeftRadius={0}
-        borderBottomLeftRadius={0}
-        pointerEvents="none"
-        aria-label="下拉按钮"
-      />
-    </Flex>
+    <span className="inline-flex items-center flex-wrap">
+      按下
+      <button type="button" className="btn flex items-center gap-2">
+        <MdFileUpload className="text-lg" />
+        导入数据库…
+      </button>
+    </span>
  );
 }
--- a/src/faq/SegmentKeyImportInstructions.tsx
+++ b/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>
-      <OrderedList>
-        <ListItem>
+      <p className="mt-2">导入密钥可以参考下面的步骤：</p>
+      <ol className="list-decimal pl-5">
+        <li>
          <SegmentTopNavSettings />
-        </ListItem>
-        <ListItem>
+        </li>
+        <li>
          设定区域选择<VQuote>{tab}</VQuote>
-        </ListItem>
-        <ListItem>
+        </li>
+        <li>
          <SegmentAddKeyDropdown />
-        </ListItem>
-        <ListItem>
-          <Flex flexDir="row" alignItems="center">
-            {'选择 '}
-            <VQuote>
-              <Icon as={MdFileUpload} boxSize={5} mr={2} /> 从文件导入密钥…
-            </VQuote>
-          </Flex>
-        </ListItem>
-        <ListItem>
-          <Text>{keyInstructionText}</Text>
-          <Tabs display="flex" flexDir="column" border="1px solid" borderColor="gray.300" borderRadius={5}>
-            {clientInstructions}
-          </Tabs>
-        </ListItem>
-      </OrderedList>
+        </li>
+        <li>
+          <p className="mb-2">{keyInstructionText}</p>
+          {clientInstructions}
+        </li>
+      </ol>
    </>
  );
 }
--- a/src/faq/SegmentTryOfficialPlayer.tsx
+++ b/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}>
-      <Alert status="info" borderRadius={5}>
-        <AlertIcon />
-        尝试用下载音乐的设备播放一次看看，如果官方客户端都无法播放，那解锁肯定会失败哦。
-      </Alert>
-    </Container>
+    <div className={`alert alert-warning my-2 ${className}`}>
+      <RiErrorWarningLine className="text-2xl" />
+      <p>尝试用下载音乐的设备播放一次看看，如果官方客户端都无法播放，那解锁肯定会失败哦。</p>
+    </div>
  );
 }
--- a/src/faq/assets/ld_settings_misc.webp
+++ b/src/faq/assets/ld_settings_misc.webp
--- a/src/faq/assets/ld_settings_misc@2x.webp
+++ b/src/faq/assets/ld_settings_misc@2x.webp
--- a/src/faq/assets/mumu_settings_misc@2x.webp
+++ b/src/faq/assets/mumu_settings_misc@2x.webp
--- a/src/features/file-listing/AlbumImage.tsx
+++ b/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>
-  );
-}
--- a/src/features/file-listing/FileError.tsx
+++ b/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,51 @@ 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 errorSummary = errorMap.get(code) ?? '未知错误';
+  const summary = errorMap.get(code) ?? '未知错误';
+
+  const copyError = () => {
+    if (error) {
+      navigator.clipboard.writeText(applyTemplate(ERROR_TEMPLATE, { summary, error })).then(
+        () => toast.success('错误信息已复制到剪贴板'),
+        (e) => toast.error(`复制错误信息失败: ${e as Error}`),
+      );
+    }
+  };

  return (
-    <Box>
-      <Text>
-        <chakra.span>
-          解密错误：
-          <chakra.span color="red.700">{errorSummary}</chakra.span>
-        </chakra.span>
-        {error && (
-          <Button ml="2" onClick={onToggle} type="button">
-            诊断信息
-          </Button>
-        )}
-      </Text>
+    <>
+      <p>
+        解密错误：
+        <span className="text-red-600">{summary}</span>
+      </p>
      {error && (
-        <Collapse in={isOpen} animateOpacity>
-          <Box as="pre" display="inline-block" mt="2" px="4" py="2" bg="red.100" color="red.800" rounded="md">
-            {error}
-          </Box>
-        </Collapse>
+        <div className="collapse border-error border w-full text-left my-2 py-0">
+          <input className="[&&&]:py-2 [&&&]:min-h-[1.5rem]" type="checkbox" />
+          <div className="collapse-title font-semibold text-center [&&&]:min-h-[1.5rem] [&&&]:py-2">详细错误信息</div>
+          <div className="collapse-content text-sm overflow-hidden">
+            <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>
+    </>
  );
 }
--- a/src/features/file-listing/FileListing.tsx
+++ b/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>
  );
 }
--- a/src/features/file-listing/FileRow.tsx
+++ b/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 = 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 }));
-    }
-  };
+  const decryptedName = file.cleanName + '.' + file.ext;

  return (
-    <Collapse
-      in={isOpen}
-      animateOpacity
-      unmountOnExit
-      startingHeight={0}
-      onAnimationComplete={onCollapseAnimationComplete}
-      style={{ width: '100%', padding: '0.25rem' }}
-    >
-      <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} />}
+    <div className="card bg-base-100 dark:bg-gray-700 shadow-sm w-full md:w-[30%] " data-testid="file-row">
+      <div className="card-body items-center text-center px-2">
+        <h2 className="card-title max-w-full whitespace-nowrap flex gap-0" data-testid="audio-meta-song-name">
+          <span className="grow overflow-hidden text-ellipsis" title={decryptedName}>
+            {file.cleanName}
+          </span>
+          {isDecrypted && file.ext && <div className="ml-2 badge badge-accent">{file.ext}</div>}
+        </h2>

-                <Wrap>
-                  {isDecrypted && (
-                    <>
-                      <WrapItem>
-                        <Button type="button" onClick={togglePlay}>
-                          播放/暂停
-                        </Button>
-                      </WrapItem>
-                      <WrapItem>
-                        {file.decrypted && (
-                          <Link href={file.decrypted} download={decryptedName}>
-                            <Button as="span">下载</Button>
-                          </Link>
-                        )}
-                      </WrapItem>
-                    </>
-                  )}
-                  <WrapItem>
-                    <Button type="button" onClick={onClose}>
-                      删除
-                    </Button>
-                  </WrapItem>
-                </Wrap>
-              </VStack>
-            </GridItem>
-          </FileRowResponsiveGrid>
-        </CardBody>
-      </Card>
-    </Collapse>
+        <div className="w-full grow">
+          {file.state === ProcessState.ERROR && <FileError error={file.errorMessage} code={file.errorCode} />}
+          {isDecrypted && (
+            <audio className="w-full" aria-disabled={!file.decrypted} controls autoPlay={false} src={file.decrypted} />
+          )}
+        </div>
+
+        <div className="card-actions justify-end">
+          <a
+            href={file.decrypted}
+            download={decryptedName}
+            title={`下载: ${decryptedName}`}
+            className={classNames('btn', {
+              'btn-primary': file.decrypted,
+              'cursor-not-allowed pointer-events-none': !file.decrypted,
+            })}
+            data-testid="audio-download"
+          >
+            下载
+          </a>
+          <button type="button" className="btn btn-error" onClick={() => dispatch(deleteFile({ id }))}>
+            删除
+          </button>
+        </div>
+      </div>
+    </div>
  );
 }
--- a/src/features/file-listing/FileRowResponsiveGrid.tsx
+++ b/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,
-  },
-});
--- a/src/features/file-listing/SongMetadata.tsx
+++ b/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>
-  );
-}
--- a/src/features/file-listing/tests/FileListing.test.tsx
+++ b/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();
 });
--- a/src/features/file-listing/tests/FileRow.test.tsx
+++ b/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');
 });
--- a/src/features/file-listing/tests/fixture/file-list.ts
+++ b/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',
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
鲁树人	a11caaae92	refactor: major package updates	2025-10-16 01:00:38 +09:00
鲁树人	2e52c67533	chore: minor package updates	2025-10-15 23:15:00 +09:00
鲁树人	56bb94b90c	docs: update highlight styling	2025-10-15 23:12:47 +09:00
鲁树人	c1a5c6bde6	chore: reformat project	2025-10-15 23:10:19 +09:00
鲁树人	009804cbbd	docs: update notes regarding supported formats	2025-10-15 23:10:12 +09:00
鲁树人	ff6fc467ae	ci: only include artifact file once.	2025-10-15 22:52:59 +09:00
鲁树人	d514a87198	0.6.0	2025-10-15 22:47:59 +09:00
鲁树人	5c537ab8d9	ci: simplify release	2025-10-15 22:47:59 +09:00
鲁树人	48f10e8e30	fix: layout issue with android instruction in mobile screen	2025-10-15 22:08:51 +09:00
鲁树人	dfac382cbd	Merge pull request '添加 Mac QQ 音乐 v10 的说明' (#3 ) from feat/mac-qqmusic-v10 into main Reviewed-on: https://git.um-react.app/um/um-react/pulls/3	2025-10-15 12:59:19 +00:00
鲁树人	7b2558c585	feat: update instructions and scripts for QQMusic Mac v10.7 and v8.8.0	2025-10-15 02:08:32 +09:00
鲁树人	fb52b0197c	feat: add insturctions on how to dump keys for v10	2025-10-15 00:57:56 +09:00
鲁树人	f49f629917	build: allow vite to access 'index.html'	2025-10-14 07:54:21 +09:00
鲁树人	8093d30579	chore: remove npm package lock file	2025-10-14 07:53:54 +09:00
鲁树人	4fe6efec1f	0.5.2	2025-09-08 21:31:34 +09:00
鲁树人	c4fe9ce938	fix: update dependencies	2025-09-08 21:31:34 +09:00
鲁树人	045bea8084	chore: log which decipher was used	2025-09-08 20:47:13 +09:00
鲁树人	c68195eb9a	feat: add instructions to block update for qqmusic mac 8.8.0	2025-09-05 22:15:15 +09:00
鲁树人	b986a2ef99	0.5.1	2025-09-03 21:32:27 +09:00
鲁树人	b48d9b0079	chore: update major versions	2025-09-03 21:32:16 +09:00
鲁树人	62e49804a5	chore: update deps	2025-09-03 21:27:38 +09:00
鲁树人	c41e5ae531	build: sort out deps	2025-09-03 21:21:01 +09:00
鲁树人	27c33a7d20	fix: replace link to new git repo	2025-09-03 21:19:37 +09:00
鲁树人	bbb557eafd	Merge pull request 'fix(downloadAll): 一点点修改' (#92 ) from awalol/um-react:fix-downloadall into main Reviewed-on: https://git.unlock-music.dev/um/um-react/pulls/92	2025-07-16 10:05:52 +00:00
awalol	befe35e5bc	ui(DownloadAll): button position	2025-07-15 18:33:37 +00:00
awalol	1fb6526cdb	docs: update faq	2025-07-15 18:33:37 +00:00
awalol	d122eaecf5	refactor(DownloadAll): 调整按钮位置	2025-07-15 18:33:37 +00:00
awalol	2da766168c	refactor(DownloadAll): 并行下载	2025-07-15 18:33:37 +00:00
awalol	17200150dd	feat(DownloadAll): 并行下载	2025-07-15 18:33:37 +00:00
awalol	2c461df5fc	fix(downloadAll): 防止未解密文件导致的下载失败优化目录选择框的弹出优化权限请求	2025-07-15 18:33:37 +00:00
鲁树人	b493391371	Merge pull request '为解密文件添加 MIME 类型' (#95 ) from awalol/um-react:fix-mime into main Reviewed-on: https://git.unlock-music.dev/um/um-react/pulls/95	2025-07-14 11:27:00 +00:00
awalol	13b67f40aa	refactor(MIME): add getMimeTypeFromExt function	2025-07-14 01:51:28 +08:00
awalol	fbe8ef8ba1	fix: add MIME type for the decrypted file	2025-07-11 23:40:31 +08:00
鲁树人	54f784d778	ci: fix wry build	2025-07-05 06:45:43 +09:00
鲁树人	665524ee34	0.5.0	2025-07-05 04:51:47 +09:00
鲁树人	7c319fa4d9	ci: exclude zip file from gitea artifact	2025-07-05 04:51:47 +09:00
鲁树人	2598b977ab	ci: product win64 zip (wry) on build	2025-07-05 04:51:47 +09:00
鲁树人	d81963ddcd	Merge pull request '框架迁移: Chakra 迁移到 Daisy UI' (#86 ) from chakra-to-daisy into main Reviewed-on: https://git.unlock-music.dev/um/um-react/pulls/86	2025-07-04 16:46:19 +00:00
鲁树人	99bce5c4ef	fix: improve dark mode color	2025-07-05 01:13:39 +09:00
鲁树人	3fcbe054b0	chore: bump node types version	2025-07-05 00:55:37 +09:00
鲁树人	67fbe77157	chore: bump minor dep version	2025-07-05 00:53:13 +09:00
鲁树人	d57cdcdb49	fix: reduce footer text, move project information to faq page	2025-06-16 22:31:08 +09:00
鲁树人	ff79b4ce27	chore: fix type issue with filesystem access api	2025-06-16 22:31:03 +09:00
鲁树人	cbb6347251	Merge pull request 'feat: 全部下载' (#91 ) from awalol/um-react:downloadall-fork-chakra-to-daisy into chakra-to-daisy Reviewed-on: https://git.unlock-music.dev/um/um-react/pulls/91 Reviewed-by: 鲁树人 <lsr@noreply.unlock-music.dev>	2025-06-16 10:15:13 +00:00
awalol	a5d0ec29a1	增加文件夹选取取消判断使用 toast 进行提示使用 react-icons 获取下载图标使用 pipeTo 方法写出到文件	2025-06-16 00:56:20 +08:00
awalol	fa7292f65b	ui: 完善全部下载按钮的样式和位置	2025-06-15 14:05:11 +08:00
awalol	519ced5e88	feat: 全部下载	2025-06-15 04:01:52 +08:00
鲁树人	b33ffa6ca7	build: include _redirects for netlify deployment	2025-05-19 10:00:53 +09:00
鲁树人	09c1bc474e	child: remove base	2025-05-19 09:58:13 +09:00
鲁树人	e0b3bd60c2	chore: update wording for settings	2025-05-19 09:51:00 +09:00
鲁树人	6371c58cd5	fix: theme support	2025-05-19 09:50:52 +09:00
鲁树人	98f1be9ac7	fix: default sub-nav to align top on large screen	2025-05-19 09:26:54 +09:00
鲁树人	3541af7a96	refactor: deep link for faq	2025-05-19 09:23:14 +09:00
鲁树人	3ab73d8369	adjust dark mode and layout	2025-05-18 23:18:01 +09:00
鲁树人	6cb1f9f87f	fix: adjust layout for settings	2025-05-18 11:05:50 +09:00
鲁树人	9518b813bd	refactor: batch 4	2025-05-18 09:58:34 +09:00
鲁树人	2e4e57be45	refactor: batch 3	2025-05-18 02:41:20 +09:00
鲁树人	75b43e1e84	refactor: batch 2	2025-05-17 11:20:52 +09:00
鲁树人	246ba48135	fix: build/test issue	2025-05-17 06:09:00 +09:00
鲁树人	13c669b4ea	refactor: batch 1	2025-05-17 05:59:39 +09:00
鲁树人	089d66cbf4	feat: add daisy ui	2025-05-17 01:44:55 +09:00
鲁树人	33a5f277fa	chore: bump major versions	2025-05-17 01:42:58 +09:00
鲁树人	8a77cb0dc8	chore: update packages	2025-05-17 01:39:01 +09:00
鲁树人	0a820b620b	docs: use gitea actions badge	2025-05-08 07:22:52 +09:00
鲁树人	721d947fdb	docs: add link to lib_um_crypto_rust	2025-05-06 10:28:22 +09:00
鲁树人	1880220aaa	docs: add issue template	2025-05-04 22:13:25 +09:00
鲁树人	d91e2fffe4	chore: bump version to v0.4.7; upgrade deps	2025-03-31 09:37:58 +09:00
鲁树人	88cfbcd337	build: retrive git hash	2025-03-31 04:03:27 +09:00
鲁树人	e9480ce6a4	chore: bump version to v0.4.2	2025-03-28 12:15:57 +09:00
鲁树人	a07bcf2575	build: build with docker	2025-03-28 12:14:59 +09:00
鲁树人	a40ecc4569	chore: reduce vscode extensions recommended	2025-03-28 11:27:51 +09:00
鲁树人	1abfe3498f	chore: bump version to v0.4.1	2025-02-25 20:30:59 +09:00
鲁树人	e69393d1bc	fix(kgm): extract hash/key from both tables	2025-02-25 20:30:25 +09:00
鲁树人	19c5d0aab9	docs: update readme	2025-02-25 07:08:37 +09:00
鲁树人	baab3057cf	0.4.0	2025-02-25 07:08:31 +09:00
鲁树人	c71078f5da	feat(kgm): kgm v5 (aka. kgg) support	2025-02-25 07:05:31 +09:00