跳至主要內容

快速开始

DGP-Studio功能教程大约 9 分钟

快速开始

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

最低系统要求

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

不支持的系统版本：

  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 下载并根据提示安装即可

添加第一个米游社账号

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

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

无论是国服账号还是国际服账号，你都有 网页登录 和 Cookie登录 两种登录方式。 对于使用米游社手机应用并绑定国服游戏账号的用户，可以选择 扫码登录。

网页登录

网页登录需要使用 Microsoft WebView2 运行时组件

  1. 点击账号面板中的 网页登录 按钮，胡桃将会通过 WebView2 打开米游社登录界面
  2. 在该界面中登录你的米游社账号，登录成功后你将进入米游社通行证界面并看到登录账号的信息
  3. 点击程序主界面右上角的 我已登录 按钮，胡桃工具箱会将当前账号添加进本地客户端，并在账号面板中显示出来

安装常见问题

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

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

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

这就是使用精简版/破解版/优化版/LTSC/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