fix(web+tray+trade): restore Tailwind v3 via Play CDN + tray log + non-blocking trades fetch

Author: quantclaws

installer/fetch-static-assets.py

@@ -3,14 +3,20 @@
 
 CI 构建 NSIS 安装包前会运行本脚本，把 Tailwind / DaisyUI / htmx 打包进
 应用目录，避免运行时从 unpkg/jsdelivr 拉取（Tracking Prevention 会拦截
-跨域 localStorage，导致 htmx 历史缓存失效；同时 Tailwind CDN 会输出
-"should not be used in production" 警告）。
+跨域 localStorage，导致 htmx 历史缓存失效）。
 
-为什么用 Tailwind v2.2.19 而不是 v3？v3 之后 Tailwind 切到 JIT 模式，不再
-发布预编译的 CSS——必须跑 Tailwind CLI 在构建期扫源码才能产出 CSS。
-v2.2.19 是最后支持"开箱即用预编译 CSS"的版本，CSS 体积约 3 MB（包含
-全部原子类），对桌面应用完全够用。生产 Tailwind（CLI + 按需生成 ~50 KB）
-是另一个 issue 的内容。
+为什么用 Tailwind Play CDN 而不是 v2 预编译 CSS 或 v3 CLI？
+- Play CDN（cdn.tailwindcss.com）是 Tailwind 官方提供的运行时 JIT 编译器，
+  客户端首次加载后扫一遍 DOM、按需生成 CSS。400 KB（含编译器本体），
+  比 v2 预编译的 ~3 MB CSS 小一档，跟原来 CDN 时代的渲染行为完全一致。
+- v2 预编译 CSS 缺少 v3 新增的若干原子类（.shrink-0 .gap-x-* .focus:ring-*
+  等），会导致"原本正常的 UI"在 vendoring 后变样，需要写一堆 polyfill
+  维护成本高。
+- v3 CLI 必须构建期扫源码，对 fasthtml 生成的 HTML（运行时才有内容）
+  不友好；要在构建期处理就得把模板里所有 class 枚举出来，可行性差。
+
+Play CDN 本地化是速度（比外网 CDN 快）+ 稳定性（不依赖网络）+ 设计保真
+（与原 CDN 渲染完全一致）的折中点。
 
 本脚本也可在本地手动执行：
 
