refactor: replace latest tag with stable release tag

Update documentation and config to enforce stable release usage instead of luminous 'latest' tags, clarifying terminology and reducing instability risks.

Author: dsx137

docs/guides/gettingStarted/cluster.md

@@ -40,17 +40,17 @@ A 和 B 两台机器以及组件集群内网互通，且A、B两台机器都有
 
 ### 1. 克隆仓库
 
-在两台机器（A 和 B）上分别执行以下命令以克隆 OpenIMServer 仓库：
+在两台机器（A 和 B）上分别执行以下命令以克隆 OpenIMServer 仓库，并切到 GitHub Releases 页面绿色 **Latest** 对应的**最新正式发布 tag**：
 
 ```bash
 git clone https://github.com/openimsdk/open-im-server
 cd open-im-server
 git fetch --tags
-LATEST_TAG=$(git tag --sort=-v:refname | head -n 1)
-git checkout "$LATEST_TAG"
+LATEST_STABLE_TAG=$(basename "$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/openimsdk/open-im-server/releases/latest)")
+git checkout "$LATEST_STABLE_TAG"
 ```
 
-> 建议两台机器使用同一个 tag（默认 latest tag）。如需固定版本（例如 `v3.8.3-patch.12`），请在两台机器都执行 `git checkout v3.8.3-patch.12`。
+> 这里的 latest 指 GitHub Releases 页面绿色 Latest 的**正式发布版**，不包含 alpha/beta/rc 等预发布版本。建议两台机器使用同一个正式版 tag；如需固定版本（例如 `v3.8.3-patch.12`），请在两台机器都执行 `git checkout v3.8.3-patch.12`。
 
 ### 2. 配置修改
 

docs/guides/gettingStarted/dockerCompose.md

@@ -9,17 +9,17 @@ sidebar_position: 2
 ## 2. 部署 OpenIMServer
 ### 2.1 仓库克隆 🗂️
 
-建议使用 **latest tag**，避免直接跟随未发布变更。
+建议使用 GitHub Releases 页面绿色 **Latest** 对应的**最新正式发布 tag**，不要直接按 tag 名字排序，也不要使用 alpha/rc 等预发布版本。
 
 ```bash
 git clone https://github.com/openimsdk/openim-docker && cd openim-docker
 git fetch --tags
-LATEST_TAG=$(git tag --sort=-v:refname | head -n 1)
-git checkout "$LATEST_TAG"
-echo "using openim-docker tag: $LATEST_TAG"
+LATEST_STABLE_TAG=$(basename "$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/openimsdk/openim-docker/releases/latest)")
+git checkout "$LATEST_STABLE_TAG"
+echo "using openim-docker stable release tag: $LATEST_STABLE_TAG"
 ```
 
-> 如需复现指定版本（例如 `v3.8.3-patch.12`），将 `git checkout "$LATEST_TAG"` 替换为 `git checkout v3.8.3-patch.12`。
+> 这里的 latest 指 GitHub Releases 页面绿色 Latest 的**正式发布版**，不包含 alpha/beta/rc 等预发布版本。
 
 ### 2.2 配置修改 🔧
 

docs/guides/gettingStarted/faq.md

@@ -5,7 +5,7 @@ sidebar_position: 10
 
 ## 一、如何升级
 
-在同一大版本内，不同小版本之间的数据通常兼容。建议优先升级到目标仓库的 **latest tag**；如需固定版本（例如 `v3.8.3-patch.12`），请显式 checkout 对应 tag。
+在同一大版本内，不同小版本之间的数据通常兼容。建议优先升级到目标仓库 GitHub Releases 页面绿色 **Latest** 对应的**最新正式发布 tag**；如需固定版本（例如 `v3.8.3-patch.12`），请显式 checkout 对应 tag。
 
 ### Docker 部署
 
@@ -14,12 +14,12 @@ sidebar_position: 10
     cd openim-docker
     ```
 
-2. **拉取最新 tag 并切换：**
+2. **拉取最新正式版 release tag 并切换：**
     ```bash
     git fetch --tags
