first commit

components/wifi-connect/USER_GUIDE.md

@@ -0,0 +1,82 @@
+# BotanicalBuddy 配网操作手册（用户版）
+
+> 适用对象：现场测试、家人用户、非开发人员  
+> 目标：让设备快速连上家里 Wi-Fi
+
+---
+
+## 1. 开始前准备
+
+- 手机已打开 Wi-Fi
+- 记住家里 Wi-Fi 名称和密码
+- 设备已上电
+
+---
+
+## 2. 进入配网模式
+
+有两种工作模式，请按项目配置使用：
+
+1. 按键触发模式：长按设备上的配网按键（约 2 秒）
+2. 常驻配网模式：设备上电后会自动开启配网
+3. 当看到“配网已启动”后，手机 Wi-Fi 列表会出现：`ESP32-xxxxxx`
+
+---
+
+## 3. 手机连接设备热点
+
+1. 在手机 Wi-Fi 中连接 `ESP32-xxxxxx`
+2. 若系统自动弹出页面，直接进入下一步
+3. 若没有自动弹出，手动打开浏览器输入：
+
+`http://192.168.4.1`
+
+> 注意：必须是 `http`，不要用 `https`
+
+---
+
+## 4. 选择路由器并提交
+
+1. 点击“扫描网络”
+2. 选择你家的 Wi-Fi
+3. 输入 Wi-Fi 密码
+4. 点击“连接”
+
+成功后页面会提示连接成功：
+
+- 按键触发模式：设备热点会在几秒后自动关闭（正常现象）
+- 常驻配网模式：设备热点保持开启（正常现象）
+
+---
+
+## 5. 成功后的现象
+
+- 设备不再广播 `ESP32-xxxxxx`
+- 串口会显示“联网成功，获取 IP=... ”
+- 设备进入正常工作状态
+
+---
+
+## 6. 常见问题
+
+### Q1：手机连上热点但打不开页面
+
+- 手动访问：`http://192.168.4.1`
+- 关闭手机“私人 DNS / 智能网络切换 / VPN”后重试
+- 确认没有强制跳 HTTPS
+
+### Q2：提示连接失败
+
+- 检查 Wi-Fi 密码是否正确
+- 确认路由器 2.4G 可用（ESP32-C3 使用 2.4G）
+- 路由器信号太弱时，靠近路由器后重试
+
+### Q3：配网成功后热点消失了
+
+- 这是正常设计：设备连上路由器后会自动关闭配网热点
+
+---
+
+## 7. 一句话速记
+
+长按按键 → 连 `ESP32-xxxxxx` → 打开 `http://192.168.4.1` → 选 Wi-Fi + 输密码 → 等待成功提示。