docs: 更新文档 - H5 技术栈改为 uni-app，添加 tar.gz 部署规则

AGENTS.md

@@ -17,6 +17,7 @@
 
 - 后端：Rust + Axum
 - 前端：React + Arco Design Pro（React版）
+- H5用户端：uni-app + Vue 3 + Pinia（跨平台，支持 H5 / 微信小程序）
 - 数据库：MySQL（阿里云RDS），开发/生产共用
 - 缓存：Redis（阿里云Redis），开发/生产共用
 - 设备通讯：TCP长连接（柜控板4G模块，Air780E Cat.1）
@@ -37,7 +38,7 @@ D:\charging-cabinet\
 ├── software/
 │   ├── api-server/     # Rust API服务
 │   ├── device-server/  # Rust TCP设备服务
-│   ├── h5/             # H5用户端（移动端）
+│   ├── h5-uniapp/      # H5用户端（uni-app + Vue 3）
 │   └── web/            # React前端（WEB管理端）
 ├── hardware/           # 硬件资料（原理图/PCB等）
 └── test/               # 测试用例/报告
@@ -58,8 +59,8 @@ D:\charging-cabinet\
 
 **部署路径：**
 - 产品介绍页：/data/landing
-- 正式环境：/data/pms（api-server、device-server、web）
+- 正式环境：/data/pms（api-server、device-server、web、h5）
-- 测试环境：/data/pms_dev（api-server、device-server、web）
+- 测试环境：/data/pms_dev（api-server、device-server、web、h5）
 
 **Nginx配置：**
 - 正式: /etc/nginx/conf.d/app.anzhizhichong.com.conf
@@ -242,11 +243,27 @@ server {
         proxy_set_header X-Forwarded-Proto $scheme;
     }
 
+    # PMS管理前端 - 不带斜杠时重定向
+    location = /pms {
+        return 301 /pms/;
+    }
+
     # PMS管理前端
     location /pms/ {
         alias /data/pms/web/;
         try_files $uri $uri/ /pms/index.html;
     }
+
+    # H5用户端 - 不带斜杠时重定向
+    location = /h5 {
+        return 301 /h5/;
+    }
+
+    # H5用户端
+    location /h5/ {
+        alias /data/pms/h5/;
+        try_files $uri $uri/ /h5/index.html;
+    }
 }
 ```
 
@@ -281,6 +298,12 @@ server {
     location /pms/ {
         try_files $uri $uri/ /pms/index.html;
     }
+
+    # H5用户端
+    location /h5/ {
+        alias /data/pms_dev/h5/;
+        try_files $uri $uri/ /h5/index.html;
+    }
 }
 ```
 
@@ -315,8 +338,16 @@ scp software/device-server/target/release/device-server root@118.31.119.206:/dat
 # 传输前端静态文件
 scp -r software/web/dist/* root@118.31.119.206:/data/pms_dev/web/  # 测试环境
 scp -r software/web/dist/* root@118.31.119.206:/data/pms/web/  # 正式环境
+
+# 传输H5用户端（tar.gz打包方式，保留UTF-8编码）
+cd software/h5-uniapp/dist/build/h5
+tar -czf /tmp/h5-build.tar.gz .
+pscp -pw "Hbhyg731024@" /tmp/h5-build.tar.gz root@118.31.119.206:/tmp/
+plink -ssh -pw "Hbhyg731024@" root@118.31.119.206 "rm -rf /data/pms/h5/* && cd /data/pms/h5 && tar -xzf /tmp/h5-build.tar.gz"
 ```
 
+> ⚠️ H5部署必须用tar.gz打包方式，不要用plink/pscp管道传单文件（会丢失UTF-8编码导致中文变问号）。
+
 **3. 服务器重启服务**
 ```bash
 # SSH到服务器
@@ -366,7 +397,7 @@ tail -f /var/log/nginx/error.log
 
 ### 不做
 
-- 微信小程序（名额暂不可用，先用H5）
+- 微信小程序（名额暂不可用，先用H5，uni-app可后续转换）
 - 支付/计费（本系统不涉及）
 
 ## 组织架构

README.md

@@ -10,7 +10,7 @@
 
 - **后端**：Rust + Axum
 - **前端**：React + Arco Design Pro（管理端）
-- **H5用户端**：Taro + React（跨平台，支持 H5 / 微信小程序）
+- **H5用户端**：uni-app + Vue 3（跨平台，支持 H5 / 微信小程序）
 - **数据库**：MySQL（阿里云RDS）
 - **缓存**：Redis（阿里云Redis）
 - **设备通讯**：TCP长连接（柜控板4G模块，Air780E Cat.1）
@@ -25,7 +25,7 @@ charging-cabinet/
 │   ├── api-server/     # Rust API服务
 │   ├── device-server/  # Rust TCP设备服务
 │   ├── web/            # React管理端前端
-│   └── h5-taro/        # H5用户端（Taro + React）
+│   └── h5-uniapp/      # H5用户端（uni-app + Vue 3）
 ├── hardware/           # 硬件资料（原理图/PCB等）
 ├── deploy/             # 部署配置
 └── test/               # 测试用例/报告