部署与运行
使用 Vercel、Docker Compose 或桌面本地后端运行 Scopify。
Scopify 将 Web、桌面客户端和后端分开管理。前端构建不依赖后端源码，只需要在运行时能够访问 NetEase API 服务。
Vercel：Web、Docs 与 API 分开部署
建议在 Vercel 中为不同应用独立建项：API 后端（如需部署云端服务）、Web 前端主应用以及 Docs 文档站。
API 项目
将 Root Directory 设置为：
repo/backend/api-enhanced如果需要限制跨域来源，在 API 项目中配置：
CORS_ALLOW_ORIGIN=https://scopify-web.vercel.app多个来源使用逗号分隔。未设置时，后端会根据请求 Origin 返回 CORS 响应。
Web 项目
| Vercel 设置 | 值 |
|---|---|
| Root Directory | repo/frontend/apps/web |
| Framework Preset | Next.js |
| Install Command | cd ../../../.. && pnpm install --frozen-lockfile && cd repo/frontend/apps/web |
| Build Command | 使用 Web 目录 vercel.json 中的配置（cd ../../../.. && pnpm run build:web && cd repo/frontend/apps/web） |
在 Web 项目中设置完整 API 根地址：
BACKEND_PUBLIC_URL=https://scopify-api.vercel.app地址不能包含路径、查询参数或哈希。该变量会在构建时写入浏览器配置，修改后需要重新部署。
Docs 项目
| Vercel 设置 | 值 |
|---|---|
| Root Directory | repo/frontend/apps/docs |
| Framework Preset | Next.js |
| Install Command | cd ../../../.. && pnpm install && cd repo/frontend/apps/docs |
| Build Command | cd ../../../.. && pnpm run build:docs && cd repo/frontend/apps/docs |
CLI 快捷部署命令
根目录配置了针对各前端应用的快捷部署脚本（需先安装 Vercel CLI 并执行 vercel login）：
# 部署至生产环境
pnpm run deploy:web
pnpm run deploy:docs
# 部署预览分支（Preview）
pnpm run deploy:web:preview
pnpm run deploy:docs:previewDocker Compose
Docker Compose 适用于本机、局域网和私有服务器：
git clone --recurse-submodules https://github.com/MT-SUPER-POWER/Scopify.git
cd Scopify
docker compose up -d --build默认地址：
- Web：
http://127.0.0.1:3000 - Backend：
http://127.0.0.1:3838
根目录 .env 可以覆盖端口和浏览器访问的后端地址：
FRONTEND_PORT=3000
BACKEND_PUBLIC_HOST=127.0.0.1
BACKEND_PUBLIC_PORT=3838其他设备访问服务器时，BACKEND_PUBLIC_HOST 必须使用服务器 IP 或域名，不能继续使用 127.0.0.1。
Electron 后端模式
桌面端支持两种模式：
| 模式 | 适用场景 |
|---|---|
| 内置本地后端 | 桌面端独立运行，后端随应用启动 |
| 独立远程后端 | 多端共享服务或连接已部署的 API |
本地后端启动策略保存在桌面配置中：
backend:
autoStart: true
port: 3838桌面端会检查端口占用并显示服务状态；设置中的 Ping 可以验证目标接口是否可访问。
单独运行后端
git submodule update --init --recursive repo/backend/api-enhanced
cd repo/backend/api-enhanced
docker build -t scopify-backend .
docker run -d --name scopify-backend -p 3838:3838 -e HOST=0.0.0.0 -e PORT=3838 scopify-backend完成部署后，可以在 OpenAPI 中查看接口，并使用文档请求面板验证服务响应。