Merge commit '49190feab6268d64bbb16e332f53d2a66f387d14' as 'Website'

Website/docs/zh/guide/installation.md

@@ -0,0 +1,149 @@
+# 安装参考
+
+::: details 将会了解 SukiSU-Ultra 安装过程
+[[toc]]
+:::
+
+::: danger 警告
+**Root 您的设备可能会使保修失效，如果操作不当可能会造成永久性损坏。**
+请务必在继续之前创建完整备份，阅读文档确保与您的设备兼容，遵循文档参考，准备好恢复计划
+:::
+
+## 通用 GKI
+
+请**全部**参考 [KernelSU 安装指南](https://kernelsu.org/zh_CN/guide/installation.html)
+
+1. 适用于 GKI 2.0 设备，如小米、红米、三星等（不包括内核修改的制造商，如魅族、一加、真我和 OPPO）
+2. 在[更多链接](./links)中查找 GKI 构建。找到设备内核版本，然后下载并使用 TWRP 或内核刷写工具刷入带有 `AnyKernel3` 后缀的
+   zip 文件。
+3. 无后缀的 `.zip` 档案是未压缩的，`gz` 后缀是特定型号使用的压缩格式。
+
+## 一加设备
+
+使用[更多链接](./links)部分提到的链接，用您的设备信息创建自定义构建，然后刷入带有 AnyKernel3 后缀的 zip 文件。
+
+::: details 展开
+
+- 只需要填写内核版本的前两部分，如 `5.10`、`5.15`、`6.1` 或 `6.6`。
+- 请自行搜索处理器代号，通常是不含数字的英文字母。
+- 可以从一加开源内核仓库中找到分支和配置文件。
+- 第三方 Recovery（推荐 TWRP）
+
+:::
+
+## 开始安装
+
+### 通用 GKI 安装
+
+::: tip
+适用于 GKI 2.0 设备，如小米、红米、三星等（不包括内核修改的制造商，如魅族、一加、真我和 OPPO）
+:::
+
+#### 步骤：
+
+1. 下载 GKI 构建文件
+
+   从我们的[资源部分](./links)查找 GKI 构建。查找您设备的内核版本并下载带有 `AnyKernel3` 后缀的 `zip` 文件。
+
+2. 通过 Recovery 刷入
+
+   启动到 `TWRP recovery`，选择 **Install**，导航到下载的 `AnyKernel3 zip` 文件，滑动刷入后重启系统
+
+3. [验证安装](#验证)
+
+::: details 文件格式说明
+无后缀的 `.zip` 档案是未压缩的，`gz` 后缀是特定型号使用的压缩格式。
+:::
+
+### 一加设备安装
+
+1. 获取设备信息
+
+- 内核版本（前两部分，例如 `5.10`、`5.15`、`6.1`、`6.6`）
+- 处理器代号（通常是不含数字的英文）
+- 来自一加开源内核仓库的分支和配置文件
+
+2. 创建自定义构建
+
+   使用我们[资源部分](./links)中提到的链接，用您的设备信息创建自定义构建。
+
+3. 刷入构建
+
+   下载生成的带有 AnyKernel3 后缀的 zip 文件，启动到 `TWRP recovery`，选择 **Install**，导航到下载的 `AnyKernel3 zip` 文件，滑动刷入后重启系统
+
+::: tip
+您只需要填写内核版本的前两部分。自行搜索处理器代号
+:::
+
+### 手动内核集成
+
+面向希望将 SukiSU Ultra 集成到自己内核构建中的高级用户
+
+#### 主分支（GKI）
+
+```sh [bash]
+curl -LSs "https://raw.githubusercontent.com/SukiSU-Ultra/SukiSU-Ultra/main/kernel/setup.sh" | bash -s main
+```
+
+#### 非 GKI 分支
+
+```sh [bash]
+curl -LSs "https://raw.githubusercontent.com/SukiSU-Ultra/SukiSU-Ultra/main/kernel/setup.sh" | bash -s nongki
+```
+
+#### SUSFS-Dev 分支（推荐）
+
+```sh [bash]
+curl -LSs "https://raw.githubusercontent.com/SukiSU-Ultra/SukiSU-Ultra/main/kernel/setup.sh" | bash -s susfs-dev
+```
+
+```bash
+curl -LSs "https://raw.githubusercontent.com/SukiSU-Ultra/SukiSU-Ultra/main/kernel/setup.sh" | bash -s susfs-main
+```
+
+::: warning 必需的内核配置
+为了支持 KPM，添加 `CONFIG_KPM=y`
+
+对于非 GKI 设备，还要添加 `CONFIG_KALLSYMS=y` 和 `CONFIG_KALLSYMS_ALL=y`
+:::
+
+## 安装后设置
+
+### 系统更新时保持 Root
+
+> [!IMPORTANT]
+> 如何在 OTA 更新后保持 root 访问权限：
+
+#### 步骤：
+
+1. 系统更新后重启前
+   - OTA 安装后不要立即重启，将 SukiSU Ultra 安装到第二插槽
+   - 打开 SukiSU Ultra 管理器，在**刷入/修补内核**界面选择 **GKI/non_GKI install**，选择您的 `AnyKernel3` 内核 `zip` 文件，选择与当前运行插槽相对的插槽然后刷入重启。
+
+2. 替代方案：LKM 模式
+
+   使用 [LKM 模式](#通用-gki) 在 OTA 后安装到未使用的插槽。
+
+::: warning 警告
+**非 GKI 设备注意事项：** 此方法不支持所有非 GKI 设备。对于非 GKI 设备，使用 TWRP 是最安全的方法。
+:::
+
+## 验证
+
+安装后，验证一切是否正常工作，
+
+- 打开 SukiSU Ultra 管理器检查 root 工作状态
+- 使用 root 权限的应用程序来验证 root 访问是否工作正常
+- 在设置 -> 关于手机中检查内核版本
+
+## 需要帮助？
+
+如果在安装过程中遇到问题：
+
+1. 查看我们的[兼容性指南](./compatibility)了解设备要求
+2. 访问我们的 [GitHub 仓库](https://github.com/sukisu-ultra/sukisu-ultra)获取支持
+3. 加入我们的 [Telegram 社区](https://t.me/sukiksu)获取帮助
+
+::: danger 安全提醒
+**始终有备用计划！** 保留您的原始 `boot.img/init_boot.img` 并知道如何在出现问题时恢复设备。
+:::