Go to file
qmstyle d4d33f63a5 2025年4月21日15:14:10 2025-04-21 15:14:15 +08:00
src/main 2025年4月21日15:12:31 2025-04-21 15:12:45 +08:00
img.png 2025年4月21日15:14:10 2025-04-21 15:14:15 +08:00
pom.xml 2025年4月3日18:13:53 2025-04-03 18:14:12 +08:00
readme.md 2025年4月21日15:12:31 2025-04-21 15:12:45 +08:00

readme.md

AI 聊天客户端 (类 Deepseek)

项目简介

这是一个基于 JavaFX 开发的 AI 聊天客户端,通过 Ollama API 实现与多个 AI 模型的对话功能。本项目旨在提供一个简洁、易用、功能完善的 AI 聊天体验。

核心功能

1. 对话管理

  • 支持多轮对话,保持上下文连贯性
  • 会话历史记录的保存与加载
  • 支持创建多个独立会话
  • 支持会话分组管理

2. AI 模型支持

  • 选用ollama + spring ai
  • 显示模型响应状态和加载进度

3. 用户界面

  • 现代化的界面设计,支持亮色/暗色主题
  • 支持代码高亮显示
  • Markdown 格式渲染
  • 消息复制
  • 快捷键支持
  • 系统提示词System Prompt配置

快捷键

对话操作

  • Ctrl/Cmd + Enter: 发送消息
  • Ctrl/Cmd + N: 新建会话
  • Ctrl/Cmd + L: 清空当前会话
  • Ctrl/Cmd + C: 复制选中文本

界面操作

  • Ctrl/Cmd + T: 切换主题(亮色/暗色)

注:在 macOS 上,Ctrl 键对应 Command(⌘)

技术架构

前端JavaFX

  • 使用 JavaFX 17+ 构建用户界面
  • 采用 MVVM 架构模式
  • 使用 CSS 实现主题定制
  • 使用 WebView 支持 Markdown 渲染

后端集成

  • 集成 Ollama REST API
  • 实现异步通信,避免界面卡顿
  • 支持流式响应,实现打字机效果
  • 本地数据持久化存储

开发计划

第一阶段(基础功能)

  1. 搭建基础项目框架
  2. 实现基本的对话界面
  3. 完成 Ollama API 集成
  4. 实现会话管理功能

第二阶段(功能完善)

  1. 添加主题支持
  2. 实现代码高亮
  3. 添加多语言支持
  4. 完善会话管理功能

使用指南

环境要求

  1. Java 17 或更高版本
  2. Ollama 服务已安装并运行
  3. 系统内存建议 8GB 以上

安装步骤

  1. 下载最新版本安装包
  2. 运行安装程序
  3. 配置 Ollama 服务地址
  4. 开始使用

基本使用

  1. 创建新会话
  2. 选择 AI 模型
  3. 输入问题并发送
  4. 查看 AI 响应

注意事项

  • 请确保 Ollama 服务正常运行
  • 建议定期备份重要对话
  • 注意网络连接状态

由于许多成熟的客户端较多,暂时放弃对此项目的维护

反馈与支持

  • 问题反馈请提交 Issue
  • 功能建议欢迎提交 PR
  • 邮件支持:[待添加]

开源协议

MIT License