diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f5e993b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,48 @@
+# BotanicalBuddy
+
+基于 ESP-IDF 的植物助手项目，当前已集成 **Wi-Fi 配网组件（wifi-connect）**，支持手机连接设备热点后通过网页完成路由器配置。
+
+## 功能特性
+
+- 长按按键进入配网模式
+- 设备开启 SoftAP（`ESP32-xxxxxx`）+ Captive Portal
+- 手机访问 `http://192.168.4.1` 完成 Wi-Fi 配置
+- 支持清除已保存 Wi-Fi 参数并重新配网
+- 串口中文状态日志，便于调试和现场维护
+
+## 目录结构
+
+- `main/`：应用入口（`app_main`）
+- `components/wifi-connect/`：配网组件实现与文档
+  - `README.md`：组件说明
+  - `USER_GUIDE.md`：用户操作手册
+  - `QUICK_POSTER.md`：张贴版快速指引
+  - `BLOG.md`：博客草稿
+
+## 开发环境
+
+- Linux
+- ESP-IDF `v5.5.2`（建议）
+- Python 与 ESP-IDF 工具链按官方方式安装
+
+## 快速开始
+
+1. 配置并编译
+   - `idf.py set-target esp32`
+   - `idf.py build`
+2. 烧录并查看日志
+   - `idf.py -p /dev/ttyUSB0 flash monitor`
+3. 配网
+   - 长按设备按键进入配网模式
+   - 手机连接 `ESP32-xxxxxx`
+   - 打开 `http://192.168.4.1`
+   - 选择路由器并输入密码提交
+
+## 当前状态
+
+项目已完成第一版配网闭环：
+- 配网入口
+- 路由连接
+- 状态显示
+- 清除配置
+- 中文日志与文档
\ No newline at end of file