From 64a4231978977743bc0f22b9bc92062fe8dc7213 Mon Sep 17 00:00:00 2001
From: Meow <197331664+Meo597@users.noreply.github.com>
Date: Fri, 26 Jun 2026 01:20:55 +0800
Subject: [PATCH] Geodata: Clarify asset reload and rollback behavior

---
 docs/config/geodata.md    | 4 ++++
 docs/en/config/geodata.md | 4 ++++
 docs/ru/config/geodata.md | 4 ++++
 3 files changed, 12 insertions(+)

diff --git a/docs/config/geodata.md b/docs/config/geodata.md
index 8a2453fb..a19275ba 100644
--- a/docs/config/geodata.md
+++ b/docs/config/geodata.md
@@ -40,6 +40,10 @@
 
 如果下载后的重载失败，本次下载替换的文件会整体回滚。
 
+::: tip
+如果未配置 `assets`，定时任务只会重载现有文件，不会执行下载。你也可以先通过其他方式更新这些文件，再交给 Xray 定时重载；但一般不建议这样做。让 Xray 自行下载可以配合回滚机制，以避免因坏文件导致下次启动失败。
+:::
+
 ### AssetObject
 
 ```json
diff --git a/docs/en/config/geodata.md b/docs/en/config/geodata.md
index f37e5466..453a34d3 100644
--- a/docs/en/config/geodata.md
+++ b/docs/en/config/geodata.md
@@ -40,6 +40,10 @@ The list of geodata files to download and replace.
 
 If reloading fails after the download, all files replaced by this update are rolled back together.
 
+::: tip
+If `assets` is not configured, the scheduled task only reloads the existing files and performs no downloads. You can still update these files by other means and let Xray reload them on schedule, but this is generally not recommended. Letting Xray download them itself works with the rollback mechanism to avoid startup failures caused by broken files.
+:::
+
 ### AssetObject
 
 ```json
diff --git a/docs/ru/config/geodata.md b/docs/ru/config/geodata.md
index 8b2fc48e..d17602f0 100644
--- a/docs/ru/config/geodata.md
+++ b/docs/ru/config/geodata.md
@@ -40,6 +40,10 @@
 
 Если после загрузки перезагрузка завершится ошибкой, все файлы, замененные в рамках этого обновления, будут откатаны вместе.
 
+::: tip
+Если `assets` не настроен, задача по расписанию только перезагружает существующие файлы и ничего не скачивает. Эти файлы можно обновить и другими способами, а затем позволить Xray перезагрузить их по расписанию, но обычно это не рекомендуется. Если Xray скачивает их сам, это работает вместе с механизмом отката, чтобы избежать сбоев при следующем запуске из-за поврежденных файлов.
+:::
+
 ### AssetObject
 
 ```json