Update quick-start

2025-11-19 21:16:31 +08:00 · 2023-12-17 23:49:07 -08:00
parent d823a39d38
commit a036c66729
4 changed files with 64 additions and 28 deletions
--- a/docs/.vuepress/public/images/202312/MSEdge.webp
+++ b/docs/.vuepress/public/images/202312/MSEdge.webp
--- a/docs/.vuepress/theme.ts
+++ b/docs/.vuepress/theme.ts
@@ -12,7 +12,7 @@ export default hopeTheme({

  iconAssets: [
    "iconfont",
-    "https://at.alicdn.com/t/c/font_3861247_nm7gjy97qqd.css",
+    "https://at.alicdn.com/t/c/font_3861247_yn9taeyq2sc.css",
  ],

  logo: "https://img.alicdn.com/imgextra/i4/1797064093/O1CN01vK3m2w1g6duwt8quS_!!1797064093.png",
--- a/docs/en/quick-start.md
+++ b/docs/en/quick-start.md
@@ -11,24 +11,27 @@ order: 5

 # Quick Start

-::: tip
+Follow this document's instruction, you can set up your Snap Hutao quickly.

-If you download and use **Snap Hutao**，you are agree to our [terms of service](statements/tos.md)
+## <HopeIcon icon="iconfont icon-windows" size="1.7rem" color="rgb(0, 168, 232)" /> Minimum System Requirements

-:::
+| Requirement             | Attribute                                                        |
+| ----------------------- | ---------------------------------------------------------------- |
+| **Minimum Required OS** | Windows 10 Build 19045 (22H2)<br/> Windows 11 Build 22621 (22H2) |
+| **Recommended OS**      | Windows 11 Build 22621 (22H2) or later versions                  |
+| Required Components     | Windows Update, App Installer                                    |
+| Optional Components     | WebView2 Runtime                                                 |

-<!-- @include: star-request.md -->
+**Unsupported OS Versions**：

-## Minimum System Requirements
+1. LTSC and LTSB versions does not include Microsoft Store, so they are not supported
+2. Windows 10 Build 19041 supports installation, but some feature may have unexpected errors due to Windows kernel issues,
+   so Snap Hutao cannot solve them
+3. Issues happens in Windows Insider preview versions will not be solved

-| Requirement             | Attribute                                       |
-| ----------------------- | ----------------------------------------------- |
-| **Minimum Required OS** | Windows 10 Build 19045 (22H2) [^first]          |
-| **Recommended OS**      | Windows 11 Build 22621 (22H2) or later versions |
-| Required Components     | Windows Update, App Installer                   |
-| Optional Components     | WebView2 Runtime                                |
+## <HopeIcon icon="iconfont icon-cache" size="1.8rem" color="rgb(128, 161, 255)" /> Download Snap Hutao

-## Download Snap Hutao
+### New Installation

 **Whatever installation method you used, package source and registration are always handled by Microsoft Store.**

@@ -61,13 +64,13 @@ On Windows 10 and Windows 11 you can click the button above to download Snap Hut

 :::

-### Upgrade to MS Store Version from Sideload Versions
+### <HopeIcon icon="iconfont icon-refresh" size="1.5rem" color="rgb(127, 186, 0)" /> Upgrade to MS Store Version from Sideload Versions

 - Uninstall the sideload version with our [uninstallation instruction document](/advanced/uninstall.html)
-  - You data will not lose as long as you don't delete data directory manually
+  - Your data will not lose as long as you don't delete data directory manually
 - Follow the method above to install the Microsoft Store version application

-## Update Snap Hutao
+### <HopeIcon icon="iconfont icon-update" size="1.5rem" color="rgb(255, 185, 0)" /> Update Snap Hutao

 **You can use any of the update methods, whatever method you used when you installed Snap Hutao. They don't need to be consistent, as Microsoft Store is the only source of packages.**
 ::: tabs  
@@ -93,7 +96,12 @@ If you still don't receive the update, you may enter the Snap Hutao [detail page

 :::

-## Installing WebView2 Runtime
+## <HopeIcon icon="iconfont icon-expansion" size="1.7rem" color="rgb(7, 163, 161)" /> Install Optional Components
+
+With optional components, Snap Hutao can implement some functions more conveniently through the system-level environment.
+They are not mandatory components, but they can bring a better experience.
+
+### <img src="/images/202312/MSEdge.webp" width="20" height="20"> WebView2 Runtime

 WebView2 Runtime is provided by Microsoft, which enables a built-in browser at a low resource cost inside the program.
 As an optional component, WebView2 is not a mandatory component, but it will make some Snap Hutao's features easier.
@@ -101,7 +109,35 @@ As an optional component, WebView2 is not a mandatory component, but it will mak
 At the bottom of the [Microsoft official page](https://developer.microsoft.com/zh-cn/microsoft-edge/webview2/),
 you can find`Evergreen Standalone Installer`, choose`x64`download and install as prompted

-[^first]:
-    As LTSC and LTSB Windows versions do not contain Microsoft Store and some other necessary dependencies, they
-    are not supported.Windows 10 Build 19041 is allowed to install Snap Hutao, but some features have known issues caused by
-    Windows Os Kernal, those issues won't be fixed.
+## <HopeIcon icon="iconfont icon-adduser" size="1.7rem" color="rgb(7, 163, 161)" /> Add First MiHoYo BBS Account
+
+After entering Snap Hutao, click `Account Panel` in the left-bottom corner between `Settings` and `Document`. In the
+pop-up panel, click the login button right corresponding to your account.
+
+If you are using a China server account, you need login within `MiYouShe` category; If you are using an oversea account
+(aka. HoYoLAB/HoYoverse account), you need login within `HoYoLAB` category.
+
+Whatever account type you have, you have both `Web Login` and `Cookie Login` method.
+
+::: tabs
+
+@tab Web Login
+
+**Web Login requires Microsoft WebView2 Runtime component**
+
+1. Click `Web Login` button in the account panel, Snap Hutao will turn on MiHoYo BBS login page with WebView2
+2. Login to your account in the web page. After successfully login to your account, you will be able to see your account information
+3. Click `I'm Logged in` button on the right-top, Snap Hutao will add this account to the client, and will display it in the account panel
+
+@tab Cookie Login
+
+If you wish to sign in to your account with MiHoYo Passport cookie that extracted by youself, you can click `Input Manually`
+button in the account panel, and input your cookie with `SToken` field. If the entered cookie is valid, your account will
+be displayed in the account panel once your click the `Confirm` button.
+
+:::
+
+---
+
+_**Now, you have finished your initial set up of Snap Hutao. You are now free to explore this application, you can also
+find all documents in this website.**_
--- a/docs/zh/quick-start.md
+++ b/docs/zh/quick-start.md
@@ -12,7 +12,7 @@ order: 5

 遵循这篇快速开始文档，你将可以快速地将胡桃工具箱设置为可用状态。

-## 最低系统要求
+## <HopeIcon icon="iconfont icon-windows" size="1.7rem" color="rgb(0, 168, 232)" /> 最低系统要求

 | 要求                   | 规格                                                             |
 | ---------------------- | ---------------------------------------------------------------- |
@@ -27,7 +27,7 @@ order: 5
 2. Windows 10 Build 19041 亦可以安装， 但部分功能会因内核问题无法使用，故该版本下的胡桃工具箱问题将不会被处理
 3. Windows Insider 预览版本的问题不会被处理

-## 下载胡桃工具箱
+## <HopeIcon icon="iconfont icon-cache" size="1.8rem" color="rgb(128, 161, 255)" /> 下载胡桃工具箱

 ### 全新安装

@@ -60,7 +60,7 @@ theme="auto">

 :::

-### 从侧载版升级至商店版
+### <HopeIcon icon="iconfont icon-refresh" size="1.5rem" color="rgb(127, 186, 0)" /> 从侧载版升级至商店版

 如果你之前安装了 Snap Hutao 侧载版则需要先卸载旧版本再进行全新安装

@@ -68,7 +68,7 @@ theme="auto">
  - 只要不手动删除数据目录，你的数据不会受到影响
 - 按照上述方法全新安装商店版应用

-### 更新胡桃工具箱
+### <HopeIcon icon="iconfont icon-update" size="1.5rem" color="rgb(255, 185, 0)" /> 更新胡桃工具箱

 **无论你使用何种方式安装了应用，你都可以选择任意的方式去更新它，不必选择和安装时一样的方法，因为微软商店是应用包唯一来源**
 ::: tabs
@@ -94,17 +94,17 @@ theme="auto">

 :::

-## 安装可选组件
+## <HopeIcon icon="iconfont icon-expansion" size="1.7rem" color="rgb(7, 163, 161)" /> 安装可选组件

 通过可选组件，胡桃工具箱可以通过系统级的环境来更方便地实现一些功能，它们不是强制要求的组件，但可以带来更好的体验

-### WebView2 运行时
+### <img src="/images/202312/MSEdge.webp" width="20" height="20"> WebView2 运行时

 WebView2 运行时由微软提供，其允许胡桃在程序内低开销地启用一个内置的浏览器。通过该组件，胡桃允许用户通过 WebView2 内置浏览器登录米游社账号。

 在[微软官网](https://developer.microsoft.com/zh-cn/microsoft-edge/webview2/)的底部，你可以找到`常青独立安装程序`，选择`x64`下载并根据提示安装即可

-## 添加第一个米游社账号
+## <HopeIcon icon="iconfont icon-adduser" size="1.7rem" color="rgb(7, 163, 161)" /> 添加第一个米游社账号

 在进入胡桃工具箱主界面后，点击左下角文档按钮和设置按钮中间的账号面板。在弹出的米游社账号面板中，根据你的账号类型选择对应的登录按钮。