跳至主要內容

快速开始

DGP-Studio2022年9月28日功能教程大约 11 分钟

快速开始

遵循这篇快速开始文档，你将可以快速地将胡桃工具箱设置为可用状态。

最低系统要求

要求规格
最低可运行系统版本Windows 10 Build 19045 (22H2)
Windows 11 Build 22621 (22H2)
推荐系统版本Windows 11 Build 22621 (22H2) 或更高版本
必要组件Windows Update, App Installer
可选组件WebView2 Runtime, MSVC 运行库

不支持的系统版本：

  1. LTSC 和 LTSB 版本由于不包含足够新版本的 MSIX Core，故不支持直接安装，需要手动处理
  2. 不支持企业版和精简版系统，所有来自非微软官方完整版家庭版（或专业版）系统的问题均不会积极处理
  3. Windows 10 Build 19041 亦可以安装，但部分功能会因内核问题无法使用，故该版本下的胡桃工具箱问题将不会被处理
  4. Windows Insider 预览版本的问题不会被处理

下载胡桃工具箱

全新安装

使用 MSIX 安装包 或 Snap.Hutao.Deployment 安装器 即可安装 Snap Hutao，你可以从以下源获取到安装包

使用 Snap.Hutao.Deployment 安装

Snap.Hutao.Deployment 是开发组自制的一键安装器，将同时安装所有需要的组件。适合广泛的普通用户和使用 MSIX 应用包安装失败的用户。

胡桃自动判断
自动判断最佳线路下载
GitHub
Snap Hutao Deployment 亦是一个开源的项目
Onedrive 镜像
由开发团队维护的镜像下载源
极狐 GitLab
Snap Hutao Deployment 代码库官方中国镜像

如果你有兴趣通过你的力量让 Snap Hutao 项目变得更好，欢迎加入我们！

从微软商店版升级至最新版

对于这项改变，你可以阅读1.9.0 版本重大改变详解来获得详细信息

如果你已经安装了 Snap Hutao 微软商店版（版本号介于1.4.11和1.8.5之间）则需要先卸载旧版本再进行全新安装

  • 按照文档提供的卸载方法卸载旧版应用
    • 只要不手动删除数据目录，你的数据不会受到影响
  • 按照上述方法全新安装新版应用

更新胡桃工具箱

如没有特殊声明，你可以通过运行 Snap.Hutao.Deployment 或安装最新版 MSIX 安装包来升级程序。

1.9.0版本起，Snap Hutao 将内置升级提示功能以提醒你获取更新包。如果你更新失败，可尝试使用 Snap.Hutao.Deployment 覆盖安装来解决问题。

  • 只要不手动删除数据目录，你的数据不会受到影响

安装可选组件

通过可选组件，胡桃工具箱可以通过系统级的环境来更方便地实现一些功能，它们不是强制要求的组件，但可以带来更好的体验

WebView2 运行时

WebView2 运行时由微软提供，其允许胡桃在程序内低开销地启用一个内置的浏览器。通过该组件，胡桃允许用户通过 WebView2 内置浏览器登录米游社账号。

在微软官网的底部，你可以找到 常青独立安装程序，选择 x64 下载并根据提示安装即可

Segoe Fluent Icons 字体

该字体由微软提供，可以为胡桃提供更好的图标显示效果，缺少该字体可能导致胡桃的部分图标显示效果不佳。

您可以点击此链接以直接下载字体压缩包。请在解压后右键安装以将字体安装到系统。

MSVC 运行库（MSVCRT）

MSVC 运行库是解锁帧率功能的必须组件，如遇解锁帧率时提示“缺少 XXX.dll”或“缺少 XXX 组件”，请先尝试安装最新版的 MSVCRT 库。此项需要您手动安装。

下载链接：MSVC 运行库（x64）｜MSVC 运行库（x86）

添加第一个米游社账号

在进入胡桃工具箱主界面后，点击左下角文档按钮和设置按钮中间的账号面板。在弹出的米游社账号面板中，根据你的账号类型选择对应的登录按钮。

如果你的原神账号是米哈游的国服账号，需要在 米游社 类别内登录；如果你的原神账号是 HoYoverse 的国际服账号，需要在 HoYoLAB 类别内登录。

无论是国服账号还是国际服账号，你都有多种登录方式可供选择。

米游社手机验证码登录

注意

请提前确认已在米游社中已经绑定国服账号

  1. 点击账号面板中的“米游社”，点击“手机验证码”按钮，填写手机号并点击“发送”
  2. 填写接收到的验证码，核对无误后点击“确认”
  3. 稍等片刻，胡桃将自动添加你的账号

安装常见问题

为什么程序中的图标会出现乱码现象

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

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

提示

对于 LTSC（IoT LTSC）官方版，可以尝试通过安装 XBox 以解决依赖问题。XBox 提供了比较完善的缺失环境检测与修复功能。

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

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

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

注意

以下问题仅适用于 MSIX 安装，请先尝试使用 Snap.Hutao.Deployment 来解决你的安装问题

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

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

如果你的系统中装有 Microsoft Store，可以从 App Installer 商店页重新安装来恢复该组件。

如果你没有Windows Store，请使用微软官方的最新完整版消费者 Windows 10 或 Windows 11 镜像。使用微软官方的提供的 Windows 10 升级助手和 Windows 11 安装助手可以帮助你简单地在保留数据的情况下升级至最新完整版 Windows。请勿使用来源不明的破解版、精简版系统镜像。

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

该问题常见于 Windows 家庭版系统。如果你使用的不是家庭版系统，则你的 Windows Update 模块可能被禁用或已失效，这导致世界范围内的 CA 根证书无法被更新。

Snap Hutao 的软件证书来源于 GlobalSign Code Signing Root R45，你可以手动从 GlobalSign 官网下载该证书并添加到你的系统中的 可信任的根证书授权机构 类别中（可能需要管理员权限）。

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

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

安装 MSIX 安装包时失败并有错误提示

错误信息原因
0x80040154 错误代码错误的 Windows 用户账户权限
应用未启动 错误提示App Installer 权限错误或已被破坏
0x80073CF0 错误代码错误的目录权限
0x80070005 错误代码错误的 Windows 用户账户权限
0x80070570 错误代码错误的 Windows 用户账户权限
0x8007065E 错误代码错误的 Windows 用户账户权限

如果你在安装失败时收到了上面的错误提示，请尝试下面的步骤来解决问题：

  1. 在 Windows 开始菜单按钮上右键，选择 PowerShell (管理员)
  2. 在打开的窗口中复制下面的代码并回车执行（在PowerShell中鼠标右键就是粘贴）
    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 并启动
用开源社区力量为原神 PC 端玩家带来最好的游戏体验
Copyright © 2024 DGP-Studio