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