AutoGPT 预览环境合成数据库种子说明

资源内容

AutoGPT 仓库提供一份滚动更新的预览数据库种子文件 fixture.dump.gz，并从开发分支构建，对应迁移头为 20261023120000_add_user_subscription_ended_at。该文件采用自定义格式并经过 gzip 压缩，只包含平台 schema（包括 _prisma_migrations）。

恢复流程

预览环境在运行某个 PR 自身的迁移之前，会先恢复该种子文件，使 schema 变更作用于已填充数据的表。恢复步骤如下：

1. 先对目标数据库执行 restore-preamble.sql。这一步会创建平台 schema，并在其中安装 vector 与 pg_trgm 扩展；pg_dump --schema=platform 不会包含这些内容。 2. 再执行 gunzip -c fixture.dump.gz | pg_restore -d <目标库> --no-owner，并且不要添加 --exit-on-error。原因是 dump 自带的 CREATE SCHEMA 会与前导脚本创建的 schema 冲突，但该冲突不会造成实际危害。

数据与安全限制

该种子文件不包含云凭证，也没有读取任何真实数据库的路径：它完全运行在一次性 Postgres 容器中，仅包含 Faker 生成的合成行，以及已公开的、签入 autogpt_platform/backend/agents/ 的市场 agent 导出数据。每次符合条件的开发推送和每周都会重新生成该资源，因此应将其视为可丢弃的文件。

需要注意，以上信息只覆盖该预览种子的构成与恢复方式，未涉及其他部署步骤或性能指标。