快速开始
遵循这篇快速开始文档，你将可以快速地将胡桃工具箱设置为可用状态。
最低系统要求
| 要求 | 规格 |
|---|---|
| 最低可运行系统版本 | Windows 10 Build 19045.5371 (22H2) Windows 11 Build 22621 (22H2) |
| 推荐系统版本 | Windows 11 Build 26100 (24H2) 或更高版本 |
| 必要组件 | Windows Update, App Installer, MSVC 运行库 |
| 可选组件 | WebView2 Runtime |
不支持的系统版本：
- Windows 企业版，包括LTSC 和 LTSB 分支
- Windows IoT 版本
- 精简版/修改版系统，所有来自非微软官方完整版系统包括第三方提供镜像系统的问题均不会积极处理，请前往 windows 网站获取最新版系统镜像安装。
- Windows Insider 预览版本的问题将视情况可能不会被积极处理。
- Windows 10 版本已结束生命周期支持，其问题将不会得到处理，请升级到最新的系统版本并尝试复现。
2025年1月发布的 Windows KB5049981 补丁是在 Windows 10 平台运行 Snap Hutao 的必要条件，其已包含在 Windows 10 Build 19045.5371 及更高版本中。
下载胡桃工具箱
全新安装
二次开发衍生版本
来自社区力量！
如果你有兴趣通过你的力量让 Snap Hutao Remastered 项目变得更好，欢迎加入我们！
更新胡桃工具箱
通常，遵循应用内的更新提示即可完成更新。
只要不手动删除数据目录，你的本地数据不会受到影响。
安装可选组件
通过可选组件，胡桃工具箱能够更高效地实现一些功能，尽管它们不是强制要求的组件，但可以显著改善用户体验。
WebView2 运行时
WebView2 运行时由微软提供，允许胡桃工具箱内嵌低开销的浏览器组件。此组件用于实现米游社账号的 WebView2 登录功能。
你可以在微软官网底部找到 常青独立安装程序，选择 x64 下载并安装。
Segoe Fluent Icons 字体
此字体由微软提供，可优化胡桃工具箱的图标显示效果。缺少该字体可能导致部分图标显示不佳。
点击此链接下载字体压缩包，解压后右键安装字体到系统。
MSVC 运行库（MSVCRT）
MSVC 运行库是解锁帧率功能的必要组件。如提示“缺少 XXX.dll”或“缺少 XXX 组件”，请安装最新版 MSVCRT。
点击此链接下载 MSVC 运行库（x64）v14.50 安装文件并完成安装。
添加第一个米游社账号
在主界面点击左下角文档按钮和设置按钮中间的账号面板。在弹出的米游社账号面板中，根据账号类型选择登录方式。
无论使用哪种方式，请确保账号已通过官方应用初始化。否则 Snap Hutao 无法正确获取账号信息。
注意
请确认米游社账号已绑定国服账号。
- 点击“手机验证码”按钮，填写手机号并发送验证码。
- 填写验证码后确认，稍等片刻即可添加账号。
安装常见问题
为什么程序中的图标会出现乱码现象
- Windows 10 用户可通过安装
Segoe Fluent Icons字体解决问题。 - 在安装时选择“为系统所有用户安装”。
能否通过修复系统组件解决安装问题
根据错误提示修复缺失组件，但 Snap Hutao 开发组不会提供支持。
注意
以下问题仅适用于 MSIX 安装，请优先尝试 Snap.Hutao.Deployment 安装。
我的计算机无法打开 MSIX 格式的安装包
检查系统是否缺少 App Installer。
- 安装 App Installer。
- 确保使用官方 Windows 10 或 11 镜像安装系统。
MSIX 安装包提示 无法验证此应用包的发布者证书
手动安装 SnapHutaoRemasteringProjectRootCA.cer 证书到 可信任的根证书授权机构（或遵循视频安装步骤）。
MSIX 安装包提示组策略错误或需要开发者许可证
- 打开Windows 设置
- 打开“系统-开发者选项”
- 开启“开发人员模式”的开关
安装 MSIX 包时失败并出现错误提示
| 错误信息 | 原因 |
|---|---|
0x80040154 错误代码 | 错误的 Windows 用户账户权限 |
应用未启动 错误提示 | App Installer 权限错误或已被破坏 |
0x80073CF0 错误代码 | 错误的目录权限 |
0x80070005 错误代码 | 错误的 Windows 用户账户权限 |
0x80070570 错误代码 | 错误的 Windows 用户账户权限 |
0x8007065E 错误代码 | 错误的 Windows 用户账户权限 |
解决步骤
在开始菜单右键选择
PowerShell (管理员)。执行以下代码完成安装：
PowerShellAdd-AppxPackage -Path <在这里填写安装包的完整路径，路径里需要包含 .msix，<>括号请删除>无红色错误提示即表示安装成功。