去哪鸭 QuackTrip 🦆

基于Flutter的智能旅游规划AI助手

English | 简体中文

去哪鸭 QuackTrip 是一个基于Flutter开发的智能旅游规划助手，集成了AI对话、旅行管理、景点收藏、花费追踪等功能。通过AI助手帮助用户规划旅行路线、查询天气、管理行程，让旅行更加轻松愉快！

这是一个开源项目，欢迎所有开发者参与贡献和学习。

• 🤖 AI旅游助手 - 5个专业AI助手（旅游规划师、美食顾问、文化讲解员等）
• 🗺️ 旅行管理 - 完整的旅行计划CRUD（创建、查看、编辑、删除）
• 🏞️ 景点收藏 - 景点分类管理，标记已访问状态
• 💰 花费追踪 - 记录旅行花费，自动统计预算使用情况
• 📋 行程规划 - 按天排列的行程表，时间地点详细记录
• 🌤️ 天气查询 - 集成和风天气API，查询实时天气和3天预报
• 💨 空气质量 - 查询城市AQI、PM2.5等空气质量指标
• 🎨 小黄鸭主题 - 可爱的黄色主题，明暗模式自适应
• 📱 跨平台 - 支持Android、iOS、Windows、macOS等

• 框架: Flutter 3.8+
• 语言: Dart
• 数据库: SQLite（旅游数据） + Hive（聊天记录）
• 状态管理: Provider
• UI设计: Material Design 3
• 动画: flutter_animate
• 第三方API:
  • 和风天气 API
  • 高德地图 API（待集成）
  • 百度翻译 API（待集成）

git clone https://github.com/yjyrichard/QuackTrip.git
cd QuackTrip

flutter pub get

重要：本项目使用第三方API，需要自行申请API Key

1. 复制示例文件：

   cp lib/secrets/api_keys.dart.example lib/secrets/api_keys.dart

2. 编辑 lib/secrets/api_keys.dart，填入你的API Keys：

class ApiKeys {
  /// 和风天气 API Key
  /// 申请地址：https://dev.qweather.com/
  static const String qweather = 'YOUR_QWEATHER_KEY';

  /// 高德地图 API Key
  /// 申请地址：https://lbs.amap.com/
  static const String amap = 'YOUR_AMAP_KEY';

  /// 百度翻译 API Key
  /// 申请地址：https://fanyi-api.baidu.com/
  static const String baiduTranslateAppId = 'YOUR_APPID';
  static const String baiduTranslateKey = 'YOUR_KEY';
}

API申请指南：

注意：

• api_keys.dart 已在 .gitignore 中忽略，不会被提交到Git
• 请勿将你的API Key泄露到公开仓库

# Android
flutter run

# iOS
flutter run -d ios

# Web
flutter run -d chrome

# Windows
flutter run -d windows

# Android APK (Release)
flutter build apk --release

# Android App Bundle
flutter build appbundle --release

# iOS (需要macOS + Xcode)
flutter build ios --release

QuackTrip/
├── lib/
│   ├── core/                    # 核心功能
│   │   ├── models/              # 数据模型（Trip, Attraction, Expense等）
│   │   ├── services/            # 服务层
│   │   │   ├── travel_database_service.dart  # SQLite数据库
│   │   │   ├── auth_service.dart             # 用户认证
│   │   │   └── travel_tools_service.dart     # 旅游工具API
│   │   └── providers/           # 状态管理
│   ├── features/                # 功能模块
│   │   ├── auth/                # 认证模块（登录、注册）
│   │   ├── trips/               # 旅行管理
│   │   ├── attractions/         # 景点管理
│   │   ├── tools/               # 工具测试页面
│   │   └── settings/            # 设置页面
│   ├── secrets/                 # 密钥配置（不提交到Git）
│   │   ├── api_keys.dart        # API Keys（需自己创建）
│   │   └── api_keys.dart.example # API Keys示例
│   └── main.dart                # 应用入口
├── assets/                      # 资源文件
│   └── QuacktripLogo.png        # 应用图标
├── android/                     # Android配置
├── ios/                         # iOS配置
├── .gitignore                   # Git忽略文件
├── pubspec.yaml                 # Flutter依赖配置
└── README.md                    # 本文件

