feat: 统一跨平台重启工作流 (#273)

* docs: 补充项目界面预览

* feat: 统一跨平台重启流程

* fix: 规范cmd换行并保护关键PID

Author: ymkiux

.gitattributes

@@ -0,0 +1 @@
+*.cmd text eol=crlf

cmd/workflows/README.md

@@ -0,0 +1,21 @@
+# Workflow Scripts
+
+This folder stores reusable developer workflow scripts.
+
+## Build + Restart Dev
+
+- Windows CMD: `cmd\workflows\build-restart.cmd`
+- Bash (macOS/Linux): `cmd/workflows/build-restart.sh`
+
+Both scripts execute the same workflow:
+
+1. `pnpm build` in `web`
+2. stop processes listening on ports `9880` and `9881`
+3. start `wails dev`
+
+The scripts auto-detect the repository root by walking up from the script location and finding:
+
+- `go.mod`
+- `web/package.json`
+
+So they continue to work even if the script folder is moved deeper under the repo.

cmd/workflows/build-restart.cmd

@@ -0,0 +1,113 @@
+@echo off
+setlocal EnableExtensions EnableDelayedExpansion
+
+set "SCRIPT_DIR=%~dp0"
+for %%I in ("%SCRIPT_DIR%.") do set "CURRENT_DIR=%%~fI"
+
+:findRoot
+if exist "!CURRENT_DIR!\go.mod" if exist "!CURRENT_DIR!\web\package.json" (
+  set "REPO_ROOT=!CURRENT_DIR!"
+  goto rootFound
+)
+
+for %%I in ("!CURRENT_DIR!\..") do set "PARENT_DIR=%%~fI"
+if /I "!PARENT_DIR!"=="!CURRENT_DIR!" goto rootNotFound
+set "CURRENT_DIR=!PARENT_DIR!"
+goto findRoot
+
+:rootNotFound
+echo [ERROR] Could not locate repo root from "%SCRIPT_DIR%".
+echo [ERROR] Expected files: go.mod and web\package.json
+exit /b 1
+
+:rootFound
+set "WEB_DIR=!REPO_ROOT!\web"
+
+echo [1/3] Build frontend ...
+cd /d "!WEB_DIR!" || (
+  echo [ERROR] Failed to enter web dir: "!WEB_DIR!"
+  exit /b 1
+)
+
+call pnpm build
+if errorlevel 1 (
+  echo [ERROR] pnpm build failed. Abort restart.
+  exit /b 1
+)
+
+echo [2/3] Stop processes on ports 9880 and 9881 ...
+set "KILLED_ANY=0"
+set "SEEN_PIDS=;"
+
+call :killByPort 9880
+call :killByPort 9881
+
+if "!KILLED_ANY!"=="0" (
+  echo [INFO] No running process found on ports 9880/9881.
+)
+
+echo [3/3] Start wails dev ...
+cd /d "!REPO_ROOT!" || (
+  echo [ERROR] Failed to enter repo root: "!REPO_ROOT!"
+  exit /b 1
+)
+
+call wails dev %*
+set "EXIT_CODE=%ERRORLEVEL%"
+echo [INFO] wails dev exited with code %EXIT_CODE%.
+exit /b %EXIT_CODE%
+
+:killByPort
+set "PORT=%~1"
+set "FOUND_ON_PORT=0"
+
+for /f "tokens=2,5" %%A in ('netstat -ano -p tcp ^| findstr /R /C:":[0-9][0-9]* " 2^>nul') do (
+  set "LOCAL_ADDR=%%A"
+  set "PID=%%B"
+  echo !LOCAL_ADDR! | findstr /R /C:":%PORT%$" >nul
+  if not errorlevel 1 (
+    set "FOUND_ON_PORT=1"
+    call :tryKillPid !PID! %PORT%
+  )
+)
+
+if "!FOUND_ON_PORT!"=="0" (
+  echo [INFO] Port %PORT% is free.
+)
+goto :eof
+
+:tryKillPid
+set "PID=%~1"
+set "PORT=%~2"
+
+if not defined PID (
+  echo [WARN] Empty PID for port %PORT%, skip.
+  goto :eof
+)
+
+echo %PID%| findstr /R "^[0-9][0-9]*$" >nul
+if errorlevel 1 (
+  echo [WARN] Invalid PID %PID% (port %PORT%), skip.
+  goto :eof
+)
+
+if %PID% LEQ 4 (
+  echo [WARN] Skip protected PID %PID% (port %PORT%).
+  goto :eof
+)
+
+echo !SEEN_PIDS! | findstr /C:";%PID%;" >nul
+if not errorlevel 1 (
+  goto :eof
+)
+
+set "SEEN_PIDS=!SEEN_PIDS!%PID%;"
+echo [INFO] Killing PID %PID% (port %PORT%)...
+taskkill /PID %PID% /F >nul 2>&1
+if errorlevel 1 (
+  echo [WARN] Failed to kill PID %PID% (might have exited already).
+) else (
+  echo [OK] Killed PID %PID%.
+  set "KILLED_ANY=1"
+)
+goto :eof

cmd/workflows/build-restart.sh

@@ -0,0 +1,99 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CURRENT_DIR="$SCRIPT_DIR"
+REPO_ROOT=""
+
+while true; do
+  if [[ -f "$CURRENT_DIR/go.mod" && -f "$CURRENT_DIR/web/package.json" ]]; then
+    REPO_ROOT="$CURRENT_DIR"
+    break
+  fi
+
+  PARENT_DIR="$(dirname "$CURRENT_DIR")"
+  if [[ "$PARENT_DIR" == "$CURRENT_DIR" ]]; then
+    break
+  fi
+  CURRENT_DIR="$PARENT_DIR"
+done
+
+if [[ -z "$REPO_ROOT" ]]; then
+  echo "[ERROR] Could not locate repo root from \"$SCRIPT_DIR\"."
+  echo "[ERROR] Expected files: go.mod and web/package.json"
+  exit 1
+fi
+
+WEB_DIR="$REPO_ROOT/web"
+
+echo "[1/3] Build frontend ..."
+(
+  cd "$WEB_DIR"
+  pnpm build
+)
+
+echo "[2/3] Stop processes on ports 9880 and 9881 ..."
+KILLED_ANY=0
+SEEN_PIDS=";"
+
+kill_pid() {
+  local pid="$1"
+  local port="$2"
+
+  [[ -z "$pid" ]] && return 0
+  case "$SEEN_PIDS" in
+    *";$pid;"*) return 0 ;;
+  esac
+
+  SEEN_PIDS="${SEEN_PIDS}${pid};"
+  echo "[INFO] Killing PID $pid (port $port)..."
+  if kill "$pid" >/dev/null 2>&1 || kill -9 "$pid" >/dev/null 2>&1; then
+    echo "[OK] Killed PID $pid."
+    KILLED_ANY=1
+  else
+    echo "[WARN] Failed to kill PID $pid (might have exited already)."
+  fi
+}
+
+kill_by_port() {
+  local port="$1"
+  local found=0
+  local pids=""
+  local scanner=""
+
+  if command -v lsof >/dev/null 2>&1; then
+    scanner="lsof"
+    pids="$(lsof -tiTCP:"$port" -sTCP:LISTEN 2>/dev/null || true)"
+  elif command -v fuser >/dev/null 2>&1; then
+    scanner="fuser"
+    pids="$(fuser -n tcp "$port" 2>/dev/null || true)"
+  elif command -v ss >/dev/null 2>&1; then
+    scanner="ss"
+    pids="$(ss -ltnp "sport = :$port" 2>/dev/null | sed -n 's/.*pid=\([0-9]\+\).*/\1/p' || true)"
+  fi
+
+  if [[ -z "$scanner" ]]; then
+    echo "[WARN] No port scanner found (need lsof/fuser/ss). Skip cleanup for port $port."
+    return 0
+  fi
+
+  for pid in $pids; do
+    found=1
+    kill_pid "$pid" "$port"
+  done
+
+  if [[ "$found" -eq 0 ]]; then
+    echo "[INFO] Port $port is free."
+  fi
+}
+
+kill_by_port 9880
+kill_by_port 9881
+
+if [[ "$KILLED_ANY" -eq 0 ]]; then
+  echo "[INFO] No running process found on ports 9880/9881."
+fi
+
+echo "[3/3] Start wails dev ..."
+cd "$REPO_ROOT"
+exec wails dev "$@"