# comic-gen

**Repository Path**: zpekii/comic-gen

## Basic Information

- **Project Name**: comic-gen
- **Description**: 七牛云-2025校招第二批项目实战-议题一
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-20
- **Last Updated**: 2025-10-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# comic-gen

> 发布地址: https://comicgen.0orz.top:6443
>

## 软件架构

### 技术选型

| 层级   | 技术/架构           |
| ------ | ------------------- |
| 前端   | Svelte + SvelteKit  |
| 后端   | Go + go-zero + gorm |
| 数据库 | Postgresql          |
| 容器化 | Docker              |
| CI/CD  | gitee go            |

### 模块设计

| 模块名称         | 说明                                              |
| ---------------- | ------------------------------------------------- |
| 漫画生成处理模块 | 主要根据请求参数完成工作流API的调用，并将结果返回 |
| 漫画管理模块     | 主要内容是漫画分享、标记/取消喜欢                 |
| 用户管理模块     | 为用户创建唯一标识，并返回会话token用于鉴权       |

### API 接口设计

具体可查看[doc/API.html](doc/API.html)

### 数据库表设计

具体可查看[doc/数据库表设计.md](doc/数据库表设计.md)

## 安装教程

### 数据库表创建

在已部署的`Postgresql`数据库上执行[doc/schema.sql](doc/schema.sql)SQL文件以创建所需要的表

### 前端

进入前端目录

```sh
cd ./fe
```

执行安装依赖

```sh
npm install
```

执行构建静态网站

```sh
npm run build
```

执行预览

```sh
npm run preview
```

### 后端

进入后端目录

```sh
cd ./be
```

安装依赖

```sh
go mod tidy
```

进入 API 服务目录

```sh
cd ./comicgen
```

创建配置目录`etc`及配置文件`comicgen-api.yaml`,并填写配置内容,以下是参考示例:

> `coze`工作流官网: https://www.coze.cn (PS: 工作流大模型节点采用**非Agent调用**，纯LLM提示词输入和文本输出)
>
> 配置工作流流程:
>
> 1. 访问 `coze`官网，进行注册/登录
> 2. 左侧导航栏点击"资源库",然后在顶部栏选择"工作流"
> 3. 接着导入项目根目录`doc/workflow`下的工作流压缩包
> 4. 导入成功后,点击进入工作流，然后再点击右上角进行发布
> 5. 发布成功后，点击在发布按钮右边的三个点按钮展开更多操作，点击里面的"API"playground调试进入调试页面，在页面中找到并拷贝工作流ID至下方配置文件内容中的指定项中
> 6. 返回上一级页面，在左侧导航栏点击"API管理"，顶部栏点击"授权",接着在二级顶部栏点击"个人访问令牌"
> 7. 点击"添加"按钮进行创建API Token,填写必要信息后,在下方权限配置中勾选上"工作流"
> 8. 添加成功后，将 API Token 拷贝到下方配置文件内容中指定项

```yaml
Name: comicgen-api
Host: 0.0.0.0
Port: 8888
AIWorkflow:
  AccessToken: "{这里填入 coze 的账号token}"
  WorkflowURL: "https://api.coze.cn"
  WorkflowID: "{这里填入 coze 工作流ID}"
DB:
  Postgres:
    Host: "{根据实际情况填写}"
    Port: 5432
    User: "{根据实际情况填写}"
    Password: "{根据实际情况填写}"
    DBName: "{根据实际情况填写}"
    sslmode: "disable"
    TimeZone: "Asia/Shanghai"
```

编译服务程序

Liunx:

```sh
go build -o comicgen
```

Windows:

```
go build -o comicgen.exe
```

配置文件内容填写无误后执行运行

Linux:

```sh
./comicgen
```

Windows:

```
./comicgen.exe
```

运行成功后，将输出:

```
Starting server at 0.0.0.0:8888...
```



前后端部署完毕后, 在浏览器地址栏输入: http://localhost:8180 即可访问应用