Go to file
qmstyle 5fcb78176e 2025年4月6日14:39:48 2025-04-06 14:39:53 +08:00
src/main 2025年4月6日14:39:48 2025-04-06 14:39:53 +08:00
pom.xml 2025年4月3日18:13:53 2025-04-03 18:14:12 +08:00
readme.md 2025年4月3日18:13:53 2025-04-03 18:14:12 +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. 完善会话管理功能

使用指南

环境要求

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

安装步骤

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

基本使用

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

注意事项

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

反馈与支持

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

开源协议

MIT License