csyqlz/vozeb-pro

VOZEB PRO

面向统一创作 Agent、Canvas 与短剧生产的源码公开 AI 创作平台

演示站 · 文档索引 · 商业授权 · 参与贡献 · 更新记录

VOZEB PRO 把统一创作 Agent、画布、短剧生产、素材库和商业运营后台放在同一套 Next.js 全栈应用中。PostgreSQL 保存账号与业务数据；媒体可写入服务器本地目录或 S3 兼容对象存储；模型、支付和存储密钥只在服务端使用。

核心功能

• 统一创作 Agent：文字问答、图片、视频和音频在同一会话中完成，支持参考素材、首帧/首尾帧、Skill、智能规划、手动逻辑模型、比例/画质/时长/数量、自定义像素、多结果、历史恢复、失败重试、WebP 预览和原件下载。
• 画布：文本、图片、视频、音频与生成节点，支持拖拽、连线、缩放、撤销重做、导入导出和 Agent Run。
• 短剧生产线：剧本、内容审核、角色/场景/道具、分镜、镜头视频、配音、字幕、版本和 FFmpeg 合成。
• 作品广场：作品草稿、版本审核、发布分享、广场检索、作者主页、点赞关注、下架重发和内容治理。
• 模型与协议：管理员维护渠道、协议、真实模型、逻辑模型、能力、优先级和默认值，覆盖 OpenAI、Gemini、Seedance 2.0、Stable Diffusion、A1111/Forge 和声明式自定义协议。
• 持久生成：独立 Worker 负责图片、视频、音频和 Agent 任务续取，页面关闭或实例切换后继续查询原上游任务，并在生成运维中处理异常任务。
• 商业后台：用户、套餐、促销、优惠券、邀请奖励、积分、CDK、订单、支付、退款、对账、财务流水、作品治理、公告、提示词和审计日志。
• 存储与备份：本地媒体、S3 兼容对象存储、引用保护、对象迁移和脱敏业务数据导入导出。

许可证与商业使用

VOZEB-PRO 采用 Business Source License 1.1（BUSL-1.1）。许可证允许个人学习、非商业研究、开发测试、评估、代码审查和社区贡献。

企业生产部署、商业运营、SaaS 服务、私有化部署、向第三方提供服务、转售，或集成到收费平台，都必须先取得 VOZEB PRO 商业授权。完整使用边界见商业授权说明。

商业授权只包含软件使用权，不包含技术支持、部署、定制开发、运维、维护或 SLA 服务。完整协议参数见 LICENSE。

项目功能流程

所有流程图默认折叠，点击对应标题后即可查看，不会一次展示全部内容。

一条生成任务只调用一次上游创建接口，轮询只查询同一个任务。只有上游明确失败并且用户点击重试，才会创建新的 attempt，避免重复消耗额度。平台规划提示词、模型理由和复盘详情只用于内部执行，不显示或持久化到生成型对话。

完整目录职责、Agent、媒体、计费和部署说明见项目结构与流程。

最低服务器配置

VOZEB PRO 调用外部 AI 模型，不要求 GPU。服务器主要承担 Web、PostgreSQL、媒体下载/存储和可选 FFmpeg 转码。

最低环境还需要：64 位 Linux、Docker 与 Compose v2、PostgreSQL 16、可用域名和 HTTPS、能够访问模型上游的出站网络。源码开发或现场构建建议至少 2GB 内存，4GB 更稳妥；本地保存视频时请按实际媒体量扩大磁盘。完整说明见低内存服务器部署。

快速开始

安装过 0.0.2 的用户必须先删除旧数据库或数据库卷，再重新安装 0.0.7，并通过 /install 重新初始化数据库；不支持沿用旧数据库或原地升级。

Docker Compose

环境要求：可运行 Docker Compose 的 Linux 服务器、HTTPS 域名，以及按业务需要准备的模型渠道。

git clone https://github.com/csyqlz/VOZEB-PRO.git
cd VOZEB-PRO
cp .env.example .env

至少修改：

NEXT_PUBLIC_SITE_URL=https://vozeb-pro.example.com
POSTGRES_PASSWORD=replace-with-a-strong-password
VOZEB_PRO_ENCRYPTION_KEY=replace-with-openssl-rand-hex-32
VOZEB_PRO_INSTALL_TOKEN=replace-with-one-time-openssl-rand-hex-32
VOZEB_PRO_MAINTENANCE_TOKEN=replace-with-another-openssl-rand-hex-32
VOZEB_PRO_WORKER_TOKEN=replace-with-a-distinct-openssl-rand-hex-32

