Skip to content

About

一个轻量化、简洁、原生性能、deepseek风格的 Android AI 对话客户端。 A lightweight, minimalist Android AI chat client with native performance and a DeepSeek-style design.

Resources

Stars

18 stars

Watchers

0 watching

Forks

Repository files navigation

SimpleChat

使用 Jetpack Compose 构建的 Android AI 对话客户端,支持长对话、本地历史管理和内容导出。

中文 | English

Version License

简介

面向长文本连续创作的 Android 端 AI 对话客户端。接入任意 OpenAI 兼容端点,历史记录本地存储,无账号体系与云同步。启用文件 API 后,上传文件同时保存在所配置的服务端。

适用场景:

  • 长文本续写、设定推演、角色扮演
  • 多轮长会话,需要上下文占用管理与压缩
  • 自建或本地 OpenAI 兼容服务

目录

特性

  • 多服务端:任意 OpenAI 兼容端点,内置 DeepSeek 与 OpenCode Go 配置。
  • 双协议通道:DeepSeek 官方端点可走 Anthropic 兼容扩展通道(联网搜索 / 链接阅读 / 正文引用 / 服务端标题 / 时间地点提醒),其余端点走 OpenAI 兼容。两条并存,可手动锁定。
  • 智能搜索:deepseek_web_search。过程以时间线呈现(搜索 / 浏览网页 / 页内查找 / 阅读链接),正文带 [ⁿ] 引用角标,下方来源条与来源弹窗用同一套编号。
  • 流式输出:SSE 逐字渲染,Markdown 实时渲染,定稿前后像素级一致。
  • 思考区:reasoning_content 折叠展示,仅计真实思考时长,正文出现即收起(可关闭)。
  • 继续生成:被用户停止、或被输出上限截断的回复可以接着写(末尾 assistant 前缀续写)。
  • 数学公式:$…$ / \(…\) 与 Markdown 正文连续混排,$$…$$ / \[…\] 作为行间公式;使用 Compose 原生渲染。
  • 双击选字:双击 AI 回复进入原生文字选择,支持拖选、全选与复制;长按菜单入口继续保留。
  • Mermaid 图表:```mermaid 渲染成图,可切回源码;脚本随包发布,离线可用。
  • 朗读:系统 TTS 逐条朗读回复,无需服务端与权限;设置里可切换音色(含试听),朗读前会剥掉代码块与表格。
  • 自动朗读:顶栏新建对话左侧的喇叭开关,开启后朗读新完成的回复,关闭即停止;使用已选朗读音色。
  • API 配置管理:独立保存多组地址、模型、协议与加密 Key,支持新建、复制、重命名、删除和一键切换;修改自动保存,现有配置自动保留。
  • 独立搜索与文件 API:自定义地址、路径和加密密钥,或复用聊天密钥;兼容 DeepSeek Search / Fetch 与 Files 协议。
  • 长文本文件传输:启用文件 API 后,超过阈值的用户输入和文本附件上传一次并复用文件 ID,减少重复传输;本地保留原始消息。配置与限制见工具 API 指南。
  • 消息树:以 parentId 组织。重新生成为会话内分支,切换版本时下游整段跟随,不删除历史;长按支持会话间分叉。
  • 上下文管理:CJK 加权 token 估算、发送前预算校验、输入栏占用圆环、分层压缩与中断恢复(通常保留最近 6 条,超大近期内容至少保留最新一轮)。压缩时显示加载状态,完成后可查看和编辑摘要。
  • 附件:拍照、相册和文件三个入口;相册与文件支持多选,无需额外申请媒体读取权限。支持图片、纯文本、docx、PDF。 导入的图片字节落在应用私有目录,数据库只存文件名,超大消息采用分块读取; 实际容量受设备可用存储与内存影响。点图进入整屏查看,多图左右翻。
  • 图片发送前校验:按文件头判断真实格式,服务端不认的格式本地转码为 JPEG;坏图跳过并提示,不会让整个会话永远发不出去。
  • 模型能力适配:所选模型不支持图片时,发请求会跳过图片并提示,而不是被服务端拒绝。
  • 数据出口:JSON 备份、ZIP 归档(备份 + 每个会话的 Markdown 文稿)与 Markdown 文稿导出; 支持导出 DeepSeek v3 兼容备份,并附加保留原数据的 SimpleChat 扩展; 支持导入本应用备份、ZIP 归档、Chatbox 备份与 DeepSeek 官方导出 (deepseek_data-*.zip);导入方式可选增量 / 覆盖同名 / 同名新命名。导入结果逐项对账(归档几条 / 进来几条 / 哪条因为什么没进来),失败条目不会静默消失。
  • 多选分享:按问答组选择消息,导出长截图、分页图片或 Markdown,也可复制文本或使用系统分享。图片保留表格和数学公式。
  • 搜索:标题与正文全文搜索,结果行显示命中片段,可选择是否包含非当前分支。
  • 长消息:超 10 行自动收起,展开后整条可点。
  • 设置:在“外观”中管理主题、主题色和字体大小,在“对话行为”中管理思考折叠和搜索范围。
  • 多语言:界面、提示词与导出模板中英双语,设置内切换(跟随系统 / 简体中文 / English);排版按语种分档(中文两端对齐,西文左对齐)。

不包含

  • 客户端内容改写。请求原样送达所配置的服务端。
  • 客户端工具调用(服务端搜索工具已支持,但不执行本地函数)、TTS 语音克隆。
  • 自动备份、云同步、账号体系。
  • 依赖 Navigation、Hilt、Koin、Retrofit、Markwon、material-icons-extended。

快速开始

环境要求

  • JDK 17(Android Studio 自带 JBR 21 可用)
  • Android SDK platform 37、build-tools 37.0.0
  • Gradle 由 wrapper 自动下载

构建

git clone https://github.com/Pokanshuu/Simple-Chat.git
cd Simple-Chat
./gradlew assembleDebug

产物位于 app/build/outputs/apk/debug/。

Windows 下需显式指定 JDK:

$env:JAVA_HOME = "C:\Program Files\Android\Android Studio\jbr"
.\gradlew.bat assembleDebug

使用示例

  1. 安装并启动。
  2. 进入「设置 → API 配置」,选择服务商、填入 API Key,点击「测试连接」。
  3. 返回对话页,输入消息发送。

配置

API

项 说明 默认值 必填
服务商 DeepSeek / OpenCode Go / 自定义 DeepSeek 是
Base URL OpenAI 兼容端点地址 随服务商 是
模型 对话模型 deepseek-flash 是
API Key 服务端密钥,本地加密保存 无 是

构建

发布签名读取 keystore.properties(不入库):

storeFile=keystore/xxx.jks
storePassword=...
keyAlias=...
keyPassword=...

文件缺失时 assembleRelease 回退 debug 签名(不是未签名包)—— 保证 clone 下来的人也能把发版流程跑通。

开发

./gradlew testDebugUnitTest    # 单元测试
./gradlew assembleDebug        # debug 包,包名后缀 .debug
./gradlew assembleRelease      # release 包,需签名配置

单元测试覆盖纯函数与协议层,无需模拟器。

技术选型

项 版本
Gradle 9.7.1
AGP 9.4.1(内置 Kotlin)
Kotlin 2.4.10
KSP 2.3.12
Compose BOM 2026.09.00
compileSdk / targetSdk 37
minSdk 26(Android 8.0)
JVM 17
Room 2.8.5
OkHttp 5.5.0
kotlinx.serialization 1.11.0
DataStore 1.2.1

完整依赖清单见 gradle/libs.versions.toml。

项目结构

app/src/main/java/com/simplechat/app/
├─ data/          仓库层:会话粘合、备份导入导出、附件处理、Keystore 加解密、token 估算
│  └─ import/     Chatbox / DeepSeek 备份、docx 抽文本、图片尺寸
├─ db/            Room:实体、DAO、显式迁移、消息树纯函数
├─ net/           DTO、SSE 客户端与行解析、Provider 与模型能力表
└─ ui/
   ├─ chat/       对话页:消息列表、输入栏、各面板、编辑弹窗,以及纯函数(文本分块 / 请求组装 / 排序)
   ├─ history/    会话抽屉与全文搜索
   ├─ settings/   设置页(API 配置、数据管理、外观、关于)
   ├─ markdown/   Markdown 渲染与软换行修复
   ├─ common/     全应用唯一的控件与视觉 token(按钮、菜单、弹窗、图标、转场)
   └─ theme/      颜色、字体、形状

隐私与安全

  • API Key 以 Android Keystore 的 AES-256-GCM 保存密文,密钥按 UID 隔离。仓库不含任何 Key。
  • 请求从设备直连所配置端点,无第三方中转。
  • 数据库迁移使用显式 Migration,不使用 fallbackToDestructiveMigration。

文档

设计文档、实现记录与变更记录见 docs/README.md,代码注释中的 § 编号对应这些文档。历史记录保留当时的版本与验证边界;当前发布说明见 RELEASE_NOTES_v1.1.5.md。

相关入口:

  • TODO.md:当前状态与待办。

贡献

欢迎提 Issue 与 PR。请保持改动聚焦,提交前跑一遍 ./gradlew testDebugUnitTest。

许可证

基于 MIT 许可证开源。

About

一个轻量化、简洁、原生性能、deepseek风格的 Android AI 对话客户端。 A lightweight, minimalist Android AI chat client with native performance and a DeepSeek-style design.

Resources

Stars

18 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages