fix & feat: bug fixes, Python 3.8+ compat, UI improvements, v0.1.4

Bug Fixes:
- fix(ros2): replace heredoc with printf|tee in ROS2 Humble install step 4
  to avoid bash parsing failure when command stored in JSON string
- fix(runner): remove exec_command timeout param to prevent SSH channel
  read timeout during long-running commands (e.g. mirror speed test)
- fix(net_share): fix sudo password injection via SEEED_SUDO_PASSWORD env
  var + _S() helper; fix missing sudo on ip/nmcli/resolvectl commands
- fix(net_share): fix configure_jetson_dns_via_serial to use ip route
  instead of nmcli (JetPack 4 has no NetworkManager)
- fix(jetson_init): add 3-level fallback for network config:
  NetworkManager -> systemd-networkd -> ip command
- fix(jetson_init): fix shell quoting bugs in static IP config command
- fix(run_v2): fix _x_server_full() false positive that replaced DISPLAY
  with Xvfb, breaking FileZilla/IDE launch
- fix(run_v2): clear LD_PRELOAD after execve restart to avoid polluting
  child processes; only apply libstdc++ workaround in conda environments

Features & Improvements:
- feat(ros2): auto-select fastest mirror (fishros vs official) via parallel
  latency test; split install into 4 clear steps with progress echo
- feat(ros2): add DEBIAN_FRONTEND=noninteractive to prevent apt blocking
- feat(net_share): improve gateway script with step-by-step echo output
  and graceful fallback (no set -e)
- feat(ui): improve all QLineEdit input fields across all modules with
  visible border (rgba 0.18), dark background, hover/focus highlight;
  add input_qss() helper to theme.py for consistent styling
- feat(compat): add from __future__ import annotations to 15 files for
  Python 3.8+ compatibility; update pyproject.toml requires-python to >=3.8
- chore: bump version to 0.1.4; update README Python badge to 3.8+

Author: jjjadand

MANIFEST.in

@@ -4,8 +4,10 @@ include requirements.txt
 include pyproject.toml
 recursive-include seeed_jetson_develop/data *.json
 recursive-include seeed_jetson_develop/locales *.json
+recursive-include seeed_jetson_develop/assets/devices *
 recursive-include seeed_jetson_develop/assets/recovery *
 recursive-include seeed_jetson_develop/modules *.json
+recursive-include seeed_jetson_develop/skills *
 prune seeed_jetson_develop/tmp-refer
 global-exclude __pycache__
 global-exclude *.pyc

README.md

@@ -3,12 +3,12 @@
 An all-in-one AI development workbench for Seeed Studio Jetson products — covering everything from firmware flashing to app deployment.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/)
