安装与配置
通过本指南，您将学会如何安装和配置 DeepTrans Studio 开发环境。
前置要求
在安装 DeepTrans Studio 之前，请确保已安装以下工具：
- Node.js ≥ 18.18（推荐使用 corepack 管理 Yarn 1.22.22）
- Yarn（通过 corepack enable 启用）
- Docker / Docker Compose（用于本地依赖服务或一键部署）
- Git 等常用工具
1
安装依赖
使用 corepack 管理 Yarn，然后安装项目依赖。
corepack enablecorepack prepare yarn@1.22.22 --activateyarn install2
配置环境变量
复制或创建 .env.local 并依据实际环境填写：
# 数据库与缓存
DATABASE_URL="postgresql://postgres:123456@localhost:5432/deeptrans"
REDIS_URL="redis://127.0.0.1:6379"
# 鉴权 & 站点配置
AUTH_SECRET="请生成随机字符串"
NEXTAUTH_URL="http://localhost:3000"
NODE_ENV=development
# LLM / AI 服务
OPENAI_API_KEY="sk-xxxx"
OPENAI_BASE_URL="https://api.openai.com/v1"
OPENAI_API_MODEL="gpt-4o-mini"
# 对象存储 & 资源
MINIO_ACCESS_KEY=minioadmin
MINIO_SECRET_KEY=minioadmin
MINIO_BUCKET=deeptrans
# 其他服务
STUDIO_HOST=localhost # Traefik/HTTPS 部署时使用
# 可选：GitHub OAuth、SMTP、Milvus 访问信息等💡 生产环境请将数据库、Redis、Milvus、对象存储改为专用实例，并妥善保管密钥。
3
初始化数据库
执行数据库迁移并生成 Prisma Client。
yarn prisma migrate deploy # 或 yarn db:push 初始化结构yarn prisma generate # 生成 Prisma Clientyarn db:seed # 可选：导入示例数据启动本地开发环境
启动依赖服务并运行 Next.js 开发服务器。
启动依赖服务
推荐使用 Docker Compose 中的服务：
docker compose up -d db redis etcd milvus minio pdfmath worker
# 如需 Attu UI 或 Traefik，请追加 attu traefik启动 Next.js 应用
启动开发服务器（支持热更新）：
yarn dev启动 Worker 服务（可选）
若希望在本地 Node 环境运行 Worker，可执行：
yarn dev:worker默认通过 compose 的 worker 容器运行。
访问应用
访问 http://localhost:3000 即可进入 Studio；Attu（Milvus UI）默认暴露在 http://localhost:8001。
使用 Docker Compose 运行
使用 Docker Compose 一键部署所有服务。
准备环境变量
准备 .env / .env.production 并确保 STUDIO_HOST 指向对外域名。
构建镜像
docker compose build studio worker pdfmath启动主要服务
docker compose up -d traefik studio workerTraefik 会将 80/443 端口映射到 Studio，Milvus/MinIO/Attu 等依赖组件可按需启动。