# hbotsdk

**Repository Path**: liul3/hbotsdk

## Basic Information

- **Project Name**: hbotsdk
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-11-23
- **Last Updated**: 2025-12-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# hbotsdk

HBotsdk 是一个集成了多种 OCR（光学字符识别）功能的 SDK，支持与 Hbot 服务进行交互，实现文件上传、聊天、会话管理等功能。本项目包含前后端代码，前端基于 Vue.js 实现，后端基于 Spring Boot 实现。

## 功能特性

- **OCR 支持**：支持多种 OCR 模式，包括通用 OCR、无布局提取、图表解析、图像描述、文本定位等。
- **文件处理**：支持文件上传、下载、删除等操作。
- **聊天功能**：支持流式聊天、同步聊天、完成请求等。
- **会话管理**：支持获取会话列表、消息列表、创建会话等。

## 技术栈

- **前端**：Vue.js、TypeScript、Vite
- **后端**：Spring Boot、Java 17、OkHttp
- **OCR 支持**：DeepSeek OCR、Paddle OCR

## 环境配置

### 前端

- Node.js 16+
- npm 或 yarn

### 后端

- Java 17+
- Maven

## 安装依赖

### 前端

```bash
cd hbotsdk-ui
npm install
```

### 后端

确保已安装 Maven，然后执行：

```bash
mvn clean install
```

## 开发模式

### 前端

```bash
npm run dev
```

### 后端

使用 IDE（如 IntelliJ IDEA）导入项目并运行 `BackendApplication.java`。

## 生产构建

### 前端

```bash
npm run build
```

### 后端

```bash
mvn clean package
```

## API 基础地址

- **DeepSeek OCR**：`/ds`
- **Paddle OCR**：`/pd`
- **白凌接口**：`/bailing`

## 使用说明

### OCR 功能

- **通用 OCR**：`POST /ds/ocr` 上传图片进行通用 OCR 识别。
- **无布局提取**：`POST /ds/ocr-free` 上传图片进行无布局 OCR 识别。
- **图表解析**：`POST /ds/ocr-figure` 上传图片解析图表内容。
- **图像描述**：`POST /ds/ocr-desc` 上传图片获取图像描述。
- **文本定位**：`POST /ds/ocr-locate` 上传图片并定位特定文字。

### 文件处理

- **上传文件**：`POST /bailing/upload-image-to-afts` 上传图片到 AFTS 服务。

### 聊天功能

- **流式聊天**：`POST /bailing/stream-chat-with-file` 支持单个文件上传的流式聊天。

### 会话管理

- **获取会话列表**：`GET /bailing/conversations` 获取会话列表。

## 项目结构

- **前端**：`hbotsdk-ui/`
- **后端**：`src/main/java/xyz/housailei/backend/`
- **配置文件**：`application.yml`
- **依赖管理**：`pom.xml`

## 贡献指南

欢迎贡献代码和文档。请遵循以下步骤：

1. Fork 项目
2. 创建新分支
3. 提交代码
4. 创建 Pull Request

## 许可证

本项目使用 MIT 许可证。详情请见 LICENSE 文件。