常见问题

如何创建胡桃的桌面快捷方式（非管理员模式）

社区力量

感谢 CzHUV 提供的解决方案

• Win+R 呼出运行窗口，在窗口中输入shell:AppsFolder
• Windows 会弹出应用程序目录，找到胡桃工具箱
• 右键，点击创建快捷方式
• 根据提示操作你就可以获得一个桌面快捷方式了

如何添加一个默认以管理员方式运行的快捷方式

自 Snap Hutao 1.7.4 版本起，你可以在程序设置页面中点击创建快捷方式来在桌面上添加一个具有管理员权限的快捷方式

你可以移动这个快捷方式到你想要的地方

如何让胡桃工具箱开机自动启动

• 请参考如下思路
  • 可以自行创建一个批处理文件，内容参考此 issue中，令胡桃以管理员模式直接运行的命令。
  • 设置一个计划任务程序令上述批处理文件开机自启，或将上述批处理文件加入启动项中
• 或有其他令胡桃工具箱可开机自启的思路，可自行探索

如何通过胡桃工具箱快速地启动游戏

• 在主程序中正确设置高级启动器功能

• 将胡桃工具箱在系统中固定在快速启动栏中

• 在快速启动栏中右键胡桃应用程序

  

• 选择启动游戏即可

如何通过网络代理使用胡桃工具箱

参考 HttpRequestException 错误 文档

为什么程序会出现乱码现象

• 当用户在 Windows 10 下使用胡桃且发现有乱码情况时：
  • 可以下载 Segoe Fluent Icons字体
  • 安装时选择为系统所有用户安装，即可解决问题
• 您可以从 微软官方下载到该字体文件

为什么会弹出需要使用新应用以打开的对话框

如在卸载胡桃工具箱后出现如上图所示的需要使用新应用以打开此 hutao 链接，说明没有按文档要求在卸载前清除实时便笺定时任务。 请根据文档在设置中清除定时任务后再卸载胡桃工具箱。

• 如果你在系统定时任务中找不到胡桃的定时任务，但问题仍然出现，请参考这份文档来解决

为什么米游社帐号登录状态经常失效，添加的帐号消失

• 我们通过储存帐号的米游社 Cookie 来维持登录状态。
• 但是当用户在浏览器或其它设备上注销帐号后， 维持登录状态的 Cookie 将失效。
• 这会导致胡桃工具箱上的米游社帐号在启动后被自动移除。
• 此情况也可能因为网络连接问题导致无法检查 Cookie 有效性，故出现此情况后请优先重启胡桃工具箱。
• 自 2022 年 10 月起，米游社极大地提高了账号被判定为有风险的概率，账号有风险时亦会令 Cookie 无法被识别为有效状态
• 自 1.4.15 版本起，你可以通过在帐号面板中刷新 Cookie 来刷新登录状态

为什么游戏登录状态会失效，导致切换帐号功能无效

• 保存游戏登录状态的要素有两个：网络环境和设备 ID
• 导致该问题的常见原因是：
  • 网络环境频繁变换，如公网 IP 更换
  • 网络设备变换，比如网卡更新、MAC 地址更换
  • 操作失误，导致实际上根本没有保存登录状态（空的登录状态无法避免被胡桃识别）
    • 确认你的帐号已登录后，进入游戏
    • 关闭游戏后，确定游戏进程已关闭
    • 再次进行帐号检测，来添加登录状态

为什么程序会提示注册计划任务失败

使用管理员模式使用一次实时便笺后，胡桃的任务计划会被以管理员权限创建。当再次以非管理员模式启动胡桃时，程序在修改计划任务时会缺少权限。 继续使用管理员模式即可解决该问题。

使用 MSIX 安装包安装时进度卡在正在安装所需框架

• 当用户系统缺少必要依赖环境时，系统会自动安装所需依赖。若用户禁用了 Windows Update 组件或网络条件差时，系统无法完成该步骤。
  • 请确保 Windows Update 已启用；胡桃工具箱升级同样依赖于 Windows Update 组件
  • 你亦可以手动下载并安装胡桃的相关依赖

无法使用管理员模式启动胡桃工具箱

该问题仅存在于 Windows 10 低于 22H2 的版本中

• 当用户系统版本低于 Windows Build 19045（即 Windows 10 22H2 版本）时，可能无法通过管理员模式启动胡桃工具箱
  • 该问题属于 Windows 内核级别问题，难以判断具体来源，故建议用户升级至 Windows 10 最新版本

转换服务器失败后如何恢复游戏程序

功能原理说明

胡桃客户端始终只从原神官方服务器下载转换服务器需要的文件，这保证了用户不会下载到被第三方篡改的危险程序。 如果你在转换到某一种目标服务器时频繁因网络问题而转换失败，则意味你的网络到目标的原神官方服务器连接质量差。 你应检查你的互联网连接、联系你的运营商或向专业人士咨询以保证你的正常使用体验。

在转换原神服务器时，如果胡桃客户端意外退出或由于用户侧网络问题会导致转换流程中断并进而导致原神客户端损坏。 此时胡桃工具箱会提示 游戏路径不正确，前往设置更改游戏路径，而游戏路径下此时可能不存在任何游戏主程序文件，导致用户无法正确设置。

在这种情况下，用户可以执行下面的步骤手动将胡桃客户端备份的游戏主程序恢复至原本的游戏目录中或直接使用官方启动器修复游戏。

在开始手动恢复游戏程序之前，你需要知道以下基本知识：

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 文件会在转服后丢失。这会造成无法进入胡桃工具箱高级启动器界面和游戏无法正常启动。

在判断你当前的游戏版本后，你可以在游戏目录下手动创建并填入对应的配置文件，下面是常见的配置文件内容。

[General]
channel=1
cps=mihoyo
game_version=4.1.0
sub_channel=1
plugin_7_version=1.0.0

[General]
channel=1
cps=mihoyo
game_version=4.1.0
sub_channel=0
plugin_7_version=1.0.0

如何完整地备份/恢复客户端数据

数据安全提示

Userdata.db 包含你的全部客户端数据，包括安全敏感的米哈游论坛 Cookie，请妥善储存该文件，不要将其分享给任何人。

从在胡桃数据目录（默认路径为 %userprofile%/Documents/Hutao）中以复制的方式将 Userdata.db 拷贝至你的备份目录即可，该文件包含了全部的 胡桃客户端数据。