feat：添加Web版本自动化部署系统

- 实现跨平台Web导出脚本(Windows/Linux/macOS)
- 添加本地测试服务器启动脚本
- 配置Godot Web导出预设
- 创建Web资源目录结构
- 支持一键导出和本地测试

scripts/build_web.bat

@@ -0,0 +1,235 @@
+@echo off
+setlocal enabledelayedexpansion
+
+echo ========================================
+echo     鲸鱼镇 Web版本导出工具 v1.0
+echo ========================================
+echo.
+
+REM 配置变量 - 请根据实际情况修改
+set "PROJECT_NAME=whaleTown"
+set "BUILD_DIR=build\web"
+set "GODOT_PATH=D:\technology\biancheng\Godot\Godot_v4.5.1-stable_win64.exe"
+set "EXPORT_PRESET=Web"
+set "VERSION=1.0.0"
+
+REM 颜色代码（Windows 10+）
+set "RED=[91m"
+set "GREEN=[92m"
+set "YELLOW=[93m"
+set "BLUE=[94m"
+set "RESET=[0m"
+
+REM 检查Godot是否存在
+echo %BLUE%[检查]%RESET% 验证Godot安装...
+if not exist "%GODOT_PATH%" (
+    echo %RED%[错误]%RESET% 未找到Godot可执行文件: %GODOT_PATH%
+    echo 请修改脚本中的GODOT_PATH变量或安装Godot 4.5+
+    echo 下载地址: https://godotengine.org/download
+    echo.
+    pause
+    exit /b 1
+)
+
+REM 检查项目文件
+echo %BLUE%[检查]%RESET% 验证项目文件...
+if not exist "project.godot" (
+    echo %RED%[错误]%RESET% 未找到project.godot文件！
+    echo 请在项目根目录运行此脚本
+    echo.
+    pause
+    exit /b 1
+)
+
+REM 显示项目信息
+echo %GREEN%[信息]%RESET% 项目信息:
+echo   项目名称: %PROJECT_NAME%
+echo   版本号: %VERSION%
+echo   Godot路径: %GODOT_PATH%
+echo   导出预设: %EXPORT_PRESET%
+echo   输出目录: %BUILD_DIR%
+echo.
+
+REM 创建构建目录结构
+echo %BLUE%[构建]%RESET% 准备构建环境...
+if not exist "build" mkdir "build"
+if not exist "%BUILD_DIR%" mkdir "%BUILD_DIR%"
+if not exist "scripts" mkdir "scripts"
+
+REM 备份旧版本（如果存在）
+if exist "%BUILD_DIR%\index.html" (
+    echo %YELLOW%[备份]%RESET% 备份旧版本...
+    set "BACKUP_DIR=build\backup\%date:~0,4%%date:~5,2%%date:~8,2%_%time:~0,2%%time:~3,2%%time:~6,2%"
+    set "BACKUP_DIR=!BACKUP_DIR: =0!"
+    mkdir "!BACKUP_DIR!" 2>nul
+    xcopy "%BUILD_DIR%\*" "!BACKUP_DIR%\" /Y /Q >nul 2>&1
+    echo   备份位置: !BACKUP_DIR!\
+)
+
+REM 清理旧文件
+echo %BLUE%[清理]%RESET% 清理旧的导出文件...
+if exist "%BUILD_DIR%\*" del /q "%BUILD_DIR%\*" >nul 2>&1
+
+REM 检查导出预设
+echo %BLUE%[验证]%RESET% 检查导出预设...
+"%GODOT_PATH%" --headless --export-debug "%EXPORT_PRESET%" --check-only >nul 2>&1
+if %ERRORLEVEL% neq 0 (
+    echo %RED%[错误]%RESET% 导出预设 "%EXPORT_PRESET%" 不存在或配置错误！
+    echo 请在Godot编辑器中创建Web导出预设
+    echo.
+    pause
+    exit /b 1
+)
+
+REM 导出项目
+echo %GREEN%[导出]%RESET% 开始导出Web版本...
+echo   目标文件: %BUILD_DIR%\index.html
+echo   请稍候...
+echo.
+
+"%GODOT_PATH%" --headless --export-release "%EXPORT_PRESET%" "%BUILD_DIR%\index.html"
+
+if %ERRORLEVEL% neq 0 (
+    echo %RED%[失败]%RESET% 导出失败！错误代码: %ERRORLEVEL%
+    echo.
+    echo 可能的原因:
+    echo 1. 导出模板未安装
+    echo 2. 项目配置错误
+    echo 3. 资源文件损坏
+    echo.
+    pause
+    exit /b %ERRORLEVEL%
+)
+
+REM 验证导出文件
+echo %BLUE%[验证]%RESET% 验证导出文件...
+set "REQUIRED_FILES=index.html index.js index.wasm index.pck"
+set "MISSING_FILES="
+
+for %%f in (%REQUIRED_FILES%) do (
+    if not exist "%BUILD_DIR%\%%f" (
+        set "MISSING_FILES=!MISSING_FILES! %%f"
+    )
+)
+
+if not "!MISSING_FILES!"=="" (
+    echo %RED%[错误]%RESET% 缺少必要文件:!MISSING_FILES!
+    echo 导出可能不完整，请检查Godot配置
+    echo.
+    pause
+    exit /b 1
+)
+
+REM 复制额外资源
+echo %BLUE%[复制]%RESET% 复制额外资源...
+if exist "assets\web\favicon.ico" copy "assets\web\favicon.ico" "%BUILD_DIR%\" >nul 2>&1
+if exist "assets\web\manifest.json" copy "assets\web\manifest.json" "%BUILD_DIR%\" >nul 2>&1
+if exist "assets\web\service-worker.js" copy "assets\web\service-worker.js" "%BUILD_DIR%\" >nul 2>&1
+if exist "assets\web\custom_shell.html" copy "assets\web\custom_shell.html" "%BUILD_DIR%\" >nul 2>&1
+
+REM 生成部署信息
+echo %BLUE%[生成]%RESET% 生成部署信息...
+(
+echo {
+echo   "project": "%PROJECT_NAME%",
+echo   "version": "%VERSION%",
+echo   "build_time": "%date% %time%",
+echo   "platform": "web",
+echo   "godot_version": "4.5",
+echo   "export_preset": "%EXPORT_PRESET%",
+echo   "build_machine": "%COMPUTERNAME%",
+echo   "build_user": "%USERNAME%"
+echo }
+) > "%BUILD_DIR%\deploy_info.json"
+
+REM 生成.htaccess文件
+echo %BLUE%[配置]%RESET% 生成Apache配置文件...
+(
+echo # 鲸鱼镇 Web版本 Apache配置
+echo # 自动生成于 %date% %time%
+echo.
+echo # MIME类型配置
+echo AddType application/wasm .wasm
+echo AddType application/octet-stream .pck
+echo AddType application/javascript .js
+echo.
+echo # 启用压缩
+echo ^<IfModule mod_deflate.c^>
+echo     AddOutputFilterByType DEFLATE text/html text/css application/javascript application/wasm
+echo     AddOutputFilterByType DEFLATE application/json application/xml
+echo ^</IfModule^>
+echo.
+echo # 缓存控制
+echo ^<IfModule mod_expires.c^>
+echo     ExpiresActive On
+echo     ExpiresByType application/wasm "access plus 1 month"
+echo     ExpiresByType application/octet-stream "access plus 1 month"
+echo     ExpiresByType application/javascript "access plus 1 week"
+echo     ExpiresByType text/html "access plus 1 hour"
+echo ^</IfModule^>
+echo.
+echo # CORS配置
+echo ^<IfModule mod_headers.c^>
+echo     Header set Access-Control-Allow-Origin "*"
+echo     Header set Access-Control-Allow-Methods "GET, POST, PUT, DELETE, OPTIONS"
+echo     Header set Access-Control-Allow-Headers "Content-Type, Authorization"
+echo     Header set Cross-Origin-Embedder-Policy "require-corp"
+echo     Header set Cross-Origin-Opener-Policy "same-origin"
+echo ^</IfModule^>
+) > "%BUILD_DIR%\.htaccess"
+
+REM 计算文件大小
+echo %BLUE%[统计]%RESET% 计算文件大小...
+set "TOTAL_SIZE=0"
+for %%f in ("%BUILD_DIR%\*") do (
+    set /a "TOTAL_SIZE+=%%~zf"
+)
+set /a "TOTAL_MB=TOTAL_SIZE/1024/1024"
+
+REM 显示构建结果
+echo.
+echo ========================================
+echo %GREEN%          导出成功！%RESET%
+echo ========================================
+echo.
+echo %GREEN%[完成]%RESET% 构建统计:
+echo   导出位置: %BUILD_DIR%\
+echo   总文件大小: %TOTAL_MB% MB
+echo   构建时间: %date% %time%
+echo.
+echo %BLUE%[文件]%RESET% 导出文件列表:
+for %%f in ("%BUILD_DIR%\*") do (
+    set "size=%%~zf"
+    set /a "size_mb=!size!/1024/1024"
+    if !size_mb! gtr 0 (
+        echo   %%~nxf: !size_mb! MB
+    ) else (
+        set /a "size_kb=!size!/1024"
+        echo   %%~nxf: !size_kb! KB
+    )
+)
+
+echo.
+echo %YELLOW%[下一步]%RESET% 部署选项:
+echo   1. 本地测试: scripts\serve_web.bat
+echo   2. 上传到服务器: 将 %BUILD_DIR%\ 目录上传
+echo   3. 查看文档: docs\web_deployment_guide.md
+echo.
+echo %GREEN%[提示]%RESET% 部署前请确保:
+echo   - 服务器支持WASM MIME类型
+echo   - 配置了正确的CORS头
+echo   - 启用了文件压缩
+echo.
+
+REM 询问是否启动本地服务器
+set /p "START_SERVER=是否启动本地测试服务器？(y/N): "
+if /i "!START_SERVER!"=="y" (
+    echo.
+    echo %GREEN%[启动]%RESET% 启动本地服务器...
+    call "scripts\serve_web.bat"
+) else (
+    echo.
+    echo 构建完成！可以手动运行 scripts\serve_web.bat 进行测试
+)
+
+pause

scripts/build_web.sh

@@ -0,0 +1,238 @@
+#!/bin/bash
+
+# 鲸鱼镇 Web版本导出工具 (Linux/macOS)
+# 版本: 1.0.0
+
+# 颜色定义
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# 配置变量 - 请根据实际情况修改
+PROJECT_NAME="whaleTown"
+BUILD_DIR="build/web"
+GODOT_PATH="/usr/local/bin/godot"  # macOS Homebrew默认路径
+# GODOT_PATH="/usr/bin/godot"      # Linux包管理器默认路径
+# GODOT_PATH="$HOME/Applications/Godot.app/Contents/MacOS/Godot"  # macOS应用程序路径
+EXPORT_PRESET="Web"
+VERSION="1.0.0"
+
+echo "========================================"
+echo "     鲸鱼镇 Web版本导出工具 v1.0"
+echo "========================================"
+echo
+
+# 检查Godot是否存在
+echo -e "${BLUE}[检查]${NC} 验证Godot安装..."
+if [ ! -f "$GODOT_PATH" ]; then
+    echo -e "${RED}[错误]${NC} 未找到Godot: $GODOT_PATH"
+    echo
+    echo "请修改脚本中的GODOT_PATH变量或安装Godot 4.5+"
+    echo "安装方法:"
+    echo "  macOS: brew install godot"
+    echo "  Ubuntu: sudo apt install godot3"
+    echo "  或从官网下载: https://godotengine.org/download"
+    echo
+    exit 1
+fi
+
+# 检查项目文件
+echo -e "${BLUE}[检查]${NC} 验证项目文件..."
+if [ ! -f "project.godot" ]; then
+    echo -e "${RED}[错误]${NC} 未找到project.godot文件！"
+    echo "请在项目根目录运行此脚本"
+    echo
+    exit 1
+fi
+
+# 显示项目信息
+echo -e "${GREEN}[信息]${NC} 项目信息:"
+echo "  项目名称: $PROJECT_NAME"
+echo "  版本号: $VERSION"
+echo "  Godot路径: $GODOT_PATH"
+echo "  导出预设: $EXPORT_PRESET"
+echo "  输出目录: $BUILD_DIR"
+echo
+
+# 创建构建目录结构
+echo -e "${BLUE}[构建]${NC} 准备构建环境..."
+mkdir -p "$BUILD_DIR"
+mkdir -p "scripts"
+
+# 备份旧版本（如果存在）
+if [ -f "$BUILD_DIR/index.html" ]; then
+    echo -e "${YELLOW}[备份]${NC} 备份旧版本..."
+    BACKUP_DIR="build/backup/$(date +%Y%m%d_%H%M%S)"
+    mkdir -p "$BACKUP_DIR"
+    cp -r "$BUILD_DIR"/* "$BACKUP_DIR/" 2>/dev/null
+    echo "  备份位置: $BACKUP_DIR/"
+fi
+
+# 清理旧文件
+echo -e "${BLUE}[清理]${NC} 清理旧的导出文件..."
+rm -f "$BUILD_DIR"/*
+
+# 检查导出预设
+echo -e "${BLUE}[验证]${NC} 检查导出预设..."
+"$GODOT_PATH" --headless --export-debug "$EXPORT_PRESET" --check-only >/dev/null 2>&1
+if [ $? -ne 0 ]; then
+    echo -e "${RED}[错误]${NC} 导出预设 \"$EXPORT_PRESET\" 不存在或配置错误！"
+    echo "请在Godot编辑器中创建Web导出预设"
+    echo
+    exit 1
+fi
+
+# 导出项目
+echo -e "${GREEN}[导出]${NC} 开始导出Web版本..."
+echo "  目标文件: $BUILD_DIR/index.html"
+echo "  请稍候..."
+echo
+
+"$GODOT_PATH" --headless --export-release "$EXPORT_PRESET" "$BUILD_DIR/index.html"
+
+if [ $? -ne 0 ]; then
+    echo -e "${RED}[失败]${NC} 导出失败！"
+    echo
+    echo "可能的原因:"
+    echo "1. 导出模板未安装"
+    echo "2. 项目配置错误"
+    echo "3. 资源文件损坏"
+    echo
+    exit 1
+fi
+
+# 验证导出文件
+echo -e "${BLUE}[验证]${NC} 验证导出文件..."
+REQUIRED_FILES="index.html index.js index.wasm index.pck"
+MISSING_FILES=""
+
+for file in $REQUIRED_FILES; do
+    if [ ! -f "$BUILD_DIR/$file" ]; then
+        MISSING_FILES="$MISSING_FILES $file"
+    fi
+done
+
+if [ -n "$MISSING_FILES" ]; then
+    echo -e "${RED}[错误]${NC} 缺少必要文件:$MISSING_FILES"
+    echo "导出可能不完整，请检查Godot配置"
+    echo
+    exit 1
+fi
+
+# 复制额外资源
+echo -e "${BLUE}[复制]${NC} 复制额外资源..."
+[ -f "assets/web/favicon.ico" ] && cp "assets/web/favicon.ico" "$BUILD_DIR/"
+[ -f "assets/web/manifest.json" ] && cp "assets/web/manifest.json" "$BUILD_DIR/"
+[ -f "assets/web/service-worker.js" ] && cp "assets/web/service-worker.js" "$BUILD_DIR/"
+[ -f "assets/web/custom_shell.html" ] && cp "assets/web/custom_shell.html" "$BUILD_DIR/"
+
+# 生成部署信息
+echo -e "${BLUE}[生成]${NC} 生成部署信息..."
+cat > "$BUILD_DIR/deploy_info.json" << EOF
+{
+  "project": "$PROJECT_NAME",
+  "version": "$VERSION",
+  "build_time": "$(date)",
+  "platform": "web",
+  "godot_version": "4.5",
+  "export_preset": "$EXPORT_PRESET",
+  "build_machine": "$(hostname)",
+  "build_user": "$(whoami)",
+  "build_os": "$(uname -s)"
+}
+EOF
+
+# 生成.htaccess文件
+echo -e "${BLUE}[配置]${NC} 生成Apache配置文件..."
+cat > "$BUILD_DIR/.htaccess" << 'EOF'
+# 鲸鱼镇 Web版本 Apache配置
+# 自动生成
+
+# MIME类型配置
+AddType application/wasm .wasm
+AddType application/octet-stream .pck
+AddType application/javascript .js
+
+# 启用压缩
+<IfModule mod_deflate.c>
+    AddOutputFilterByType DEFLATE text/html text/css application/javascript application/wasm
+    AddOutputFilterByType DEFLATE application/json application/xml
+</IfModule>
+
+# 缓存控制
+<IfModule mod_expires.c>
+    ExpiresActive On
+    ExpiresByType application/wasm "access plus 1 month"
+    ExpiresByType application/octet-stream "access plus 1 month"
+    ExpiresByType application/javascript "access plus 1 week"
+    ExpiresByType text/html "access plus 1 hour"
+</IfModule>
+
+# CORS配置
+<IfModule mod_headers.c>
+    Header set Access-Control-Allow-Origin "*"
+    Header set Access-Control-Allow-Methods "GET, POST, PUT, DELETE, OPTIONS"
+    Header set Access-Control-Allow-Headers "Content-Type, Authorization"
+    Header set Cross-Origin-Embedder-Policy "require-corp"
+    Header set Cross-Origin-Opener-Policy "same-origin"
+</IfModule>
+EOF
+
+# 计算文件大小
+echo -e "${BLUE}[统计]${NC} 计算文件大小..."
+TOTAL_SIZE=$(du -sb "$BUILD_DIR" | cut -f1)
+TOTAL_MB=$((TOTAL_SIZE / 1024 / 1024))
+
+# 显示构建结果
+echo
+echo "========================================"
+echo -e "${GREEN}          导出成功！${NC}"
+echo "========================================"
+echo
+echo -e "${GREEN}[完成]${NC} 构建统计:"
+echo "  导出位置: $BUILD_DIR/"
+echo "  总文件大小: ${TOTAL_MB} MB"
+echo "  构建时间: $(date)"
+echo
+
+echo -e "${BLUE}[文件]${NC} 导出文件列表:"
+for file in "$BUILD_DIR"/*; do
+    if [ -f "$file" ]; then
+        filename=$(basename "$file")
+        size=$(stat -f%z "$file" 2>/dev/null || stat -c%s "$file" 2>/dev/null)
+        size_mb=$((size / 1024 / 1024))
+        if [ $size_mb -gt 0 ]; then
+            echo "  $filename: ${size_mb} MB"
+        else
+            size_kb=$((size / 1024))
+            echo "  $filename: ${size_kb} KB"
+        fi
+    fi
+done
+
+echo
+echo -e "${YELLOW}[下一步]${NC} 部署选项:"
+echo "  1. 本地测试: ./scripts/serve_web.sh"
+echo "  2. 上传到服务器: 将 $BUILD_DIR/ 目录上传"
+echo "  3. 查看文档: docs/web_deployment_guide.md"
+echo
+
+echo -e "${GREEN}[提示]${NC} 部署前请确保:"
+echo "  - 服务器支持WASM MIME类型"
+echo "  - 配置了正确的CORS头"
+echo "  - 启用了文件压缩"
+echo
+
+# 询问是否启动本地服务器
+echo -n "是否启动本地测试服务器？(y/N): "
+read -r START_SERVER
+if [[ $START_SERVER =~ ^[Yy]$ ]]; then
+    echo
+    echo -e "${GREEN}[启动]${NC} 启动本地服务器..."
+    ./scripts/serve_web.sh
+else
+    echo
+    echo "构建完成！可以手动运行 ./scripts/serve_web.sh 进行测试"
+fi

scripts/serve_web.bat

@@ -0,0 +1,173 @@
+@echo off
+setlocal enabledelayedexpansion
+
+echo ========================================
+echo     鲸鱼镇 本地Web服务器 v1.0
+echo ========================================
+echo.
+
+REM 配置变量
+set "BUILD_DIR=build\web"
+set "PORT=8000"
+set "FALLBACK_PORT=8080"
+
+REM 颜色代码
+set "RED=[91m"
+set "GREEN=[92m"
+set "YELLOW=[93m"
+set "BLUE=[94m"
+set "RESET=[0m"
+
+REM 检查导出文件
+echo %BLUE%[检查]%RESET% 验证Web导出文件...
+if not exist "%BUILD_DIR%\index.html" (
+    echo %RED%[错误]%RESET% 未找到Web导出文件！
+    echo.
+    echo 请先运行以下命令导出项目:
+    echo   scripts\build_web.bat
+    echo.
+    echo 或在Godot编辑器中导出Web版本到: %BUILD_DIR%\
+    echo.
+    pause
+    exit /b 1
+)
+
+REM 检查必要文件
+echo %BLUE%[验证]%RESET% 检查必要文件...
+set "REQUIRED_FILES=index.html index.js index.wasm index.pck"
+set "MISSING_FILES="
+
+for %%f in (%REQUIRED_FILES%) do (
+    if not exist "%BUILD_DIR%\%%f" (
+        set "MISSING_FILES=!MISSING_FILES! %%f"
+    )
+)
+
+if not "!MISSING_FILES!"=="" (
+    echo %RED%[错误]%RESET% 缺少必要文件:!MISSING_FILES!
+    echo 请重新导出项目
+    echo.
+    pause
+    exit /b 1
+)
+
+REM 检查Python
+echo %BLUE%[检查]%RESET% 验证Python环境...
+python --version >nul 2>&1
+if %ERRORLEVEL% neq 0 (
+    echo %RED%[错误]%RESET% 未找到Python！
+    echo.
+    echo 请安装Python 3.x:
+    echo   下载地址: https://python.org/downloads
+    echo   或使用包管理器: winget install Python.Python.3
+    echo.
+    echo 安装后请重启命令提示符
+    echo.
+    pause
+    exit /b 1
+)
+
+REM 获取Python版本
+for /f "tokens=2" %%i in ('python --version 2^>^&1') do set "PYTHON_VERSION=%%i"
+echo %GREEN%[信息]%RESET% Python版本: %PYTHON_VERSION%
+
+REM 显示文件信息
+echo.
+echo %GREEN%[信息]%RESET% Web文件统计:
+set "TOTAL_SIZE=0"
+for %%f in ("%BUILD_DIR%\*") do (
+    set "size=%%~zf"
+    set /a "TOTAL_SIZE+=size"
+    set /a "size_mb=size/1024/1024"
+    if !size_mb! gtr 0 (
+        echo   %%~nxf: !size_mb! MB
+    ) else (
+        set /a "size_kb=size/1024"
+        echo   %%~nxf: !size_kb! KB
+    )
+)
+set /a "TOTAL_MB=TOTAL_SIZE/1024/1024"
+echo   总大小: %TOTAL_MB% MB
+
+REM 检查端口占用
+echo.
+echo %BLUE%[网络]%RESET% 检查端口占用...
+netstat -an | find ":%PORT%" >nul 2>&1
+if %ERRORLEVEL% equ 0 (
+    echo %YELLOW%[警告]%RESET% 端口 %PORT% 已被占用，尝试使用 %FALLBACK_PORT%
+    set "PORT=%FALLBACK_PORT%"
+    
+    netstat -an | find ":%PORT%" >nul 2>&1
+    if %ERRORLEVEL% equ 0 (
+        echo %RED%[错误]%RESET% 端口 %PORT% 也被占用！
+        echo 请手动指定端口: python -m http.server [端口号]
+        echo.
+        pause
+        exit /b 1
+    )
+)
+
+REM 获取本机IP地址
+for /f "tokens=2 delims=:" %%i in ('ipconfig ^| find "IPv4"') do (
+    set "LOCAL_IP=%%i"
+    set "LOCAL_IP=!LOCAL_IP: =!"
+    goto :ip_found
+)
+:ip_found
+
+REM 显示启动信息
+echo.
+echo %GREEN%[启动]%RESET% 启动HTTP服务器...
+echo   端口: %PORT%
+echo   目录: %BUILD_DIR%
+echo   Python: %PYTHON_VERSION%
+echo.
+echo ========================================
+echo %GREEN%          访问地址%RESET%
+echo ========================================
+echo   本地访问: http://localhost:%PORT%
+echo   局域网访问: http://!LOCAL_IP!:%PORT%
+echo.
+echo %YELLOW%[控制]%RESET% 服务器控制:
+echo   停止服务器: Ctrl+C
+echo   重启服务器: 关闭后重新运行脚本
+echo.
+echo %BLUE%[调试]%RESET% 调试工具:
+echo   开发者工具: F12
+echo   控制台日志: 查看浏览器Console
+echo   网络请求: 查看Network标签
+echo.
+echo ========================================
+
+REM 尝试自动打开浏览器
+echo %BLUE%[浏览器]%RESET% 尝试打开默认浏览器...
+start http://localhost:%PORT% >nul 2>&1
+if %ERRORLEVEL% neq 0 (
+    echo %YELLOW%[提示]%RESET% 无法自动打开浏览器，请手动访问上述地址
+)
+
+echo.
+echo %GREEN%[就绪]%RESET% 服务器启动中...
+echo.
+
+REM 切换到构建目录并启动服务器
+cd "%BUILD_DIR%"
+
+REM 创建简单的服务器日志
+echo [%date% %time%] 服务器启动 - 端口:%PORT% >> server.log
+
+REM 启动Python HTTP服务器
+python -m http.server %PORT%
+
+REM 服务器停止后的清理
+echo.
+echo %YELLOW%[停止]%RESET% 服务器已停止
+echo [%date% %time%] 服务器停止 >> server.log
+
+REM 返回原目录
+cd ..\..
+
+echo.
+echo %GREEN%[完成]%RESET% 感谢使用鲸鱼镇Web服务器！
+echo.
+pause

scripts/serve_web.sh

@@ -0,0 +1,188 @@
+#!/bin/bash
+
+# 鲸鱼镇 本地Web服务器 (Linux/macOS)
+# 版本: 1.0.0
+
+# 颜色定义
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# 配置变量
+BUILD_DIR="build/web"
+PORT=8000
+FALLBACK_PORT=8080
+
+echo "========================================"
+echo "     鲸鱼镇 本地Web服务器 v1.0"
+echo "========================================"
+echo
+
+# 检查导出文件
+echo -e "${BLUE}[检查]${NC} 验证Web导出文件..."
+if [ ! -f "$BUILD_DIR/index.html" ]; then
+    echo -e "${RED}[错误]${NC} 未找到Web导出文件！"
+    echo
+    echo "请先运行以下命令导出项目:"
+    echo "  ./scripts/build_web.sh"
+    echo
+    echo "或在Godot编辑器中导出Web版本到: $BUILD_DIR/"
+    echo
+    exit 1
+fi
+
+# 检查必要文件
+echo -e "${BLUE}[验证]${NC} 检查必要文件..."
+REQUIRED_FILES="index.html index.js index.wasm index.pck"
+MISSING_FILES=""
+
+for file in $REQUIRED_FILES; do
+    if [ ! -f "$BUILD_DIR/$file" ]; then
+        MISSING_FILES="$MISSING_FILES $file"
+    fi
+done
+
+if [ -n "$MISSING_FILES" ]; then
+    echo -e "${RED}[错误]${NC} 缺少必要文件:$MISSING_FILES"
+    echo "请重新导出项目"
+    echo
+    exit 1
+fi
+
+# 检查Python
+echo -e "${BLUE}[检查]${NC} 验证Python环境..."
+if ! command -v python3 &> /dev/null && ! command -v python &> /dev/null; then
+    echo -e "${RED}[错误]${NC} 未找到Python！"
+    echo
+    echo "请安装Python 3.x:"
+    echo "  macOS: brew install python"
+    echo "  Ubuntu: sudo apt install python3"
+    echo "  或访问: https://python.org/downloads"
+    echo
+    exit 1
+fi
+
+# 确定Python命令
+PYTHON_CMD="python3"
+if ! command -v python3 &> /dev/null; then
+    PYTHON_CMD="python"
+fi
+
+# 获取Python版本
+PYTHON_VERSION=$($PYTHON_CMD --version 2>&1 | cut -d' ' -f2)
+echo -e "${GREEN}[信息]${NC} Python版本: $PYTHON_VERSION"
+
+# 显示文件信息
+echo
+echo -e "${GREEN}[信息]${NC} Web文件统计:"
+TOTAL_SIZE=$(du -sb "$BUILD_DIR" | cut -f1)
+TOTAL_MB=$((TOTAL_SIZE / 1024 / 1024))
+
+for file in "$BUILD_DIR"/*; do
+    if [ -f "$file" ]; then
+        filename=$(basename "$file")
+        size=$(stat -f%z "$file" 2>/dev/null || stat -c%s "$file" 2>/dev/null)
+        size_mb=$((size / 1024 / 1024))
+        if [ $size_mb -gt 0 ]; then
+            echo "  $filename: ${size_mb} MB"
+        else
+            size_kb=$((size / 1024))
+            echo "  $filename: ${size_kb} KB"
+        fi
+    fi
+done
+echo "  总大小: ${TOTAL_MB} MB"
+
+# 检查端口占用
+echo
+echo -e "${BLUE}[网络]${NC} 检查端口占用..."
+if lsof -Pi :$PORT -sTCP:LISTEN -t >/dev/null 2>&1; then
+    echo -e "${YELLOW}[警告]${NC} 端口 $PORT 已被占用，尝试使用 $FALLBACK_PORT"
+    PORT=$FALLBACK_PORT
+    
+    if lsof -Pi :$PORT -sTCP:LISTEN -t >/dev/null 2>&1; then
+        echo -e "${RED}[错误]${NC} 端口 $PORT 也被占用！"
+        echo "请手动指定端口: $PYTHON_CMD -m http.server [端口号]"
+        echo
+        exit 1
+    fi
+fi
+
+# 获取本机IP地址
+LOCAL_IP=$(ifconfig | grep -Eo 'inet (addr:)?([0-9]*\.){3}[0-9]*' | grep -Eo '([0-9]*\.){3}[0-9]*' | grep -v '127.0.0.1' | head -1)
+if [ -z "$LOCAL_IP" ]; then
+    LOCAL_IP=$(hostname -I | cut -d' ' -f1 2>/dev/null)
+fi
+if [ -z "$LOCAL_IP" ]; then
+    LOCAL_IP="localhost"
+fi
+
+# 显示启动信息
+echo
+echo -e "${GREEN}[启动]${NC} 启动HTTP服务器..."
+echo "  端口: $PORT"
+echo "  目录: $BUILD_DIR"
+echo "  Python: $PYTHON_VERSION"
+echo
+
+echo "========================================"
+echo -e "${GREEN}          访问地址${NC}"
+echo "========================================"
+echo "  本地访问: http://localhost:$PORT"
+echo "  局域网访问: http://$LOCAL_IP:$PORT"
+echo
+
+echo -e "${YELLOW}[控制]${NC} 服务器控制:"
+echo "  停止服务器: Ctrl+C"
+echo "  重启服务器: 关闭后重新运行脚本"
+echo
+
+echo -e "${BLUE}[调试]${NC} 调试工具:"
+echo "  开发者工具: F12"
+echo "  控制台日志: 查看浏览器Console"
+echo "  网络请求: 查看Network标签"
+echo
+
+echo "========================================"
+
+# 尝试自动打开浏览器
+echo -e "${BLUE}[浏览器]${NC} 尝试打开默认浏览器..."
+if command -v open &> /dev/null; then
+    # macOS
+    open "http://localhost:$PORT" 2>/dev/null
+elif command -v xdg-open &> /dev/null; then
+    # Linux
+    xdg-open "http://localhost:$PORT" 2>/dev/null
+else
+    echo -e "${YELLOW}[提示]${NC} 无法自动打开浏览器，请手动访问上述地址"
+fi
+
+echo
+echo -e "${GREEN}[就绪]${NC} 服务器启动中..."
+echo
+
+# 切换到构建目录并启动服务器
+cd "$BUILD_DIR"
+
+# 创建简单的服务器日志
+echo "[$(date)] 服务器启动 - 端口:$PORT" >> server.log
+
+# 设置信号处理
+trap 'echo -e "\n${YELLOW}[停止]${NC} 服务器已停止"; echo "[$(date)] 服务器停止" >> server.log; exit 0' INT
+
+# 启动Python HTTP服务器
+$PYTHON_CMD -m http.server $PORT
+
+# 服务器停止后的清理
+echo
+echo -e "${YELLOW}[停止]${NC} 服务器已停止"
+echo "[$(date)] 服务器停止" >> server.log
+
+# 返回原目录
+cd ../..
+
+echo
+echo -e "${GREEN}[完成]${NC} 感谢使用鲸鱼镇Web服务器！"
+echo