• 本地账户注册/登录
• SHA256密码加密
• SharedPreferences持久化

• 创建旅行计划（目的地、日期、预算）
• 旅行状态管理（计划中、进行中、已完成）
• 编辑/删除旅行

• 6种景点分类（风景名胜、博物馆、餐厅等）
• 标记已访问/未访问
• 关联到旅行计划

• 6种花费分类（交通、餐饮、住宿等）
• 自动计算总花费
• 预算使用进度条

• 按天排列的行程表
• 时间、地点、活动详细记录

• 5个旅游主题AI助手
• 支持多模型（OpenAI、Claude、Gemini等）
• 聊天记录持久化

• 🌤️ 天气查询（和风天气API）
• 💨 空气质量查询
• 🕐 本地时间
• 🗺️ 地图搜索（待集成）
• 🌐 翻译功能（待集成）

待添加

欢迎所有形式的贡献！包括但不限于：

• 🐛 提交Bug报告
• 💡 提出新功能建议
• 📝 改进文档
• 🔧 提交代码修复
• 🎨 UI/UX设计优化

贡献流程：

1. Fork本仓库
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 提交Pull Request

本项目采用 AGPL-3.0 License 开源协议。

详见 LICENSE 文件。

• 2025-11-08: 完成旅行管理模块、景点管理、花费追踪完整CRUD
• 2025-11-07: 完成品牌升级、底部导航、AI助手预设
• 2025-11-06: 完成基础设施搭建（SQLite数据库、认证系统、小黄鸭主题）

详见 当前进度.md

• 感谢 Kelivo 项目提供的基础架构
• 感谢和风天气提供的免费API
• 感谢所有为Flutter生态做出贡献的开发者

• 项目地址: https://github.com/yjyrichard/QuackTrip
• 问题反馈: GitHub Issues
• 开发者: 杨佳宇（学号：23251109209）
• 课程: 移动应用开发（期末作业）

QuackTrip is an intelligent travel planning assistant built with Flutter, featuring AI chat, trip management, attraction bookmarking, expense tracking, and more. With AI assistants, users can plan travel routes, check weather, and manage itineraries effortlessly!

This is an open-source project, welcoming all developers to contribute and learn.

• 🤖 AI Travel Assistants - 5 specialized AI assistants (travel planner, food advisor, culture guide, etc.)
• 🗺️ Trip Management - Complete CRUD for travel plans
• 🏞️ Attraction Bookmarks - Categorized attractions with visit status
• 💰 Expense Tracking - Record expenses with automatic budget calculation
• 📋 Itinerary Planning - Day-by-day schedules with detailed time and location
• 🌤️ Weather Query - Real-time weather and 3-day forecast (QWeather API)
• 💨 Air Quality - City AQI, PM2.5 indicators
• 🎨 Duck Theme - Cute yellow theme with dark mode support
• 📱 Cross-platform - Android, iOS, Windows, macOS support

git clone https://github.com/yjyrichard/QuackTrip.git
cd QuackTrip

flutter pub get

Important: This project uses third-party APIs. You need to apply for your own API keys.

1. Copy example file:

   cp lib/secrets/api_keys.dart.example lib/secrets/api_keys.dart

2. Edit lib/secrets/api_keys.dart with your API keys:

class ApiKeys {
  static const String qweather = 'YOUR_QWEATHER_KEY';
  static const String amap = 'YOUR_AMAP_KEY';
  static const String baiduTranslateAppId = 'YOUR_APPID';
  static const String baiduTranslateKey = 'YOUR_KEY';
}

API Application Guide:

Note: api_keys.dart is ignored in .gitignore and won't be committed.

flutter run

# Android APK
flutter build apk --release

# iOS (requires macOS + Xcode)
flutter build ios --release

Contributions are welcome! Including:

• 🐛 Bug reports
• 💡 Feature suggestions
• 📝 Documentation improvements
• 🔧 Code fixes
• 🎨 UI/UX optimizations

This project is licensed under the AGPL-3.0 License. See LICENSE file for details.

• Project URL: https://github.com/yjyrichard/QuackTrip
• Issues: GitHub Issues
• Developer: Yang Jiayu (Student ID: 23251109209)