ahdoawhfo/um-react
1
0
Fork 0
mirror of https://git.um-react.app/um/um-react.git synced 2025-11-28 11:33:02 +00:00
Code Issues Packages Projects Releases Wiki Activity

refactor: batch 3

Browse Source
This commit is contained in:
鲁树人
2025-05-18 02:41:20 +09:00
parent 75b43e1e84
commit 2e4e57be45
52 changed files with 933 additions and 1136 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
src/faq/KugouFAQ.tsx
View File

@@ -1,31 +1,25 @@
import { Alert, AlertIcon, Container, Flex, List, ListItem, Text } from '@chakra-ui/react';
import { Header4 } 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 (
<>
<Header4>解锁失败</Header4>
<List spacing={2}>
<ListItem>
<Text>
酷狗现在对部分用户推送了 <code>kgg</code> 加密格式（安卓、Windows 客户端）。
</Text>
<Text>根据平台不同，你需要提取密钥数据库。</Text>
<p>
酷狗现在对部分用户推送了 <code>kgg</code> 加密格式（安卓、Windows 客户端）。
</p>
<p>根据平台不同，你需要提取密钥数据库。</p>
<Container p={2}>
<Alert status="warning" borderRadius={5}>
<AlertIcon />
<Flex flexDir="column">
<Text>安卓用户提取密钥需要 root 权限，或注入文件提供器。</Text>
</Flex>
</Alert>
</Container>
<div className="p-2 @container">
<div className="alert alert-warning">
<RiErrorWarningLine className="size-6" />
<p>安卓用户提取密钥需要 root 权限，或注入文件提供器。</p>
</div>
</div>
<SegmentKeyImportInstructions tab="酷狗密钥" clientInstructions={<KugouAllInstructions />} />
</ListItem>
</List>
<SegmentKeyImportInstructions tab="酷狗密钥" clientInstructions={<KugouAllInstructions />} />
</>
);
}

65
src/faq/KuwoFAQ.tsx
View File

@@ -1,52 +1,45 @@
import { Alert, AlertIcon, Container, Flex, List, ListItem, Text } from '@chakra-ui/react';
import { Header4 } from '~/components/HelpText/Headers';
import { VQuote } from '~/components/HelpText/VQuote';
import { SegmentTryOfficialPlayer } from './SegmentTryOfficialPlayer';
import { HiWord } from '~/components/HelpText/HiWord';
import { KWMv2AllInstructions } from '~/features/settings/panels/KWMv2/KWMv2AllInstructions';
import { SegmentKeyImportInstructions } from './SegmentKeyImportInstructions';
import { RiErrorWarningLine } from 'react-icons/ri';
export function KuwoFAQ() {
return (
<>
<Header4>解锁失败</Header4>
<List spacing={2}>
<ListItem>
<SegmentTryOfficialPlayer />
</ListItem>
<ListItem>
<Text>
日前，仅<HiWord>手机客户端</HiWord>下载的
<VQuote>
<strong>至臻全景声</strong>
</VQuote>
及
<VQuote>
<strong>至臻母带</strong>
</VQuote>
{'音质的音乐文件采用新版加密。'}
</Text>
<Text>其他音质目前不需要提取密钥。</Text>
<Text>PC平台暂未推出使用新版加密的音质。</Text>
<SegmentTryOfficialPlayer />
<p>
日前，仅<HiWord>手机客户端</HiWord>下载的
<VQuote>
<strong>至臻全景声</strong>
</VQuote>
及
<VQuote>
<strong>至臻母带</strong>
</VQuote>
音质的音乐文件采用新版加密。
</p>
<p>其他音质目前不需要提取密钥。</p>
<p>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>
<div className="alert alert-warning">
<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 />} />
</>
);
}

218
src/faq/OtherFAQ.tsx
View File

