viewer: 只读语义文案对齐、清理死状态、DB 路径多候选+启动校验

app.py

@@ -33,9 +33,22 @@ PACKAGE = Path(os.environ.get("SETVL_PACKAGE", HERE / "package"))
 DATASET = os.environ.get("SETVL_DATASET", "").strip()
 HF_TOKEN = (os.environ.get("HF_TOKEN")
             or os.environ.get("HUGGING_FACE_HUB_TOKEN") or "").strip()
-DB = (Path(os.environ["SETVL_DB"]) if os.environ.get("SETVL_DB")
-      else (HERE / "graph.sqlite" if (HERE / "graph.sqlite").exists()
-            else PACKAGE / "graph.sqlite"))
+def _resolve_db() -> Path:
+    """按优先级找库：显式环境变量 > 同目录（容器里就在 /app）> space/ > package/。"""
+    if os.environ.get("SETVL_DB"):
+        return Path(os.environ["SETVL_DB"])
+    for cand in (HERE / "graph.sqlite", HERE / "space" / "graph.sqlite",
+                 PACKAGE / "graph.sqlite"):
+        if cand.exists():
+            return cand
+    return PACKAGE / "graph.sqlite"          # 供报错信息指向默认位置
+
+
+DB = _resolve_db()
+if not DB.exists():                          # 启动即失败，不要拖到浏览到一半才炸
+    raise RuntimeError(
+        f"找不到数据库。已尝试 {HERE/'graph.sqlite'}、{HERE/'space'/'graph.sqlite'}、"
+        f"{PACKAGE/'graph.sqlite'}；可用 SETVL_DB 指定。")
 
 _TLS = threading.local()