fix(scripts): run --help 不再误启动服务，新增完整帮助文档

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

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