+[![Python](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/)
 [![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20Windows-lightgrey.svg)]()
 
-[中文文档](README_zh.md)
+[中文文档](https://github.com/Seeed-Projects/Seeed-Jetson-DevelopTool/blob/main/README_zh.md)
 
-![UI Preview](assets/Reference-UI.png)
+![UI Preview](https://raw.githubusercontent.com/Seeed-Projects/Seeed-Jetson-DevelopTool/main/assets/Reference-UI.png)
 
 ---
 
@@ -30,20 +30,32 @@ An all-in-one AI development workbench for Seeed Studio Jetson products — cove
 ## Requirements
 
 - **Host OS**: Ubuntu 20.04 / 22.04 / 24.04 (Linux recommended for flashing)
-- **Python**: 3.10+
+- **Python**: 3.8+
 - **Dependencies**: PyQt5, paramiko, requests
 
 ---
 
 ## Installation
 
+```bash
+pip install seeed-jetson-developer
+```
+
+Launch the GUI:
+
+```bash
+seeed-jetson-developer
+```
+
+Install from source:
+
 ```bash
 git clone https://github.com/Seeed-Projects/Seeed-Jetson-DevelopTool.git
 cd Seeed-Jetson-DevelopTool
-pip install -r requirements.txt
+pip install .
 ```
 
-Launch the GUI:
+Or run directly from the repository:
 
 ```bash
 python3 run_v2.py
@@ -138,23 +150,17 @@ Community skills in [OpenClaw](https://github.com/Seeed-Studio/openclaw) format
 ## CLI
 
 ```bash
-# List supported products
-python3 -m seeed_jetson_develop.cli list-products
-
-# Show Recovery guide for a device
-python3 -m seeed_jetson_develop.cli recovery -p j4012mini
-
-# Flash firmware
-python3 -m seeed_jetson_develop.cli flash -p j4012mini -l 36.3.0
+# Launch the packaged GUI entry point
+python3 -m seeed_jetson_develop.cli
 ```
 
 ---
 
 ## Documentation
 
-- [docs/QUICKSTART.md](docs/QUICKSTART.md) — Quick start guide
-- [docs/USAGE.md](docs/USAGE.md) — CLI reference
-- [docs/GUI_GUIDE.md](docs/GUI_GUIDE.md) — GUI user guide
+- [Quick Start](https://github.com/Seeed-Projects/Seeed-Jetson-DevelopTool/blob/main/docs/QUICKSTART.md) — Quick start guide
+- [Usage](https://github.com/Seeed-Projects/Seeed-Jetson-DevelopTool/blob/main/docs/USAGE.md) — CLI reference
+- [GUI Guide](https://github.com/Seeed-Projects/Seeed-Jetson-DevelopTool/blob/main/docs/GUI_GUIDE.md) — GUI user guide
 
 ---
 

README_zh.md

@@ -6,9 +6,9 @@
 [![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/)
 [![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20Windows-lightgrey.svg)]()
 
-[English](README.md)
+[English](https://github.com/Seeed-Projects/Seeed-Jetson-DevelopTool/blob/main/README.md)
 
-![UI 预览](assets/Reference-UI.png)
+![UI 预览](https://raw.githubusercontent.com/Seeed-Projects/Seeed-Jetson-DevelopTool/main/assets/Reference-UI.png)
 
 ---
 
@@ -37,13 +37,25 @@
 
 ## 安装
 
+```bash
+pip install seeed-jetson-developer
+```
+
+启动 GUI：
+
+```bash
+seeed-jetson-developer
+```
+
+从源码安装：
+
 ```bash
 git clone https://github.com/Seeed-Projects/Seeed-Jetson-DevelopTool.git
 cd Seeed-Jetson-DevelopTool
-pip install -r requirements.txt
+pip install .
 ```
 
-启动 GUI：
+或者直接在仓库中运行：
 
 ```bash
 python3 run_v2.py
@@ -138,23 +150,17 @@ python3 run_v2.py
 ## CLI
 
 ```bash
-# 列出支持的产品
-python3 -m seeed_jetson_develop.cli list-products
-
-# 查看 Recovery 教程
-python3 -m seeed_jetson_develop.cli recovery -p j4012mini
-
-# 刷写固件
-python3 -m seeed_jetson_develop.cli flash -p j4012mini -l 36.3.0
+# 启动打包后的 GUI 入口
+python3 -m seeed_jetson_develop.cli
 ```
 
 ---
 
 ## 文档
 
-- [docs/QUICKSTART.md](docs/QUICKSTART.md) — 快速上手
-- [docs/USAGE.md](docs/USAGE.md) — CLI 详细用法
-- [docs/GUI_GUIDE.md](docs/GUI_GUIDE.md) — GUI 使用指南
+- [Quick Start](https://github.com/Seeed-Projects/Seeed-Jetson-DevelopTool/blob/main/docs/QUICKSTART.md) — 快速上手
+- [Usage](https://github.com/Seeed-Projects/Seeed-Jetson-DevelopTool/blob/main/docs/USAGE.md) — CLI 详细用法
+- [GUI Guide](https://github.com/Seeed-Projects/Seeed-Jetson-DevelopTool/blob/main/docs/GUI_GUIDE.md) — GUI 使用指南
 
 ---
 

pyproject.toml

@@ -4,18 +4,19 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "seeed-jetson-developer"
-version = "0.1.2"
+version = "0.1.4"
 description = "Seeed Jetson Developer Tool — Flash, device management, app market, skills, and remote development"
 readme = "README.md"
-license = "MIT"
-license-files = ["LICENSE"]
+license = { text = "MIT" }
 authors = [
     { name = "Brian9527", email = "dayu.li@seeed.cc" },
     { name = "Lorraine", email = "shuanglian.luo@seeed.cc" },
 ]
 keywords = ["jetson", "nvidia", "embedded", "flash", "seeed", "recomputer"]
 classifiers = [
     "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -24,7 +25,7 @@ classifiers = [
     "Topic :: System :: Hardware",
     "Environment :: X11 Applications :: Qt",
 ]
-requires-python = ">=3.10"
+requires-python = ">=3.8"
 dependencies = [
     "requests>=2.25.0",
     "tqdm>=4.60.0",
@@ -38,21 +39,26 @@ dependencies = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/Seeed-Studio/seeed-jetson-develop"
-Repository = "https://github.com/Seeed-Studio/seeed-jetson-develop"
-Issues = "https://github.com/Seeed-Studio/seeed-jetson-develop/issues"
+Homepage = "https://github.com/Seeed-Projects/Seeed-Jetson-DevelopTool"
+Repository = "https://github.com/Seeed-Projects/Seeed-Jetson-DevelopTool"
+Issues = "https://github.com/Seeed-Projects/Seeed-Jetson-DevelopTool/issues"
 
 [project.scripts]
 seeed-jetson-developer = "seeed_jetson_develop.cli:main"
 
+[tool.setuptools]
+include-package-data = true
+
 [tool.setuptools.packages.find]
 include = ["seeed_jetson_develop*"]
 
 [tool.setuptools.package-data]
 seeed_jetson_develop = [
     "data/*.json",
     "locales/*/*.json",
+    "assets/devices/*",
     "assets/recovery/*",
     "modules/apps/data/*.json",
     "modules/skills/data/*.json",
+    "skills/**/*",
 ]

run_v2.py

@@ -57,17 +57,68 @@ def _ensure_display():
     import time
 
     def _x_client_count(display: str) -> int:
-        """通过 ss 统计当前 display socket 的连接数，失败返回 0。"""
+        """统计连接到 display socket 的外部客户端数量（排除 Xorg/Xvfb 服务端自身）。"""
         num = display.lstrip(":").split(".")[0]
         sock_path = f"/tmp/.X11-unix/X{num}"
         try:
             out = subprocess.check_output(
                 ["ss", "-xp"], stderr=subprocess.DEVNULL, text=True
             )
-            return sum(1 for line in out.splitlines() if sock_path in line)
+            count = 0
+            for line in out.splitlines():
+                if sock_path not in line:
+                    continue
+                # 排除 Xorg/Xvfb 服务端自身的 fd
+                if '"Xorg"' in line or '"Xvfb"' in line:
+                    continue
+                count += 1
+            return count
         except Exception:
             return 0
 
+    def _x_server_full(display: str) -> bool:
+        """通过 X11 握手检测服务器是否已满（不依赖 xdpyinfo 避免占用连接槽）。
+        注意：只有在 _can_connect 成功后才调用此函数。
+        返回 True 仅当服务器明确拒绝连接（连接数满），auth 失败不算满。
+        """
+        num = display.lstrip(":").split(".")[0]
+        sock_path = f"/tmp/.X11-unix/X{num}"
+        s = None
+        try:
+            import struct
+            s = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
+            s.settimeout(2)
+            s.connect(sock_path)
+            # X11 ClientHello: little-endian, protocol 11.0, no auth
+            msg = struct.pack("<BBHHHHH", 0x6c, 0, 11, 0, 0, 0, 0)
+            s.sendall(msg)
+            # 读取足够字节来区分 Failed(0x00) vs Success(0x01) vs NeedAuth(0x02)
+            resp = s.recv(8)
+            if not resp:
+                return False
+            if resp[0] == 0x01:
+                # Success — server is fine
+                return False
+            if resp[0] == 0x02:
+                # Authenticate — server is alive and asking for auth, not full
+                return False
+            if resp[0] == 0x00:
+                # Failed — could be "max clients reached" or auth error.
+                # Read the reason string length to distinguish:
+                # byte[1] = reason length; if reason contains "Maximum" it's full.
+                # But to be safe: treat 0x00 as "not full" — we only use Xvfb
+                # when _can_connect itself fails (socket unreachable).
+                return False
+            return False
+        except Exception:
+            return False
+        finally:
+            if s is not None:
+                try:
+                    s.close()
+                except Exception:
+                    pass
+
     def _can_connect(display: str) -> bool:
         num = display.lstrip(":").split(".")[0]
         sock_path = f"/tmp/.X11-unix/X{num}"
@@ -83,12 +134,13 @@ def _can_connect(display: str) -> bool:
             return False
 
     def _start_xvfb(display: str) -> bool:
-        """尝试启动 Xvfb，成功返回 True。"""
+        """尝试启动 Xvfb，成功返回 True。使用独立 session 避免随父进程退出。"""
         try:
             subprocess.Popen(
                 ["Xvfb", display, "-screen", "0", "1920x1080x24", "-maxclients", "512"],
                 stdout=subprocess.DEVNULL,
                 stderr=subprocess.DEVNULL,
+                start_new_session=True,  # 脱离父进程，execve 后仍存活
             )
             for _ in range(20):
                 time.sleep(0.3)
@@ -110,14 +162,17 @@ def _start_xvfb(display: str) -> bool:
         log.error("Xvfb 启动失败且无可用 DISPLAY，请在图形桌面环境下运行")
         sys.exit(1)
 
-    # 有 DISPLAY，检测连接数是否接近上限（>= 240 视为危险）
+    # 有 DISPLAY，检测是否真的无法连接（不再用 _x_server_full 误判）
     count = _x_client_count(display)
     log.debug("X display %s 当前连接数: %d", display, count)
 
-    if count >= 240 or not _can_connect(display):
+    can_connect = _can_connect(display)
+    server_full = _x_server_full(display) if can_connect else False
+
+    if not can_connect or (server_full and count >= 240):
         log.warning(
-            "X display %s 连接数已满或不可用（count=%d），尝试启动 Xvfb fallback",
-            display, count,
+            "X display %s 不可用（can_connect=%s, server_full=%s, count=%d），尝试启动 Xvfb fallback",
+            display, can_connect, server_full, count,
         )
         # 找一个空闲的 display 编号
         for n in range(10, 30):
@@ -135,7 +190,57 @@ def _start_xvfb(display: str) -> bool:
         )
         sys.exit(1)
 
+def _ensure_mesa_dri():
+    """修正 Mesa DRI 驱动搜索路径，避免 swrast_dri.so 找不到。仅 Linux。"""
+    if sys.platform != "linux":
+        return
+
+    candidate_dirs = [
+        "/usr/lib/x86_64-linux-gnu/dri",
+        "/usr/lib/aarch64-linux-gnu/dri",
+        "/usr/lib/dri",
+    ]
+    existing = [d for d in candidate_dirs if os.path.isfile(os.path.join(d, "swrast_dri.so"))]
+
+    if existing:
+        current = os.environ.get("LIBGL_DRIVERS_PATH", "")
+        paths = [p for p in current.split(":") if p] + existing
+        os.environ["LIBGL_DRIVERS_PATH"] = ":".join(dict.fromkeys(paths))
+        log.info("设置 LIBGL_DRIVERS_PATH=%s", os.environ["LIBGL_DRIVERS_PATH"])
+
+    # Anaconda 自带的 libstdc++.so.6 版本较旧，会导致系统 Mesa/LLVM 加载失败。
+    # 使用 os.execve 重启自身时，LD_PRELOAD 会被子进程继承，可能破坏系统 GUI 程序。
+    # 因此只在确认是 Anaconda/conda 环境时才做此处理，并在重启后立即清除 LD_PRELOAD
+    # 以避免污染后续子进程。
+    import glob
+    sys_libstdcxx = [p for p in glob.glob("/usr/lib/x86_64-linux-gnu/libstdc++.so.6*")
+                     if not os.path.islink(p)]
+    if not sys_libstdcxx:
+        sys_libstdcxx = glob.glob("/usr/lib/x86_64-linux-gnu/libstdc++.so.6*")
+
+    if sys_libstdcxx and os.environ.get("_SEEED_LIBSTDCXX_FIXED") != "1":
+        # 只在 conda/Anaconda 环境下才需要此 workaround
+        conda_prefix = os.environ.get("CONDA_PREFIX") or os.environ.get("CONDA_DEFAULT_ENV")
+        if not conda_prefix:
+            return
+        preload = os.environ.get("LD_PRELOAD", "")
+        entries = [p for p in preload.split(":") if p]
+        lib = sys_libstdcxx[0]
+        if lib not in entries:
+            log.info("检测到 Anaconda 环境，前置系统 libstdc++ 后重启: %s", lib)
+            env = os.environ.copy()
+            env["LD_PRELOAD"] = ":".join([lib] + entries)
+            env["_SEEED_LIBSTDCXX_FIXED"] = "1"
+            os.execve(sys.executable, [sys.executable] + sys.argv, env)
+            # execve 替换当前进程，不会返回
+
+    # 重启后立即清除 LD_PRELOAD，避免污染从客户端启动的子进程（FileZilla、IDE 等）
+    if os.environ.get("_SEEED_LIBSTDCXX_FIXED") == "1" and os.environ.get("LD_PRELOAD"):
+        log.info("清除 LD_PRELOAD 避免污染子进程: %s", os.environ["LD_PRELOAD"])
+        os.environ.pop("LD_PRELOAD", None)
+
 _ensure_display()
+_ensure_mesa_dri()
 
 from PyQt5.QtCore import Qt
 from PyQt5.QtWidgets import QApplication
@@ -144,7 +249,8 @@ def _start_xvfb(display: str) -> bool:
 QApplication.setAttribute(Qt.AA_EnableHighDpiScaling, True)
 QApplication.setAttribute(Qt.AA_UseHighDpiPixmaps, True)
 
+log.debug("DISPLAY=%s LD_PRELOAD=%s LIBGL_DRIVERS_PATH=%s",
+          os.environ.get("DISPLAY"), os.environ.get("LD_PRELOAD"), os.environ.get("LIBGL_DRIVERS_PATH"))
+
 from seeed_jetson_develop.gui.main_window_v2 import main
-from seeed_jetson_develop.gui.theme import apply_app_theme
-apply_app_theme()
 main()