From 0b26d3d331ed15b354cd7b38064e38dc47228eac Mon Sep 17 00:00:00 2001
From: SoKingwah <peter446833245@gmail.com>
Date: Mon, 20 Apr 2026 02:28:51 +0800
Subject: [PATCH] =?UTF-8?q?docs(user-guide):=20=E6=B7=BB=E5=8A=A0=E6=9C=AC?=
 =?UTF-8?q?=E5=9C=B0=E9=A2=84=E8=A7=88=E6=96=B9=E5=BC=8F=E8=AF=B4=E6=98=8E?=
 =?UTF-8?q?=E5=92=8C=E5=90=AF=E5=8A=A8=E8=84=9A=E6=9C=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

解决 file:// 协议 CORS 限制问题：
- README 添加本地 HTTP 服务器启动说明
- 新增 start-server.bat 快捷启动脚本
---
 user-guide/README.md        | 19 +++++++++++++++++++
 user-guide/start-server.bat | 13 +++++++++++++
 2 files changed, 32 insertions(+)
 create mode 100644 user-guide/start-server.bat

diff --git a/user-guide/README.md b/user-guide/README.md
index fc6f7ed..05fa325 100644
--- a/user-guide/README.md
+++ b/user-guide/README.md
@@ -261,6 +261,25 @@
 - [演示h5_v1.html](演示h5_v1.html)
 - [演示h5_v2_iPhone16竖屏比例.html](演示h5_v2_iPhone16竖屏比例.html)
 
+### 本地预览方式
+
+由于浏览器安全限制（CORS 策略），直接双击打开 HTML 文件（`file://` 协议）会导致图片无法加载。
+
+**推荐方式：启动本地 HTTP 服务器**
+
+双击运行 `start-server.bat` 启动脚本，然后浏览器访问：
+
+```
+http://localhost:3000/user-guide/演示h5_v2_iPhone16竖屏比例.html
+```
+
+或命令行启动：
+
+```bash
+cd user-guide
+npx serve -l 3000
+```
+
 ---
 
 阿尼坊团队
\ No newline at end of file
diff --git a/user-guide/start-server.bat b/user-guide/start-server.bat
new file mode 100644
index 0000000..0cf01d8
--- /dev/null
+++ b/user-guide/start-server.bat
@@ -0,0 +1,13 @@
+@echo off
+chcp 65001 >nul
+echo ========================================
+echo   阿尼坊用户指南 - 本地服务器
+echo ========================================
+echo.
+echo 启动 HTTP 服务器...
+echo 访问地址: http://localhost:3000/user-guide/
+echo.
+echo 按 Ctrl+C 停止服务器
+echo ========================================
+cd /d "%~dp0"
+npx serve -l 3000
\ No newline at end of file