commit 0daef81497fc0632deb112f8d76945c729efc238
Author: 西街长安 <nanxun@nxsir.cn>
Date:   Fri Jan 30 21:34:01 2026 +0800

    添加 测试环境自动化构建使用手册

diff --git a/%E6%B5%8B%E8%AF%95%E7%8E%AF%E5%A2%83%E8%87%AA%E5%8A%A8%E5%8C%96%E6%9E%84%E5%BB%BA%E4%BD%BF%E7%94%A8%E6%89%8B%E5%86%8C.md b/%E6%B5%8B%E8%AF%95%E7%8E%AF%E5%A2%83%E8%87%AA%E5%8A%A8%E5%8C%96%E6%9E%84%E5%BB%BA%E4%BD%BF%E7%94%A8%E6%89%8B%E5%86%8C.md
new file mode 100644
index 0000000..abe8925
--- /dev/null
+++ b/%E6%B5%8B%E8%AF%95%E7%8E%AF%E5%A2%83%E8%87%AA%E5%8A%A8%E5%8C%96%E6%9E%84%E5%BB%BA%E4%BD%BF%E7%94%A8%E6%89%8B%E5%86%8C.md
@@ -0,0 +1,56 @@
+# 🧪 测试环境自动化构建使用手册
+
+本手册用于指导测试人员如何通过 Jenkins 快速部署指定分支的代码，并访问对应的测试地址。
+
+---
+
+### 1. 环境准备
+
+| 平台名称               | 地址                                                         |
+| ---------------------- | ------------------------------------------------------------ |
+| Jenkins IM前端构建任务 | [Jenkins](http://192.168.5.100:8100/job/IM前端/build?delay=0sec) |
+| Jenkins IM后端构建任务 | [IM后端 - Jenkins](http://192.168.5.100:8100/job/IM后端/)    |
+| 前端分支列表           | https://im.test.nxsir.cn                                     |
+
+在开始构建前，请确认：
+
+* 已拥有 **Jenkins 登录权限**。
+* **前置环境wireguard**已启动。
+* 已获取需要测试的 **Git 分支名称**（例如：`feature/order-page`）。
+
+---
+
+### 2. 构建操作步骤流程
+
+1.  **登录 Jenkins**：访问 [此处输入你的Jenkins地址] 并登录。
+2.  **进入任务**：在项目列表中点击进入对应的测试项目。
+3.  **参数化构建**：
+    * 点击左侧菜单栏的 **Build with Parameters**（带参数构建）。
+    * 在 **`BRANCH_NAME`** 输入框中，填入或选择你的 Git 分支名。
+4.  **开始构建**：点击下方的 **Build** 按钮。
+
+> ⚠️ **提示**：建议直接从代码仓库复制分支名，避免手动输入导致拼写错误。
+
+---
+
+### 3. 查看构建状态与结果
+
+* **观察状态**：在左下角 **Build History** 看到圆形图标变为 **蓝色/绿色**，表示构建成功。
+* **访问网页**：
+  * 构建成功后，点击该次构建编号（如 `#10`）。
+  * 在详情页中点击 **[访问测试环境]** 链接（通常位于页面显著位置）。
+  * 或者直接访问：`https://im.test.nxsir.cn/[分支名]`
+
+---
+
+### 4. 常见问题排查
+
+| 现象                        | 可能原因               | 解决方法                                                     |
+| :-------------------------- | :--------------------- | :----------------------------------------------------------- |
+| **构建显示红色（Failure）** | 分支名不存在或代码冲突 | 检查分支名是否已推送到远端仓库。                             |
+| **点击链接显示 404**        | 部署尚未完全完成       | 构建完成后通常有几秒延迟，请稍后刷新。                       |
+| **页面依然显示旧内容**      | 浏览器缓存             | 请使用 `Ctrl + F5` (Windows) 或 `Cmd + Shift + R` (Mac) 强制刷新。 |
+
+---
+
+**💡 运维备注**：如遇 Jenkins 无法登录或构建按钮置灰，请联系管理员。
\ No newline at end of file