# deepseek4j

**Repository Path**: git4chen/deepseek4j

## Basic Information

- **Project Name**: deepseek4j
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-07
- **Last Updated**: 2025-02-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: AI

## README

# DeepSeek4j Spring Boot Starter

[![Maven Central](https://img.shields.io/maven-central/v/io.github.pig-mesh.ai/deepseek4j.svg?style=flat-square)](https://maven.badges.herokuapp.com/maven-central/io.github.pig-mesh.ai/deepseek4j)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

DeepSeek4j Spring Boot Starter 是一个用于快速集成 DeepSeek AI 能力的 Spring Boot 启动器。它提供了简单的配置方式和易用的 API，让你能够在 Spring Boot 项目中轻松使用 DeepSeek 的 AI 功能。

## 特性

- 完整的 DeepSeek API 支持，支持返回思维链和会话账单
- 支持自定义连接参数、代理配置、超时设置、请求响应日志
- Reactor 响应式支持，简化流式返回开发
  
## 快速开始

### Maven 依赖

在你的 `pom.xml` 中添加以下依赖：

```xml
<dependency>
    <groupId>io.github.pig-mesh.ai</groupId>
    <artifactId>deepseek-spring-boot-starter</artifactId>
    <version>1.1.0</version>
</dependency>
```

### 基础配置

在 `application.yml` 或 `application.properties` 中添加必要的配置：

```yaml
deepseek:
  api-key: your-api-key-here
  base-url: https://api.deepseek.com  # 可选，默认为官方 API 地址
  log-requests: true  # 可选，是否记录请求日志
  log-responses: true  # 可选，是否记录响应日志
  # 可选的超时配置（单位：秒）
  connect-timeout: 10
  read-timeout: 30
  call-timeout: 60
  # 代理配置（可选）
  proxy:
    host: proxy.example.com
    port: 8080
  # 日志级别配置（可选）
  log-level: BASIC
```

### 1. 快速入门

```java
@Autowired
private DeepSeekClient deepSeekClient;

// sse 流式返回
@GetMapping(value = "/chat", produces = MediaType.TEXT_EVENT_STREAM_VALUE)
public Flux<ChatCompletionResponse> chat(String prompt) {
    return deepSeekClient.chatFluxCompletion(prompt);
}
```

### 2. 进阶配置

- ChatCompletionRequest 支持链式配置，包括模型选择、多轮会话、最大 Token、JSON 结构化输出、Function Tool 等
  
```java
// sse 流式返回
public Flux<ChatCompletionResponse> chat(String prompt) {
    ChatCompletionRequest request = ChatCompletionRequest.builder()
            // 模型选择，支持 DEEPSEEK_CHAT、DEEPSEEK_REASONER 等
            .model(ChatCompletionModel.DEEPSEEK_CHAT)
            // 添加用户消息
            .addUserMessage(prompt)
            // 添加助手消息，用于多轮对话
            .addAssistantMessage("上轮结果")
            // 添加系统消息，用于设置角色和行为
            .addSystemMessage("你是一个专业的助手")
            // 设置最大生成 token 数，默认 2048
            .maxTokens(1000)
            // 设置响应格式，支持 JSON 结构化输出
            .responseFormat()
            .tools() // function calling
            .build();

    return deepSeekClient.chatFluxCompletion(request);
}
```

### 3. 前端调试

双击运行根目录的 sse.html 文件，即可打开调试页面。在页面中输入后端 SSE 接口地址，点击发送后可实时查看推理过程和最终结果。页面提供了完整的前端实现代码，可作为集成参考。

<img src='https://minio.pigx.vip/oss/202502/1738864340.png' alt='1738864340'/>


## 配置说明

| 配置项 | 说明 | 默认值 |
|--------|------|---------|
| deepseek.api-key | DeepSeek API 密钥 | 必填 |
| deepseek.base-url | API 基础地址 | https://api.deepseek.com |
| deepseek.log-requests | 是否记录请求日志 | false |
| deepseek.log-responses | 是否记录响应日志 | false |
| deepseek.connect-timeout | 连接超时时间（秒） | 10 |
| deepseek.read-timeout | 读取超时时间（秒） | 30 |
| deepseek.call-timeout | 调用超时时间（秒） | 60 |
| deepseek.proxy.host | 代理服务器地址 | 无 |
| deepseek.proxy.port | 代理服务器端口 | 无 |
| deepseek.log-level | 日志级别（NONE/BASIC/HEADERS/BODY） | BASIC |

## 许可证与致谢

本项目基于 [Apache License 2.0](LICENSE) 许可证开源。

项目设计灵感来源于 [OpenAI4J](https://github.com/ai-for-java/openai4j) 项目，在其优秀架构设计的基础上：
- 扩展了 DeepSeek 特有功能
- 增强了 Reactor 响应式支持
- 提供了更完整的 Spring Boot 集成

## 相关链接

- [PIG AI ](https://ai.pig4cloud.com)
- [DeepSeek 官方文档](https://platform.deepseek.com)
- [OpenAI4J 项目](https://github.com/ai-for-java/openai4j)