flomo-ai/flomo-ai

Flomo-AI Android 客户端

📱 项目简介

Flomo-AI 是一款基于 Android 平台的 AI 增强笔记应用客户端，专为移动端用户设计。该应用结合了现代化的 UI 设计和高效的笔记管理功能，并集成多种 AI 大模型实现智能标签生成，让用户能够随时随地记录灵感和重要信息。

🌟 主要特性

核心功能

• ✨ 智能标签生成 - 支持智谱AI (GLM-4-Flash) 和星火大模型，自动分析文章内容生成4个精准标签
• 📝 便捷笔记记录 - 快速创建和编辑笔记内容
• 🏷️ 一键添加标签 - 点击生成的标签即可快速添加到笔记中（#标签格式）
• 📤 云端同步 - 一键将笔记提交至 Flomo 服务器
• 🎨 个性化定制 - 支持自定义背景图片和状态栏主题颜色（红/绿/蓝/橙）
• 🔐 安全可靠 - 集成 JWT 认证和数据加密

技术亮点

• ⚡ 流畅体验 - 基于 Jetpack Compose 的响应式界面
• 🚀 高性能架构 - 使用 Kotlin 协程和现代异步编程
• 🌐 网络通信 - 集成 OkHttp、Retrofit、Moshi 进行高效数据传输
• 📦 模块化设计 - 清晰的代码结构和组件分离

🛠 技术栈

类别	技术
语言	Kotlin
框架	Android Jetpack, Jetpack Compose
网络	OkHttp, Retrofit
JSON	Moshi, Gson
安全	JWT, Nimbus JOSE JWT
异步	Kotlin Coroutines
UI	Material Design 3, Compose
构建	Gradle Kotlin DSL

📋 系统要求

• 最低 Android 版本: Android 9.0 (API Level 28)
• 目标 Android 版本: Android 14 (API Level 34)
• 开发环境: Android Studio
• 构建工具: Gradle 8.4+
• JDK 版本: Java 8+

🚀 快速开始

克隆项目

git clone http://124.223.26.33:3000/xiaji/flomo-ai.git
cd flomo-ai

构建项目

# 清理并构建
./gradlew clean build

# 构建 Debug 版本
./gradlew assembleDebug

# 构建 Release 版本
./gradlew assembleRelease

运行应用

# 连接设备后安装
./gradlew installDebug

📁 项目结构

flomo-ai/
├── app/
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/com/example/flomo_ai/
│   │   │   │   ├── MainActivity.kt      # 主界面（笔记输入+AI标签生成）
│   │   │   │   ├── SecondActivity.kt   # 配置界面（API管理+个性化设置）
│   │   │   │   ├── kwt.kt              # JWT认证工具类
│   │   │   │   └── ui/                 # UI 组件
│   │   │   ├── res/                    # 资源文件
│   │   │   └── AndroidManifest.xml     # 应用配置
│   │   └── build.gradle.kts            # 模块构建配置
├── gradle/                             # Gradle 配置
├── build.gradle.kts                    # 项目构建配置
└── README.md                           # 项目说明文档

🔧 配置说明

AI API 配置

应用支持配置多个 AI 服务商：

• 智谱AI (zhipu): 默认模型 glm-4-flash
• 星火大模型 (spark): 默认模型 general

每个配置包含：

• API 名称
• API URL
• API Key
• Secret Key
• 模型名称

个性化设置

• 背景图片: 支持从相册选择自定义背景
• 主题颜色: 支持红、绿、蓝、橙四种状态栏颜色

Gradle 配置优化

项目已配置国内镜像源以提升构建速度：

# gradle.properties
org.gradle.wrapper.downloadUrl=https://mirrors.aliyun.com/macports/distfiles/gradle/
org.gradle.internal.http.connectionTimeout=120000
org.gradle.internal.http.socketTimeout=120000

权限说明

应用需要以下权限：

• INTERNET: 网络通信
• READ_EXTERNAL_STORAGE: 读取外部存储（用于背景图片）

📸 应用截图

主界面	笔记页面	配置界面

🤝 贡献指南

欢迎提交 Issue 和 Pull Request 来改进项目！

开发流程

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

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

📞 联系方式

• 项目地址: http://124.223.26.33:3000/xiaji/flomo-ai.git
• 开发者: xiaji

---

Made with ❤️ for Android developers