100 lines
2.2 KiB
Markdown
100 lines
2.2 KiB
Markdown
|
# 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
|
|||
|
|
|