@@ -31,8 +37,10 @@
 
 ASSETS: list[tuple[str, str]] = [
     (
-        "https://unpkg.com/tailwindcss@2.2.19/dist/tailwind.min.css",
-        "tailwind.min.css",
+        # Tailwind Play CDN（含 v3 JIT 编译器，~400 KB）。
+        # 比 v2 预编译 CSS 小，渲染行为与原 CDN 时代一致，保留所有 v3 原子类。
+        "https://cdn.tailwindcss.com",
+        "tailwind.min.js",
     ),
     (
         "https://unpkg.com/htmx.org@1.9.12/dist/htmx.min.js",

installer/installer.nsi

@@ -313,6 +313,7 @@ Section "-Core" SEC_CORE
     File "start.bat"
     File "start-silent.bat"
     File "start-silent.vbs"
+    File "wait-and-open-browser.ps1"
     File "task-template.xml"
     File "register-task.ps1"
     File "create-shortcuts.ps1"

installer/start.bat

@@ -1,4 +1,5 @@
 @echo off
+chcp 65001 >nul 2>&1
 cd /d "%~dp0"
 setlocal
 set "QMT_GATEWAY_HOME=%~dp0data\home"
@@ -11,40 +12,21 @@ if exist "%QMT_GATEWAY_HOME%\.port" (
     set /p GATEWAY_PORT=<"%QMT_GATEWAY_HOME%\.port"
 )
 
-:: 如果已有 gateway 在 .port 指向的端口上跑着，就只打开浏览器，不重复启动。
-:: 重复启动会让 mini-qmt 同时收到多个 session_id 的连接，互相挤掉，导致
-:: UI 一直显示"未连接"。脚本里用纯 PowerShell 探活，避免拉起额外的 exe。
+rem 如果已有 gateway 在 .port 指向的端口上跑着，就只打开浏览器，不重复启动。
 powershell.exe -NoProfile -Command "try{$c=New-Object Net.Sockets.TcpClient; $c.Connect('127.0.0.1', %GATEWAY_PORT%); $c.Close(); exit 0}catch{exit 1}" >nul 2>&1
 if not errorlevel 1 (
     start "" "http://localhost:%GATEWAY_PORT%"
     endlocal
     exit /b 0
 )
 
-:: 端口没响应——可能是 gateway 没启动（用户刚从托盘"停止"过，.port 已被
-:: atexit 删掉），也可能是上一个实例崩了。先在后台启动一个"等待就绪并打开
-:: 浏览器"的任务，再在前台启动 gateway——这样 gateway 的日志留在当前控制
-:: 台窗口，浏览器在 gateway 监听端口后自动弹出。旧实现是在启动 gateway
-:: 之前就 start 浏览器，结果浏览器先于 gateway 就绪弹出，显示"无法连接"。
-::
-:: .port 可能因为 8130 被占用而指向 8131-8139，所以等待结束后重新读取，
-:: 而不是沿用启动前的值。
-start "" /B powershell.exe -NoProfile -ExecutionPolicy Bypass -Command ^
-  "$portFile='%QMT_GATEWAY_HOME%\.port';" ^
-  "$w=0;" ^
-  "while($w -lt 15){" ^
-    "if(Test-Path -LiteralPath $portFile){$r=Get-Content -LiteralPath $portFile -ErrorAction SilentlyContinue; if($r -match '^\d+$'){break}}" ^
-    "Start-Sleep -Seconds 1; $w++" ^
-  "};" ^
-  "$port=8130; if(Test-Path -LiteralPath $portFile){$r=Get-Content -LiteralPath $portFile -ErrorAction SilentlyContinue; if($r -match '^\d+$'){$port=[int]$r}};" ^
-  "$w=0;" ^
-  "while($w -lt 30){" ^
-    "try{$c=New-Object Net.Sockets.TcpClient; $c.Connect('127.0.0.1',$port); $c.Close(); start \"\" \"http://localhost:$port\"; exit 0}catch{}; Start-Sleep -Seconds 1; $w++" ^
-  "}"
+rem 端口没响应：gateway 没启动或已停止。先在后台启动等待就绪打开浏览器的
+rem 任务，再在前台启动 gateway。浏览器在 gateway 监听端口后自动弹出。
+start "" /B powershell.exe -NoProfile -ExecutionPolicy Bypass -File "%~dp0wait-and-open-browser.ps1" -PortFile "%QMT_GATEWAY_HOME%\.port"
+
 python\python.exe -m qmt_gateway
 set "RC=%ERRORLEVEL%"
-:: 退出码 2 = 另一个实例已在跑（被单实例锁拒绝）。浏览器由上面的等待逻辑
-:: 打开，不需要提示用户出错。
+rem 退出码 2 = 另一个实例已在跑（被单实例锁拒绝）。
 if not "%RC%"=="2" (
     if not "%RC%"=="0" (
         echo qmt-gateway 启动失败，退出码 %RC%

installer/wait-and-open-browser.ps1

@@ -0,0 +1,47 @@
+# 等待 gateway 写入 .port 并真正监听，然后打开浏览器。
+#
+# 由 start.bat 在后台调用（start "" /B powershell ... -File 本文件）。
+# 单独成文件而不是内联在 start.bat 的 ^ 续行里，是因为中文系统下
+# cmd.exe 用 GBK 读取 .bat，多行 ^ 续行 + 中文注释会被 GBK 字节
+# 切断，导致注释内容被当作命令执行。
+#
+# 调用：powershell -NoProfile -ExecutionPolicy Bypass -File 本文件 -PortFile <path>
+param(
+    [Parameter(Mandatory = $true)]
+    [string]$PortFile
+)
+
+$defaultPort = 8130
+
+# 1. 等 gateway 写 .port（最多 15 秒）
+$w = 0
+while ($w -lt 15) {
+    if (Test-Path -LiteralPath $PortFile) {
+        $r = Get-Content -LiteralPath $PortFile -ErrorAction SilentlyContinue
+        if ($r -match '^\d+$') { break }
+    }
+    Start-Sleep -Seconds 1
+    $w++
+}
+
+# 2. 读真实端口（8130 被占用时 gateway 会跳到 8131-8139）
+$port = $defaultPort
+if (Test-Path -LiteralPath $PortFile) {
+    $r = Get-Content -LiteralPath $PortFile -ErrorAction SilentlyContinue
+    if ($r -match '^\d+$') { $port = [int]$r }
+}
+
+# 3. 探活端口就绪后打开浏览器（最多 30 秒）
+$w = 0
+while ($w -lt 30) {
+    try {
+        $c = New-Object Net.Sockets.TcpClient
+        $c.Connect('127.0.0.1', $port)
+        $c.Close()
+        Start-Process "http://localhost:$port"
+        exit 0
+    } catch {}
+    Start-Sleep -Seconds 1
+    $w++
+}
+exit 1

qmt_gateway/app.py

@@ -318,18 +318,14 @@ def create_app():
     # 创建 FastHTML 应用
     app = FastHTML(
         hdrs=[
-            # Tailwind v2（预编译，~3 MB；覆盖 .flex .text-sm .w-9 等原子类）
-            # 必须先于 DaisyUI——DaisyUI 的 .btn .card 等组件依赖 Tailwind 变量
-            Link(rel="stylesheet", href="/static/tailwind.min.css"),
+            # Tailwind Play CDN（v3 JIT 编译器，本地化；与原 CDN 渲染行为完全一致，
+            # 保留全部 v3 原子类，包括 .shrink-0 .gap-x-* .focus:ring-* 等）。
+            # 体积 ~400 KB（含编译器），小于 v2 预编译的 ~3 MB CSS。
+            Script(src="/static/tailwind.min.js"),
             # DaisyUI（主题层；.btn .loading .text-primary 等组件）
             Link(rel="stylesheet", href="/static/daisyui.min.css"),
             # HTMX
             Script(src="/static/htmx.min.js"),
-            # v3-only 工具类 polyfill（tailwind v2 没有 .shrink-0 简写）
-            Style(
-                ".shrink-0 { flex-shrink: 0; }\n"
-                ".flex-shrink-0 { flex-shrink: 0; }"
-            ),
         ],
         session_cookie="qmt_gateway_session",
     )

qmt_gateway/services/trade_service.py

@@ -1254,7 +1254,11 @@ def get_orders(self) -> list[dict]:
         Returns:
             委托列表（字典列表）
         """
-        if not self._ensure_connected():
+        # 不要在同步 HTTP 路径里触发 _ensure_connected() —— 那是阻塞路径，
+        # 会同步启动 QMT 客户端（10+ 秒），导致 / 和 /trading 页面首次
+        # 加载卡住。断线场景由 mark_disconnected → _schedule_auto_reconnect
+        # 异步处理；这里只读已连接状态。
+        if not self._connected or self._trader is None or self._account is None:
             return []
 
         try:
@@ -1300,7 +1304,8 @@ def get_trades(self) -> list[dict]:
         Returns:
             成交列表（字典列表）
         """
-        if not self._ensure_connected():
+        # 同 get_orders：避免在同步路径里同步 connect()。
+        if not self._connected or self._trader is None or self._account is None:
             return []
 
         try:

qmt_gateway/tray.py

@@ -228,43 +228,57 @@ def _load_icon() -> Image.Image:
 
 
 def _open_browser(icon: pystray.Icon, item: pystray.MenuItem) -> None:
-    port = _read_port()
-    url = f"http://localhost:{port}"
-    logger.info(f"打开浏览器: {url}")
-    webbrowser.open(url)
+    try:
+        port = _read_port()
+        url = f"http://localhost:{port}"
+        logger.info(f"打开浏览器: {url}")
+        webbrowser.open(url)
+    except Exception as exc:
+        logger.exception(f"打开浏览器失败: {exc}")
 
 
 def _restart_gateway(icon: pystray.Icon, item: pystray.MenuItem) -> None:
-    logger.info("用户触发重启")
-    # 先清过期锁（gateway 已被外部 kill -9 / 任务管理器结束的场景）
-    _clear_stale_lock()
-    # "停止"之后 gateway 已死、.lock 已被 atexit 删掉，_read_pid() 返回 None。
-    # 此时 _kill_gateway() 返回 False，旧实现会短路掉 _spawn_gateway()——
-    # 结果用户点"重启"什么也没发生。这里改成：没有正在跑的进程就直接拉起。
-    # 注意不调 _wait_for_port_free：停止后 .port 已被删，_read_port() 退回
-    # 8130，但 8130 可能被别的应用占用——此时等它空闲会误判为"端口占用"。
-    # gateway 内部的 find_available_port 会自己探测可用端口，托盘不需要干预。
-    pid = _read_pid()
-    if pid is None:
-        logger.info("未发现正在运行的 gateway，直接启动新实例")
-        _spawn_gateway()
-        return
-    port = _read_port()
-    if _kill_gateway() and _wait_for_port_free(port, timeout=10.0):
-        _spawn_gateway()
-    else:
-        logger.warning("重启失败：旧进程未退出或端口仍占用")
+    try:
+        logger.info("用户触发重启")
+        # 先清过期锁（gateway 已被外部 kill -9 / 任务管理器结束的场景）
+        _clear_stale_lock()
+        # "停止"之后 gateway 已死、.lock 已被 atexit 删掉，_read_pid() 返回 None。
+        # 此时 _kill_gateway() 返回 False，旧实现会短路掉 _spawn_gateway()——
+        # 结果用户点"重启"什么也没发生。这里改成：没有正在跑的进程就直接拉起。
+        # 注意不调 _wait_for_port_free：停止后 .port 已被删，_read_port() 退回
+        # 8130，但 8130 可能被别的应用占用——此时等它空闲会误判为"端口占用"。
+        # gateway 内部的 find_available_port 会自己探测可用端口，托盘不需要干预。
+        pid = _read_pid()
+        if pid is None:
+            logger.info("未发现正在运行的 gateway，直接启动新实例")
+            if not _spawn_gateway():
+                logger.error("重启失败：spawn 返回 False")
+            return
+        port = _read_port()
+        if _kill_gateway() and _wait_for_port_free(port, timeout=10.0):
+            if not _spawn_gateway():
+                logger.error("重启失败：spawn 返回 False")
+        else:
+            logger.warning("重启失败：旧进程未退出或端口仍占用")
+    except Exception as exc:
+        logger.exception(f"重启失败: {exc}")
 
 
 def _stop_gateway(icon: pystray.Icon, item: pystray.MenuItem) -> None:
-    logger.info("用户触发停止")
-    _kill_gateway()
+    try:
+        logger.info("用户触发停止")
+        _kill_gateway()
+    except Exception as exc:
+        logger.exception(f"停止失败: {exc}")
 
 
 def _quit_tray(icon: pystray.Icon, item: pystray.MenuItem) -> None:
     """退出托盘本身；gateway 继续运行（用户可从开始菜单重启托盘）。"""
-    logger.info("退出托盘；gateway 保持运行")
-    icon.stop()
+    try:
+        logger.info("退出托盘；gateway 保持运行")
+        icon.stop()
+    except Exception as exc:
+        logger.exception(f"退出托盘失败: {exc}")
 
 
 def _start_gateway(icon: pystray.Icon, item: pystray.MenuItem) -> None:
@@ -275,15 +289,19 @@ def _start_gateway(icon: pystray.Icon, item: pystray.MenuItem) -> None:
     探测可用端口，托盘不需要预先等端口空闲（否则 8130 被别的应用占用时
     会误判为"无法启动"）。
     """
-    logger.info("用户触发启动")
-    _clear_stale_lock()
-    pid = _read_pid()
-    if pid is not None and _is_pid_alive_windows(pid):
-        # 已经在跑——直接打开浏览器，不重复拉起
-        logger.info("gateway 已在运行，打开浏览器")
-        _open_browser(icon, item)
-        return
-    _spawn_gateway()
+    try:
+        logger.info("用户触发启动")
+        _clear_stale_lock()
+        pid = _read_pid()
+        if pid is not None and _is_pid_alive_windows(pid):
+            # 已经在跑——直接打开浏览器，不重复拉起
+            logger.info("gateway 已在运行，打开浏览器")
+            _open_browser(icon, item)
+            return
+        if not _spawn_gateway():
+            logger.error("启动失败：spawn 返回 False")
+    except Exception as exc:
+        logger.exception(f"启动失败: {exc}")
 
 
 def _build_menu() -> pystray.Menu:
@@ -334,5 +352,24 @@ def _ready_signal():
 if __name__ == "__main__":
     logger.remove()
     logger.add(sys.stderr, level="INFO")
+    # 托盘是 DETACHED_PROCESS 启动的，stderr 在父进程上下文里没有可见
+    # 的控制台——所有诊断信息会消失。这里把 INFO 及以上级别的日志镜像
+    # 到 $INSTDIR\logs\tray.log（开发态为仓库根的 logs\tray.log），
+    # 出问题时有据可查。
+    try:
+        log_dir = Path(__file__).resolve().parent.parent / "logs"
+        # 安装态：qmt_gateway/tray.py 在 $INSTDIR\app\qmt_gateway\，
+        # parent.parent 是 $INSTDIR\app，所以这里指向 app\logs。
+        # 退而求其次写到 logs\tray.log（cwd 视角）。
+        log_dir.mkdir(parents=True, exist_ok=True)
+        logger.add(
+            log_dir / "tray.log",
+            level="INFO",
+            rotation="1 MB",
+            retention=3,
+            encoding="utf-8",
+        )
+    except OSError:
+        pass
     logger.info("QMT Gateway 托盘启动")
     run()

qmt_gateway/web/theme.py

@@ -26,11 +26,11 @@ def headers():
         构建时下载到 ``qmt_gateway/web/static/``。
         """
         return [
-            # Tailwind v2（必须先于 DaisyUI）
-            Link(rel="stylesheet", href="/static/tailwind.min.css"),
+            # Tailwind Play CDN（v3 JIT，本地化；与原 CDN 时代渲染完全一致）
+            Script(src="/static/tailwind.min.js"),
             # DaisyUI（Tailwind 主题层）
             Link(rel="stylesheet", href="/static/daisyui.min.css"),
-            # 自定义主题 CSS + Tailwind v2→v3 兼容 polyfill
+            # 自定义主题 CSS
             Style(f"""
                 :root {{
                     --p: 4 90% 58%;  /* primary color in HSL: #D13527 approx */
@@ -50,9 +50,6 @@ def headers():
                 .border-primary {{
                     border-color: {PRIMARY_COLOR} !important;
                 }}
-                /* Tailwind v3-only utility polyfill for v2 compat */
-                .shrink-0 {{ flex-shrink: 0; }}
-                .flex-shrink-0 {{ flex-shrink: 0; }}
             """),
             # HTMX
             Script(src="/static/htmx.min.js"),