From c77e1c14905f7c01ef063dbaf242aa9900905038 Mon Sep 17 00:00:00 2001
From: wangjia <809946525@qq.com>
Date: Tue, 19 May 2026 09:01:56 +0800
Subject: [PATCH] =?UTF-8?q?fix(scripts):=20run=20--help=20=E4=B8=8D?=
 =?UTF-8?q?=E5=86=8D=E8=AF=AF=E5=90=AF=E5=8A=A8=E6=9C=8D=E5=8A=A1=EF=BC=8C?=
 =?UTF-8?q?=E6=96=B0=E5=A2=9E=E5=AE=8C=E6=95=B4=E5=B8=AE=E5=8A=A9=E6=96=87?=
 =?UTF-8?q?=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 scripts/dev.sh | 39 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 38 insertions(+), 1 deletion(-)

diff --git a/scripts/dev.sh b/scripts/dev.sh
index b99c2d7..3bf9058 100755
--- a/scripts/dev.sh
+++ b/scripts/dev.sh
@@ -94,12 +94,44 @@ RUN_BACKEND=true
 RUN_FRONTEND=true   # macOS
 RUN_WEB=false
 
+show_help() {
+  echo "用法: sh scripts/dev.sh <命令> [选项]"
+  echo ""
+  echo "启动命令："
+  echo "  run                    启动前后端（macOS 桌面端）"
+  echo "  run --force            强制重启后端"
+  echo "  run --web              启动前后端（Chrome Web 端）"
+  echo "  run --all              启动前后端（macOS + Web 同时）"
+  echo "  --backend-only         仅启动后端"
+  echo "  --frontend-only        仅启动前端（macOS）"
+  echo "  --web-only             仅启动前端（Web）"
+  echo ""
+  echo "数据库命令："
+  echo "  seed <shop_code>       清空并写入指定门店测试数据（如 H001）"
+  echo "  reset                  删表重建（AutoMigrate）"
+  echo "  clear                  清空所有业务数据"
+  echo ""
+  echo "其他："
+  echo "  stop                   停止后端服务"
+  echo "  help / --help / -h     显示此帮助"
+}
+
 case "$COMMAND" in
   run)
     case "${2:-}" in
       --force) FORCE=true ;;
       --web)   RUN_FRONTEND=false; RUN_WEB=true ;;
       --all)   RUN_WEB=true ;;
+      --help|-h|help)
+        show_help
+        exit 0
+        ;;
+      "")  ;;
+      *)
+        error "run: 未知选项 '${2}'"
+        echo "可用选项: --force | --web | --all"
+        exit 1
+        ;;
     esac
     ;;
   seed)
@@ -153,9 +185,14 @@ case "$COMMAND" in
     fi
     exit 0
     ;;
+  help|--help|-h)
+    show_help
+    exit 0
+    ;;
   *)
     error "未知命令: $COMMAND"
-    echo "用法: sh scripts/dev.sh [run [--force|--web|--all] | seed <shop> | reset | clear | stop | --backend-only | --frontend-only | --web-only]"
+    echo ""
+    show_help
     exit 1
     ;;
 esac