's'

scripts/env_check.py

@@ -0,0 +1,91 @@
+# -*- coding: utf-8 -*-
+"""启动前环境分析：Python 依赖、ffmpeg、Node/npm、端口提示（Windows / Linux 通用）。"""
+from __future__ import annotations
+
+import importlib.util
+import shutil
+import socket
+import sys
+
+
+def _has_module(name: str) -> bool:
+    return importlib.util.find_spec(name) is not None
+
+
+def _local_ips() -> list[str]:
+    out: list[str] = []
+    try:
+        hostname = socket.gethostname()
+        for info in socket.getaddrinfo(hostname, None, family=socket.AF_INET):
+            ip = info[4][0]
+            if ip and ip != "127.0.0.1" and ip not in out:
+                out.append(ip)
+    except OSError:
+        pass
+    return out[:4]
+
+
+def print_env_report(
+    *,
+    dev: bool,
+    need_npm: bool,
+    host: str,
+    port: str,
+    next_port: str = "3000",
+) -> None:
+    print()
+    print("┌── 环境检测 ─────────────────────────────────────────")
+    print(f"│ 系统: {sys.platform}  Python: {sys.version.split()[0]}")
+    ok = True
+    for mod, label in (
+        ("fastapi", "FastAPI"),
+        ("uvicorn", "Uvicorn"),
+    ):
+        if _has_module(mod):
+            print(f"│ ✓ {label} 已安装")
+        else:
+            print(f"│ ✕ 缺少 {label}，请执行: pip install -r requirements.txt")
+            ok = False
+
+    ff = shutil.which("ffmpeg")
+    fp = shutil.which("ffplay")
+    if ff:
+        print(f"│ ✓ ffmpeg: {ff}")
+    else:
+        print("│ ⚠ 未找到 ffmpeg（推流/录制/OBS 拉流会失败；Docker 镜像已内置）")
+        ok = False
+    if fp:
+        print(f"│ ✓ ffplay: {fp}")
+    elif sys.platform != "win32":
+        print("│ ⚠ 未找到 ffplay（HDMI 全屏播放需要完整 ffmpeg 套件）")
+
+    if need_npm:
+        npm = shutil.which("npm") or shutil.which("npm.cmd")
+        if npm:
+            print(f"│ ✓ npm: {npm}")
+        else:
+            print("│ ✕ 未找到 npm（构建/开发前端需要安装 Node.js）")
+            ok = False
+
+    print("│")
+    print("│ 同机端口提示（若冲突请在 config/runtime.env 修改 PORT）：")
+    print("│   本控制台 API/Web 使用环境变量 PORT（默认见 launch.py）")
+    print("│   SRS 常见: 1935/1985/8080/10080 等；代理常见: 7890/9090；Chrome 远程: 9222")
+    print("│")
+    print(f"│ 监听: {host}:{port}")
+    if dev:
+        ips = _local_ips()
+        print(f"│ 开发 UI: 0.0.0.0:{next_port}（局域网可用本机 IP 访问）")
+        if ips:
+            print(f"│ 示例: http://{ips[0]}:{next_port}/")
+    else:
+        if host == "0.0.0.0":
+            ips = _local_ips()
+            if ips:
+                print(f"│ 局域网访问示例: http://{ips[0]}:{port}/")
+            else:
+                print("│ 局域网访问: http://<本机IP>:%s/" % port)
+    print("└────────────────────────────────────────────────────")
+    print()
+    if not ok and not dev:
+        print("[env] 存在警告，仍可尝试启动；若运行失败请按上述提示补全依赖。\n")