数据库说明

本文档只记录后端当前已经使用的主要数据表。

数据库

后端使用 GORM 管理数据库连接和表结构迁移。

支持的存储驱动：

• sqlite
• mysql
• postgresql

当前启动时执行 AutoMigrate，自动维护以下表：

• users
• credit_logs
• prompts
• assets
• asset_groups
• tob_assets
• settings
• video_generation_tasks
• image_generation_tasks

后续新增表时再同步补充本文档，未实际使用的规划表不提前写入。

users

系统用户表。用户基础信息、角色、算力点余额和第三方登录标识放在该表中。

prompts

提示词表。用于保存公开提示词、内置 GitHub 系统提示词、分类和预览内容。

github_url 仅用于接口返回，不写入数据库。

assets

素材表。当前用于后台素材库。

asset_groups

素材组表。云端素材分组管理，每个素材组关联一个上游素材组 ID。

tob_assets

云端素材表。保存通过上游素材管理服务创建的素材记录，含上游同步状态。

settings

系统配置表，只保存两行数据：public 放前端可读取的公开配置，private 放仅后端和管理员可读取的私有配置，配置值都用 JSON。

public.value 常放前端展示和可公开读取的配置，例如模型列表、登录开关等。
private.value 常放渠道密钥、登录密钥、后台内部开关等。

当前系统设置接口会按后端结构体序列化和反序列化已知字段；数据库 JSON 中额外存在的旧字段会被忽略。

public.value 当前字段：

modelChannel 当前字段：

modelCosts 每项字段：

auth.linuxDo 当前字段：

private.value 当前字段：

channels 每项字段：

promptSync 字段：

auth.linuxDo 当前字段：

后端请求模型时，先按模型名筛选启用且包含该模型的渠道，再按 weight 加权随机选择一个渠道。

credit_logs

用户算力点变更流水表。当前记录后台手动调整、模型调用预扣和模型调用失败返还。

type 当前取值：

video_generation_tasks

视频生成任务表。保存视频生成任务的元数据、上游任务 ID、状态、结果 URL、参数日志等；实际视频文件不保存在该表，而是保存到服务器磁盘或直接使用上游返回的远程 URL。

image_generation_tasks

图片生成任务表。保存图片生成任务的元数据、上游任务 ID、状态、结果引用、参数日志等；不保存图片文件或 base64 字节，result_urls 只保存上游返回的公网 URL 或前端回写的 storageKey。