From 3433d2e86076c9ebf069c1bb8ebe462cec4d86d4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=81=E6=A0=91=E4=BA=BA?= <lu.shuren@um-react.app>
Date: Fri, 16 Jun 2023 02:03:23 +0100
Subject: [PATCH 1/4] fix: performance issue when there's over 100s ekeys

---
 .../settings/panels/PanelQMCv2Key.tsx         | 58 +++---------------
 .../settings/panels/QMCv2/KeyInput.tsx        | 59 +++++++++++++++++++
 2 files changed, 66 insertions(+), 51 deletions(-)
 create mode 100644 src/features/settings/panels/QMCv2/KeyInput.tsx

diff --git a/src/features/settings/panels/PanelQMCv2Key.tsx b/src/features/settings/panels/PanelQMCv2Key.tsx
index e485d4b..8b7e7e7 100644
--- a/src/features/settings/panels/PanelQMCv2Key.tsx
+++ b/src/features/settings/panels/PanelQMCv2Key.tsx
@@ -7,26 +7,21 @@ import {
   Heading,
   Icon,
   IconButton,
-  Input,
-  InputGroup,
-  InputLeftElement,
-  InputRightElement,
   List,
-  ListItem,
   Menu,
   MenuButton,
   MenuDivider,
   MenuItem,
   MenuList,
   Text,
-  VStack,
 } from '@chakra-ui/react';
 import { useDispatch, useSelector } from 'react-redux';
-import { qmc2AddKey, qmc2ClearKeys, qmc2DeleteKey, qmc2UpdateKey } from '../settingsSlice';
+import { qmc2AddKey, qmc2ClearKeys } from '../settingsSlice';
 import { selectStagingQMCv2Settings } from '../settingsSelector';
-import React, { useState } from 'react';
-import { MdAdd, MdDelete, MdDeleteForever, MdExpandMore, MdFileUpload, MdVpnKey } from 'react-icons/md';
+import { useState } from 'react';
+import { MdAdd, MdDeleteForever, MdExpandMore, MdFileUpload } from 'react-icons/md';
 import { ImportFileModal } from './QMCv2/ImportFileModal';
+import { KeyInput } from './QMCv2/KeyInput';
 
 export function PanelQMCv2Key() {
   const dispatch = useDispatch();
@@ -34,9 +29,6 @@ export function PanelQMCv2Key() {
   const [showImportModal, setShowImportModal] = useState(false);
 
   const addKey = () => dispatch(qmc2AddKey());
-  const updateKey = (prop: 'name' | 'key', id: string, e: React.ChangeEvent<HTMLInputElement>) =>
-    dispatch(qmc2UpdateKey({ id, field: prop, value: e.target.value }));
-  const deleteKey = (id: string) => dispatch(qmc2DeleteKey({ id }));
   const clearAll = () => dispatch(qmc2ClearKeys());
 
   return (
@@ -50,7 +42,7 @@ export function PanelQMCv2Key() {
         客户端的情况下，其「离线加密文件」对应的「密钥」储存在独立的数据库文件内。
       </Text>
 
-      <Box pb={2} pt={2}>
+      <HStack pb={2} pt={2}>
         <ButtonGroup isAttached colorScheme="purple" variant="outline">
           <Button onClick={addKey} leftIcon={<Icon as={MdAdd} />}>
             添加一条密钥
@@ -68,48 +60,12 @@ export function PanelQMCv2Key() {
             </MenuList>
           </Menu>
         </ButtonGroup>
-      </Box>
+      </HStack>
 
       <Box flex={1} minH={0} overflow="auto" pr="4">
         <List spacing={3}>
           {qmc2Keys.map(({ id, key, name }, i) => (
-            <ListItem key={id} mt={0} pt={2} pb={2} _even={{ bg: 'gray.50' }}>
-              <HStack>
-                <Text w="2em" textAlign="center">
-                  {i + 1}
-                </Text>
-
-                <VStack flex={1}>
-                  <Input
-                    variant="flushed"
-                    placeholder="文件名"
-                    value={name}
-                    onChange={(e) => updateKey('name', id, e)}
-                  />
-
-                  <InputGroup size="xs">
-                    <InputLeftElement pr="2">
-                      <Icon as={MdVpnKey} />
-                    </InputLeftElement>
-                    <Input variant="flushed" placeholder="密钥" value={key} onChange={(e) => updateKey('key', id, e)} />
-                    <InputRightElement>
-                      <Text pl="2" color={key.length ? 'green.500' : 'red.500'}>
-                        <code>{key.length || '?'}</code>
-                      </Text>
-                    </InputRightElement>
-                  </InputGroup>
-                </VStack>
-
-                <IconButton
-                  aria-label="删除该密钥"
-                  icon={<Icon as={MdDelete} boxSize={6} />}
-                  variant="ghost"
-                  colorScheme="red"
-                  type="button"
-                  onClick={() => deleteKey(id)}
-                />
-              </HStack>
-            </ListItem>
+            <KeyInput key={id} id={id} ekey={key} name={name} i={i} />
           ))}
         </List>
         {qmc2Keys.length === 0 && <Text>还没有添加密钥。</Text>}
diff --git a/src/features/settings/panels/QMCv2/KeyInput.tsx b/src/features/settings/panels/QMCv2/KeyInput.tsx
new file mode 100644
index 0000000..77d193e
--- /dev/null
+++ b/src/features/settings/panels/QMCv2/KeyInput.tsx
@@ -0,0 +1,59 @@
+import {
+  HStack,
+  Icon,
+  IconButton,
+  Input,
+  InputGroup,
+  InputLeftElement,
+  InputRightElement,
+  ListItem,
+  Text,
+  VStack,
+} from '@chakra-ui/react';
+import { MdDelete, MdVpnKey } from 'react-icons/md';
+import { qmc2DeleteKey, qmc2UpdateKey } from '../../settingsSlice';
+import { useAppDispatch } from '~/hooks';
+import { memo } from 'react';
+
+export const KeyInput = memo(({ id, name, ekey, i }: { id: string; name: string; ekey: string; i: number }) => {
+  const dispatch = useAppDispatch();
+
+  const updateKey = (prop: 'name' | 'key', e: React.ChangeEvent<HTMLInputElement>) =>
+    dispatch(qmc2UpdateKey({ id, field: prop, value: e.target.value }));
+  const deleteKey = () => dispatch(qmc2DeleteKey({ id }));
+
+  return (
+    <ListItem mt={0} pt={2} pb={2} _even={{ bg: 'gray.50' }}>
+      <HStack>
+        <Text w="2em" textAlign="center">
+          {i + 1}
+        </Text>
+
+        <VStack flex={1}>
+          <Input variant="flushed" placeholder="文件名" value={name} onChange={(e) => updateKey('name', e)} />
+
+          <InputGroup size="xs">
+            <InputLeftElement pr="2">
+              <Icon as={MdVpnKey} />
+            </InputLeftElement>
+            <Input variant="flushed" placeholder="密钥" value={ekey} onChange={(e) => updateKey('key', e)} />
+            <InputRightElement>
+              <Text pl="2" color={ekey.length ? 'green.500' : 'red.500'}>
+                <code>{ekey.length || '?'}</code>
+              </Text>
+            </InputRightElement>
+          </InputGroup>
+        </VStack>
+
+        <IconButton
+          aria-label="删除该密钥"
+          icon={<Icon as={MdDelete} boxSize={6} />}
+          variant="ghost"
+          colorScheme="red"
+          type="button"
+          onClick={deleteKey}
+        />
+      </HStack>
+    </ListItem>
+  );
+});

From 77c201c551ec08066a43279ad6c0e4eae66b10cf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=81=E6=A0=91=E4=BA=BA?= <lu.shuren@um-react.app>
Date: Fri, 16 Jun 2023 02:28:38 +0100
Subject: [PATCH 2/4] feat: added option to search closest ekey

---
 .../settings/panels/PanelQMCv2Key.tsx         | 41 +++++++++-
 .../settings/panels/QMCv2/InstructionsIOS.tsx |  2 +
 src/features/settings/persistSettings.ts      | 13 +++-
 src/features/settings/settingsSelector.ts     | 17 +++-
 src/features/settings/settingsSlice.ts        | 10 +++
 src/util/__tests__/levenshtein.test.ts        | 17 ++++
 src/util/levenshtein.ts                       | 77 +++++++++++++++++++
 7 files changed, 169 insertions(+), 8 deletions(-)
 create mode 100644 src/util/__tests__/levenshtein.test.ts
 create mode 100644 src/util/levenshtein.ts

diff --git a/src/features/settings/panels/PanelQMCv2Key.tsx b/src/features/settings/panels/PanelQMCv2Key.tsx
index 8b7e7e7..52856f2 100644
--- a/src/features/settings/panels/PanelQMCv2Key.tsx
+++ b/src/features/settings/panels/PanelQMCv2Key.tsx
@@ -2,6 +2,7 @@ import {
   Box,
   Button,
   ButtonGroup,
+  Checkbox,
   Flex,
   HStack,
   Heading,
@@ -14,23 +15,29 @@ import {
   MenuItem,
   MenuList,
   Text,
+  Tooltip,
 } from '@chakra-ui/react';
 import { useDispatch, useSelector } from 'react-redux';
-import { qmc2AddKey, qmc2ClearKeys } from '../settingsSlice';
+import { qmc2AddKey, qmc2AllowFuzzyNameSearch, qmc2ClearKeys } from '../settingsSlice';
 import { selectStagingQMCv2Settings } from '../settingsSelector';
-import { useState } from 'react';
+import React, { useState } from 'react';
 import { MdAdd, MdDeleteForever, MdExpandMore, MdFileUpload } from 'react-icons/md';
 import { ImportFileModal } from './QMCv2/ImportFileModal';
 import { KeyInput } from './QMCv2/KeyInput';
+import { InfoOutlineIcon } from '@chakra-ui/icons';
 
 export function PanelQMCv2Key() {
   const dispatch = useDispatch();
-  const qmc2Keys = useSelector(selectStagingQMCv2Settings).keys;
+  const { keys: qmc2Keys, allowFuzzyNameSearch } = useSelector(selectStagingQMCv2Settings);
   const [showImportModal, setShowImportModal] = useState(false);
 
   const addKey = () => dispatch(qmc2AddKey());
   const clearAll = () => dispatch(qmc2ClearKeys());
 
+  const handleAllowFuzzyNameSearchCheckbox = (e: React.ChangeEvent<HTMLInputElement>) => {
+    dispatch(qmc2AllowFuzzyNameSearch({ enable: e.target.checked }));
+  };
+
   return (
     <Flex minH={0} flexDir="column" flex={1}>
       <Heading as="h2" size="lg">
@@ -60,6 +67,34 @@ export function PanelQMCv2Key() {
             </MenuList>
           </Menu>
         </ButtonGroup>
+
+        <HStack>
+          <Checkbox isChecked={allowFuzzyNameSearch} onChange={handleAllowFuzzyNameSearchCheckbox}>
+            <Text>匹配相似文件名</Text>
+          </Checkbox>
+          <Tooltip
+            hasArrow
+            closeOnClick={false}
+            label={
+              <Box>
+                <Text>若文件名匹配失败，则使用相似文件名的密钥。</Text>
+                <Text>
+                  使用「
+                  <ruby>
+                    莱文斯坦距离
+                    <rp> (</rp>
+                    <rt>Levenshtein distance</rt>
+                    <rp>)</rp>
+                  </ruby>
+                  」算法计算相似程度。
+                </Text>
+                <Text>若密钥数量过多，匹配时可能会造成浏览器卡顿或无响应一段时间。</Text>
+              </Box>
+            }
+          >
+            <InfoOutlineIcon />
+          </Tooltip>
+        </HStack>
       </HStack>
 
       <Box flex={1} minH={0} overflow="auto" pr="4">
diff --git a/src/features/settings/panels/QMCv2/InstructionsIOS.tsx b/src/features/settings/panels/QMCv2/InstructionsIOS.tsx
index 9bb4662..1060f20 100644
--- a/src/features/settings/panels/QMCv2/InstructionsIOS.tsx
+++ b/src/features/settings/panels/QMCv2/InstructionsIOS.tsx
@@ -54,6 +54,8 @@ export function InstructionsIOS() {
       <Heading as="h3" size="md" mt="3">
         解密离线文件
       </Heading>
+      <Text>勾选设定界面的「使用近似文件名匹配」可跳过该节内容。</Text>
+      <Text>⚠ 注意：若密钥过多，匹配过程可能会造成浏览器卡顿或无响应。</Text>
       <OrderedList>
         <ListItem>
           <Text>
diff --git a/src/features/settings/persistSettings.ts b/src/features/settings/persistSettings.ts
index 5a1f6a5..c77d543 100644
--- a/src/features/settings/persistSettings.ts
+++ b/src/features/settings/persistSettings.ts
@@ -10,9 +10,16 @@ const DEFAULT_STORAGE_KEY = 'um-react-settings';
 
 function mergeSettings(settings: ProductionSettings): ProductionSettings {
   return produce(settingsSlice.getInitialState().production, (draft) => {
-    for (const [k, v] of enumObject(settings.qmc2?.keys)) {
-      if (typeof v === 'string') {
-        draft.qmc2.keys[k] = v;
+    if (settings?.qmc2) {
+      const { allowFuzzyNameSearch, keys } = settings.qmc2;
+      for (const [k, v] of enumObject(keys)) {
+        if (typeof v === 'string') {
+          draft.qmc2.keys[k] = v;
+        }
+      }
+
+      if (typeof allowFuzzyNameSearch === 'boolean') {
+        draft.qmc2.allowFuzzyNameSearch = allowFuzzyNameSearch;
       }
     }
   });
diff --git a/src/features/settings/settingsSelector.ts b/src/features/settings/settingsSelector.ts
index 8ea41d4..f53f796 100644
--- a/src/features/settings/settingsSelector.ts
+++ b/src/features/settings/settingsSelector.ts
@@ -1,5 +1,6 @@
 import type { DecryptCommandOptions } from '~/decrypt-worker/types';
 import type { RootState } from '~/store';
+import { closestByLevenshtein } from '~/util/levenshtein';
 import { hasOwn } from '~/util/objects';
 
 export const selectStagingQMCv2Settings = (state: RootState) => state.settings.staging.qmc2;
@@ -7,9 +8,21 @@ export const selectFinalQMCv2Settings = (state: RootState) => state.settings.pro
 
 export const selectDecryptOptionByFile = (state: RootState, name: string): DecryptCommandOptions => {
   const normalizedName = name.normalize();
-  const qmc2Keys = selectFinalQMCv2Settings(state).keys;
+
+  let qmc2Key: string | undefined;
+  const { keys: qmc2Keys, allowFuzzyNameSearch } = selectFinalQMCv2Settings(state);
+  if (hasOwn(qmc2Keys, normalizedName)) {
+    qmc2Key = qmc2Keys[normalizedName];
+  } else if (allowFuzzyNameSearch) {
+    const qmc2KeyStoreNames = Object.keys(qmc2Keys);
+    if (qmc2KeyStoreNames.length > 0) {
+      const closestName = closestByLevenshtein(normalizedName, qmc2KeyStoreNames);
+      console.debug('qmc2: key db could not find %o, using closest %o instead.', normalizedName, closestName);
+      qmc2Key = qmc2Keys[closestName];
+    }
+  }
 
   return {
-    qmc2Key: hasOwn(qmc2Keys, normalizedName) ? qmc2Keys[normalizedName] : undefined,
+    qmc2Key,
   };
 };
diff --git a/src/features/settings/settingsSlice.ts b/src/features/settings/settingsSlice.ts
index 45097f3..dacd10b 100644
--- a/src/features/settings/settingsSlice.ts
+++ b/src/features/settings/settingsSlice.ts
@@ -6,12 +6,14 @@ import { objectify } from 'radash';
 export interface StagingSettings {
   qmc2: {
     keys: { id: string; name: string; key: string }[];
+    allowFuzzyNameSearch: boolean;
   };
 }
 
 export interface ProductionSettings {
   qmc2: {
     keys: Record<string, string>; // {  [fileName]: ekey  }
+    allowFuzzyNameSearch: boolean;
   };
 }
 
@@ -22,11 +24,13 @@ export interface SettingsState {
 const initialState: SettingsState = {
   staging: {
     qmc2: {
+      allowFuzzyNameSearch: false,
       keys: [],
     },
   },
   production: {
     qmc2: {
+      allowFuzzyNameSearch: false,
       keys: {},
     },
   },
@@ -39,12 +43,14 @@ const stagingToProduction = (staging: StagingSettings): ProductionSettings => ({
       (item) => item.name.normalize(),
       (item) => item.key.trim()
     ),
+    allowFuzzyNameSearch: staging.qmc2.allowFuzzyNameSearch,
   },
 });
 
 const productionToStaging = (production: ProductionSettings): StagingSettings => ({
   qmc2: {
     keys: Object.entries(production.qmc2.keys).map(([name, key]) => ({ id: nanoid(), name, key })),
+    allowFuzzyNameSearch: production.qmc2.allowFuzzyNameSearch,
   },
 });
 
@@ -81,6 +87,9 @@ export const settingsSlice = createSlice({
     qmc2ClearKeys(state) {
       state.staging.qmc2.keys = [];
     },
+    qmc2AllowFuzzyNameSearch(state, { payload: { enable } }: PayloadAction<{ enable: boolean }>) {
+      state.staging.qmc2.allowFuzzyNameSearch = enable;
+    },
     discardStagingChanges: (state) => {
       state.staging = productionToStaging(state.production);
     },
@@ -107,6 +116,7 @@ export const {
   qmc2DeleteKey,
   qmc2ClearKeys,
   qmc2ImportKeys,
+  qmc2AllowFuzzyNameSearch,
 
   commitStagingChange,
   discardStagingChanges,
diff --git a/src/util/__tests__/levenshtein.test.ts b/src/util/__tests__/levenshtein.test.ts
new file mode 100644
index 0000000..e3c5b1e
--- /dev/null
+++ b/src/util/__tests__/levenshtein.test.ts
@@ -0,0 +1,17 @@
+import { closestByLevenshtein, levenshtein } from '../levenshtein';
+
+test('levenshtein quick test', () => {
+  expect(levenshtein('cat', '')).toStrictEqual(3);
+  expect(levenshtein('', 'cat')).toStrictEqual(3);
+  expect(levenshtein('cat', 'cat')).toStrictEqual(0);
+  expect(levenshtein('cat', 'cut')).toStrictEqual(1);
+  expect(levenshtein('kitten', 'sitting')).toStrictEqual(3);
+  expect(levenshtein('tier', 'tor')).toStrictEqual(2);
+  expect(levenshtein('mississippi', 'swiss miss')).toStrictEqual(8);
+});
+
+test('closestByLevenshtein quick test', () => {
+  expect(closestByLevenshtein('cat', ['cut', 'dog', 'bat'])).toStrictEqual('cut');
+  expect(closestByLevenshtein('dag', ['dog', 'pumpkin'])).toStrictEqual('dog');
+  expect(closestByLevenshtein('hello', ['jello', 'yellow', 'bello'])).toStrictEqual('jello');
+});
diff --git a/src/util/levenshtein.ts b/src/util/levenshtein.ts
new file mode 100644
index 0000000..49617c5
--- /dev/null
+++ b/src/util/levenshtein.ts
@@ -0,0 +1,77 @@
+const textEncoder = new TextEncoder();
+
+// translation of pseudocode from Wikipedia:
+// https://en.wikipedia.org/wiki/Levenshtein_distance#Iterative_with_two_matrix_rows
+export function levenshtein(str1: string, str2: string) {
+  if (str1 === str2) {
+    return 0;
+  }
+
+  if (str1.length === 0) {
+    return str2.length;
+  } else if (str2.length === 0) {
+    return str1.length;
+  }
+
+  // Convert them to Uint8Array to avoid expensive string APIs.
+  const s = textEncoder.encode(str1.toLowerCase());
+  const t = textEncoder.encode(str2.toLowerCase());
+  const m = s.byteLength;
+  const n = t.byteLength;
+
+  // create two work vectors of integer distances
+  let v0 = new Uint32Array(n + 1);
+  let v1 = new Uint32Array(n + 1);
+
+  // initialize v0 (the previous row of distances)
+  // this row is A[0][i]: edit distance from an empty s to t;
+  // that distance is the number of characters to append to  s to make t.
+  for (let i = 0; i <= n; i++) {
+    v0[i] = i;
+  }
+
+  for (let i = 0; i < m; i++) {
+    // calculate v1 (current row distances) from the previous row v0
+
+    // first element of v1 is A[i + 1][0]
+    //   edit distance is delete (i + 1) chars from s to match empty t
+    v1[0] = i + 1;
+
+    // use formula to fill in the rest of the row
+    for (let j = 0; j < n; j++) {
+      // calculating costs for A[i + 1][j + 1]
+      const deletionCost = v0[j + 1] + 1;
+      const insertionCost = v1[j] + 1;
+      const substitutionCost = v0[j] + (s[i] === t[j] ? 0 : 1);
+      v1[j + 1] = Math.min(deletionCost, insertionCost, substitutionCost);
+    }
+
+    // copy v1 (current row) to v0 (previous row) for next iteration
+    // since data in v1 is always invalidated, a swap without copy could be more efficient
+    [v0, v1] = [v1, v0];
+  }
+
+  // after the last swap, the results of v1 are now in v0
+  return v0[n];
+}
+
+export function closestByLevenshtein(str: string, candidates: string[]) {
+  // Faster than pre-calculate all and pass scores to Math.min.
+  const n = candidates.length;
+  if (n === 0) {
+    throw new Error('empty candidates');
+  }
+
+  let lowestIdx = 0;
+  let lowestScore = levenshtein(str, candidates[0]);
+
+  for (let i = 1; i < n; i++) {
+    const score = levenshtein(str, candidates[i]);
+    if (score < lowestScore) {
+      lowestScore = score;
+      lowestIdx = i;
+    }
+  }
+
+  return candidates[lowestIdx];
+}

From 672c5681ed8941a708670c7b5c429a7ae9ad2f6f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=81=E6=A0=91=E4=BA=BA?= <lu.shuren@um-react.app>
Date: Fri, 16 Jun 2023 20:43:49 +0100
Subject: [PATCH 3/4] docs: improve ios docs

---
 .../settings/panels/QMCv2/InstructionsIOS.tsx | 136 ++++++------------
 .../panels/QMCv2/InstructionsIOSCondition.tsx | 101 +++++++++++++
 .../settings/panels/QMCv2/iosAllowBackup.webp | Bin 0 -> 5236 bytes
 3 files changed, 143 insertions(+), 94 deletions(-)
 create mode 100644 src/features/settings/panels/QMCv2/InstructionsIOSCondition.tsx
 create mode 100644 src/features/settings/panels/QMCv2/iosAllowBackup.webp

diff --git a/src/features/settings/panels/QMCv2/InstructionsIOS.tsx b/src/features/settings/panels/QMCv2/InstructionsIOS.tsx
index 1060f20..3454525 100644
--- a/src/features/settings/panels/QMCv2/InstructionsIOS.tsx
+++ b/src/features/settings/panels/QMCv2/InstructionsIOS.tsx
@@ -1,103 +1,51 @@
-import { Box, Code, Heading, ListItem, OrderedList, Text, UnorderedList } from '@chakra-ui/react';
-import { FilePathBlock } from '~/components/FilePathBlock';
-
-const EXAMPLE_MEDIA_ID = '0011wjLv1bIkvv';
-const EXAMPLE_NAME_IOS = '333407709-0011wjLv1bIkvv-1.mgalaxy';
-const EXAMPLE_NAME_DB = 'Q0M00011wjLv1bIkvv.mflac';
+import {
+  Accordion,
+  AccordionButton,
+  AccordionIcon,
+  AccordionItem,
+  AccordionPanel,
+  Box,
+  Heading,
+  Text,
+} from '@chakra-ui/react';
+import { InstructionsIOSCondition } from './InstructionsIOSCondition';
 
 export function InstructionsIOS() {
   return (
     <>
-      <Text>不推荐从该平台客户端提取文件，因为使用者需要对 iOS 设备进行完整备份。</Text>
-      <Heading as="h3" size="md" mt="3">
-        未越狱用户指南
-      </Heading>
-      <Text>未越狱用户需要对设备进行完整备份，并能提取备份内的文件。</Text>
-      <OrderedList>
-        <ListItem>
-          <Text>使用你喜欢的备份软件对 iOS 设备进行完整备份；</Text>
-        </ListItem>
-        <ListItem>
-          <Text>打开备份文件，并导航到下述目录：</Text>
-          <FilePathBlock>/AppDomain-com.tencent.QQMusic/Documents/mmkv/</FilePathBlock>
-        </ListItem>
-        <ListItem>
-          <Text>
-            提取或导出密钥数据库文件 <Code>filenameEkeyMap</Code>；
-          </Text>
-        </ListItem>
-        <ListItem>
-          <Text>
-            提交导出的 <Code>filenameEkeyMap</Code> 文件；
-          </Text>
-        </ListItem>
-        <ListItem>
-          <Text>按下「保存」来应用更改。</Text>
-        </ListItem>
-      </OrderedList>
-      <Heading as="h3" size="md" mt="3">
-        获取离线文件
-      </Heading>
       <Box>
-        <Text>通过客户端下载的音乐文件存储在备份的下述目录：</Text>
-        <Code>/AppDomain-com.tencent.QQMusic/Library/Application Support/com.tencent.QQMusic/iData/iMusic</Code>
-        <Text>
-          该目录又存在数个子目录，其子目录下保存的「<Code>*.mgalaxy</Code>」文件则是最终的加密文件。
-        </Text>
-        <Text>
-          格式：<Code>[随机数字]-[id]-[随机数字].mgalaxy</Code>
-        </Text>
-        <Text>
-          &#x3000;例：<Code>{EXAMPLE_NAME_IOS}</Code>
-        </Text>
+        <Text>iOS 设备获取应用私有文件比较麻烦，你需要越狱或使用一台 PC 或 Mac 来对 iOS 设备进行完整备份。</Text>
+        <Text>因此，建议换用 PC 或 Mac 重新下载音乐文件然后再尝试解密。</Text>
       </Box>
-      <Heading as="h3" size="md" mt="3">
-        解密离线文件
-      </Heading>
-      <Text>勾选设定界面的「使用近似文件名匹配」可跳过该节内容。</Text>
-      <Text>⚠ 注意：若密钥过多，匹配过程可能会造成浏览器卡顿或无响应。</Text>
-      <OrderedList>
-        <ListItem>
-          <Text>
-            在上方的样例文件的情况下，得知其 id 为 <Code>{EXAMPLE_MEDIA_ID}</Code>；
-          </Text>
-        </ListItem>
-        <ListItem>
-          <Text>
-            查找密钥表，得到文件名「<Code>{EXAMPLE_NAME_DB}</Code>」；
-          </Text>
-        </ListItem>
-        <ListItem>
-          <Text>
-            将导出的「<Code>{EXAMPLE_NAME_IOS}</Code>」更名为数据库存储的文件名「
-            <Code>{EXAMPLE_NAME_DB}</Code>」；
-          </Text>
-        </ListItem>
-        <ListItem>
-          <Text>
-            回到主界面，提交离线文件「<Code>{EXAMPLE_NAME_DB}</Code>」。
-          </Text>
-        </ListItem>
-      </OrderedList>
-      <Heading as="h3" size="md" mt="3">
-        越狱用户参考
-      </Heading>
-      <Text>该节信息根据网络上公开的信息整理，仅供参考。</Text>
-      <UnorderedList>
-        <ListItem>
-          <Text>密钥数据库文件路径：</Text>
-          <FilePathBlock>
-            /var/mobile/Containers/Data/Application/&lt;随机&gt;/Documents/mmkv/filenameEkeyMap
-          </FilePathBlock>
-        </ListItem>
-        <ListItem>
-          <Text>离线音乐文件下载目录：</Text>
-          <FilePathBlock>
-            /var/mobile/Containers/Data/Application/&lt;随机&gt;/Library/Application
-            Support/com.tencent.QQMusic/iData/iMusic
-          </FilePathBlock>
-        </ListItem>
-      </UnorderedList>
+      <Accordion allowToggle mt="2">
+        <AccordionItem>
+          <Heading as="h3" size="md">
+            <AccordionButton>
+              <Box as="span" flex="1" textAlign="left">
+                我的 iOS 设备已经越狱
+              </Box>
+              <AccordionIcon />
+            </AccordionButton>
+          </Heading>
+          <AccordionPanel pb={4}>
+            <InstructionsIOSCondition jailbreak={true} />
+          </AccordionPanel>
+        </AccordionItem>
+
+        <AccordionItem>
+          <Heading as="h3" size="md">
+            <AccordionButton>
+              <Box as="span" flex="1" textAlign="left">
+                我的 iOS 设备没有越狱
+              </Box>
+              <AccordionIcon />
+            </AccordionButton>
+          </Heading>
+          <AccordionPanel pb={4}>
+            <InstructionsIOSCondition jailbreak={false} />
+          </AccordionPanel>
+        </AccordionItem>
+      </Accordion>
     </>
   );
 }
diff --git a/src/features/settings/panels/QMCv2/InstructionsIOSCondition.tsx b/src/features/settings/panels/QMCv2/InstructionsIOSCondition.tsx
new file mode 100644
index 0000000..2527e09
--- /dev/null
+++ b/src/features/settings/panels/QMCv2/InstructionsIOSCondition.tsx
@@ -0,0 +1,101 @@
+import { Box, Code, Heading, Image, ListItem, OrderedList, Text } from '@chakra-ui/react';
+import iosAllowBackup from './iosAllowBackup.webp';
+import { FilePathBlock } from '~/components/FilePathBlock';
+
+const EXAMPLE_MEDIA_ID = '0011wjLv1bIkvv';
+const EXAMPLE_NAME_IOS = '333407709-0011wjLv1bIkvv-1.mgalaxy';
+const EXAMPLE_NAME_DB = 'Q0M00011wjLv1bIkvv.mflac';
+
+export function InstructionsIOSCondition({ jailbreak }: { jailbreak: boolean }) {
+  const useJailbreak = jailbreak;
+  const useBackup = !jailbreak;
+
+  const pathPrefix = jailbreak ? '/var/mobile/Containers/Data/Application/<随机>/' : '/AppDomain-';
+
+  return (
+    <>
+      <Heading as="h3" size="md">
+        获取密钥数据库文件
+      </Heading>
+      <OrderedList>
+        {useBackup && (
+          <ListItem>
+            <Text>首先需要在 iOS 客户端的设定允许备份：</Text>
+            <Image src={iosAllowBackup}></Image>
+          </ListItem>
+        )}
+        {useBackup && (
+          <ListItem>
+            <Text>使用你喜欢的备份软件对 iOS 设备进行完整备份；</Text>
+          </ListItem>
+        )}
+        <ListItem>
+          {useBackup && <Text>打开备份文件，并导航到下述目录：</Text>}
+          {useJailbreak && <Text>访问下述目录：</Text>}
+          <FilePathBlock>{pathPrefix}com.tencent.QQMusic/Documents/mmkv/</FilePathBlock>
+        </ListItem>
+        <ListItem>
+          <Text>
+            提取或导出密钥数据库文件 <Code>filenameEkeyMap</Code>；
+          </Text>
+        </ListItem>
+        <ListItem>
+          <Text>
+            提交导出的 <Code>filenameEkeyMap</Code> 文件；
+          </Text>
+        </ListItem>
+        <ListItem>
+          <Text>按下「保存」来应用更改。</Text>
+        </ListItem>
+      </OrderedList>
+
+      <Heading as="h3" size="md" mt="3">
+        获取离线文件
+      </Heading>
+      <Box>
+        <Text>访问下述目录：</Text>
+        <FilePathBlock>
+          {pathPrefix}com.tencent.QQMusic/Library/Application Support/com.tencent.QQMusic/iData/iMusic
+        </FilePathBlock>
+        <Text>
+          该目录又存在数个子目录，其子目录下保存的「<Code>[字符].m[字符]</Code>」文件则是最终的加密文件。
+        </Text>
+        <Text>
+          格式：<Code>[song_id]-[mid]-[随机数字].m[后缀]</Code>
+        </Text>
+        <Text>
+          &#x3000;例：<Code>{EXAMPLE_NAME_IOS}</Code>
+        </Text>
+      </Box>
+
+      <Heading as="h3" size="md" mt="3">
+        解密离线文件
+      </Heading>
+      <Text>勾选设定界面的「使用近似文件名匹配」可跳过该节内容。</Text>
+      <Text>⚠ 注意：若密钥过多，匹配过程可能会造成浏览器卡顿或无响应。</Text>
+      <OrderedList>
+        <ListItem>
+          <Text>
+            提取文件的 <Code>[mid]</Code> 部分，如 <Code>{EXAMPLE_MEDIA_ID}</Code>；
+          </Text>
+        </ListItem>
+        <ListItem>
+          <Text>
+            查找密钥表，得到文件名「<Code>{EXAMPLE_NAME_DB}</Code>」；
+          </Text>
+        </ListItem>
+        <ListItem>
+          <Text>
+            将文件更名为对应的文件名，如<Code display="inline">{EXAMPLE_NAME_IOS}</Code> ➔
+            <Code display="inline">{EXAMPLE_NAME_DB}</Code>；
+          </Text>
+        </ListItem>
+        <ListItem>
+          <Text>
+            回到主界面，提交文件「<Code>{EXAMPLE_NAME_DB}</Code>」。
+          </Text>
+        </ListItem>
+      </OrderedList>
+    </>
+  );
+}
diff --git a/src/features/settings/panels/QMCv2/iosAllowBackup.webp b/src/features/settings/panels/QMCv2/iosAllowBackup.webp
new file mode 100644
index 0000000000000000000000000000000000000000..513d7b4c83a51a0b67619f30eace86141e07689e
GIT binary patch
literal 5236
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

literal 0
HcmV?d00001


From 825ddf946214aab52ea6c04adbec1715954eb8a8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=81=E6=A0=91=E4=BA=BA?= <lu.shuren@um-react.app>
Date: Fri, 16 Jun 2023 20:44:08 +0100
Subject: [PATCH 4/4] chore: add dev doc content

---
 docs/adb_dump.md | 9 +++++++++
 1 file changed, 9 insertions(+)
 create mode 100644 docs/adb_dump.md

diff --git a/docs/adb_dump.md b/docs/adb_dump.md
new file mode 100644
index 0000000..0b8a1aa
--- /dev/null
+++ b/docs/adb_dump.md
@@ -0,0 +1,9 @@
+# 利用 ADB 访问安卓私有数据
+
+```sh
+APP_ID="com.tencent.qqmusic" # QQ 音乐
+APP_ID="cn.kuwo.player" # 酷我
+
+adb shell su -c "tar c '/data/data/${APP_ID}/' | base64" \
+    | base64 -d | pv | tar -x --strip-components 2
+```