integrate faq (en)

This commit is contained in:
qhy040404
2024-02-25 13:38:07 +08:00
parent c5b20de779
commit f7e9c75a46
13 changed files with 185 additions and 224 deletions

View File

@@ -24,6 +24,7 @@ export const enSidebar = sidebar({
"character-data",
"hutao-API",
"develop-plan",
"mhy-account-switch"
],
},
{
@@ -34,7 +35,7 @@ export const enSidebar = sidebar({
{
icon: "iconfont icon-setting",
text: "Snap Hutao Features",
children: ["feedback-center", "hutao-passport", "hutao-settings"],
children: ["setup", "feedback-center", "hutao-passport", "hutao-settings"],
},
],
},

View File

@@ -6,88 +6,7 @@ category:
order: 1
---
# FAQ
> 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
If the following answers can not solve your issue, feel free to [report bug to us](../statements/bug-report.md)!
## Installation FAQ
::: info Tips for Failed Installation
If you failed installation with MSIX package, please try [Snap.Hutao.Deployment](https://api.snapgenshin.com/patch/hutao-deployment/download) first, it can solve most of the installation 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
- 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)
### 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 dont have Windows Store, please use the latest full version of Microsofts 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 packages 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.
### Got "Cannot open this application" Error when Open Snap Hutao
![unable to run](https://img.alicdn.com/imgextra/i3/388777087/O1CN01WqkqOl22DtpuPYZB6_!!388777087.png)
If you got this error when you open Snap Hutao, please use PowerShell (Admin) to execute the following command.
```PowerShell :no-line-numbers
net stop appxsvc; Invoke-WebRequest -Uri https://aka.ms/windowsappsdk/1.4/latest/windowsappruntimeinstall-x64.exe -OutFile $env:temp/windowsappruntimeinstall-x64.exe; Invoke-Expression "$env:temp/windowsappruntimeinstall-x64.exe --repair"
```
### Starting FAQ
# Other FAQ
### How to Create Desktop Shortcut (with No Admin Privilege)
@@ -121,85 +40,6 @@ Click `Create Desktop Shortcut` in the settings page.
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
- Right click on Snap Hutao and you will see the quick launcher
![quick-start](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01Uu8QzN1g6du6MRp8h_!!1797064093.png)
- Select `Lauch Game`, you will be asked which account to start the game
### 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
removed.
This problem may also be caused by network error, you should check this first; If it's not caused by network issue,
you can use `Refresh Cookie` in the account panel; You can also remove your account manually and add it back again.
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
- There are two factors associated with game account login status: network and device ID
- This issue usually caused by:
- Change of public IP address
- Change of network adapter or network adapter MAC address
- Failed saving operation, no real login status been saved (Snap Hutao cannot detect if the status is real valid)
- Make sure to enter the game after sign in
- Make sure the game process is gone after closing the game
- Detect the account again to save your login status
### 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.
After identify the server version on your device, you can manually create and fill the configuration file with the right
content. The following are common configurations.
::: tabs#game_config_samples
@tab CN Server Official
```
[General]
channel=1
cps=mihoyo
game_version=4.1.0
sub_channel=1
plugin_7_version=1.0.0
```
@tab Global Server Official
```
[General]
channel=1
cps=mihoyo
game_version=4.1.0
sub_channel=0
plugin_7_version=1.0.0
```
:::
### Why does setting up automatic refresh of real-time notes prompt "Failed to modify Scheduled Task"
The automatic refresh of real-time notes relies on task scheduling. In order to avoid possible permission issues, Snap Hutao will force scheduled tasks to be set in non-administrator mode.
If you turned on automatic refresh in the old version, you can solve the problem by manually deleting the old task schedule in Task Scheduler. The name of the scheduled task is `SnapHutaoDailyNoteRefreshTask`.
If you did not turn on automatic refresh in the old version, then this problem is caused by the Windows user account you are currently using having insufficient permissions. If your current user account is an administrator account, you can only solve this problem by reinstalling the system.
## 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
@@ -209,20 +49,4 @@ Loopback network are disabled for all Windows Appx container application (includ
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
with anyone.
:::
Copy `Userdata.db` from Snap Hutao data folder (`%userprofile%/Documents/Hutao` by default) to your backup location, this
file contains entire data of the client.
2. Unlock Loopback restrictions in Feedback Center

View File

@@ -1,23 +0,0 @@
---
category:
- FAQ
- dependency
- installation
icon: iconfont icon-structure
order: 6
comment: false
---
# Install Dependency Manually
Snap Hutao relies on Windows App Runtime as a dependency, when user's system is missing this environment, Windows will
install this framework before Snap Hutao's installation.
![](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01RJFPnY1g6dye2b8Uy_!!1797064093.png_.webp)
If you are in a poor network, you may slow or even stuck at framework installation stage. In such a scenario, you can
download the framework from Microsoft website and install it manually.
1. Visit Microsoft document page[Latest downloads for the Windows App SDK](https://learn.microsoft.com/en-us/windows/apps/windows-app-sdk/downloads)
2. Click on `Download the latest x64 stable installer` to download the offline installer
3. Run Windows App Runtime installer you just downloaded, and then install Snap Hutao

View File

@@ -10,13 +10,6 @@ comment: false
This document covers solutions of **foreseeable client error**
## RuntimeEnvironmentException
- Exception: `RuntimeEnvironmentException`
- Hint: `Unable to set registry key without enabling long path`
- Issue source: Windows long path limit is set to be limited at 256 characters by default
- Solution: Download [EnableLongPaths.zip](https://d.hut.ao/d/tools/EnableLongPaths.zip), unzip it and run `.reg` file
## Return Code: -10001
- This error comes directly from MiHoYo BBS, hints include

View File

@@ -30,3 +30,15 @@ comment: false
- Right click on it, and select `Unstall`
- Remove data folder (If you want remove it completely)
- Open and delete `%userprofile%/Documents/Hutao`
## 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
with anyone.
:::
Copy `Userdata.db` from Snap Hutao data folder (`%userprofile%/Documents/Hutao` by default) to your backup location, this
file contains entire data of the client.

View File

@@ -69,8 +69,11 @@ Each account is saved in a field under the `Detect Account` field, they are sele
## Genshin Impact HDR in Windows Platform
Genshin Impact currently has an HDR feature built in that can only be enabled by setting registry key values. Although this may mean that the feature is a test feature of the game, you can already experience it in advance!
You can enable the Genshin Impact HDR feature on the Windows platform to enhance the visual experience on monitors that support HDR. In the game launcher, you can enable the Windows HDR option, and Snap Hutao will activate this built-in feature of the game when the game starts.
~~Genshin Impact currently has an HDR feature built in that can only be enabled by setting registry key values. Although this may mean that the feature is a test feature of the game, you can already experience it in advance!~~
~~You can enable the Genshin Impact HDR feature on the Windows platform to enhance the visual experience on monitors that support HDR. In the game launcher, you can enable the Windows HDR option, and Snap Hutao will activate this built-in feature of the game when the game starts.~~
Genshin Impact has temporarily disabled the HDR feature, so the feature will not work for the time being.
## Launch Parameters
@@ -103,6 +106,9 @@ You can enable the Genshin Impact HDR feature on the Windows platform to enhance
- `-monitor` parameter
- **Monitor**, allows users with multiple monitors to choose a specific monitor to run the game
- If you can't determine which monitor each option represents, you can click `Identify Monitor` to get a hint.
::: warning
Please note that modifying the primary monitor may cause the game to appear on a monitor that does not correspond to the numbered monitor.
:::
## Resource Download
@@ -153,3 +159,64 @@ Fact that may cause **failure in unlocking frame rate limit**:
3. `Max Framerate` limit is not changed in your graphic card settings
4. `Power Saving` mode is not disabled in power settings
5. Your graphic card is not powerful enough
## FAQ
### Use Snap Hutao to quick start the game
- Config the game launcher in the settings
- Pin Snap Hutao on taskbar
- Right click on Snap Hutao and you will see the quick launcher
![quick-start](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01Uu8QzN1g6du6MRp8h_!!1797064093.png)
- Select `Lauch Game`, you will be asked which account to start the game
### 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:
- Change of public IP address
- Change of network adapter or network adapter MAC address
- Failed saving operation, no real login status been saved (Snap Hutao cannot detect if the status is real valid)
- Make sure to enter the game after sign in
- Make sure the game process is gone after closing the game
- Detect the account again to save your login status
### 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.
After identify the server version on your device, you can manually create and fill the configuration file with the right
content. The following are common configurations.
::: info
Please modify `game_version` to the current game version yourself
:::
::: tabs#game_config_samples
@tab CN Server Official
```
[General]
channel=1
cps=mihoyo
game_version=4.1.0
sub_channel=1
plugin_7_version=1.0.0
```
@tab Global Server Official
```
[General]
channel=1
cps=mihoyo
game_version=4.1.0
sub_channel=0
plugin_7_version=1.0.0
```
:::

View File

@@ -44,3 +44,17 @@ you can find the entry to login in to your MiYouShe and HoYoLAB account:
no third-party server (including any server from Snap Hutao) will involve in this process.**
:::
## FAQ
### 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
removed.
This problem may also be caused by network error, you should check this first; If it's not caused by network issue,
you can use `Refresh Cookie` in the account panel; You can also remove your account manually and add it back again.
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

View File

@@ -63,3 +63,13 @@ verification, then your account can be used to refresh data.
- Hover the cursor over the form of Real-time Notes account that needs to delete
- Clock on the remove button on it, and you can remove the corresponding account
## FAQ
### Why does setting up automatic refresh of real-time notes prompt "Failed to modify Scheduled Task"
The automatic refresh of real-time notes relies on task scheduling. In order to avoid possible permission issues, Snap Hutao will force scheduled tasks to be set in non-administrator mode.
If you turned on automatic refresh in the old version, you can solve the problem by manually deleting the old task schedule in Task Scheduler. The name of the scheduled task is `SnapHutaoDailyNoteRefreshTask`.
If you did not turn on automatic refresh in the old version, then this problem is caused by the Windows user account you are currently using having insufficient permissions. If your current user account is an administrator account, you can only solve this problem by reinstalling the system.

View File

@@ -88,6 +88,11 @@ background="rgba(244, 125, 63, 0.15)"
@tab Use MSIX Package
<div class="vp-card-container">
<div class="hint-container warning">
<p class="hint-container-title">Warning</p>
<p>We recommend using Snap.Hutao.Deployment to install Snap Hutao. Any problems that arise when installing using MSIX installation packages will not be actively handled.</p>
</div>
<VPCard
title="Join the Community"
desc="We will manually upload package in the community after each update"
@@ -117,7 +122,6 @@ background="rgba(244, 125, 63, 0.15)"
background="rgba(244, 125, 63, 0.15)"
/>
- If you face any of the following errro during the installation, please refer to [Install Dependency Manually](advanced/dependency.md) to solve itthis happens when your Windows cannot download necessary framework 1. `App Installer failed to iunstall package dependencies. Ask the developer for package` 2. Stuck at `Installing framework`
</div>
:::
@@ -132,13 +136,13 @@ If you installed a Microsoft Store version of Snap Hutao (version 1.4.11 to 1.8.
> For details of this change, please refer to [Explanation of Breaking Changes in Version 1.9.0](blog/version-1-9-0-breaking-changes.md)
- Uninstall the old version with our [uninstallation instruction document](advanced/uninstall.html)
- Uninstall the old version with our [uninstallation instruction document](advanced/uninstall.md)
- Your data will not lose as long as you don't delete data directory manually
- Follow the method above to install the new version application
### <HopeIcon icon="iconfont icon-update" size="1.5rem" color="rgb(255, 185, 0)" /> Update Snap Hutao
If no special instruction is given, you can download and install latest MSIX package to update your Snap Hutao.
If no special instruction is given, You can upgrade the program by running [Snap.Hutao.Deployment](https://api.snapgenshin.com/patch/hutao-deployment/download) or installing the latest MSIX installation package.
Starting from 1.9.0 version, Snap Hutao has embedded update module to notify the updates. You may try [Snap.Hutao.Deployment](https://api.snapgenshin.com/patch/hutao-deployment/download) if you failed the update.
@@ -195,3 +199,60 @@ be displayed in the account panel once your click the `Confirm` button.
_**Now, you have finished your initial set up of Snap Hutao. You are now free to explore this application, you can also
find all documents in this website.**_
## <HopeIcon icon="iconfont icon-ask" size="1.7rem" color="var(--theme-color)" /> Installation FAQ
### 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)
### 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.
::: warning
The following FAQs only apply to MSIX installations, please try to use [Snap.Hutao.Deployment](https://api.snapgenshin.com/patch/hutao-deployment/download) first to resolve your installation issues
:::
### 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 dont have Windows Store, please use the latest full version of Microsofts 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 packages 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. Right click on Windows Start button, and select `PowerShell (Admin)`
2. 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
```
3. 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.

View File

@@ -52,7 +52,7 @@ comment: false
连接到胡桃服务器时失败,请检查胡桃客户端的网络连接
如果你使用了网络代理,请务必检查是否[解除了 Windows 容器 Loopback 限制](faq.md#如何通过网络代理使用胡桃工具箱)
如果你使用了网络代理,请务必检查是否[解除了 Windows 容器 Loopback 限制](FAQ.md#如何通过网络代理使用胡桃工具箱)
### 403 (Forbidden)/ 404 (NOT FOUND)

View File

@@ -158,15 +158,6 @@ comment: false
- 选择 “启动游戏” 即可
### 为什么米游社账号登录状态经常失效,添加的账号消失
- 我们通过储存账号的米游社 Cookie 来维持登录状态。
- 但是当用户在浏览器或其它设备上**注销账号**后, 维持登录状态的 Cookie 将**失效**。
- 这会导致胡桃工具箱上的米游社账号在启动后被自动移除。
- 此情况也可能因为网络连接问题导致无法检查 Cookie 有效性,故出现此情况后请优先重启胡桃工具箱。
- 自 2022 年 10 月起,米游社极大地提高了账号被判定为有风险的概率,[账号有风险](../advanced/exceptions.md#状态1034-验证失败)时亦会令 Cookie 无法被识别为有效状态
- 自 1.4.15 版本起,你可以通过在账号面板中刷新 Cookie 来刷新登录状态
### 为什么游戏登录状态会失效,导致切换账号功能无效
- 保存游戏登录状态的要素有两个:网络环境和设备 ID

View File

@@ -41,3 +41,14 @@ comment: false
- **在胡桃工具箱中通过密码或 Cookie 登录米游社的过程中,你的数据只经米游社服务器和本地胡桃工具箱处理,不经过包括胡桃服务器在内的任何第三方服务。**
:::
## 常见问题
### 为什么米游社账号登录状态经常失效,添加的账号消失
- 我们通过储存账号的米游社 Cookie 来维持登录状态。
- 但是当用户在浏览器或其它设备上**注销账号**后, 维持登录状态的 Cookie 将**失效**。
- 这会导致胡桃工具箱上的米游社账号在启动后被自动移除。
- 此情况也可能因为网络连接问题导致无法检查 Cookie 有效性,故出现此情况后请优先重启胡桃工具箱。
- 自 2022 年 10 月起,米游社极大地提高了账号被判定为有风险的概率,[账号有风险](../advanced/exceptions.md#状态1034-验证失败)时亦会令 Cookie 无法被识别为有效状态
- 自 1.4.15 版本起,你可以通过在账号面板中刷新 Cookie 来刷新登录状态