mirror of
https://jihulab.com/DGP-Studio/Snap.Hutao.Docs.git
synced 2025-11-19 21:16:31 +08:00
Masterain
GitHub
@@ -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"],
|
||||
},
|
||||
],
|
||||
},
|
||||
|
||||
@@ -24,6 +24,7 @@ export const zhSidebar = sidebar({
|
||||
"character-data",
|
||||
"hutao-API",
|
||||
"develop-plan",
|
||||
"mhy-account-switch"
|
||||
],
|
||||
},
|
||||
{
|
||||
@@ -34,7 +35,7 @@ export const zhSidebar = sidebar({
|
||||
{
|
||||
icon: "iconfont icon-setting",
|
||||
text: "软件功能",
|
||||
children: ["feedback-center", "hutao-passport", "hutao-settings"],
|
||||
children: ["setup", "feedback-center", "hutao-passport", "hutao-settings"],
|
||||
},
|
||||
],
|
||||
},
|
||||
|
||||
@@ -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 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.
|
||||
|
||||
### Got "Cannot open this application" Error when Open Snap Hutao
|
||||
|
||||
|
||||
|
||||
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
|
||||
|
||||
|
||||
|
||||
- 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
|
||||
|
||||
@@ -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.
|
||||
|
||||
|
||||
|
||||
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
|
||||
@@ -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
|
||||
|
||||
@@ -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.
|
||||
@@ -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
|
||||
|
||||
|
||||
|
||||
- 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
|
||||
```
|
||||
|
||||
:::
|
||||
@@ -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
|
||||
@@ -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.
|
||||
|
||||
@@ -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 it，this 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 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. 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.
|
||||
|
||||
@@ -6,89 +6,7 @@ order: 1
|
||||
comment: false
|
||||
---
|
||||
|
||||
# 常见问题
|
||||
|
||||
> 请使用 **网页右上角的搜索框** 或 **浏览器内置的搜索功能（快捷键 `Ctrl+F`）** 以搜索诸如错误代码之类的关键词来提高你的查询效率
|
||||
|
||||
如果下面的解答不能帮你解决问题，欢迎你向我们[提交问题报告](../statements/bug-report.md)
|
||||
|
||||
## 安装篇
|
||||
|
||||
::: info 安装问题提示
|
||||
当你使用MSIX安装包遇到任意安装问题时，请先尝试使用[Snap.Hutao.Deployment](https://api.snapgenshin.com/patch/hutao-deployment/download)安装器，大部分问题都可以用此方法解决。
|
||||
:::
|
||||
|
||||
### 使用 MSIX 安装包安装时进度卡在 `正在安装所需框架`
|
||||
|
||||
- 当用户系统缺少必要依赖环境时，系统会自动安装所需依赖。若用户禁用了 Windows Update 组件或网络条件差时，系统无法完成该步骤。
|
||||
- 请确保 Windows Update 已启用；胡桃工具箱的安装过程依赖于 Windows Update 组件
|
||||
- 你亦可以手动下载并安装[胡桃的相关依赖](dependency.md)
|
||||
|
||||
### 为什么程序中的图标会出现乱码现象
|
||||
|
||||
- 当用户在 Windows 10 下使用胡桃且发现有乱码情况时：
|
||||
- 可以下载 `Segoe Fluent Icons`字体
|
||||
- 安装时选择`为系统所有用户安装`，即可解决问题
|
||||
- 您可以从 [微软官方](https://aka.ms/SegoeFluentIcons)下载到该字体文件
|
||||
|
||||
### 我的计算机无法打开 MSIX 格式的安装包
|
||||
|
||||
你的计算机缺少了 Windows 系统重要组件 App Installer，你可能是盗版软件的受害者。
|
||||
|
||||
如果你的系统中装有 Microsoft Store，可以从 [App Installer 商店页](https://apps.microsoft.com/detail/9NBLGGH4NNS1?hl=en-us&gl=US) 重新安装来恢复该组件。
|
||||
|
||||
如果你没有Windows Store，请使用微软官方的最新完整版消费者 [Windows 10](https://www.microsoft.com/zh-cn/software-download/windows10) 或 [Windows 11](https://www.microsoft.com/zh-cn/software-download/windows11) 镜像。使用微软官方的提供的 Windows 10 升级助手和 Windows 11 安装助手可以帮助你简单地在保留数据的情况下升级至最新完整版 Windows。**请勿使用来源不明的破解版、精简版系统镜像。**
|
||||
|
||||
### MSIX 安装包提示 `无法验证此应用包的发布者证书` 错误并无法安装
|
||||
|
||||
该问题常见于 Windows 家庭版系统。如果你使用的不是家庭版系统，则你的 Windows Update 模块可能被禁用或已失效，这导致世界范围内的 CA 根证书无法被更新。
|
||||
|
||||
Snap Hutao 的软件证书来源于 [GlobalSign Code Signing Root R45](https://support.globalsign.com/ca-certificates/root-certificates/globalsign-root-certificates)，你可以手动从 GlobalSign 官网下载 [该证书](https://secure.globalsign.com/cacert/codesigningrootr45.crt) 并添加到你的系统中的 `可信任的根证书授权机构` 类别中。
|
||||
|
||||
### MSIX 安装包提示组策略错误或需要 Windows 开发者许可证错误并无法安装
|
||||
|
||||
如果你使用的 Windows 家庭版操作系统，请尝试打开系统设置中的开发者模式以解决该问题
|
||||
|
||||
### 安装 MSIX 安装包时失败并有错误提示
|
||||
|
||||
| 错误信息 | 原因 |
|
||||
| --------------------- | -------------------------------- |
|
||||
| `0x80040154` 错误代码 | 错误的Windows用户账户权限 |
|
||||
| `应用未启动` 错误提示 | App Installer 权限错误或已被破坏 |
|
||||
| `0x80073CF0` 错误代码 | 错误的目录权限 |
|
||||
| `0x80070005` 错误代码 | 错误的Windows用户账户权限 |
|
||||
| `0x80070570` 错误代码 | 错误的Windows用户账户权限 |
|
||||
| `0x8007065E` 错误代码 | 错误的Windows用户账户权限 |
|
||||
|
||||
如果你在安装失败时收到了上面的错误提示，请尝试下面的步骤来解决问题：
|
||||
|
||||
1. 手动下载并安装[胡桃的相关依赖](dependency.md)
|
||||
2. 在 Windows 开始菜单按钮上右键，选择 `PowerShell (管理员)`
|
||||
3. 在打开的窗口中复制下面的代码并回车执行（在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. 如果 PowerShell 没有任何错误输出（通常为红色），意味着安装成功。请在开始菜单中的全部应用列表中寻找 `Snap Hutao` 并启动
|
||||
|
||||
### 能不能通过添加缺少的系统组件来实现胡桃的安装
|
||||
|
||||
> 这就是使用精简版/破解版/优化版/LTSC/LTSB版本的代价，不是不报，时候未到。没有足够的水平就不要用高级的东西。
|
||||
|
||||
当你问出这个问题的时候，那答案已经是不可以了，因为你完全不了解你的操作系统。
|
||||
|
||||
你不知道你手中所谓的精简版系统少了多少必要组件。当你装上了一个组件，解决了当前的问题，你还会遇上下一个问题。
|
||||
|
||||
### 打开胡桃显示“无法打开此应用”
|
||||
|
||||
|
||||
|
||||
如果你打开胡桃时显示此窗口，请使用管理员 PowerShell 运行以下命令。
|
||||
|
||||
```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"
|
||||
```
|
||||
|
||||
## 启动篇
|
||||
# 其他常见问题
|
||||
|
||||
### 如何创建胡桃的桌面快捷方式（非管理员模式）
|
||||
|
||||
@@ -121,111 +39,6 @@ net stop appxsvc; Invoke-WebRequest -Uri https://aka.ms/windowsappsdk/1.4/latest
|
||||
- 当用户系统版本低于 `Windows Build 19045`（即 `Windows 10 22H2` 版本）时，可能无法通过管理员模式启动胡桃工具箱
|
||||
- 该问题属于 Windows 内核级别问题，难以判断具体来源，故建议用户升级至 Windows 10 最新版本
|
||||
|
||||
## 功能使用篇
|
||||
|
||||
### 如何通过胡桃工具箱快速地启动游戏
|
||||
|
||||
- 在主程序中正确设置高级启动器功能
|
||||
- 将胡桃工具箱在系统中固定在快速启动栏中
|
||||
- 在快速启动栏中右键胡桃应用程序
|
||||
|
||||
|
||||
|
||||
- 选择 “启动游戏” 即可
|
||||
|
||||
### 为什么米游社账号登录状态经常失效，添加的账号消失
|
||||
|
||||
- 我们通过储存账号的米游社 Cookie 来维持登录状态。
|
||||
- 但是当用户在浏览器或其它设备上**注销账号**后， 维持登录状态的 Cookie 将**失效**。
|
||||
- 这会导致胡桃工具箱上的米游社账号在启动后被自动移除。
|
||||
- 此情况也可能因为网络连接问题导致无法检查 Cookie 有效性，故出现此情况后请优先重启胡桃工具箱。
|
||||
- 自 2022 年 10 月起，米游社极大地提高了账号被判定为有风险的概率，[账号有风险](exceptions.md#状态1034-验证失败)时亦会令 Cookie 无法被识别为有效状态
|
||||
- 自 1.4.15 版本起，你可以通过在账号面板中刷新 Cookie 来刷新登录状态
|
||||
|
||||
### 为什么游戏登录状态会失效，导致切换账号功能无效
|
||||
|
||||
- 保存游戏登录状态的要素有两个：网络环境和设备 ID
|
||||
- 导致该问题的常见原因是：
|
||||
- 网络环境频繁变换，如公网 IP 更换
|
||||
- 网络设备变换，比如网卡更新、MAC 地址更换
|
||||
- 操作失误，导致实际上根本没有保存登录状态（空的登录状态无法避免被胡桃识别）
|
||||
- 确认你的账号已登录后，进入游戏
|
||||
- 关闭游戏后，确定游戏进程已关闭
|
||||
- 再次进行账号检测，来添加登录状态
|
||||
|
||||
### 转换服务器失败后如何恢复游戏程序
|
||||
|
||||
::: info 功能原理说明
|
||||
胡桃客户端始终只从原神官方服务器下载转换服务器需要的文件，这保证了用户不会下载到被第三方篡改的危险程序。
|
||||
如果你在转换到某一种目标服务器时频繁因网络问题而转换失败，则意味你的网络到目标的原神官方服务器连接质量差。
|
||||
你应检查你的互联网连接、联系你的运营商或向专业人士咨询以保证你的正常使用体验。
|
||||
:::
|
||||
|
||||
在转换原神服务器时，如果胡桃客户端意外退出或由于用户侧网络问题会导致转换流程中断并进而导致原神客户端损坏。
|
||||
此时胡桃工具箱会提示 `游戏路径不正确，前往设置更改游戏路径`，而游戏路径下此时可能不存在任何游戏主程序文件，导致用户无法正确设置。
|
||||
|
||||
在这种情况下，用户可以执行下面的步骤**手动将胡桃客户端备份的游戏主程序恢复至原本的游戏目录中**或**直接使用官方启动器修复游戏**。
|
||||
|
||||
在开始手动恢复游戏程序之前，你需要知道以下基本知识：
|
||||
|
||||
1. 关于游戏客户端
|
||||
1. 国服原神客户端目录下有名为 `YuanShen.exe` 的游戏主程序和名为 `YuanShen_Data` 的游戏程序目录
|
||||
2. 国际服原神客户端目录下有名为 `GenshinImpact.exe` 的游戏主程序和名为 `GenshinImpact_Data` 的游戏程序目录
|
||||
2. 关于胡桃客户端转换服务器功能下的备份步骤
|
||||
1. 在转换服务器前，胡桃客户端会备份当前游戏客户端的主程序以及国服／国际服客户端专有的一些组件程序，即 `exe` 主程序和 `_Data` 目录
|
||||
2. 备份文件储存于当前 Windows 用户下的文档库中的 `Hutao/ServerCache` 目录下，即 `%userprofile%/Documents/Hutao/ServerCache`
|
||||
|
||||
手动恢复游戏主程序步骤（此处以国际服转国服为例）：
|
||||
|
||||
1. 进入胡桃用于备份游戏主程序的 `ServerCache` 目录，此时该目录下存放着转换前的游戏程序备份文件，即 `GenshinImpact.exe` 和 `GenshinImpact_Data`
|
||||
2. 进入游戏主程序目录，此时既没有 `YuanShen.exe` 也没有 `GenshinImpact.exe`，并且有一个国服目录 `YuanShen_Data`
|
||||
3. 手动将游戏主程序目录下的 `YuanShen_Data` 文件夹更名为 `GenshinImpact_Data`
|
||||
4. 手动将 `Hutao/ServerCache` 下的 `GenshinImpact.exe` 和 `GenshinImpact_Data` 复制回游戏主程序目录中并覆盖当前已有文件
|
||||
5. 此时你的游戏客户端应已恢复正常
|
||||
6. 重新进入胡桃客户端的 “游戏启动器” 界面，“游戏路径不正确” 错误应不再出现，且 “服务器” 设置一栏为空。此时，你可以选择原本的服务器版本（国际服）并立刻启动游戏，或选择新的服务器目标（国服）并转换客户端版本。
|
||||
|
||||
### 如何恢复 `config.ini` 配置文件
|
||||
|
||||
在某些特定条件下（如游戏目录权限错误），`config.ini` 文件会在转服后丢失。这会造成无法进入胡桃工具箱高级启动器界面和游戏无法正常启动。
|
||||
|
||||
在判断你当前的游戏版本后，你可以在游戏目录 `%your_launcher_folder%/Genshin Impact Game/` 下手动创建并填入对应的配置文件，下面是常见的配置文件内容。
|
||||
|
||||
::: tabs#game_config_samples
|
||||
|
||||
@tab 国服 Official
|
||||
|
||||
```
|
||||
[General]
|
||||
channel=1
|
||||
cps=mihoyo
|
||||
game_version=4.1.0
|
||||
sub_channel=1
|
||||
plugin_7_version=1.0.0
|
||||
```
|
||||
|
||||
@tab 国际服 Official
|
||||
|
||||
```
|
||||
[General]
|
||||
channel=1
|
||||
cps=mihoyo
|
||||
game_version=4.1.0
|
||||
sub_channel=0
|
||||
plugin_7_version=1.0.0
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
### 为什么设置实时便笺的自动刷新会提示 “修改计划任务失败”
|
||||
|
||||
实时便笺的自动刷新依赖于任务计划。为了避免可能的权限问题，胡桃工具箱会强制在非管理员模式设置计划任务。
|
||||
|
||||
如果你在旧版本开启了自动刷新，那你可以通过手动在任务计划程序中删除旧的任务计划来解决问题。任务计划的名称为 `SnapHutaoDailyNoteRefreshTask`。
|
||||
|
||||
如果你没有在旧版本开启自动刷新，那么此问题是由于你目前使用的 Windows 用户账户权限不足导致的。如果你当前的用户账户是管理员账户，那你只能通过重装系统来解决此问题。
|
||||
|
||||
## 网络篇
|
||||
|
||||
### 如何通过网络代理使用胡桃工具箱
|
||||
|
||||
> Snap Hutao 有着良好的云端网络结构，在全球各地你都能获得良好的网络服务
|
||||
@@ -235,27 +48,4 @@ plugin_7_version=1.0.0
|
||||
如果你需要通过网络代理使用 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
|
||||
```
|
||||
|
||||
## 卸载篇
|
||||
|
||||
### 为什么会弹出需要使用新应用以打开的对话框
|
||||
|
||||
|
||||
|
||||
如在卸载胡桃工具箱后出现如上图所示的 “需要使用新应用以打开此 hutao 链接”，说明没有按文档要求在卸载前清除实时便笺定时任务。
|
||||
请根据文档在设置中清除定时任务后再卸载胡桃工具箱。
|
||||
|
||||
- 如果你在系统定时任务中找不到胡桃的定时任务，但问题仍然出现，请参考[这份文档](https://github.com/DGP-Studio/Snap.Hutao.Docs/issues/18)来解决
|
||||
|
||||
### 如何完整地备份/恢复客户端数据
|
||||
|
||||
::: warning 数据安全提示
|
||||
`Userdata.db` 包含你的全部客户端数据，包括安全敏感的米哈游论坛 Cookie，请妥善储存该文件，不要将其分享给任何人。
|
||||
:::
|
||||
|
||||
从在胡桃数据目录（默认路径为 `%userprofile%/Documents/Hutao`）中以复制的方式将 `Userdata.db` 拷贝至你的备份目录即可，该文件包含了全部的胡桃客户端数据。
|
||||
2. 在反馈中心中解除 Loopback 限制
|
||||
@@ -1,18 +0,0 @@
|
||||
---
|
||||
category: [FAQ, 依赖项, 安装]
|
||||
icon: iconfont icon-structure
|
||||
order: 6
|
||||
comment: false
|
||||
---
|
||||
|
||||
# 手动安装依赖项
|
||||
|
||||
Snap Hutao 依赖于 Windows App Runtime 作为环境，当用户系统缺少该环境时，Windows 系统会在安装胡桃前安装该框架。
|
||||
|
||||
|
||||
|
||||
若你处在网络较差的环境中，可能会卡在环境安装过程中。在这种情况下，你可以从微软官网下载 Windows App Runtime 安装包并手动安装：
|
||||
|
||||
1. 访问微软官方文档：[Windows 应用 SDK 最新的下载项](https://learn.microsoft.com/zh-cn/windows/apps/windows-app-sdk/downloads)
|
||||
2. 点击 “下载最新的 x64 稳定安装程序” 以下载离线安装包
|
||||
3. 运行下载的 Windows App Runtime 安装包，完成后再安装 Snap Hutao
|
||||
@@ -10,13 +10,6 @@ comment: false
|
||||
|
||||
该文档包含由**用户端错误**造成的问题
|
||||
|
||||
## RuntimeEnvironmentException
|
||||
|
||||
- 异常：`RuntimeEnvironmentException`
|
||||
- 提示：`未开启长路径功能，无法设置注册表键值`
|
||||
- 问题来源：没有解除 Windows 目录长度限制
|
||||
- 解决方案：下载 [EnableLongPaths.zip](https://d.hut.ao/d/tools/EnableLongPaths.zip) 后解压，运行解压后的 `.reg` 文件
|
||||
|
||||
## Return Code: -10001
|
||||
|
||||
- 该异常实际上来源于米游社的返回信息，包括：
|
||||
@@ -90,4 +83,4 @@ comment: false
|
||||
安装时出现 `0x80073D05` 错误码的主要原因是先前卸载时没有删除部分本地文件导致的。
|
||||
|
||||
- 需要打开 `%appdata%/../Local/Packages`
|
||||
- 并在文件夹中找到 `60568DGPStudio.SnapHutao_ebfp3nyc27j86` 文件夹并删除（如果权限不足请考虑使用 `NSudo_LG` 解决，详情请百度）
|
||||
- 并在文件夹中找到 `60568DGPStudio.SnapHutao_wbnnev551gwxy` 文件夹并删除（如果权限不足请考虑使用 `NSudo_LG` 解决，详情请百度）
|
||||
|
||||
@@ -8,7 +8,7 @@ comment: false
|
||||
# 卸载胡桃工具箱
|
||||
|
||||
- 清除有关的任务计划
|
||||
- 1.4.15 版本前，若不执行该步骤，胡桃用于获取实时便笺数据的计划任务将不会被删除，会出现[这个问题](FAQ.md#为什么会弹出需要使用新应用以打开的对话框)
|
||||
- 1.4.15 版本前，若不执行该步骤，胡桃用于获取实时便笺数据的计划任务将不会被删除，会出现[这个问题](#为什么会弹出需要使用新应用以打开的对话框)
|
||||
- **方法 1** <Badge text="仅限早于 1.4.15 的版本" type="tip" />：
|
||||
- 打开胡桃，选择 **设置** 页签
|
||||
- 找到 **删除所有计划任务** 一栏中，点击右侧的 **执行** 按钮 <Badge text="需要管理员模式" type="tip" />
|
||||
@@ -29,3 +29,22 @@ comment: false
|
||||
- 右键点击 “胡桃”，并选择 “卸载”
|
||||
- 清除数据文件夹（如需完全卸载）
|
||||
- 打开并删除该文件夹 `%userprofile%/Documents/Hutao`
|
||||
|
||||
## 常见问题
|
||||
|
||||
### 为什么会弹出需要使用新应用以打开的对话框
|
||||
|
||||
|
||||
|
||||
如在卸载胡桃工具箱后出现如上图所示的 “需要使用新应用以打开此 hutao 链接”，说明没有按文档要求在卸载前清除实时便笺定时任务。
|
||||
请根据文档在设置中清除定时任务后再卸载胡桃工具箱。
|
||||
|
||||
- 如果你在系统定时任务中找不到胡桃的定时任务，但问题仍然出现，请参考[这份文档](https://github.com/DGP-Studio/Snap.Hutao.Docs/issues/18)来解决
|
||||
|
||||
### 如何完整地备份/恢复客户端数据
|
||||
|
||||
::: warning 数据安全提示
|
||||
`Userdata.db` 包含你的全部客户端数据，包括安全敏感的米哈游论坛 Cookie，请妥善储存该文件，不要将其分享给任何人。
|
||||
:::
|
||||
|
||||
从在胡桃数据目录（默认路径为 `%userprofile%/Documents/Hutao`）中以复制的方式将 `Userdata.db` 拷贝至你的备份目录即可，该文件包含了全部的胡桃客户端数据。
|
||||
@@ -59,7 +59,7 @@ Snap.Genshin 已停止更新，项目已归档
|
||||
|
||||
~~基本不会考虑~~。后续可能会考虑。
|
||||
|
||||
你可以通过快速启动栏来快速启动游戏，具体方法可见[此文档](../advanced/FAQ.md)
|
||||
你可以通过快速启动栏来快速启动游戏，具体方法可见[此文档](../features/game-launcher.md#如何通过胡桃工具箱快速地启动游戏)
|
||||
|
||||
## 将来会有移动端吗？有考虑根据胡桃做个手机桌面小组件吗？胡桃以后支持插件吗？胡桃会有插件开发文档吗？
|
||||
|
||||
|
||||
@@ -61,6 +61,9 @@ comment: false
|
||||
|
||||
- “米游社养成计算” 同步的数据来源于米游社养成计算数据
|
||||
- 该同步方式一次可同步全部角色信息
|
||||
|
||||
:::
|
||||
|
||||
- 在胡桃工具箱的 “我的角色” 功能页面，在界面右上角点击 “同步角色信息”
|
||||
- 点击 “从米游社养成计算同步”
|
||||
|
||||
|
||||
@@ -69,8 +69,11 @@ comment: false
|
||||
|
||||
## Windows 平台上的原神 HDR
|
||||
|
||||
原神目前内置了仅能通过设置注册表键值开启的 HDR 功能，虽然此举可能意味着该功能属于游戏的测试功能，但是你已经能够抢先体验！
|
||||
可以在支持 HDR 的显示器上启用 Windows 平台上的原神 HDR 功能以提升视觉体验。在游戏启动器中，你可以启用 Windows HDR 选项，胡桃工具箱会在游戏启动时激活游戏的此内置功能。
|
||||
~~原神目前内置了仅能通过设置注册表键值开启的 HDR 功能，虽然此举可能意味着该功能属于游戏的测试功能，但是你已经能够抢先体验！~~
|
||||
|
||||
~~可以在支持 HDR 的显示器上启用 Windows 平台上的原神 HDR 功能以提升视觉体验。在游戏启动器中，你可以启用 Windows HDR 选项，胡桃工具箱会在游戏启动时激活游戏的此内置功能。~~
|
||||
|
||||
原神暂时禁用了 HDR 功能，因此该功能暂时无法生效。
|
||||
|
||||
## 启动参数
|
||||
|
||||
@@ -94,6 +97,9 @@ comment: false
|
||||
- `-monitor` 参数
|
||||
- **显示器**，允许多显示器用户选择指定的显示器来运行游戏
|
||||
- 如果你无法判断各选项代表的显示器，可以点击 “识别显示器” 来获得提示
|
||||
::: warning
|
||||
请注意，修改主显示器可能会导致游戏出现在与编号不对应的显示器上。
|
||||
:::
|
||||
|
||||
## 资源下载
|
||||
|
||||
@@ -139,3 +145,93 @@ comment: false
|
||||
3. 在显卡驱动中存在 “最大帧速率” 的设置
|
||||
4. 在显卡驱动软件内存在未关闭的类似于 “节能模式” 的选项
|
||||
5. 显卡性能不足
|
||||
|
||||
## 常见问题
|
||||
|
||||
### 如何通过胡桃工具箱快速地启动游戏
|
||||
|
||||
- 在主程序中正确设置高级启动器功能
|
||||
- 将胡桃工具箱在系统中固定在快速启动栏中
|
||||
- 在快速启动栏中右键胡桃应用程序
|
||||
|
||||
|
||||
|
||||
- 选择 “启动游戏” 即可
|
||||
|
||||
### 为什么游戏登录状态会失效，导致切换账号功能无效
|
||||
|
||||
- 保存游戏登录状态的要素有两个：网络环境和设备 ID
|
||||
- 导致该问题的常见原因是：
|
||||
- 网络环境频繁变换，如公网 IP 更换
|
||||
- 网络设备变换，比如网卡更新、MAC 地址更换
|
||||
- 操作失误，导致实际上根本没有保存登录状态（空的登录状态无法避免被胡桃识别）
|
||||
- 确认你的账号已登录后，进入游戏
|
||||
- 关闭游戏后，确定游戏进程已关闭
|
||||
- 再次进行账号检测，来添加登录状态
|
||||
|
||||
### 转换服务器失败后如何恢复游戏程序
|
||||
|
||||
::: info 功能原理说明
|
||||
胡桃客户端始终只从原神官方服务器下载转换服务器需要的文件，这保证了用户不会下载到被第三方篡改的危险程序。
|
||||
如果你在转换到某一种目标服务器时频繁因网络问题而转换失败，则意味你的网络到目标的原神官方服务器连接质量差。
|
||||
你应检查你的互联网连接、联系你的运营商或向专业人士咨询以保证你的正常使用体验。
|
||||
:::
|
||||
|
||||
在转换原神服务器时，如果胡桃客户端意外退出或由于用户侧网络问题会导致转换流程中断并进而导致原神客户端损坏。
|
||||
此时胡桃工具箱会提示 `游戏路径不正确，前往设置更改游戏路径`，而游戏路径下此时可能不存在任何游戏主程序文件，导致用户无法正确设置。
|
||||
|
||||
在这种情况下，用户可以执行下面的步骤**手动将胡桃客户端备份的游戏主程序恢复至原本的游戏目录中**或**直接使用官方启动器修复游戏**。
|
||||
|
||||
在开始手动恢复游戏程序之前，你需要知道以下基本知识：
|
||||
|
||||
1. 关于游戏客户端
|
||||
1. 国服原神客户端目录下有名为 `YuanShen.exe` 的游戏主程序和名为 `YuanShen_Data` 的游戏程序目录
|
||||
2. 国际服原神客户端目录下有名为 `GenshinImpact.exe` 的游戏主程序和名为 `GenshinImpact_Data` 的游戏程序目录
|
||||
2. 关于胡桃客户端转换服务器功能下的备份步骤
|
||||
1. 在转换服务器前，胡桃客户端会备份当前游戏客户端的主程序以及国服／国际服客户端专有的一些组件程序，即 `exe` 主程序和 `_Data` 目录
|
||||
2. 备份文件储存于当前 Windows 用户下的文档库中的 `Hutao/ServerCache` 目录下，即 `%userprofile%/Documents/Hutao/ServerCache`
|
||||
|
||||
手动恢复游戏主程序步骤（此处以国际服转国服为例）：
|
||||
|
||||
1. 进入胡桃用于备份游戏主程序的 `ServerCache` 目录，此时该目录下存放着转换前的游戏程序备份文件，即 `GenshinImpact.exe` 和 `GenshinImpact_Data`
|
||||
2. 进入游戏主程序目录，此时既没有 `YuanShen.exe` 也没有 `GenshinImpact.exe`，并且有一个国服目录 `YuanShen_Data`
|
||||
3. 手动将游戏主程序目录下的 `YuanShen_Data` 文件夹更名为 `GenshinImpact_Data`
|
||||
4. 手动将 `Hutao/ServerCache` 下的 `GenshinImpact.exe` 和 `GenshinImpact_Data` 复制回游戏主程序目录中并覆盖当前已有文件
|
||||
5. 此时你的游戏客户端应已恢复正常
|
||||
6. 重新进入胡桃客户端的 “游戏启动器” 界面，“游戏路径不正确” 错误应不再出现，且 “服务器” 设置一栏为空。此时，你可以选择原本的服务器版本（国际服）并立刻启动游戏，或选择新的服务器目标（国服）并转换客户端版本。
|
||||
|
||||
### 如何恢复 `config.ini` 配置文件
|
||||
|
||||
在某些特定条件下（如游戏目录权限错误），`config.ini` 文件会在转服后丢失。这会造成无法进入胡桃工具箱高级启动器界面和游戏无法正常启动。
|
||||
|
||||
在判断你当前的游戏版本后，你可以在游戏目录 `%your_launcher_folder%/Genshin Impact Game/` 下手动创建并填入对应的配置文件，下面是常见的配置文件内容。
|
||||
|
||||
::: info
|
||||
请自行修改 `game_version` 至当前游戏版本
|
||||
:::
|
||||
|
||||
::: tabs#game_config_samples
|
||||
|
||||
@tab 国服 Official
|
||||
|
||||
```
|
||||
[General]
|
||||
channel=1
|
||||
cps=mihoyo
|
||||
game_version=4.1.0
|
||||
sub_channel=1
|
||||
plugin_7_version=1.0.0
|
||||
```
|
||||
|
||||
@tab 国际服 Official
|
||||
|
||||
```
|
||||
[General]
|
||||
channel=1
|
||||
cps=mihoyo
|
||||
game_version=4.1.0
|
||||
sub_channel=0
|
||||
plugin_7_version=1.0.0
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
@@ -41,3 +41,14 @@ comment: false
|
||||
- **在胡桃工具箱中通过密码或 Cookie 登录米游社的过程中，你的数据只经米游社服务器和本地胡桃工具箱处理，不经过包括胡桃服务器在内的任何第三方服务。**
|
||||
|
||||
:::
|
||||
|
||||
## 常见问题
|
||||
|
||||
### 为什么米游社账号登录状态经常失效，添加的账号消失
|
||||
|
||||
- 我们通过储存账号的米游社 Cookie 来维持登录状态。
|
||||
- 但是当用户在浏览器或其它设备上**注销账号**后， 维持登录状态的 Cookie 将**失效**。
|
||||
- 这会导致胡桃工具箱上的米游社账号在启动后被自动移除。
|
||||
- 此情况也可能因为网络连接问题导致无法检查 Cookie 有效性，故出现此情况后请优先重启胡桃工具箱。
|
||||
- 自 2022 年 10 月起，米游社极大地提高了账号被判定为有风险的概率，[账号有风险](../advanced/exceptions.md#状态1034-验证失败)时亦会令 Cookie 无法被识别为有效状态
|
||||
- 自 1.4.15 版本起，你可以通过在账号面板中刷新 Cookie 来刷新登录状态
|
||||
|
||||
@@ -56,3 +56,13 @@ comment: false
|
||||
|
||||
- 将鼠标停留在需要被设置的角色实时便笺的窗体上
|
||||
- 点击其窗体右上角出现的移除标志按钮，即可移除该角色对应的实时便笺
|
||||
|
||||
## 常见问题
|
||||
|
||||
### 为什么设置实时便笺的自动刷新会提示 “修改计划任务失败”
|
||||
|
||||
实时便笺的自动刷新依赖于任务计划。为了避免可能的权限问题，胡桃工具箱会强制在非管理员模式设置计划任务。
|
||||
|
||||
如果你在旧版本开启了自动刷新，那你可以通过手动在任务计划程序中删除旧的任务计划来解决问题。任务计划的名称为 `SnapHutaoDailyNoteRefreshTask`。
|
||||
|
||||
如果你没有在旧版本开启自动刷新，那么此问题是由于你目前使用的 Windows 用户账户权限不足导致的。如果你当前的用户账户是管理员账户，那你只能通过重装系统来解决此问题。
|
||||
|
||||
@@ -86,13 +86,11 @@ background="rgba(244, 125, 63, 0.15)"
|
||||
@tab 使用 MSIX 安装包安装
|
||||
|
||||
<div class="vp-card-container">
|
||||
<VPCard
|
||||
title="加入用户社区"
|
||||
desc="我们会在用户社区手动分发安装包"
|
||||
logo="/images/202312/community.svg"
|
||||
link="community.html"
|
||||
background="rgba(242, 255, 28, 0.25)"
|
||||
/>
|
||||
<div class="hint-container warning">
|
||||
<p class="hint-container-title">注意</p>
|
||||
<p>我们建议使用 Snap.Hutao.Deployment 来安装胡桃，任何使用 MSIX 安装包安装时出现的问题均不会被积极处理。</p>
|
||||
</div>
|
||||
|
||||
<VPCard
|
||||
title="胡桃自动判断"
|
||||
desc="自动判断最佳线路下载"
|
||||
@@ -116,11 +114,6 @@ background="rgba(244, 125, 63, 0.15)"
|
||||
/>
|
||||
</div>
|
||||
|
||||
- 在安装过程中，如果出现任意以下错误之一，请参考文章[手动安装依赖项](advanced/dependency.md)解决，该问题来源是Windows无法自动安装所需要的框架环境
|
||||
1. `应用程序无法安装应用包相关项，请向开发人员索要包`
|
||||
2. 在安装过程中长时间卡在`正在安装框架`
|
||||
- 更多在安装时遇上的问题，请阅读 [常见问题-安装篇](advanced/FAQ.md) 文档
|
||||
|
||||
:::
|
||||
|
||||
---
|
||||
@@ -139,7 +132,7 @@ background="rgba(244, 125, 63, 0.15)"
|
||||
|
||||
### <HopeIcon icon="iconfont icon-update" size="1.5rem" color="rgb(255, 185, 0)" /> 更新胡桃工具箱
|
||||
|
||||
如没有特殊声明，则你可以通过安装最新版 MSIX 安装包来升级程序。
|
||||
如没有特殊声明，你可以通过运行 [Snap.Hutao.Deployment](https://api.snapgenshin.com/patch/hutao-deployment/download) 或安装最新版 MSIX 安装包来升级程序。
|
||||
|
||||
1.9.0版本起，Snap Hutao 将内置升级提示功能以提醒你获取更新包。如果你更新失败，可尝试使用 [Snap.Hutao.Deployment](https://api.snapgenshin.com/patch/hutao-deployment/download) 覆盖安装来解决问题。
|
||||
|
||||
@@ -188,6 +181,61 @@ WebView2 运行时由微软提供，其允许胡桃在程序内低开销地启
|
||||
|
||||
:::
|
||||
|
||||
---
|
||||
## <HopeIcon icon="iconfont icon-ask" size="1.7rem" color="var(--theme-color)" /> 安装常见问题
|
||||
|
||||
_**至此，你已经初步设置好了你的胡桃工具箱。你现在可以自由探索这个应用，你也可以在这个这个网站中找到胡桃的全部帮助文档。**_
|
||||
### 为什么程序中的图标会出现乱码现象
|
||||
|
||||
- 当用户在 Windows 10 下使用胡桃且发现有乱码情况时：
|
||||
- 可以下载 `Segoe Fluent Icons`字体
|
||||
- 安装时选择`为系统所有用户安装`，即可解决问题
|
||||
- 您可以从 [微软官方](https://aka.ms/SegoeFluentIcons)下载到该字体文件
|
||||
|
||||
### 能不能通过添加缺少的系统组件来实现胡桃的安装
|
||||
|
||||
> 这就是使用精简版/破解版/优化版/LTSC/LTSB版本的代价，不是不报，时候未到。没有足够的水平就不要用高级的东西。
|
||||
|
||||
当你问出这个问题的时候，那答案已经是不可以了，因为你完全不了解你的操作系统。
|
||||
|
||||
你不知道你手中所谓的精简版系统少了多少必要组件。当你装上了一个组件，解决了当前的问题，你还会遇上下一个问题。
|
||||
|
||||
::: warning
|
||||
以下问题仅适用于 MSIX 安装，请先尝试使用 [Snap.Hutao.Deployment](https://api.snapgenshin.com/patch/hutao-deployment/download) 来解决你的安装问题
|
||||
:::
|
||||
|
||||
### 我的计算机无法打开 MSIX 格式的安装包
|
||||
|
||||
你的计算机缺少了 Windows 系统重要组件 App Installer，你可能是盗版软件的受害者。
|
||||
|
||||
如果你的系统中装有 Microsoft Store，可以从 [App Installer 商店页](https://apps.microsoft.com/detail/9NBLGGH4NNS1?hl=en-us&gl=US) 重新安装来恢复该组件。
|
||||
|
||||
如果你没有Windows Store，请使用微软官方的最新完整版消费者 [Windows 10](https://www.microsoft.com/zh-cn/software-download/windows10) 或 [Windows 11](https://www.microsoft.com/zh-cn/software-download/windows11) 镜像。使用微软官方的提供的 Windows 10 升级助手和 Windows 11 安装助手可以帮助你简单地在保留数据的情况下升级至最新完整版 Windows。**请勿使用来源不明的破解版、精简版系统镜像。**
|
||||
|
||||
### MSIX 安装包提示 `无法验证此应用包的发布者证书` 错误并无法安装
|
||||
|
||||
该问题常见于 Windows 家庭版系统。如果你使用的不是家庭版系统，则你的 Windows Update 模块可能被禁用或已失效，这导致世界范围内的 CA 根证书无法被更新。
|
||||
|
||||
Snap Hutao 的软件证书来源于 [GlobalSign Code Signing Root R45](https://support.globalsign.com/ca-certificates/root-certificates/globalsign-root-certificates)，你可以手动从 GlobalSign 官网下载 [该证书](https://secure.globalsign.com/cacert/codesigningrootr45.crt) 并添加到你的系统中的 `可信任的根证书授权机构` 类别中。
|
||||
|
||||
### MSIX 安装包提示组策略错误或需要 Windows 开发者许可证错误并无法安装
|
||||
|
||||
如果你使用的 Windows 家庭版操作系统，请尝试打开系统设置中的开发者模式以解决该问题
|
||||
|
||||
### 安装 MSIX 安装包时失败并有错误提示
|
||||
|
||||
| 错误信息 | 原因 |
|
||||
| --------------------- | -------------------------------- |
|
||||
| `0x80040154` 错误代码 | 错误的Windows用户账户权限 |
|
||||
| `应用未启动` 错误提示 | App Installer 权限错误或已被破坏 |
|
||||
| `0x80073CF0` 错误代码 | 错误的目录权限 |
|
||||
| `0x80070005` 错误代码 | 错误的Windows用户账户权限 |
|
||||
| `0x80070570` 错误代码 | 错误的Windows用户账户权限 |
|
||||
| `0x8007065E` 错误代码 | 错误的Windows用户账户权限 |
|
||||
|
||||
如果你在安装失败时收到了上面的错误提示，请尝试下面的步骤来解决问题：
|
||||
|
||||
1. 在 Windows 开始菜单按钮上右键，选择 `PowerShell (管理员)`
|
||||
2. 在打开的窗口中复制下面的代码并回车执行（在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. 如果 PowerShell 没有任何错误输出（通常为红色），意味着安装成功。请在开始菜单中的全部应用列表中寻找 `Snap Hutao` 并启动
|
||||
|
||||
@@ -15,9 +15,10 @@ comment: false
|
||||
在发起新的 Issue 之前，请先执行以下清单：
|
||||
|
||||
- [ ] 当前使用的是最新版本客户端
|
||||
- [ ] 阅读[常见问题](../advanced/FAQ.md)文档和[已知问题](../advanced/known-issue.md)文档
|
||||
- [ ] 使用搜索功能搜索你的问题并检查[已知问题](../advanced/known-issue.md)文档
|
||||
- [ ] 搜索项目 Issue，检查是否已有相同或类似的问题
|
||||
- 若执行上述步骤后没有得到问题解决方案，你可以在 GitHub 上发起一个新的 Issue
|
||||
|
||||
若执行上述步骤后没有得到问题解决方案，你可以在 GitHub 上发起一个新的 Issue
|
||||
|
||||
如果你不清楚怎样是一个好的 Issue 可以阅读 Snap Hutao 过去的一些[优质问题](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+label%3A%E4%BC%98%E8%B4%A8%E9%97%AE%E9%A2%98+is%3Aclosed)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user