开发者指南

快速开始

配置 OpenStory 本地开发环境

OpenStory 是一个开源 AI 视频制作平台。本指南将带你完成本地开发环境的配置。

前置要求

无需准备其他工具。不需要 Docker、外部数据库或 Cloudflare 账户——本地开发环境通过 Miniflare 在 Workerd 内运行完整技术栈(D1、R2、Workflows、Durable Objects 和邮件服务)。

快速启动

# Clone the repository
git clone https://github.com/openstory-so/openstory.git
cd openstory

# Install and run
bun install
bun dev

bun dev 会完成所有准备工作:首次运行时生成 .env.local(包含身份验证和加密密钥)、迁移本地数据库并填充种子数据,然后启动开发服务器。

应用将在 http://localhost:3000 上运行。

AI 密钥

要使用 AI 生成功能,你需要两个 API 密钥——运行 bun setup 以交互方式添加,或将它们粘贴到 .env.local:

  • FAL_KEY — 用于生成图像、视频和音频的 fal.ai 密钥
  • OPENROUTER_KEY — 用于 LLM 剧本分析的 OpenRouter 密钥

环境变量

可用环境变量的完整列表请参阅 .env.example,其中还包括 Google OAuth、Stripe、PostHog 和远程 R2 存储等可选服务。

数据库

本地开发通过 Drizzle ORM 使用 Cloudflare D1 数据库(由 Miniflare 支持的 SQLite),无需账户或远程服务。bun dev 会自动迁移数据库并填充种子数据。

# Generate migrations from schema changes
bun db:generate

# Apply migrations to the local D1 database
bun db:migrate:local

# Open Drizzle Studio against the local D1 database
bun db:studio:local

生产部署使用 Cloudflare D1。详情请参阅 Cloudflare 部署指南。

后续步骤