{
    "installation": {
        "title": "安装与配置",
        "subtitle": "通过本指南，您将学会如何安装和配置 DeepTrans Studio 开发环境。",
        "prerequisites": {
            "title": "前置要求",
            "description": "在安装 DeepTrans Studio 之前，请确保已安装以下工具：",
            "items": [
                "Node.js ≥ 18.18（推荐使用 corepack 管理 Yarn 1.22.22）",
                "Yarn（通过 corepack enable 启用）",
                "Docker / Docker Compose（用于本地依赖服务或一键部署）",
                "Git 等常用工具"
            ]
        },
        "installDeps": {
            "title": "安装依赖",
            "description": "使用 corepack 管理 Yarn，然后安装项目依赖。",
            "commands": {
                "enableCorepack": "corepack enable",
                "prepareYarn": "corepack prepare yarn@1.22.22 --activate",
                "install": "yarn install"
            }
        },
        "envConfig": {
            "title": "配置环境变量",
            "description": "复制或创建 .env.local 并依据实际环境填写：",
            "note": "💡 生产环境使用腾讯云 COS 作为对象存储，PostgreSQL 18 + pgvector/PGroonga 作为记忆检索，Valkey 作为队列，并默认使用 MinerU 在线解析 PDF。",
            "example": "# 数据库与缓存\nDATABASE_URL=\"postgresql://postgres:123456@localhost:5432/deeptrans\"\nREDIS_URL=\"redis://valkey:6379\"\n\n# 鉴权 & 站点配置\nAUTH_SECRET=\"请生成随机字符串\"\nNEXTAUTH_URL=\"http://localhost:3000\"\nNODE_ENV=development\n\n# LLM / AI 服务\nOPENAI_API_KEY=\"sk-xxxx\"\nOPENAI_BASE_URL=\"https://api.openai.com/v1\"\nOPENAI_API_MODEL=\"gpt-4o-mini\"\n\n# 独立聊天/翻译 LLM 配置\n# LLM_API_KEY=\"sk-xxxx\"\n# LLM_BASE_URL=\"https://api.openai.com/v1\"\n# LLM_MODEL=\"gpt-4o-mini\"\n\n# Embedding 提供方\nOPENAI_EMBED_MODEL=doubao-embedding-text-240715\n# EMBEDDING_API_KEY=\"sk-xxxx\"\n# EMBEDDING_BASE_URL=\"https://api.openai.com/v1\"\n# EMBEDDING_API_PATH=\"/embeddings\"\n# EMBEDDING_MODEL=\"doubao-embedding-text-240715\"\n# EMBEDDING_DIMENSIONS=\n\n# MinerU 在线 PDF 解析\nMINERU_API_MODE=agent\nMINERU_AGENT_BASE_URL=https://mineru.net/api/v1/agent\nMINERU_API_BASE_URL=https://mineru.net/api/v4\n# MINERU_API_TOKEN=\"standard-or-precise-mode-token\"\nMINERU_MODEL_VERSION=vlm\nMINERU_LANGUAGE=ch\nMINERU_IS_OCR=false\nMINERU_ENABLE_TABLE=true\nMINERU_ENABLE_FORMULA=true\nMINERU_TIMEOUT_MS=300000\nMINERU_POLL_INTERVAL_MS=3000\n# MINERU_PAGE_RANGE=1-20\n# MINERU_DISABLE=false\n\n# 对象存储\n# 开发环境：MinIO\nSTORAGE_TYPE=minio\nSTORAGE_ENDPOINT=localhost\nSTORAGE_PORT=9000\nSTORAGE_USE_SSL=false\nSTORAGE_ACCESS_KEY=minioadmin\nSTORAGE_SECRET_KEY=minioadmin\nSTORAGE_BUCKET=deeptrans\n\n# 生产环境：腾讯云 COS\n# STORAGE_TYPE=cos\n# COS_SECRET_ID=AKIDxxxxxxxx\n# COS_SECRET_KEY=xxxxxxxx\n# COS_BUCKET=deeptrans-1250000000\n# COS_REGION=ap-guangzhou\n\n# 其他服务\nSTUDIO_HOST=localhost        # Traefik/HTTPS 部署时使用\n\n# 可选：SMTP、pgvector 访问信息等\n# EMAIL_SERVER=smtps://deeptrans_studio%40163.com:<163客户端授权码>@smtp.163.com:465\n# EMAIL_FROM=\"DeepTrans Studio <deeptrans_studio@163.com>\""
        },
        "initDb": {
            "title": "初始化数据库",
            "description": "执行数据库迁移并生成 Prisma Client。",
            "commands": {
                "migrate": "yarn prisma migrate deploy      # 或 yarn db:push 初始化结构",
                "generate": "yarn prisma generate            # 生成 Prisma Client",
                "seed": "yarn db:seed                    # 可选：导入示例数据"
            }
        },
        "startDev": {
            "title": "启动本地开发环境",
            "description": "启动依赖服务并运行 Next.js 开发服务器。",
            "step1": {
                "title": "启动依赖服务",
                "description": "推荐使用 Docker Compose 中的服务：",
                "command": "docker compose up -d db valkey minio\n# 开发环境本地使用 MinIO；生产环境使用腾讯云 COS，不启动 MinIO。"
            },
            "step2": {
                "title": "启动 Next.js 应用",
                "description": "启动开发服务器（支持热更新）：",
                "command": "yarn dev"
            },
            "step3": {
                "title": "启动 Worker 服务（可选）",
                "description": "若希望在本地 Node 环境运行 Worker，可执行：",
                "command": "yarn worker",
                "note": "Docker Compose 中对应服务为 app_worker。"
            },
            "access": {
                "title": "访问应用",
                "description": "访问 http://localhost:3000 即可进入 Studio；Prisma Studio 可通过 `yarn db:studio` 启动。"
            }
        },
        "dockerCompose": {
            "title": "使用 Docker Compose 运行",
            "description": "使用 Docker Compose 一键部署所有服务。",
            "step1": {
                "title": "准备环境变量",
                "description": "准备 .env / .env.production 并确保 STUDIO_HOST 指向对外域名。"
            },
            "step2": {
                "title": "构建镜像",
                "command": "docker compose build app app_worker"
            },
            "step3": {
                "title": "启动主要服务",
                "command": "docker compose up -d traefik app app_worker db valkey",
                "note": "Traefik 会将 80/443 端口映射到 Studio，Prisma Studio 可按需启动。"
            }
        },
        "nextSteps": {
            "title": "下一步",
            "description": "安装完成后，您可以：",
            "links": {
                "gettingStarted": "查看快速开始指南",
                "concepts": "了解核心概念",
                "workflows": "学习工作流程"
            }
        }
    }
}
