fix #71

2025-11-19 21:16:31 +08:00 · 2023-11-26 00:06:07 -08:00
parent 3feaeefeff
commit ea6e60e06d
1 changed files with 55 additions and 30 deletions
--- a/docs/zh/quick-start.md
+++ b/docs/zh/quick-start.md
@@ -10,35 +10,27 @@ order: 5

 # 快速开始

-::: tip
-若您已下载或使用**胡桃工具箱**，即表示你已阅读并完全同意[用户使用协议与法律声明](statements/tos.md)
-:::
-
-<!-- @include: star-request.md -->
-
-## 视频指南
-
-对于大多数人而言，遵循本页文档会有更高的效率。
-
-但如果你对其中包含的操作不熟悉，也可以回到这里来跟着视频指南操作。
-
-::: details 胡桃工具箱视频指南 - 下载/安装/卸载篇
-
-<BiliBili bvid="BV13A411k7B4" />
-
-:::
+遵循这篇快速开始文档，你将可以快速地将胡桃工具箱设置为可用状态。

 ## 最低系统要求

-| 要求                   | 规格                                     |
-| ---------------------- | ---------------------------------------- |
-| **最低可运行系统版本** | Windows 10 Build 19045 (22H2) [^first]   |
-| **推荐系统版本**       | Windows 11 Build 22621 (22H2) 或更高版本 |
-| **必要组件**           | Windows Update, App Installer            |
-| 可选组件               | WebView2 Runtime                         |
+| 要求                   | 规格                                                             |
+| ---------------------- | ---------------------------------------------------------------- |
+| **最低可运行系统版本** | Windows 10 Build 19045 (22H2)<br/> 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，在点击`确认`后你将成功登录你的米游社账号并在账号面板中显示出来。
+
+:::
+
+---
+
+_**至此，你已经初步设置好了你的胡桃工具箱。你现在可以自由探索这个应用，你也可以在这个这个网站中找到胡桃的全部帮助文档。**_