From ea6e60e06d2be8989f25db955d948b76cc03a330 Mon Sep 17 00:00:00 2001 From: Masterain Date: Sun, 26 Nov 2023 00:06:07 -0800 Subject: [PATCH] fix #71 --- docs/zh/quick-start.md | 85 +++++++++++++++++++++++++++--------------- 1 file changed, 55 insertions(+), 30 deletions(-) diff --git a/docs/zh/quick-start.md b/docs/zh/quick-start.md index deff41ded..b351be468 100644 --- a/docs/zh/quick-start.md +++ b/docs/zh/quick-start.md @@ -10,35 +10,27 @@ order: 5 # 快速开始 -::: tip -若您已下载或使用**胡桃工具箱**，即表示你已阅读并完全同意[用户使用协议与法律声明](statements/tos.md) -::: - - - -## 视频指南 - -对于大多数人而言，遵循本页文档会有更高的效率。 - -但如果你对其中包含的操作不熟悉，也可以回到这里来跟着视频指南操作。 - -::: details 胡桃工具箱视频指南 - 下载/安装/卸载篇 - - - -::: +遵循这篇快速开始文档，你将可以快速地将胡桃工具箱设置为可用状态。 ## 最低系统要求 -| 要求 | 规格 | -| ---------------------- | ---------------------------------------- | -| **最低可运行系统版本** | Windows 10 Build 19045 (22H2) [^first] | -| **推荐系统版本** | Windows 11 Build 22621 (22H2) 或更高版本 | -| **必要组件** | Windows Update, App Installer | -| 可选组件 | WebView2 Runtime | +| 要求 | 规格 | +| ---------------------- | ---------------------------------------------------------------- | +| **最低可运行系统版本** | Windows 10 Build 19045 (22H2)
Windows 11 Build 22621 (22H2) | +| **推荐系统版本** | Windows 11 Build 22621 (22H2) 或更高版本 | +| **必要组件** | Windows Update, App Installer | +| 可选组件 | WebView2 Runtime | + +**不支持的系统版本**： + +1. LTSC 和 LTSB 版本系统由于不包含微软商店，不在支持列表中 +2. Windows 10 Build 19041 亦可以安装， 但部分功能会因内核问题无法使用，故该版本下的胡桃工具箱问题将不会被处理 +3. Windows Insider 预览版本的问题不会被处理 ## 下载胡桃工具箱 +### 全新安装 + **无论使用何种安装方式，应用包来源和注册授权都由微软商店管理** ::: tabs @@ -59,9 +51,9 @@ theme="auto"> - 根据提示允许安装 - 如果安装失败或显示缺少依赖包，或卡在安装框架阶段，请参考[手动安装依赖项](advanced/dependency.md)一文 -@tab 从 MSIX 文件安装 +@tab 使用 MSIX 安装包安装 -- 访问胡桃工具箱[最新发布页面](https://github.com/DGP-Studio/Snap.Hutao/releases/latest/)或[胡桃资源站](https://d.hut.ao/releases) +- 访问胡桃工具箱[最新发布页面](https://github.com/DGP-Studio/Snap.Hutao/releases/latest/) - 下载 MSIX 应用包 - 直接运行 MSIX 应用包以执行安装 - 如果安装失败或显示缺少依赖包，或卡在安装框架阶段，请参考[手动安装依赖项](advanced/dependency.md)一文 @@ -70,11 +62,13 @@ theme="auto"> ### 从侧载版升级至商店版 +如果你之前安装了 Snap Hutao 侧载版则需要先卸载旧版本再进行全新安装 + - 按照文档提供的[卸载方法](advanced/uninstall.html)卸载侧载版应用 - 只要不手动删除数据目录，你的数据不会受到影响 - 按照上述方法全新安装商店版应用 -## 更新胡桃工具箱 +### 更新胡桃工具箱 **无论你使用何种方式安装了应用，你都可以选择任意的方式去更新它，不必选择和安装时一样的方法，因为微软商店是应用包唯一来源** ::: tabs @@ -92,7 +86,7 @@ theme="auto"> - 执行命令 `winget upgrade "Snap Hutao"` - 根据提示允许安装 -@tab 从 GitHub 更新 +@tab 使用 MSIX 安装包更新 - 访问胡桃工具箱[最新发布页面](https://github.com/DGP-Studio/Snap.Hutao/releases/latest/) - 下载 MSIX 应用包 @@ -100,10 +94,41 @@ theme="auto"> ::: -## 安装 WebView2 运行时 +## 安装可选组件 -WebView2 运行时由微软提供，其允许胡桃在程序内低开销地启用一个内置的浏览器。作为可选组件，WebView2 运行时不是强制组件，但安装后你会更容易地使用部分功能。 +通过可选组件，胡桃工具箱可以通过系统级的环境来更方便地实现一些功能，它们不是强制要求的组件，但可以带来更好的体验 + +### WebView2 运行时 + +WebView2 运行时由微软提供，其允许胡桃在程序内低开销地启用一个内置的浏览器。通过该组件，胡桃允许用户通过 WebView2 内置浏览器登录米游社账号。 在[微软官网](https://developer.microsoft.com/zh-cn/microsoft-edge/webview2/)的底部，你可以找到`常青独立安装程序`，选择`x64`下载并根据提示安装即可 -[^first]: LTSC 和 LTSB 版本系统由于不包含微软商店，不在支持列表中。Windows 10 Build 19041 亦可以安装，但部分功能会因内核问题无法使用，故该版本下的胡桃工具箱问题将不会被处理 +## 添加第一个米游社账号 + +在进入胡桃工具箱主界面后，点击左下角文档按钮和设置按钮中间的账号面板。在弹出的米游社账号面板中，根据你的账号类型选择对应的登录按钮。 + +如果你的原神账号是米哈游的国服账号，需要在`米游社`类别内登录；如果你的原神账号是 HoYoverse 的国际服账号，需要在 `HoYoLAB` 类别内登录。 + +无论是国服账号还是国际服账号，你都有`网页登录`和`Cookie登录`两种登录方式 + +::: tabs + +@tab 网页登录 + +**网页登录需要使用 Microsoft WebView2 运行时组件** + +1. 点击账号面板中的`网页登录`按钮，胡桃将会通过 WebView2 打开米游社登录界面 +2. 在该界面中登录你的米游社账号，登录成功后你将进入米游社通行证界面并看到登录账号的信息 +3. 点击程序主界面右上角的`我已登录`按钮，胡桃工具箱会将当前账号添加进本地客户端，并在账号面板中显示出来 + +@tab Cookie 登录 + +如果你能希望使用自己提取的米哈游通行证 Cookie 登录到胡桃工具箱，可以在登录面板中点击 `手动输入`，并在弹出的窗口中输入包含 SToken 的 Cookie。 +若你填入了一个有效的 Cookie，在点击`确认`后你将成功登录你的米游社账号并在账号面板中显示出来。 + +::: + +--- + +_**至此，你已经初步设置好了你的胡桃工具箱。你现在可以自由探索这个应用，你也可以在这个这个网站中找到胡桃的全部帮助文档。**_