PlantPulse 🌱

天气 × 室内环境 × 植物状态 三维联动 的 AI 植物养护助手
根据实时天气动态调整浇水建议，告别「每隔 N 天浇一次」的机械提醒

核心特色：高湿度 / 雨天自动延长浇水间隔，并暂停施肥

✨ 核心亮点

• 三维联动决策：和风天气 + 室内温湿度 + 植物健康分 → 个性化浇水时机
• 天气主动推送：湿度 96% 时自动提醒减浇，对话内一键确认调整计划
• 自然语言零表单：说「我今天给尖尾芋浇水了」即可记录，8 步后处理自动入库
• AI 症状诊断：上传照片 + 结合室内外环境数据，给出初步判断与养护建议
• 植物识别：PlantNet 拍照识种，自动填充分类与养护计划
• 养护日历：月/周/日视图、周报/月报、计划与实际养护对照
• 智能相册：时间线记录植物生长，健康分与养护标签可追溯
• 长期记忆：跨会话记住植物清单、偏好与养护历史

📸 功能截图

控制台 · 天气与环境一览

天气联动 · 对话内推送与确认

浇水记录 · 结合当地天气给出风险提示

AI 诊断 · 上传照片 + 环境参考

植物库 · 智能相册时间线

拍照识种 · 自动生成养护计划

个性化养护计划 · 同步日历

养护日历 · 月视图

技术栈

层	技术
前端	Vue 3 + Vite + Element Plus
后端	FastAPI + LangChain + Pydantic
LLM	通义千问（阿里云 DashScope）
外部 API	PlantNet（植物识别）、和风天气（QWeather）
存储	SQLite + 设备目录 JSON（LTM、天气缓存）
定时任务	APScheduler

快速开始

1. 环境要求

• Node.js >= 16
• Python >= 3.8

2. 安装依赖

# 前端
cd frontend && npm install

# 后端
cd backend && pip install -r requirements.txt

3. 配置 API 密钥

在 backend 目录创建 .env 文件：

DASHSCOPE_API_KEY=your-dashscope-api-key
PLANTNET_API_KEY=your-plantnet-api-key
QWEATHER_API_KEY=your-qweather-api-key

获取 API 密钥：

• 通义千问：https://dashscope.console.aliyun.com/
• PlantNet：https://my.plantnet.org/
• 和风天气：https://dev.qweather.com/

4. 启动服务

# 后端（http://localhost:8000）
cd backend && python main.py

# 前端（http://localhost:5173）
cd frontend && npm run dev

Windows 也可使用根目录 start-all.bat 一键启动。

5. 访问应用

浏览器打开 http://localhost:5173

API 文档

启动后端后访问：

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

项目结构

PlantPulse/
├── frontend/src/          # Vue 3 前端
├── backend/
│   ├── routers/           # API 路由
│   ├── app_services/      # 业务服务层
│   ├── models/            # Pydantic 模型
│   └── data/              # SQLite + 设备记忆目录
├── data/assets/           # README 截图资源
└── README.md

注意事项

1. 需配置 API 密钥才能使用完整功能（LLM、识种、天气）
2. 结构化数据存于 SQLite，LTM 与天气缓存存于设备目录 JSON
3. 当前为本地部署模式，适合课程项目与个人使用

贡献

欢迎提交 Issue 和 Pull Request！

许可证

MIT License