docs: add ZH version for troubleshooting topic (#2641)

* initial draft

* refine in progress

* add zh version for troubleshooting

* Apply suggestions from code review

Co-authored-by: Meow33 <supermonkey03@163.com>

* address comments

* address comments

* fix link

---------

Co-authored-by: Meow33 <supermonkey03@163.com>

docs/.vitepress/zh.ts

@@ -51,7 +51,11 @@ const side = {
             {
               text: "LarePass VPN 无法使用",
               link: "/zh/manual/help/ts-larepass-vpn-not-working",
-            }
+            },
+            {
+              text: "网络尚未准备好或 olares 连接错误",
+              link: "/zh/manual/help/ts-network-not-ready",
+            }            
           ],
         },
       ],

docs/manual/help/ts-network-not-ready.md

@@ -36,8 +36,7 @@ Try this method first because it is the most convenient way to access your devic
 
     a. Tap **Vault** in the LarePass app. When prompted, enter your local password to unlock.
 
-    b. In the top-left corner, tap **Authenticator** to open the side navigation, then tap **All vaults** to display all saved items.
-        ![Switch Vault filter](/images/one/ssh-switch-filter.png#bordered)
+    b. In the top-left corner, tap **Vault** to open the side navigation, and then tap **All vaults** to display all saved items.
 
     c. Find the item with the <span class="material-symbols-outlined">terminal</span> icon and tap it to reveal the password.
         ![Check saved SSH password in Vault](/images/one/ssh-check-password-in-vault.png#bordered)
@@ -54,7 +53,7 @@ Try this method first because it is the most convenient way to access your devic
         
     c. When prompted, type the SSH password, and then press **Enter**.
 
-    d. If the connection is successful, skip to [Step 3](#step-3-check-system-status).
+    d. If the connection is successful, skip to [Step 3](#step-3-check-system-pod-status).
 
 ### Step 2: Log in locally
 
@@ -69,15 +68,15 @@ When the SSH access is unavailable, log in to the device locally using a monitor
 2. Type the username `olares` and press **Enter**.
 3. Type the same SSH password obtained in **Step 1** and press **Enter**.
 
-### Step 3: Check system status
+### Step 3: Check system pod status
 
-1. Once you log in successfully, type the following command and then press **Enter** to view the list of internal software components:
+1. Once you log in successfully, type the following command and then press **Enter** to to get the status of all pods across all namespaces:
 
     ```bash
     kubectl get pods -A
     ```
     
-2. Check the **STATUS** column for any components that are not showing `Running` or `Completed`.
-3. Take a clear photo or a screenshot of the full command output, or manually note down the abnormal components.
+2. Check the **STATUS** column for any pods that are not in the `Running` state.
+3. Take a clear photo or a screenshot of the full command output, or manually note down the problematic pods.
 4. Attach this photo or your notes with descriptions to Olares team by [submitting a GitHub Issue](https://github.com/beclab/Olares/issues/new).
 

docs/zh/manual/help/ts-network-not-ready.md

@@ -0,0 +1,84 @@
+---
+outline: [2, 3]
+description: 排查 Olares One 设备已连接网络但无法通过标准访问方式连接的问题。
+---
+
+# 网络尚未准备好或 olares 连接错误
+
+当你的 Olares One 设备已开机并连接至网络，但突然停止响应时，可参考本指南进行排查。
+
+## 适用情况
+
+- LarePass 移动端显示 **Network not ready**，访问 Olares 桌面时出现 **olares connection error**，但路由器显示设备已连接，且设备能响应网络 `ping` 命令。
+- 重启设备和路由器后，问题依然存在。
+
+## 原因
+
+Olares One 设备的底层操作系统运行正常，因此能够成功连接至路由器并显示在线。然而，核心 Olares 软件服务（Kubernetes 集群）意外卡死或崩溃。
+
+## 解决方案
+
+按以下步骤收集诊断信息，以便 Olares 团队协助你恢复访问。
+
+### 步骤 1：尝试 SSH 连接
+
+建议优先尝试此方法，因为这是访问设备并收集诊断信息最便捷的方式。
+
+1. 获取 Olares One 的局域网 IP 地址。
+
+   a. 打开 LarePass 移动端，进入**设置** > **系统**，打开 **Olares 管理**页面。
+
+   ![访问 Olares 管理](/images/zh/manual/larepass/system.png#bordered)
+
+   b. 点击 Olares One 设备卡片。
+
+   c. 向下滚动至**网络**部分，记录**内网 IP**。
+
+2. 在 Vault 中查看 SSH 密码。
+
+   a. 在 LarePass 移动端中点击 **Vault**。根据提示输入本地密码解锁。
+
+   b. 点击左上角的 **Vault** 打开侧边导航，然后点击**所有 Vault** 显示所有已保存条目。
+
+   c. 找到带有 <span class="material-symbols-outlined">terminal</span> 图标的条目，点击查看密码。
+
+      ![在 Vault 中查看保存的 SSH 密码](/public/images/zh/manual/olares/ssh-check-password-in-vault1.png#bordered)
+
+3. 通过 SSH 连接。
+
+   a. 在电脑上打开终端。
+
+   b. 输入以下命令，将 `<local_ip_address>` 替换为内网 IP，然后按回车键：
+
+      ```bash
+      ssh olares@<local_ip_address>
+      ```
+
+   c. 根据提示输入 SSH 密码，然后按回车键。
+
+   d. 如果连接成功，直接跳转至[步骤 3](#步骤-3-检查系统-pod-状态)。
+
+### 步骤 2：本地登录设备
+
+如果无法通过 SSH 访问，使用显示器和键盘在本地登录设备。
+
+1. 将显示器和键盘连接至 Olares One。屏幕上会自动显示基于文本的登录提示窗口：
+
+   ```text
+   olares login:
+   ```
+
+2. 输入用户名 `olares` 并按回车键。
+3. 输入**步骤 1** 中获取的 SSH 密码并按回车键。
+
+### 步骤 3：检查系统 Pod 状态
+
+1. 登录成功后，输入以下命令并按回车键，查看所有命名空间下的 Pod 状态：
+
+   ```bash
+   kubectl get pods -A
+   ```
+
+2. 查看 **STATUS** 列，找到状态不是 `Running` 的 Pod。
+3. 对完整命令输出拍摄清晰照片或截图，或手动记录异常 Pod。
+4. 通过[提交 GitHub Issue](https://github.com/beclab/Olares/issues/new) 将照片或记录连同问题描述发送给 Olares 团队。