Add win-linux doc link, by-ua redir, mention uboot var may cause problem

Author: kagura114

docs/Installation/intro.mdx

@@ -10,10 +10,11 @@ RevyOS目前支持多个设备，以下表格是针对于每个设备的镜像
 ## 刷写教程支持情况
 
 import { DownloadLink } from "@site/src/components/ImageLinks";
+import { RedirectBasedOnUA } from "@site/src/components/RedirectBasedOnUA";
 
 | 支持设备          | 镜像下载（最新版本） | 刷写教程 |
 | ----------------- | ----------|--------------------------------------------- |
-| Lichee Pi 4A      | {<DownloadLink device="Lichee Pi 4A" />}       | [镜像刷写](licheepi4a) |
+| Lichee Pi 4A      | {<DownloadLink device="Lichee Pi 4A" />}       | {<RedirectBasedOnUA windowsLink="./licheepi4a-windows" otherLink="./licheepi4a" description="镜像刷写" /> } |
 | Milk-V Meles      | {<DownloadLink device="Milk-V Meles" />}       | [Milk-V 官方镜像刷写教程](https://milkv.io/zh/docs/meles/installation) |
 | Milk-V Pioneer    | {<DownloadLink device="Milk-V Pioneer" />}     | [镜像刷写](milkv-pioneer) |
 | Lichee Cluster 4A | {<DownloadLink device="Lichee Cluster 4A" />}  | 编写中 |

docs/Installation/licheepi4a-windows.mdx

@@ -6,11 +6,14 @@ import { DownloadLink } from "@site/src/components/ImageLinks";
 
 # LicheePi4A在Windows上的镜像刷写教程
 
-此页面是 LiCheePi 4A 镜像在 Windows 操作系统上的镜像刷写教程，如想在 Linux 系统上进行刷写请点击[LiCheePi4A镜像刷写教程](./licheepi4a.mdx)，如想获取其他镜像刷写教程请从下面表格点击链接进行查看。
+此页面是 LicheePi4A 镜像刷写教程，适用于 Windows
 
-| 支持设备 |                |
+如想查看镜像刷写教程请从下面的表格中点击链接进行查看。
+
+| 其他刷写教程 |   链接     |
 | ------- | -------------- |
-| Milk-V Pioneer | [刷写教程](milkv-pioneer.mdx) |
+| LicheePi4A (在 Linux 上刷写)| [Linux 刷写教程](./licheepi4a) |
+| Milk-V pioneer | [刷写教程](./milkv-pioneer) |
 
 ## 注意！
 

docs/Installation/licheepi4a.mdx

@@ -6,10 +6,13 @@ import { DownloadLink } from "@site/src/components/ImageLinks";
 
 # LicheePi4A镜像刷写教程
 
-此页面是 LicheePi4A 镜像刷写教程，如想获取其它镜像刷写教程请从下面的表格中点击链接进行查看。
+此页面是 LicheePi4A 镜像刷写教程，适用于 Linux
 
-| 支持设备 |                |
+如想查看镜像刷写教程请从下面的表格中点击链接进行查看。
+
+| 其他刷写教程 |   链接     |
 | ------- | -------------- |
+| LicheePi4A (在 Windows 上刷写)| [Windows 刷写教程](./licheepi4a-windows) |
 | Milk-V pioneer | [刷写教程](./milkv-pioneer) |
 
 ## 注意！
@@ -437,12 +440,22 @@ boot，大小为 92886476 Bytes为例，可在 `cmd_parameter: boot, imagesize:
 
 刷写完成后拔掉电脑与板卡连接的USB-Type-C线，接入电源线便可直接启动进入系统。
 
-#### 可能出现的问题
+### 可能出现的问题
+
+#### Linux only：卡在< waiting for any device >
 
 如果 `lsusb` 中存在 download 设备，但`fastboot` 命令仍然卡在 `< waiting for any device >` ，可以尝试使用 `sudo` 运行 `fastboot` 命令。
 
 ![waiting](/img/image-for-flash/waiting.png)
 
+#### 大版本升级后出现问题
+
+如果 **使用串口进入 uboot** 并启动 fastboot 刷入（见[此处](#写入镜像到emmc接入串口)），可能是 uboot 保留了旧版本的环境变量导致了问题，请在串口的 uboot 控制台中输入
+```
+env default -a -f; env save; reset
+```
+如果有此版本有分区表变化，请额外运行：`run gpt_partition`
+
 ### 用户登录
 
 下面是默认的系统账户以及密码

i18n/en/docusaurus-plugin-content-docs/current/Installation/intro.mdx

@@ -9,10 +9,11 @@ RevyOS currently supports multiple devices. The table below provides the status
 ## Installation Guide Availability
 
 import { DownloadLink } from "@site/src/components/ImageLinks";
+import { RedirectBasedOnUA } from "@site/src/components/RedirectBasedOnUA";
 
 | Supported Device   | Image Download (Latest Version)                      | Installation Guide                                 |
 | ------------------ | ---------------------------------------------------- | ---------------------------------------------- |
-| Lichee Pi 4A       | {<DownloadLink device="Lichee Pi 4A" />}       | [Installation Guide](licheepi4a)               |
+| Lichee Pi 4A       | {<DownloadLink device="Lichee Pi 4A" />}       | {<RedirectBasedOnUA windowsLink="./licheepi4a-windows" otherLink="./licheepi4a" description="Installation Guide" /> }               |
 | Milk-V Meles       | {<DownloadLink device="Lichee Pi 4A" />}       | [Official Milk-V Installation Guide](https://milkv.io/docs/meles/installation) |
 | Milk-V Pioneer     | {<DownloadLink device="Milk-V Pioneer" />}     | [Installation Guide](milkv-pioneer)            |
 | Lichee Cluster 4A | {<DownloadLink device="Lichee Cluster 4A" />}  | In Progress |

i18n/en/docusaurus-plugin-content-docs/current/Installation/licheepi4a-windows.mdx

@@ -6,10 +6,12 @@ import { DownloadLink } from "@site/src/components/ImageLinks";
 
 # Installing RevyOS on the LicheePi 4A (Windows)
 
-This page provides a tutorial for flashing the LicheePi 4A image on Windows operating systems. If you want to flash the image on a Linux system, please click [LicheePi4A Image Flashing Tutorial](./licheepi4a.mdx). For other image flashing tutorials, please click the links in the table below.
+This page provides a tutorial for flashing the LicheePi 4A image on Windows.
+If you want to flash the image on a Linux, or view other image flashing tutorials, please view the links in the table below.
 
-| Supported Devices |                |
+| Other Flashing Tutorial | Link |
 | ----------------- | -------------- |
+| LicheePi4A (Installing using Linux)| [Installation guilde for Linux](./licheepi4a) |
 | Milk-V Pioneer    | [Flashing Tutorial](./milkv-pioneer.mdx) |
 
 ## Attention!

i18n/en/docusaurus-plugin-content-docs/current/Installation/licheepi4a.mdx

@@ -8,11 +8,13 @@ import LocaleImage from "@site/src/components/LocaleImage";
 
 # Installing RevyOS on the LicheePi 4A
 
-This guide provides instructions for installing RevyOS on the LicheePi4A. For other device flashing guides, click the links in the table below.
+This page provides a tutorial for flashing the LicheePi 4A image on Linux.
+If you want to flash the image on a Windows, or view other image flashing tutorials, please view the links in the table below.
 
-| Device Name |                |
-| ------- | -------------- |
-| Milk-V pioneer | [Installation Guide](./milkv-pioneer) |
+| Other Flashing Tutorial | Link |
+| ----------------- | -------------- |
+| LicheePi4A (Installing using Windows)| [Installation guilde for Windows](./licheepi4a-windows) |
+| Milk-V Pioneer    | [Flashing Tutorial](./milkv-pioneer.mdx) |
 
 ## Important!
 
@@ -381,10 +383,25 @@ fastboot flash root root-lpi4a-20240720_171951.ext4
 Once flashing is complete, disconnect the USB-Type-C cable from the computer and the board, connect the power cable, and the system will boot up.
 
 
-#### Potential Issues
+### Potential Issues
+
+#### Linux only: stuck at < waiting for any device >
 
 If the `lsusb` output shows a download device but the `fastboot` command remains stuck at `< waiting for any device >`, try running the `fastboot` command with `sudo`.
 
+#### Issues After Major Version Upgrade  
+
+If you **use a serial connection to enter U-Boot** and start fastboot flashing (see [here](#writing-the-image-to-emmc-with-serial-connection)), the issue might be caused by U-Boot retaining old environment variables. Please enter the following command in the U-Boot serial console:  
+
+```  
+env default -a -f; env save; reset  
+```  
+
+If this version includes partition table changes, additionally run:  
+```  
+run gpt_partition  
+```
+
 ### User Login
 
 - Login account: `debian`

src/components/RedirectBasedOnUA.tsx

@@ -0,0 +1,27 @@
+import React from "react";
+import { useEffect, useState } from "react";
+
+interface RedirectProps {
+  windowsLink: string;
+  otherLink: string;
+  description: string;
+}
+
+/**
+ * 根据用户的 User-Agent 选择合适的链接，并动态渲染 <a> 标签。
+ * @param {string} windowsLink - Windows 用户的跳转链接
+ * @param {string} otherLink - 其他系统用户的跳转链接
+ * @param {string} description - 显示的文字
+ * @returns a标签。
+ */
+export const RedirectBasedOnUA: React.FC<RedirectProps> = ({ windowsLink, otherLink, description }) => {
+  const [targetLink, setTargetLink] = useState<string>("");
+
+  useEffect(() => {
+    const userAgent = navigator.userAgent.toLowerCase();
+    const isWindows = userAgent.includes("windows");
+    setTargetLink(isWindows ? windowsLink : otherLink);
+  }, [windowsLink, otherLink]);
+
+  return <a href={targetLink}>{description}</a>; 
+};