docs: clarify Space app_file vs dashboard; fix README structure bullets

DEPLOY_HF_SPACE.md

@@ -133,10 +133,12 @@ If the UI shows **no examples** or **`No PNG examples`**, usually:
 
 | File | Role |
 |------|------|
-| `README.md` | Must start with YAML frontmatter (`sdk: gradio`, `app_file: app.py`, `sdk_version`, …). |
+| `README.md` | Must start with YAML frontmatter (`sdk: gradio`, `app_file: …`, `sdk_version`, …). The **`app_file`** value is what Spaces should launch after each build. |
 | `app.py` | Full NeAR entry point; uses `PORT` / `GRADIO_SERVER_*` env vars. |
 | `app_hyshape.py` | Optional HyShape-only diagnostic entry (see repo README). |
-| `app_gsplat.py` | Optional gsplat-only raster probe (same RGB+ED layout as `app.py` warmup). |
+| `app_gsplat.py` | Optional gsplat image-fitting Gradio demo (`@spaces.GPU`). |
+
+If the running Space does not match `README.md` **`app_file`**, check **Space → Settings → App file** (dashboard can disagree until you align it) and **Restart** the Space. Use the **spaces** URL (`/spaces/<user>/<name>`), not the model repo URL.
 | `requirements.txt` | `pip` dependencies. |
 | `packages.txt` | Optional `apt` packages (OpenGL, etc.). |
 

README.md

@@ -48,7 +48,8 @@ This repository combines:
 
 ## ZeroGPU Runtime Notes
 
-- The Space **`app_file`** in the YAML header above is **`app.py`** (full NeAR app). Switch to **`app_gsplat.py`** or **`app_hyshape.py`** for isolated diagnostics.
+- The Space entry script is **`app_file`** in the YAML header at the very top of this README (currently **`app_gsplat.py`**). Use **`app.py`** for the full NeAR app or **`app_hyshape.py`** for HyShape-only diagnostics.
+- **Space still runs the old entry?** (1) Open the **Space** URL: [huggingface.co/spaces/luh0502/NeAR](https://huggingface.co/spaces/luh0502/NeAR) (not `huggingface.co/luh0502/NeAR`, which is the model repo). (2) In **Space Settings → App file**, ensure it matches the README (the dashboard can override or lag). (3) **Restart** the Space (or trigger a new build) after pushing.
 - **`app_hyshape.py`** (when used as entry): defaults to **`NEAR_HYSHAPE_GEOMETRY_CPU_PRELOAD_AT_START=1`** — background **CPU** Hunyuan load at start; **Generate Mesh** pays **GPU move + inference** in `@spaces.GPU`.
 - The full `app.py` Space keeps **page-load image defaults** and **HDRI preview** on lightweight CPU paths so the first page visit does not spend the first ZeroGPU allocation on model initialization.
 - **`app.py`**: optional background **CPU** preload of Hunyuan + NeAR (`NEAR_MODEL_CPU_PRELOAD_AT_START`); **`@spaces.GPU`** callbacks move each pipeline to CUDA once, then run inference. **gsplat** is used when the pipeline renders (no separate app-level warmup pass).
@@ -102,8 +103,8 @@ Compared with a standard image-to-3D pipeline, NeAR focuses on:
 Key files and directories:
 
 - `example.py` — minimal end-to-end inference example.
-- `app.py` — full NeAR Gradio app; default **`app_file`** for the Hugging Face Space (see README YAML header).
-- `app_gsplat.py` — **gsplat-only** ZeroGPU probe; set `app_file: app_gsplat.py` to test rasterization in isolation.
+- `app.py` — full NeAR Gradio app; set **`app_file: app.py`** in the README YAML header to run it on the Space.
+- `app_gsplat.py` — gsplat **image-fitting** Gradio demo (ZeroGPU); README YAML **`app_file`** is set to this when you want this entry (see top of file).
 - `app_hyshape.py` — HyShape-only diagnostic; set `app_file: app_hyshape.py` for Hunyuan geometry in isolation.
 - `setup.sh` — environment setup helper.
 - `checkpoints/` — local pipeline configuration and model checkpoints.