# chatgpt-java
**Repository Path**: hoppin/chatgpt-java
## Basic Information
- **Project Name**: chatgpt-java
- **Description**: OpenAI ChatGPT 的逆向工程SDK。可扩展用于聊天机器人等。demo展示http://hoppinzq.com/chat/index.html
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: http://hoppinzq.com/chat/index.html
- **GVP Project**: No
## Statistics
- **Stars**: 282
- **Forks**: 119
- **Created**: 2022-12-09
- **Last Updated**: 2025-10-11
## Categories & Tags
**Categories**: ai
**Tags**: None
## README
## Hi 👋
这里是hoppinzq，和他的小AI，然后这是一个演示项目，演示一些AI
## ✍️ 语言
## 🛠 技术栈和工具
| | 技术栈&中间件&工具 |
| -------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  |     |
|  |    |
|  |   |
|  |   |
|  |    |
## 🎤介绍
本项目是很多项目通过SpringHoppin框架集成的微服务版，算是一个Demo性质的项目，融合了注册中心、统一认证、网关、AI、博客、短视频、爬虫等一系列项目。
当然你可能只对AI感兴趣，我的意向也是这样。所以目前网站上只有关于AI的内容，AI的代码也是最完善的，其他待迁移。另外，你无需了解SpringHoppin是如何工作的。
前端框架使用Alpine和JQuery
> 👉 [Alpine的官方文档](https://www.alpinejs.cn/)
>
> 👉 [SpringHoppin文档](https://hoppinzq.com/springhoppinzq/doc.html)
## 📗目录结构
部分代码未迁移或者部分迁移，如需完整源代码（在我的私有仓库），请联系微信：zhangqiff19
项目有57个模块，AI是其中一个模块，如果你只想要AI模块，可联系我或者自行拆分（应尽可能保留注册中心模块、auth认证模块、file文件模块、gateway网关模块）
，本项目尽可能完善AI模块，但是AI模块对我来说并不是重点。目前我已经仅最大可能拆分了，想要让openai-app服务正常工作的话，需要的模块还是很多~
```text
/hoppin-ai [项目目录]
│
├─hoppinzq-center ------------------[注册中心模块，可以不启动]
├─hoppinzq-client ------------------[核心模块，SpringHoppin客户端依赖]
├─hoppinzq-common ------------------[核心模块，公共模块]
│─hoppinzq-gateway -------------------[核心模块，网关模块]
│─hoppinzq-html -------------------[前端页面，前后分离的]
│─hoppinzq-lucene -------------------[非核心模块，提供搜索引擎的能力]
│─hoppinzq-module-auth -------------------[核心模块，认证模块]
│─hoppinzq-module-auth-api -------------------[供外部服务调用认证模块的服务进行认证]
└─hoppinzq-module-auth-app -------------------[认证模块的具体实现代码]
│─hoppinzq-module-file -------------------[核心模块，文件模块]
│─hoppinzq-module-file-api -------------------[供外部服务调用]
└─hoppinzq-module-file-app -------------------[文件模块，集成了OSS、minio、ftp、ssh等文件操作能力]
│─hoppinzq-module-openai -------------------[AI模块，提供AI的能力]
│─hoppinzq-module-a2a -------------------[a2a模块]
│─hoppinzq-module-a2a-client -------------------[a2a的客户端模块]
│─hoppinzq-module-a2a-model -------------------[a2a model模块]
└─hoppinzq-module-a2a-server -------------------[a2a的服务端模块]
│─hoppinzq-module-langchain -------------------[langchain模块，没有代码]
│─hoppinzq-module-openai-model -------------------[hoppinAI模块model模块]
│─hoppinzq-module-openai-api -------------------[hoppinAI模块api模块]
│─hoppinzq-module-openai-app -------------------[hoppinAI模块具体代码]
│─hoppinzq-module-openai-core -------------------[hoppinAI核心模块]
└─hoppinzq-module-mcp -------------------[mcp模块]
│─hoppinzq-module-mcp-async-server -------------------[MCP Server异步]
│─hoppinzq-module-mcp-client -------------------[MCP客户端模块]
│─hoppinzq-module-mcp-server -------------------[MCP Server标准输入输出模块]
│─hoppinzq-module-mcp-server-sse -------------------[MCP Server SSE模块]
└─hoppinzq-module-mcp-spring-ai -------------------[基于springAI的MCP Server模块]
│─mcp-demo -------------------[演示用demo]
│─hoppinzq-module-spring-ai-mcp-client -------------------[springAI的MCP客户端模块]
│─hoppinzq-module-spring-ai-mcp-server -------------------[springAI的MCP Server 标准输入输出模块]
└─hoppinzq-module-spring-ai-mcp-server-sse -------------------[springAI的MCP Server 流式输出模块]
│─hoppinzq-mybatis -------------------[非核心模块，mybatis和拓展]
│─hoppinzq-redis -------------------[非核心模块，提供缓存的能力]
└─hoppinzq-service -------------------[核心模块，SpringHoppin服务端依赖]
```
## 💡如何启动
要启动ai模块，你最好先启动注册中心和认证中心，然后再启动ai模块。当然不启动会一直在报错，但不影响使用。
#### 1、执行sql文件里的脚本
#### 2、启动注册中心模块hoppinzq-center
#### 3、配置认证中心的数据源，启动认证中心hoppinzq-module-auth模块（可选）
#### 4、配置AI模块数据源，启动hoppinzq-module-openai-app模块
#### 5、打开zq-apps-chat.html即可
### 调用示例
```java
OpenAiService service=new OpenAiService("api-key",
Duration.ofSeconds(60),"OpenAI代理地址");
final List messages=new ArrayList<>();
final ChatMessage userMessage=new ChatMessage(ChatMessageRole.USER.value(),"你好AI");
messages.add(userMessage);
ChatCompletionRequest chatCompletionRequest=ChatCompletionRequest
.builder()
.model("gpt-4o-mini")
.messages(messages)
.n(1)
.build();
ChatCompletionResult chatCompletion=service.createChatCompletion(chatCompletionRequest);
```
## 💡如何部署
我们有一套自动的CI/CD流程，考虑到对你们并没有什么用，就都去掉了，反正把注册中心、认证中心、openai-app打这三个jar包就行了。配置文件你得配好。
## ✏️hoppinAI更新内容
- 添加了对functionCall的支持，支持动态调用Java代码
- 添加了对MCP Client的支持，支持调用注册的MCP Server
- 添加了ZSON，用于处理大模型返回不规范的json，不过有了FunctionCall后，并没什么用。适用于以下场景：
```text
1、非json数据：{"a":"acv","dd":"qwe"}希望对你有帮助
2、未闭合的json：{"a":{"b":[1,2,
3、多余的json：{{"name":"zhangsan"}}
4、单引号json：{'a':1,"v":"qwe"}
5、遗漏,json：{"name":"zhangsan""v":"qwe"}
6、多余,json：{"name":"zhangsan","v":"qwe",}
7、markdown的json：```json {"name":"zhangsan","v":"qwe"}```
8、用=代替冒号的json：{"name"="zhangsan","v"="qwe"}
9、丢失冒号的json：{"name" "zhangsan","v" "qwe"}
10、未加引号的json：{"name":zhangsan,"v":1}
11、中文符号的json：{“name”：“张三”}
12、带注释的json：{“name”：“张三”//这是name}
13、值缺失：[1,2,,3]
14、带有未转义的控制字符的json：{"name":"zhangsan","v":"qwe\n"}
```
- 所有openAI协议接口支持
- Deepseek 推理能力支持
- 增加了RAG知识库的支持
- 聊天页面重写
- 添加了计费接口和token工具类
- 封装hoppinai client端mcp调用的提示词
```text
你是一个有用的助手，可以使用一些工具来回答用户的问题，现在有这些工具：
工具1：
- 工具名称：search
- 工具描述：搜索相关内容
- 工具参数：
- search_content:
- 类型：string
- 描述：搜索的内容
- 是否必填：是
- search_type:
- 类型：string
- 描述：搜索内容的类型
- 默认值：music
- 是否必填：否
- 可选值：[music, website, other]
- search_num:
- 类型：integer
- 描述：搜索数目
- 默认值：10
- 最小值：1
- 最大值：30
- 是否必填：否
- 参数必填：[search_content]
- 参数示例：{"search_content":"周杰伦","search_type":"music"}
根据用户的问题选择合适的工具。如果不需要工具，请直接回复。
重要提示：当您需要使用工具时，您必须只使用以下确切的JSON对象格式进行响应，而不能使用其他格式：
{
"tool":"tool_name",
"arguments":{
"arguments_name"："value"
}
}
收到工具的响应后：
- 1、将原始数据转换为自然的对话式响应。
- 2、保持回答简洁但信息丰富
- 3、关注最相关的信息
- 4、使用用户问题中的适当上下文
- 5、永远不要用完全相同的参数重新进行之前的工具调用
请仅使用上面明确定义的工具。
```
- 其他更新，我忘了
## 📗文档
- [✖️你可能想了解✖️]()
- [1️⃣OpenAI文档](https://openai.apifox.cn/)
- [2️⃣MCP](https://hoppinzq.com/mcp/mcp.html)
- [3️⃣Ollama](https://ollama.com/)
- [😜其他]()
- [📗Embeddings：](https://hoppinzq.com/embedding/embedding.html)
- [🌹A2A](https://hoppinzq.com/a2a/a2a.html)
## 📷截图
#### 💦类似于百度搜索的实现，案例已经抓取了足够的链接供测试
#### 🌳特性
#### ▶️CSDN爬虫，可将指定的CSDN博客链接下的博客爬取出来内容
#### ㊙️东方project
#### 🆙bilibili 亁杯🍺
#### 📁爬虫配置
## 🎬反馈
> 🌷微信：zhangqiff19
## 😘感谢
[OpenAI](http://openai.com/)
[MCP](https://modelcontextprotocol.io/)
[Trae](https://www.trae.cn/)
[deepseek](https://chat.deepseek.com/)
[Cursor](https://modelcontextprotocol.io/)
[Cherry Studio](https://modelcontextprotocol.io/)
[腾讯云](https://cloud.tencent.com/)
## 📄License
MIT
### ❤️ GitHub Stats
[](https://gitee.com/hoppin/chatgpt-java)
[](https://gitee.com/hoppin/chatgpt-java)