跳至主要內容

常见问题

DGP-StudioFAQ大约 11 分钟

常见问题

安装篇

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

  • 当用户系统缺少必要依赖环境时，系统会自动安装所需依赖。若用户禁用了 Windows Update 组件或网络条件差时，系统无法完成该步骤。

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

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

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

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

我的计算机无法打开 MSIX 格式的安装包

你的计算机缺少了 Windows 系统重要组件，你可能是盗版软件的受害者。

请使用微软官方的最新完整版消费者 Windows 10open in new window 或 Windows 11open in new window 镜像。 使用微软官方的提供的 Windows 10 升级助手和 Windows 11 安装助手可以帮助你简单地在保留数据的情况下升级至最新完整版 Windows。

请勿使用来源不明的破解版、精简版系统镜像。

MSIX 安装包提示 无法验证此应用包的发布者证书 错误并无法安装

你的 Windows Update 模块被禁用或已失效，这导致世界范围内的 CA 根证书无法被更新。这是一个严重的系统安全风险，请及时更新你的系统或使用微软官方的升级助手修复你的操作系统。

Snap Hutao 的软件证书来源于 GlobalSign Code Signing Root R45open in new window，你可以手动从 GlobalSign 官网下载该证书open in new window并添加到你的系统中的可信任的根证书授权机构模块中。

MSIX 安装包提示组策略错误或需要 Windows 开发者许可证错误并无法安装

如果你使用的 Windows 家庭版操作系统，请尝试打开系统设置中的开发者模式以解决该问题

安装 MSIX 安装包时提示 0x80040154 错误

该问题包含两种不同的错误提示

  1. 使用程序包 60568DGPStudio.SnapHutao_1.9.1.0_x64__ebfp3nyc27j86 中的目标卷 C: 执行的部署 Add 操作失败，错误为 0x80040154
  2. 应用安装失败，错误消息：没有注册类 0x80040154

该问题来源于被恶意禁用或修改的系统组件、服务、注册表项目或组策略。微软建议重新安装完整系统以修复该问题。

如果你有更多的线索可以在 https://github.com/DGP-Studio/Snap.Hutao/issues/1223open in new window 议题中回复。

双击打开 MSIX 文件时跳出错误显示应用未启动

该问题有缓解的方法，但我们需要更多的用户帮助我们排查造成该问题的原因。

如果你有线索，可以在 https://github.com/DGP-Studio/Snap.Hutao/issues/1222open in new window 议题中回复。

安装 MSIX 安装包时提示 0x80073CF0 错误

该问题造成的原因未知，我们需要更多的用户提交错误信息以帮助我们排查问题。

如果你有线索，可以在 https://github.com/DGP-Studio/Snap.Hutao/issues/1221open in new window 议题中回复。

能不能通过添加缺少的系统组件来实现胡桃的安装

这就是使用精简版/破解版/优化版/LTSC/LTSB版本的代价，不是不报，时候未到。没有足够的水平就不要用高级的东西。

当你问出这个问题的时候，那答案已经是不可以了，因为你完全不了解你的操作系统。

你不知道你手中所谓的精简版系统少了多少必要组件。当你装上了一个组件，解决了当前的问题，你还会遇上下一个问题。

启动篇

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

社区力量

感谢 CzHUV 提供的解决方案open in new window

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

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

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

你可以移动这个快捷方式到你想要的地方，包括但不限于任务栏和开始菜单

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

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

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

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

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

功能使用篇

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

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

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

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

    quick-start

  • 选择启动游戏即可

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

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

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

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

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

功能原理说明

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

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

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

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

  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/ 下手动创建并填入对应的配置文件，下面是常见的配置文件内容。

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

网络篇

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

参考 HttpRequestException 错误 文档

卸载篇

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

uninstall-error

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

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

数据安全提示

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

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

用开源社区力量为原神 PC 端玩家带来最好的游戏体验
Copyright © 2023 DGP-Studio