mirror of
https://jihulab.com/DGP-Studio/Snap.Hutao.Docs.git
synced 2025-11-19 21:16:31 +08:00
Update docs
This commit is contained in:
Masterain
BIN
docs/.vuepress/public/images/202312/DGP-v3.webp
Normal file
BIN
docs/.vuepress/public/images/202312/DGP-v3.webp
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 33 KiB |
@@ -8,11 +8,80 @@ order: 1
|
||||
|
||||
# FAQ
|
||||
|
||||
## How to create desktop shortcut (with no admin privilege)
|
||||
> Please use **search bar on the top right** or **browser built-in search `(ctrl+F)`** to search keyword such as error code to improve your searching efficiency
|
||||
|
||||
## Installation FAQ
|
||||
|
||||
### Stuck at `Installing Required Framework` when Using MSIX Package to Install
|
||||
|
||||
- When user's OS missing required dependency framework, Windows will download and install it automatically.
|
||||
However, if the user disabled Windows Update or have a bad network, the system is unable to process this installation.
|
||||
- Make sure Windows Update is enabled
|
||||
- You can also download and install the [dependency](dependency.md) manually
|
||||
|
||||
### Mojibake in Snap Hutao Icons
|
||||
|
||||
- If you are using Windows 10 and see some button are not display properly
|
||||
- You can download `Segoe Fluent Icons` font
|
||||
- You need to install it for all users
|
||||
- You can find this font from [Microsoft](https://aka.ms/SegoeFluentIcons)
|
||||
|
||||
### Snap Hutao Throws Failed to add Scheduled Task Error
|
||||
|
||||
Open Windows Task Scheduler, find and delete `SnapHutaoDailyNoteRefreshTask` task
|
||||
|
||||
### My Computer Cannot Open MSIX Format Installer
|
||||
|
||||
Your computer is missing the App Installer, an important component of the Windows system.
|
||||
|
||||
If Microsoft Store is installed on your system, you can restore this component by reinstalling it from the [App Installer Store Page](https://apps.microsoft.com/detail/9NBLGGH4NNS1?hl=en-us&gl=US).
|
||||
|
||||
If you don’t have Windows Store, please use the latest full version of Microsoft’s official consumer version [Windows 10](https://www.microsoft.com/zh-cn/software-download/windows10) or [Windows 11](https://www.microsoft.com/zh-cn/software-download/windows11) mirror. Using the Windows 10 Upgrade Assistant and Windows 11 Installation Assistant provided by Microsoft can help you simply upgrade to the latest full version of Windows while retaining your data.
|
||||
|
||||
### Got `This app package’s publisher certificate could not be verified` Error when Install with MSIX Package
|
||||
|
||||
This issue is commonly seen in Home Edition of Windows. If you are not using a Home Edition, your Windows Update module may be disabled or cracked, this cause worldwide CA certificates cannot be updated from Microsoft servers.
|
||||
|
||||
Snap Hutao's code signing certificate comes from [GlobalSign Code Signing Root R45](https://support.globalsign.com/ca-certificates/root-certificates/globalsign-root-certificates), you can manually download [this CA certificate](https://secure.globalsign.com/cacert/codesigningrootr45.crt) from GlobalSign official website.
|
||||
|
||||
### Got `Policy check failed` Error when Install with MSIX Package
|
||||
|
||||
If you are using Windows Home Edition, please try to enable developer mode in your system settings and try the installation again.
|
||||
|
||||
### Got Error Prompt or Error Code when Install with MSIX Package
|
||||
|
||||
| Error | Reason |
|
||||
| ------------------------------------ | -------------------------------------------------------- |
|
||||
| `0x80040154` Error Code | Broken Windows account permission |
|
||||
| `The app did not start` Error Prompt | Cracked App Installer or broken App Installer permission |
|
||||
| `0x80073CF0` Error Code | Broken folder permission |
|
||||
| `0x80070005` Error Code | Broken Windows account permission |
|
||||
| `0x80070570` Error Code | Broken Windows account permission |
|
||||
| `0x8007065E` Error Code | Broken Windows account permission |
|
||||
|
||||
If you got any of error showing above, please use the following steps to solve the issue:
|
||||
|
||||
1. Manually download and install [Snap Hutao Dependency](dependency.md)
|
||||
2. Right click on Windows Start button, and select `PowerShell (Admin)`
|
||||
3. In the PowerShell windows, copy and paste the following command and run it (Right-click is paste feature in PowerShell)
|
||||
```PowerShell :no-line-numbers
|
||||
cd $env:USERPROFILE\Downloads; $url="https://api.snapgenshin.com/patch/hutao/download"; $targetFileName="Snap.Hutao.latest.msix"; $targetFilePath=Join-Path -Path $PWD -ChildPath $targetFileName; Invoke-WebRequest -Uri $url -OutFile $targetFilePath; Add-AppxPackage -Path $targetFilePath; Remove-Item -Path $targetFilePath
|
||||
```
|
||||
4. If PowerShell does not outcome any error message, then it means installation is successful. Please find `Snap Hutao` in your Start Menu and enjoy it.
|
||||
|
||||
### Can I Add Missing System Components to Install Snap Hutao
|
||||
|
||||
Probably not if you are asking this, because you are not familiar with your system.
|
||||
|
||||
You don't know how many components are missing. When you install the one that tell you in the error message, you will see next missing component in the next error message, endless.
|
||||
|
||||
### Starting FAQ
|
||||
|
||||
### How to Create Desktop Shortcut (with No Admin Privilege)
|
||||
|
||||
::: tip Community Power
|
||||
|
||||
Thanks to [solution provided by CzHUV](https://github.com/DGP-Studio/Snap.Hutao.Docs/issues/12)。
|
||||
Thanks to [CzHUV](https://github.com/DGP-Studio/Snap.Hutao.Docs/issues/12) for the solution.
|
||||
|
||||
:::
|
||||
|
||||
@@ -21,21 +90,30 @@ Thanks to [solution provided by CzHUV](https://github.com/DGP-Studio/Snap.Hutao.
|
||||
- Right lick on it, and click `Create shortcut`
|
||||
- Confirm the operation and you will get the desktop shortcut
|
||||
|
||||
## How to create desktop shortcut with Administrator privilege
|
||||
### How to Create Desktop Shortcut (With Admin Privilege)
|
||||
|
||||
Starting from Snap Hutao 1.7.4, you can create a desktop shortcut with Administrator privilege by click `Create Desktop Shortcut`
|
||||
in the settings page.
|
||||
Click `Create Desktop Shortcut` in the settings page.
|
||||
|
||||
You can move this shortcut to any place you need.
|
||||
|
||||
## How to run Snap Hutao when Windows starts
|
||||
### How to run Snap Hutao when Windows starts
|
||||
|
||||
**This is a workaround solution**
|
||||
|
||||
- Create a bat file, content refers to [this Issue](https://github.com/DGP-Studio/Snap.Hutao/issues/184), it allows bat to run Snap Hutao with Administrator privilege
|
||||
- Create a Scheduled Task, run the bat when Windows startup, or drag it to Windows start folder
|
||||
|
||||
## Use Snap Hutao to quick start the game
|
||||
### Unable to Run Snap Hutao as Administrator
|
||||
|
||||
> This issue only occurs in Windows 10 older than 22H2 version
|
||||
|
||||
- When user's OS version older than `Windows Build 19045` (aka Windows 10 22H2), Snap Hutao is unable to start when
|
||||
running as Administrator
|
||||
- This issue comes from Windows kernel, and it's hard to locate, so we suggest you to update your OS to the latest version
|
||||
|
||||
## Feature FAQ
|
||||
|
||||
### Use Snap Hutao to quick start the game
|
||||
|
||||
- Config the game launcher in the settings
|
||||
- Pin Snap Hutao on taskbar
|
||||
@@ -45,18 +123,7 @@ You can move this shortcut to any place you need.
|
||||
|
||||
- Select `Lauch Game`, you will be asked which account to start the game
|
||||
|
||||
## Use Snap Hutao with Network Proxy
|
||||
|
||||
Refer to [HttpRequestException Error (502)](exceptions.html#_502-bad-gateway) document
|
||||
|
||||
## Mojibake in Snap Hutao
|
||||
|
||||
- If you are using Windows 10 and see some button are not display properly
|
||||
- You can download `Segoe Fluent Icons` font
|
||||
- You need to install it for all users
|
||||
- You can find this font from [Microsoft](https://aka.ms/SegoeFluentIcons)
|
||||
|
||||
## MiHoYo BBS Account often Lose Login Status
|
||||
### MiHoYo BBS Account often Lose Login Status
|
||||
|
||||
Snap Hutao use saved MiHoYo BBS cookies to maintain login status. If you **log out** your account in your browser or
|
||||
other device, cookie will become invalid, and Snap Hutao will also be forced to log out, account will be automatically
|
||||
@@ -68,7 +135,7 @@ you can use `Refresh Cookie` in the account panel; You can also remove your acco
|
||||
Since October 2022, MiYouShe (Chinese BBS) rapidly increased bot detection and may set users' account as under-risk status,
|
||||
this may cause Snap Hutao failed to check validation of the cookie
|
||||
|
||||
## Game Account Lose Login Status in the Launcher
|
||||
### Game Account Lose Login Status in the Launcher
|
||||
|
||||
- There are two factors associated with game account login status: network and device ID
|
||||
- This issue usually caused by:
|
||||
@@ -79,30 +146,7 @@ this may cause Snap Hutao failed to check validation of the cookie
|
||||
- Make sure the game process is gone after closing the game
|
||||
- Detect the account again to save your login status
|
||||
|
||||
## Snap Hutao Throws Failed to add Scheduled Task Error
|
||||
|
||||
If you are using Administrator privilege to start real-time notes feature, Snap Hutao's scheduled task will be created
|
||||
as Administrator role. When next time edit real-time notes settings without Administrator privilege, the program will
|
||||
have a lack of privilege to edit the settings and throw out this error.
|
||||
|
||||
Run Snap Hutao as Administrator to edit your settings to solve this issue.
|
||||
|
||||
## Stuck at `Installing Required Framework` when Using MSIX Package to Install
|
||||
|
||||
- When user's OS missing required dependency framework, Windows will download and install it automatically.
|
||||
However, if the user disabled Windows Update or have a bad network, the system is unable to process this installation.
|
||||
- Make sure Windows Update is enabled; Snap Hutao's update also relies on it
|
||||
- You can also download and install the [dependency](ttps://d.hut.ao/releases/Dependency) manually
|
||||
|
||||
## Unable to Run Snap Hutao as Administrator
|
||||
|
||||
> This issue only occurs in Windows 10 older than 22H2 version
|
||||
|
||||
- When user's OS version older than `Windows Build 19045` (aka Windows 10 22H2), Snap Hutao is unable to start when
|
||||
running as Administrator
|
||||
- This issue comes from Windows kernel, and it's hard to locate, so we suggest you to update your OS to the latest version
|
||||
|
||||
## How to Recover `config.ini` Configuration File
|
||||
### How to Recover `config.ini` Configuration File
|
||||
|
||||
In some particular conditions (such as wrong game folder permission), `config.ini` may lose after server conversion.
|
||||
This will cause user not able to get into advanced launcher page and launch the game.
|
||||
@@ -136,7 +180,26 @@ plugin_7_version=1.0.0
|
||||
|
||||
:::
|
||||
|
||||
## How to Fully Backup/Recover Client Data
|
||||
## Network FAQ
|
||||
|
||||
### Use Snap Hutao with Network Proxy
|
||||
|
||||
> Snap Hutao has a well-designed cloud network structure, you should be able to get good network service wherever you are located
|
||||
|
||||
Loopback network are disabled for all Windows Appx container application (including Snap Hutao), so some modern network proxy software will cause container applications to lose Internet access, and lead to application errors.
|
||||
|
||||
If you need network proxy to use Snap Hutao, you have two ways to fix it:
|
||||
|
||||
1. Enable `TUN Mode` in your network proxy software
|
||||
2. Use [Windows 8 AppContainer Loopback Utility](https://www.telerik.com/fiddler/add-ons) to unlock Windows App Container Loopback limit
|
||||
- If network security is not a concern for you, you can use the following PowerShell command to unlock all container loopback limit in your computer
|
||||
```PowerShell :no-line-numbers
|
||||
FOR /F "tokens=11 delims=\" %p IN ('REG QUERY "HKCU\Software\Classes\Local Settings\Software\Microsoft\Windows\CurrentVersion\AppContainer\Mappings"') DO CheckNetIsolation.exe LoopbackExempt -a -p=%p
|
||||
```
|
||||
|
||||
## Uninstallation FAQ
|
||||
|
||||
### How to Fully Backup/Recover Client Data
|
||||
|
||||
::: warning Data Security Warning
|
||||
`Userdata.db` contains all client data, including MiHoYO BBS Cookie, please save the data file properly and do NOT share it
|
||||
|
||||
@@ -41,7 +41,7 @@ You can use MSIX package to install Snap Hutao, you can find pakcage from the fo
|
||||
desc="We will manually upload package in the community after each update"
|
||||
logo="/images/202312/community.svg"
|
||||
link="community.html"
|
||||
background="rgba(253, 233, 233, 0.45)"
|
||||
background="rgba(242, 255, 28, 0.25)"
|
||||
/>
|
||||
<VPCard
|
||||
title="Hutao Auto Download"
|
||||
@@ -64,6 +64,13 @@ You can use MSIX package to install Snap Hutao, you can find pakcage from the fo
|
||||
link="https://jihulab.com/DGP-Studio/Snap.Hutao/-/releases"
|
||||
background="rgba(244, 125, 63, 0.15)"
|
||||
/>
|
||||
<VPCard
|
||||
title="Snap.Hutao.Deployment"
|
||||
desc="Installer designed by DGP-Studio, will install missing required framework. Good for users failed MSIX installation"
|
||||
logo="/images/202312/DGP-v3.webp"
|
||||
link="https://api.snapgenshin.com/patch/hutao-deployment/download"
|
||||
background="rgba(88, 164, 255, 0.15)"
|
||||
/>
|
||||
</div>
|
||||
|
||||
- If you face any of the following errro during the installation, please refer to [Install Dependency Manually](advanced/dependency.md) to solve it，this happens when your Windows cannot download necessary framework
|
||||
|
||||
@@ -19,7 +19,7 @@ comment: false
|
||||
- 请确保 Windows Update 已启用；胡桃工具箱的安装过程依赖于 Windows Update 组件
|
||||
- 你亦可以手动下载并安装[胡桃的相关依赖](dependency.md)
|
||||
|
||||
### 为什么程序会出现乱码现象
|
||||
### 为什么程序中的图标会出现乱码现象
|
||||
|
||||
- 当用户在 Windows 10 下使用胡桃且发现有乱码情况时：
|
||||
- 可以下载 `Segoe Fluent Icons`字体
|
||||
@@ -28,8 +28,7 @@ comment: false
|
||||
|
||||
### 为什么程序会提示注册计划任务失败
|
||||
|
||||
使用管理员模式使用一次实时便笺后，胡桃的任务计划会被以管理员权限创建。当再次以非管理员模式启动胡桃时，程序在修改计划任务时会缺少权限。
|
||||
继续使用管理员模式即可解决该问题。
|
||||
打开 Windows 计划任务程序，找到 `SnapHutaoDailyNoteRefreshTask` 任务并删除
|
||||
|
||||
### 我的计算机无法打开 MSIX 格式的安装包
|
||||
|
||||
@@ -92,7 +91,7 @@ Snap Hutao 的软件证书来源于 [GlobalSign Code Signing Root R45](https://s
|
||||
- 右键，点击`创建快捷方式`
|
||||
- 根据提示操作你就可以获得一个桌面快捷方式了
|
||||
|
||||
### 如何添加一个默认以管理员方式运行的快捷方式
|
||||
### 如何创建胡桃的桌面快捷方式 （管理员模式）
|
||||
|
||||
你可以在程序设置页面中点击`创建快捷方式`来在桌面上添加一个具有管理员权限的快捷方式
|
||||
|
||||
@@ -212,7 +211,18 @@ plugin_7_version=1.0.0
|
||||
|
||||
### 如何通过网络代理使用胡桃工具箱
|
||||
|
||||
参考 [HttpRequestException 错误](exceptions.html#_502-bad-gateway) 文档
|
||||
> Snap Hutao 有着良好的云端网络结构，在全球各地你都能获得良好的网络服务
|
||||
|
||||
所有的 Windows Appx 容器应用（包括 Snap Hutao）都被禁用了 Loopback 网络，因此使用一些现代化的网络代理软件时会导致容器化应用无法访问互联网，进而导致程序错误。
|
||||
|
||||
如果你需要通过网络代理使用 Snap Hutao，你有两种方法：
|
||||
|
||||
1. 在网络代理软件中启用 TUN 模式
|
||||
2. 使用 [Windows 8 AppContainer Loopback Utility](https://www.telerik.com/fiddler/add-ons) 解除 Windows App Container Loopback 限制
|
||||
- 如果你不介意网络安全问题，可以使用下面的 PowerShell 命令解除计算机中所有容器化应用的 Loopback 限制
|
||||
```PowerShell :no-line-numbers
|
||||
FOR /F "tokens=11 delims=\" %p IN ('REG QUERY "HKCU\Software\Classes\Local Settings\Software\Microsoft\Windows\CurrentVersion\AppContainer\Mappings"') DO CheckNetIsolation.exe LoopbackExempt -a -p=%p
|
||||
```
|
||||
|
||||
## 卸载篇
|
||||
|
||||
|
||||
@@ -40,7 +40,7 @@ order: 5
|
||||
desc="我们会在用户社区手动分发安装包"
|
||||
logo="/images/202312/community.svg"
|
||||
link="community.html"
|
||||
background="rgba(253, 233, 233, 0.45)"
|
||||
background="rgba(242, 255, 28, 0.25)"
|
||||
/>
|
||||
<VPCard
|
||||
title="胡桃自动判断"
|
||||
@@ -63,6 +63,13 @@ order: 5
|
||||
link="https://jihulab.com/DGP-Studio/Snap.Hutao/-/releases"
|
||||
background="rgba(244, 125, 63, 0.15)"
|
||||
/>
|
||||
<VPCard
|
||||
title="Snap.Hutao.Deployment"
|
||||
desc="开发组自制的一键安装包，将同时安装所有需要的组件。适合使用MSIX安装失败的用户。"
|
||||
logo="/images/202312/DGP-v3.webp"
|
||||
link="https://api.snapgenshin.com/patch/hutao-deployment/download"
|
||||
background="rgba(88, 164, 255, 0.15)"
|
||||
/>
|
||||
</div>
|
||||
|
||||
- 在安装过程中，如果出现任意以下错误之一，请参考文章[手动安装依赖项](advanced/dependency.md)解决，该问题来源是Windows无法自动安装所需要的框架环境
|
||||
|
||||
Reference in New Issue
Block a user