src/sys/tests/README.md

@@ -11,6 +11,25 @@
     - 可用根目录命令构建：`./build/build_images.sh [--intranet]`
   - 主机具备 Docker 与 Docker Compose。
 
+  - UID/GID 配置（用于容器内文件属主与挂载卷写入权限）
+    - 默认值：`UID=2133`、`GID=2015`。
+    - 方式 A（推荐）：在仓库根目录创建 `configs/build_user.local.conf`：
+      
+      UID=<你的宿主用户UID>
+      GID=<你的宿主用户GID>
+      
+      例如：
+      
+      UID=1000
+      GID=1000
+      
+    - 方式 B：通过环境变量覆盖（优先级最高）：
+      
+      export ARGUS_BUILD_UID=1000
+      export ARGUS_BUILD_GID=1000
+      
+    - 说明：`scripts/common/build_user.sh` 会按顺序读取 `configs/build_user.local.conf` → `configs/build_user.conf` → 环境变量，最终值会用于镜像构建参数与测试脚本，并在 `01_bootstrap.sh` 中对 `src/sys/tests/private/argus/*` 进行 `chown` 以匹配容器内运行用户。
+
 - 一键执行
   - `cd src/sys/tests`
   - `./scripts/00_e2e_test.sh`