OpenDroidChat

一款为 Android 6+ 设计的开源、轻量级 LLM API 聊天客户端

哇还有API额度浪费装置

简体中文 | English | 繁體中文

Important

OpenDroidChat正处于危机！访问并了解 KeepAndroidOpen[↗]，反对 Google 强制验证所有 Android 开发者的政策 —— 这破坏了 Android 的开放根基

Note

程序翻译尚不完善，如果您有能力进行 OpenDroidChat 项目的本土化，欢迎向我们发送 Pull Request。

🔨 技术栈

• Kotlin[↗] — 主要编程语言
• Jetpack Compose[↗] — 声明式 UI 框架
• Material Design 3 (M3)[↗] — 原生 GUI 设计实现
• Gradle[↗] — 构建工具
• Markwon[↗] — 用于渲染 LLM 消息中的 Markdown
• OkHttp[↗] — 高效、功能强大的 Java/Android HTTP 客户端。
• Ktor[↗] — 基于 Kotlin 协程的异步后端框架，支持多平台。

✨ 特性

• 支持 Android 6.0(API等级23) 及以上版本
• 系统原生、美观的 Material 3 Expressive 界面
• 支持 Markdown 消息渲染（代码块、标题、链接等）
• 轻量级，易于空间拮据的设备使用
• 可接入多种 LLM API
• 使用加密，保护用户LLM API Key
• 可启用模型思考，增加AI输出内容准确性

Note

预置的 LLM 提供商

• OpenAI / Azure OpenAI
• Google Gemini
• DeepSeek
• Dashscope (阿里云百炼)
• Claude

📥 安装

1. 从 Releases[↗] 下载APK 文件
2. (建议) 校验安装包完整性
3. 使用软件安装器安装

🛠️ 从源代码构建

确保已安装 Android Studio 或 Gradle。

Important

• 你可能需要使用 VPN 或代理来下载 Gradle 使用的外部资源。
• 你可能需要一台性能足够的计算机来完成编译。

🔧 基本构建（Debug 版本）

# 克隆仓库
git clone https://github.com/HOE-Team/OpenDroidChat.git
cd OpenDroidChat

# 使用 Gradle Wrapper 构建 Debug 版本
./gradlew assembleDebug    # Linux / macOS
gradlew.bat assembleDebug   # Windows

构建成功后，APK 位于 app/build/outputs/apk/。

如果要执行Release构建，请参阅 Release构建指南[↗]

📁 项目结构

project/
├─ app/                  # 源码
├─ docs/                 # 文档
├─ gradle/               # Gradle 配置
├─ build.gradle.kts      # 项目构建配置
├─ settings.gradle.kts   # Gradle 设置
├─ gradlew               # Gradle Wrapper (Linux / macOS)
├─ gradlew.bat           # Gradle Wrapper (Windows)
├─ LICENSE               # 许可证
├─ CODE_OF_CONDUCT.md    # 贡献者准则
└─ README.md             # 项目说明

🚀 使用方法

1. 打开应用
2. 添加一个实例
3. 选择你的大语言模型 API 提供商
4. 输入要使用的模型名称
5. 输入你的 LLM API Key
6. 输入你的LLM AppID（可选）
7. 配置一个人格（可选）
8. 开始聊天！

🤝 贡献

我们欢迎各种形式的贡献！请参阅 CODE_OF_CONDUCT.md[↗] 了解贡献者行为准则。

欢迎提交：

• 🐛 Issue - 报告错误或提出新功能建议
• 🔧 Pull Request - 直接贡献代码改进

💬 群组

欢迎加入OpenDroidChat Bug反馈/交流群，你可以在这里交流和反馈问题。
你可以通过搜索群号（887447099）的方式或者点击这里[↗]加入群聊。

如有任何疑问，请发送邮件到 hoe_software_team@outlook.com

🔧 开发人员内容

1. 如要构建 Release APK，请参阅 Release 版本构建指南 (简体中文)，如果已经熟悉了 Release 构建流程，可忽略此条提示。

2. OpenDroidChat 使用的 JKS 密钥文件指纹：
   请通过以下SHA-256指纹验证应用的真实性（您可通过keytool -list -v -keystore或APK分析工具比对）：

   • 旧证书指纹（已停用）： 06:F6:A5:21:94:DE:BD:85:71:9E:4F:AD:FB:0F:62:44:BA:07:D7:B3:B3:F0:76:16:E3:EA:AC:A4:1F:9F:10:2D
   • 新证书指纹（当前生效）： 4B:F3:B1:FF:B1:6B:1C:AB:CA:6C:C4:5B:DA:B0:84:4E:48:A9:EA:BC:0A:07:BC:36:CD:71:D0:8E:5A:E7:93:FB

📄 许可证

本项目基于 MIT License[↗] 开源。

Note

这份许可证意味着：

1. 你可以随意使用这个项目代码，无论是在个人项目还是商业项目中。
2. 你可以修改并重新发布这个代码。
3. 你甚至可以用它来开发商业软件并销售，只要你在你的产品中包含原始的 MIT 许可证文本和版权声明。
4. 作者不提供任何保证，如果使用该软件导致任何问题，你需要自己承担风险。

版权所有 © 2025-2026 HOE Team，保留所有权利。

Warning

著作权声明

OpenDroidChat Geometry 系列徽标为 HOE Team 所有，受法律保护。未经明确书面授权，不得用于商业用途或进行修改后使用。

旧式应用图标（OpenDroidChat Bugdroid-Say）由ChatGPT[↗]生成，使用CC BY-NC-SA协议开放

Note

由于HOE Team开发人员错误的Git操作，导致了安全问题的发生，现已重新创建仓库以消除安全问题，对各贡献者及开发者带来的不便还请谅解，HOE Team将在今后的开发中避免此类安全问题的再次发生。
因为仓库的重新创建，先前的Releases、Star、Commit和Issue记录都已不存在，对各位用户和支持者带来的困扰我们深感歉意。
注意：本项目已执行密钥轮换，您可能需要卸载后重新安装应用