@@ -1,139 +1,161 @@
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 { Header4, Header5 } from '~/components/HelpText/Headers';
import { VQuote } from '~/components/HelpText/VQuote';
import { ProjectIssue } from '~/components/ProjectIssue';
import LdPlayerSettingsScreen from './assets/ld_settings_misc.webp';
import { RiErrorWarningLine } from 'react-icons/ri';
import LdPlayerSettingsMisc2x from './assets/ld_settings_misc@2x.webp';
import MumuSettingsMisc2x from './assets/mumu_settings_misc@2x.webp';
export function OtherFAQ() {
return (
<>
<Header4>解密后没有封面等信息</Header4>
<Text>该项目进行解密处理。如果加密前的资源没有内嵌元信息或封面，解密的文件也没有。</Text>
<Text>请使用第三方工具进行编辑或管理元信息。</Text>
<p>该项目进行解密处理。如果加密前的资源没有内嵌元信息或封面，解密的文件也没有。</p>
<p>请使用第三方工具进行编辑或管理元信息。</p>
<Header4>批量下载</Header4>
<Text>
<p>
{'暂时没有实现，不过你可以在 '}
<ProjectIssue id={34} title="[UI] 全部下载功能" />
{' 以及 '}
<ProjectIssue id={43} title="批量下载" />
{' 追踪该问题。'}
</Text>
</p>
<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>
<p>⚠️ 手机端浏览器支持有限，请使用最新版本的 Chrome 或 Firefox 官方浏览器。</p>
<div className="flex flex-col md:flex-row gap-2 md:gap-8">
<div>
<Header5>已知有问题的浏览器</Header5>
<ul className="list-disc list-inside pl-2">
<li>Via 浏览器</li>
<li>夸克浏览器</li>
<li>UC 浏览器</li>
</ul>
</div>
<div>
<Header5>可能会遇到的问题包括</Header5>
<ul className="list-disc list-inside pl-2">
<li>网页白屏</li>
<li>无法下载解密后内容</li>
<li>下载的文件名错误</li>
</ul>
</div>
</div>
<Header4>安卓: root 相关说明</Header4>
<Text>
<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>如果希望不破坏系统完整性，你可以考虑在电脑上使用安卓模拟器。</p>
<p>
很多安卓模拟器都提供了 root 特权支持，可以很方便的启用，例如
<VQuote>
<ExtLink href="https://mumu.163.com/">网易 MuMu 模拟器（安卓 12，推荐）</ExtLink>
</VQuote>
或
<VQuote>
<ExtLink href="https://www.ldmnq.com/">雷电模拟器（安卓 9）</ExtLink>
</VQuote>
。
</Text>
</p>
<Container p={2}>
<Alert status="warning" borderRadius={5}>
<AlertIcon />
<Flex flexDir="column">
<Text>
<strong>注意</strong>：根据应用的风控策略，使用模拟器登录的账号<strong>有可能会导致账号被封锁</strong>
{'；使用前请自行评估风险。'}
</Text>
</Flex>
</Alert>
</Container>
<div className="my-4 alert alert-warning">
<RiErrorWarningLine className="text-lg" />
<div>
<p>
根据应用的风控策略，使用模拟器登录的账号<strong>有可能会导致账号被封锁</strong>。
</p>
<p>使用前请自行评估风险。</p>
</div>
</div>
<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>
<p>以下是为上述模拟器启用 root 的方式：</p>
<div className="grid grid-cols-1 gap-2 md:gap-4 lg:grid-cols-2">
<div>
<Header5>网易 MuMu模拟器</Header5>
<ul className="list-disc pl-6">
<li>
打开<VQuote>设置中心</VQuote>
</li>
<li>
选择<VQuote>其他</VQuote>
</li>
<li>
勾选<VQuote>开启手机Root权限</VQuote>
</li>
</ul>
<img className="rounded-md border border-base-300" loading="lazy" srcSet={`${MumuSettingsMisc2x} 2x`} />
</div>
<div>
<Header5>雷电模拟器</Header5>
<ul className="list-disc pl-6">
<li>
打开<VQuote>模拟器设置</VQuote>
</li>
<li>
选择<VQuote>其他</VQuote>
</li>
<li>
设置<VQuote>ROOT 权限</VQuote>为<VQuote>开启</VQuote>状态
</li>
</ul>
<img className="rounded-md border border-base-300" loading="lazy" srcSet={`${LdPlayerSettingsMisc2x} 2x`} />
</div>
</div>
<Header4>相关项目</Header4>
<UnorderedList>
<ListItem>
<Text>
<ExtLink href="https://github.com/CarlGao4/um-react-electron">
<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.unlock-music.dev/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>
</p>
<ul className="list-disc pl-6">
<li>
<p>
<ExtLink href="https://git.unlock-music.dev/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>
<p className="flex flex-row gap-1">
欢迎加入
<ExtLink href={'https://t.me/unlock_music_chat'}>“音乐解锁-交流” 交流群</ExtLink>
一起讨论。
</p>
</>
);
}

151
src/faq/QQMusicFAQ.tsx
View File

@@ -1,159 +1,18 @@
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 { 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>
<SegmentTryOfficialPlayer />
<Text>重复下载同一首的歌曲不重复扣下载配额，但是同一首歌的两个版本会重复扣下载配额，请仔细分辨。</Text>
<Text>
<p>重复下载同一首的歌曲不重复扣下载配额，但是同一首歌的两个版本会重复扣下载配额，请仔细分辨。</p>
<p className="mb-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>
<QMCv2QQMusicAllInstructions />
</>
);
}

27
src/faq/SegmentAddKeyDropdown.tsx
View File

@@ -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>
);
}

38
src/faq/SegmentKeyImportInstructions.tsx
View File

@@ -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>导入密钥可以参考下面的步骤：</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>{keyInstructionText}</p>
{clientInstructions}
</li>
</ol>
</>
);
}

12
src/faq/SegmentTryOfficialPlayer.tsx
View File

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

BIN
src/faq/assets/ld_settings_misc.webp
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 7.9 KiB

BIN
src/faq/assets/ld_settings_misc@2x.webp Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 30 KiB

BIN
src/faq/assets/mumu_settings_misc@2x.webp Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 22 KiB