快速开始
快速开始
遵循这篇快速开始文档，你将可以快速地将胡桃工具箱设置为可用状态。
最低系统要求
| 要求 | 规格 |
|---|---|
| 最低可运行系统版本 | Windows 10 Build 19045 (22H2) Windows 11 Build 22621 (22H2) |
| 推荐系统版本 | Windows 11 Build 22621 (22H2) 或更高版本 |
| 必要组件 | Windows Update, App Installer |
| 可选组件 | WebView2 Runtime |
不支持的系统版本：
- LTSC 和 LTSB 版本系统由于不包含微软商店，不在支持列表中
- Windows 10 Build 19041 亦可以安装， 但部分功能会因内核问题无法使用，故该版本下的胡桃工具箱问题将不会被处理
- Windows Insider 预览版本的问题不会被处理
下载胡桃工具箱
全新安装
无论使用何种安装方式，应用包来源和注册授权都由微软商店管理
- 启动 PowerShell
- 执行命令
winget install "Snap Hutao" - 根据提示允许安装
- 如果安装失败或显示缺少依赖包，或卡在安装框架阶段，请参考手动安装依赖项一文
从侧载版升级至商店版
如果你之前安装了 Snap Hutao 侧载版则需要先卸载旧版本再进行全新安装
- 按照文档提供的卸载方法卸载侧载版应用
- 只要不手动删除数据目录，你的数据不会受到影响
- 按照上述方法全新安装商店版应用
更新胡桃工具箱
无论你使用何种方式安装了应用，你都可以选择任意的方式去更新它，不必选择和安装时一样的方法，因为微软商店是应用包唯一来源
- 启动微软商店
- 点击左下角的库，查看到你目前已安装的全部应用
- 点击界面右上角的获取更新，你的应用将会被更新
若点击获取更新后胡桃仍然没有获取到更新，则可以进入Snap Hutao的商店详情页面，等待信息加载完成来获取更新
- 启动 PowerShell
- 执行命令
winget upgrade "Snap Hutao" - 根据提示允许安装
- 访问胡桃工具箱最新发布页面
- 下载 MSIX 应用包
- 直接运行 MSIX 应用包以执行安装
安装可选组件
通过可选组件，胡桃工具箱可以通过系统级的环境来更方便地实现一些功能，它们不是强制要求的组件，但可以带来更好的体验
WebView2 运行时
WebView2 运行时由微软提供，其允许胡桃在程序内低开销地启用一个内置的浏览器。通过该组件，胡桃允许用户通过 WebView2 内置浏览器登录米游社账号。
在微软官网的底部，你可以找到常青独立安装程序，选择x64下载并根据提示安装即可
添加第一个米游社账号
在进入胡桃工具箱主界面后，点击左下角文档按钮和设置按钮中间的账号面板。在弹出的米游社账号面板中，根据你的账号类型选择对应的登录按钮。
如果你的原神账号是米哈游的国服账号，需要在米游社类别内登录；如果你的原神账号是 HoYoverse 的国际服账号，需要在 HoYoLAB 类别内登录。
无论是国服账号还是国际服账号，你都有网页登录和Cookie登录两种登录方式
网页登录需要使用 Microsoft WebView2 运行时组件
- 点击账号面板中的
网页登录按钮，胡桃将会通过 WebView2 打开米游社登录界面 - 在该界面中登录你的米游社账号，登录成功后你将进入米游社通行证界面并看到登录账号的信息
- 点击程序主界面右上角的
我已登录按钮，胡桃工具箱会将当前账号添加进本地客户端，并在账号面板中显示出来
如果你能希望使用自己提取的米哈游通行证 Cookie 登录到胡桃工具箱，可以在登录面板中点击 手动输入，并在弹出的窗口中输入包含 SToken 的 Cookie。 若你填入了一个有效的 Cookie，在点击确认后你将成功登录你的米游社账号并在账号面板中显示出来。
至此，你已经初步设置好了你的胡桃工具箱。你现在可以自由探索这个应用，你也可以在这个这个网站中找到胡桃的全部帮助文档。