# 数字人上传后端（Java）

**Repository Path**: Marthkoper/human-library

## Basic Information

- **Project Name**: 数字人上传后端（Java）
- **Description**: 该仓库为数字人后端（java），用来上传、分类数字人
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-02
- **Last Updated**: 2026-02-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Human Library 项目说明

本文档旨在帮助用户配置并启动 Human Library 项目。

## 1. 环境准备

在开始之前，请确保您的开发环境满足以下要求：

*   **JDK**: 1.8 或更高版本
*   **Maven**: 3.6 或更高版本 (如果需要编译)
*   **MySQL**: 5.7 或 8.0
*   **IDE**: IntelliJ IDEA (推荐，可选)

## 2. 数据库配置

### 2.1 导入 SQL 脚本

1.  找到项目根目录下的 `sql` 文件夹。
2.  在您的 MySQL 数据库中创建一个名为 `human-library` 的数据库（或者根据您的需求自定义名称）。
3.  执行 `sql/human-library.sql` 脚本以初始化表结构和数据。

## 3. 配置文件说明

项目的主要配置文件位于 `library/src/main/resources/application.yml`。无论您使用哪种方式启动，都需要关注以下配置项。

### 3.1 数据库连接

```yaml
spring:
  datasource:
    # 修改数据库地址和数据库名称
    url: jdbc:mysql://localhost:3306/human-library?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
    # 修改数据库用户名
    username: root
    # 修改数据库密码
    password: cfx2000
```

### 3.2 文件上传路径

```yaml
# 上传目录配置
upload:
  # 请确保此目录在您的电脑上存在，或者修改为您希望存储文件的路径
  base-dir: D:/heygem_data
  model-dir: face2face/temp
  audio-dir: voice/data/origin_audio
  thumbnail-dir: face2face/temp
```

> **注意**：请确保 `base-dir` 对应的文件夹已经创建。

## 4. 启动项目

您可以选择使用 IDE 启动（适合开发）或直接使用 Jar 包启动（适合部署或无 IDE 环境）。

### 方式一：使用 IntelliJ IDEA 启动

1.  使用 IntelliJ IDEA 打开项目。
2.  修改 `library/src/main/resources/application.yml` 中的配置（数据库、路径等）。
3.  等待 Maven 依赖下载完成。
4.  找到启动类：`library/src/main/java/org/chen/AppStart.java`。
5.  运行 `AppStart` 类的 `main` 方法。

### 方式二：使用 Jar 包启动 (无需 IDE)

如果您没有安装 IDE，可以直接使用项目提供的 Jar 包启动。

1.  **准备配置文件**：
    *   进入项目的 `jar` 文件夹。
    *   为了确保配置生效（如数据库密码、上传路径），建议在 `jar` 文件夹下创建一个名为 `application.yml` 的文件。
    *   将 `library/src/main/resources/application.yml` 的内容复制到这个新建的 `application.yml` 中，并根据您的环境进行修改。
    *   *注意：Spring Boot 会优先读取 Jar 包同级目录下的 `application.yml` 文件覆盖默认配置。*

2.  **启动命令**：
    *   打开命令行工具（CMD 或 PowerShell）。
    *   进入 `jar` 目录。
    *   执行以下命令启动服务：
        ```bash
        java -jar library-1.0.2.jar
        ```

## 5. 验证启动

项目启动成功后，您可以通过浏览器访问接口文档以验证服务是否正常运行：

*   地址: `http://localhost:2000/doc.html` (如果未修改端口)