-    TARGET_TAG=$(git tag --sort=-v:refname | head -n 1)
+    TARGET_TAG=$(basename "$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/openimsdk/openim-docker/releases/latest)")
     git checkout "$TARGET_TAG"
-    echo "upgrade openim-docker to tag: $TARGET_TAG"
+    echo "upgrade openim-docker to stable release tag: $TARGET_TAG"
     ```
 
 3. **检查 `.env` 中镜像 tag 与当前仓库版本一致（必要时按发布说明手动调整）。**
@@ -48,10 +48,10 @@ sidebar_position: 10
     mage stop
     ```
 
-3. **切换到最新 tag（或指定 tag）并更新代码：**
+3. **切换到最新正式版 release tag（或指定 tag）并更新代码：**
     ```bash
     git fetch --tags
-    TARGET_TAG=$(git tag --sort=-v:refname | head -n 1)
+    TARGET_TAG=$(basename "$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/openimsdk/open-im-server/releases/latest)")
     git checkout "$TARGET_TAG"
     ```
 
@@ -63,6 +63,8 @@ sidebar_position: 10
 
 5. **如果部署了 ChatServer，也建议同步升级到对应 tag 后再重启 Chat 服务。**
 
+> 说明：这里的 latest 指 GitHub Releases 页面绿色 Latest 的**正式发布版**，不包含 alpha/beta/rc 等预发布版本。
+
 
 ---
 ## 二、 如何迁移数据

docs/guides/gettingStarted/imSourceCodeDeployment.md

@@ -13,17 +13,17 @@ OpenIMServer 与外部组件部署在同一台机器上，部分组件可按需
 
 ## 二、获取 OpenIMServer 并部署依赖组件
 
-建议通过仓库拉取并切到 **latest tag**（而不是直接跟随分支）。
+建议通过仓库拉取并切到 GitHub Releases 页面绿色 **Latest** 对应的**最新正式发布 tag**。
 
 ```bash
 git clone https://github.com/openimsdk/open-im-server && cd open-im-server
 git fetch --tags
-LATEST_TAG=$(git tag --sort=-v:refname | head -n 1)
-git checkout "$LATEST_TAG"
-echo "using open-im-server tag: $LATEST_TAG"
+LATEST_STABLE_TAG=$(basename "$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/openimsdk/open-im-server/releases/latest)")
+git checkout "$LATEST_STABLE_TAG"
+echo "using open-im-server stable release tag: $LATEST_STABLE_TAG"
 ```
 
-> 如需复现指定版本（例如 `v3.8.3-patch.12`），将 `git checkout "$LATEST_TAG"` 替换为 `git checkout v3.8.3-patch.12`。
+> 这里的 latest 指 GitHub Releases 页面绿色 Latest 的**正式发布版**，不包含 alpha/beta/rc 等预发布版本。当前该仓库会把 `v3.8.3-patch.12` 识别为最新正式版，而不会误选 `v3.8.4-alpha.1` 这类预发布版本。
 
 > 注意：后续所有命令都在 OpenIMServer 项目根目录执行。
 
@@ -107,17 +107,17 @@ mage
 
 > 如果已有自有账号系统，可不部署 ChatServer。
 
-同样建议拉取后切到 **latest tag**：
+同样建议拉取后切到 GitHub Releases 页面绿色 **Latest** 对应的**最新正式发布 tag**：
 
 ```bash
 git clone https://github.com/openimsdk/chat && cd chat
 git fetch --tags
-LATEST_TAG=$(git tag --sort=-v:refname | head -n 1)
-git checkout "$LATEST_TAG"
-echo "using chat tag: $LATEST_TAG"
+LATEST_STABLE_TAG=$(basename "$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/openimsdk/chat/releases/latest)")
+git checkout "$LATEST_STABLE_TAG"
+echo "using chat stable release tag: $LATEST_STABLE_TAG"
 ```
 
