docs: Ubuntu desktop --expect Directory listing, /vnc.html

docs/PUSH_DEBUG.md

@@ -21,7 +21,15 @@ HF 开始构建/部署
 
 ---
 
-## 2. 常用命令（按顺序用）
+## 2. 轮询方式（正确做法）
+
+用 **HF API** 看远端状态和日志，不要只轮询应用 URL：
+
+- **Runtime 状态**：`get_space_runtime`（脚本里 `--wait-running` / `--until-ok` 会轮询）。
+- **构建日志**：`GET .../spaces/<SPACE_ID>/logs/build`（需 `Authorization: Bearer $HF_TOKEN`）。
+- **运行日志**：`GET .../spaces/<SPACE_ID>/logs/run`（同上）。
+
+一轮流程：push → 用 API 等 RUNNING（或看 build 失败）→ 跑测试 → 失败则看 run/build 日志尾修代码 → 再 push，循环直到测试全过。
 
 ### 2.1 推送（触发部署）
 
@@ -33,19 +41,45 @@ git push origin main
 
 （若 Space 在别的分支，把 `main` 换成该分支。）
 
-### 2.2 实时看远端日志（debug 用）
+### 2.2 持续看远端状态（不退出）
+
+用 curl + Bearer token 周期性拉 run 日志并查应用 URL，适合观察部署过程：
+
+```bash
+# 从 .env 读 HF_TOKEN 时直接运行（脚本会自动加载 .env）
+python3 scripts/monitor_and_test.py --watch
+
+# 每 30 秒轮询一次
+python3 scripts/monitor_and_test.py --watch --watch-interval 30
+```
+
+会循环打印：当前 stage、GET APP_URL 结果、run 日志尾部。Ctrl+C 结束。
+
+### 2.3 用 API 看远端日志（debug 用）
+
+```bash
+# 流式拉取构建日志（推送后看）
+HF_TOKEN=你的token python3 scripts/monitor_and_test.py --logs build
+
+# 流式拉取运行日志（看容器输出）
+HF_TOKEN=你的token python3 scripts/monitor_and_test.py --logs run
+```
+
+等价 curl（便于脚本里用）：
 
 ```bash
-# 构建日志（推送后立刻看）
-HF_TOKEN=你的token python3 scripts/monitor_and_test.py --space-id 你的用户名/你的Space名 --logs build
+# Get container logs (SSE)
+curl -N -H "Authorization: Bearer $HF_TOKEN" \
+  "https://huggingface.co/api/spaces/tao-shen/HuggingRun/logs/run"
 
-# 运行日志（构建完成后看容器是否正常）
-HF_TOKEN=你的token python3 scripts/monitor_and_test.py --space-id 你的用户名/你的Space名 --logs run
+# Get build logs (SSE)
+curl -N -H "Authorization: Bearer $HF_TOKEN" \
+  "https://huggingface.co/api/spaces/tao-shen/HuggingRun/logs/build"
 ```
 
-`--space-id` 默认是 `tao-shen/HuggingRun`，可省略。
+`--until-ok` 在 build/run 或测试失败时会自动拉取并打印日志尾部，无需单独跑上面命令。
 
-### 2.3 等 RUNNING / 等 URL 就绪后跑完整测试（一键「远端是否成功」）
+### 2.4 等 RUNNING / 等 URL 就绪后跑完整测试（一键「远端是否成功」）
 
 **方式 A：有 HF_TOKEN 时**（推荐，可看 API 状态）
 
@@ -53,10 +87,10 @@ HF_TOKEN=你的token python3 scripts/monitor_and_test.py --space-id 你的用户
 # Demo 或默认 Space
 HF_TOKEN=你的token python3 scripts/monitor_and_test.py --wait-running --test
 
-# Ubuntu 桌面等：指定 URL 和期望页面关键词
+# Ubuntu 桌面等：根路径返回 noVNC 目录列表，用 Directory listing；桌面在 /vnc.html
 HF_TOKEN=你的token python3 scripts/monitor_and_test.py --wait-running --test \
   --url https://你的用户名-你的Space名.hf.space \
-  --expect noVNC
+  --expect "Directory listing"
 ```
 
 **方式 B：无 HF_TOKEN 时**（只轮询 URL 直到页面出现期望内容）
@@ -64,17 +98,17 @@ HF_TOKEN=你的token python3 scripts/monitor_and_test.py --wait-running --test \
 ```bash
 python3 scripts/monitor_and_test.py --wait-url --test \
   --url https://你的用户名-你的Space名.hf.space \
-  --expect noVNC --max-wait 900
+  --expect "Directory listing" --max-wait 900
 ```
 
-脚本会先轮询直到 GET 200 且 body 含 `noVNC`（或你给的 `--expect`），再跑：基础 GET、压力请求、多轮持久化检查。**全部通过才 exit 0**，任一失败则 exit 1。
+脚本会先轮询直到 GET 200 且 body 含你给的 `--expect`（Ubuntu 桌面根路径返回目录列表，用 `--expect "Directory listing"`；桌面客户端在 `/vnc.html`），再跑：基础 GET、压力请求、多轮持久化检查。**全部通过才 exit 0**，任一失败则 exit 1。
 
-### 2.4 不等待、直接测当前页面（Space 已 RUNNING 时）
+### 2.5 不等待、直接测当前页面（Space 已 RUNNING 时）
 
 ```bash
 python3 scripts/monitor_and_test.py --test
 # 或
-python3 scripts/monitor_and_test.py --url https://xxx.hf.space --test --expect noVNC
+python3 scripts/monitor_and_test.py --url https://xxx.hf.space --test --expect "Directory listing"
 ```
 
 ---
@@ -88,7 +122,7 @@ python3 scripts/monitor_and_test.py --url https://xxx.hf.space --test --expect n
 
 2. **构建完成后**：另一个终端等 RUNNING 并跑测试。
    ```bash
-   HF_TOKEN=xxx python3 scripts/monitor_and_test.py --wait-running --test --url https://tao-shen-huggingrun.hf.space --expect noVNC
+   HF_TOKEN=xxx python3 scripts/monitor_and_test.py --until-ok --url https://tao-shen-huggingrun.hf.space --expect "Directory listing"
    ```
 
 3. 若 **测试失败或一直 503**：用 `--logs run`（以及 `--logs build`）看容器内报错，修代码后：