为四个变量分别执行一次下面的命令，并保存每次不同的输出。维护令牌与 Worker 令牌必须不同：

openssl rand -hex 32

写入 .env 后启动：

docker compose pull
docker compose up -d
docker compose ps

VOZEB_PRO_INSTALL_TOKEN 只用于初始化数据库和创建首个管理员，必须从服务器 .env 粘贴到安装向导；安装完成后可从环境变量中移除。VOZEB_PRO_MAINTENANCE_TOKEN 只授权外部计划维护任务，VOZEB_PRO_WORKER_TOKEN 只授权 App 与生成 Worker 的内部任务领取、心跳和回调。Worker 不读取包含数据库、支付、安装令牌或外部维护令牌的完整 .env。完整变量说明见配置说明。

打开 https://你的域名/install，依次检查数据库、初始化表结构并创建首个管理员。

宝塔 PostgreSQL

宝塔已安装 PostgreSQL 时使用：

docker compose -f docker-compose.baota.yml up -d

.env 中的数据库连接使用宿主机回环地址：

VOZEB_PRO_DATABASE_PROVIDER=postgres
DATABASE_URL=postgres://user:[email protected]:5432/vozeb_pro
VOZEB_PRO_DATABASE_SSL=0
VOZEB_PRO_TRUSTED_PROXY_HOPS=1

宝塔 Nginx 反向代理到应用后，应转发 Host、X-Forwarded-Host、X-Forwarded-Proto 和 X-Forwarded-For。详细步骤见生产上线基线和Docker 部署。

源码开发

环境要求：Node.js 22、pnpm 10+、PostgreSQL 16；短剧合成和本地转码还需要 FFmpeg。

cp .env.example web/.env.local
cd web
pnpm install --frozen-lockfile
pnpm run dev

访问 http://localhost:3000/install。文档站在 docs/ 中独立运行，并固定使用 http://localhost:3001，不会占用主应用的 3000 端口：

cd docs
pnpm install --frozen-lockfile
pnpm run dev

http://localhost:3000 必须显示 VOZEB PRO 主应用；如果看到“VOZEB PRO 文档中心”，说明启动的是 docs/ 子项目或旧版文档脚本，请停止该进程并从 web/ 启动主应用。独立文档站只使用 http://localhost:3001。

首次配置顺序

1. 在 /install 完成数据库初始化和首个管理员创建。
2. 在后台“模型渠道”按五步向导选择协议、配置连接、获取模型、同步逻辑模型并确认启用；无鉴权协议无需 API Key，未知上游可生成自定义协议草稿。
3. 设置默认逻辑模型，并在 /create 统一 Agent 中分别发起文本、图片、视频和音频真实业务请求验证。
4. 配置套餐、积分规则和可选支付渠道。
5. 配置 SMTP、注册策略、本地媒体或 S3 兼容对象存储。
6. 在“初始化配置”检查上线项，再验证真实生成、退款和备份恢复。

目录与文件用途

更完整的目录树、关键源码入口、Service、Route Handler、Repository 和任务 Store 职责见项目结构与流程。

页面展示

用户端、公开页和管理后台共 40 张功能截图见页面功能图册。

数据与安全

• PostgreSQL 保存用户、会话、设置、创作会话、Canvas、素材、短剧、生成任务、积分和订单。
• 外部存储关闭时新媒体只写 VOZEB_PRO_DATA_DIR；开启时新媒体只写 S3 兼容对象存储。历史媒体按登记 Provider 读取。
• 业务记录保存稳定站内 storageKey，不保存 base64、对象 Key 或临时签名 URL。
• .env、API Key、支付密钥、数据库、媒体文件、备份、日志和构建产物不得提交 Git。
• 生产备份必须同时覆盖 PostgreSQL 和本地媒体或对象存储，不能只备份其中一部分。

验证

cd web
pnpm test
pnpm run typecheck
pnpm run format:check
pnpm run build

cd ../docs
pnpm run types:check
pnpm run build

文档与协议

• 功能总览
• 目录与文件用途
• 配置说明
• 数据库结构
• 待测试
• 参与贡献
• 安全策略
• Business Source License 1.1
• 商业授权说明
• 许可证说明
• 商业授权协议模板
• 免责声明
• 授权与合规警示
• 贡献者协议

社区交流

致谢

• 感谢 LINUX DO 社区、相关提示词开源仓库、Codex / Claude Code 生态，以及项目使用的所有开源工具与基础设施。