-> 如需复现指定版本（例如 `v3.8.3-patch.12` 对应联调版本），按实际发布说明改为固定 tag。
+> 如需复现指定版本，按实际发布说明改为固定 tag；若服务端联调需要固定到 `v3.8.3-patch.12` 对应版本，也请同时固定 ChatServer 的对应正式版 tag。
 
 ## 五、部署 ChatServer
 

docs/guides/gettingStarted/internalDeployment.md

@@ -8,20 +8,21 @@ sidebar_position: 4
 
 ## 版本策略（重要）
 
-- 默认建议：在联网机器上拉取仓库后，切换到 **latest tag** 再做离线打包。
-- 如需固定版本（例如 `v3.8.3-patch.12`）：将 `git checkout "$LATEST_TAG"` 替换为 `git checkout v3.8.3-patch.12`。
+- 默认建议：在联网机器上拉取仓库后，切换到 GitHub Releases 页面绿色 **Latest** 对应的**最新正式发布 tag** 再做离线打包。
+- 这里的 latest 指**正式发布版**，不包含 alpha/beta/rc 等预发布版本。
+- 如需固定版本（例如 `v3.8.3-patch.12`）：直接执行 `git checkout v3.8.3-patch.12`。
 - 强烈建议：OpenIMServer、ChatServer、openim-docker 使用同一批次发布版本，避免跨版本组合。
 
 ### **Docker部署**
 
-1. 使用一台连接到互联网的机器，克隆仓库并切换到 latest tag：
+1. 使用一台连接到互联网的机器，克隆仓库并切换到最新正式发布 tag：
 
    ```sh
    git clone https://github.com/openimsdk/openim-docker && cd openim-docker
    git fetch --tags
-   LATEST_TAG=$(git tag --sort=-v:refname | head -n 1)
-   git checkout "$LATEST_TAG"
-   echo "using openim-docker tag: $LATEST_TAG"
+   LATEST_STABLE_TAG=$(basename "$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/openimsdk/openim-docker/releases/latest)")
+   git checkout "$LATEST_STABLE_TAG"
+   echo "using openim-docker stable release tag: $LATEST_STABLE_TAG"
    ```
 
 2. 运行 `docker compose up -d` 拉取镜像并生成本地镜像清单。
@@ -61,24 +62,24 @@ sidebar_position: 4
 
 ### **源码部署**
 
-1. 使用一台连接到互联网的机器，克隆 OpenIMServer 并切换到 latest tag：
+1. 使用一台连接到互联网的机器，克隆 OpenIMServer 并切换到最新正式发布 tag：
 
    ```sh
    git clone https://github.com/openimsdk/open-im-server && cd open-im-server
    git fetch --tags
-   LATEST_TAG=$(git tag --sort=-v:refname | head -n 1)
-   git checkout "$LATEST_TAG"
-   echo "using open-im-server tag: $LATEST_TAG"
+   LATEST_STABLE_TAG=$(basename "$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/openimsdk/open-im-server/releases/latest)")
+   git checkout "$LATEST_STABLE_TAG"
+   echo "using open-im-server stable release tag: $LATEST_STABLE_TAG"
    ```
 
-2. 克隆 ChatServer 并切换到 latest tag：
+2. 克隆 ChatServer 并切换到最新正式发布 tag：
 
    ```bash
    git clone https://github.com/openimsdk/chat && cd chat
    git fetch --tags
-   LATEST_TAG=$(git tag --sort=-v:refname | head -n 1)
-   git checkout "$LATEST_TAG"
-   echo "using chat tag: $LATEST_TAG"
+   LATEST_STABLE_TAG=$(basename "$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/openimsdk/chat/releases/latest)")
+   git checkout "$LATEST_STABLE_TAG"
+   echo "using chat stable release tag: $LATEST_STABLE_TAG"
    ```
 
 3. 参考 [docker部署](#docker部署) 步骤保存依赖组件镜像（源码部署场景不需要服务端业务镜像）。