app-template/app/docs/guide/quick-start.md

快速上手

目标：几分钟内跑起来，登录进去看到界面。

你需要什么

• Node.js 22 以上
• Yarn 4（用 Corepack 打开就行）
• 不用装数据库软件，默认用本地 SQLite 文件

四步跑起来

1. 装依赖

corepack enable
yarn install

2. 准备配置

cp .env.example .env

本地开发一般不用改什么。TURSO_DATABASE_URL 默认就是 file:local.db，数据存在当前目录。

如果要挂网盘，还需要一个密钥（用来加密你保存的网盘密码）：

openssl rand -hex 32

把结果填进 .env 的 MEDIA_SECRET_KEY。

3. 建库、建管理员

yarn db:push
yarn db:seed

db:seed 会建一个管理员：admin / admin123。上线前记得改密码。

4. 启动

yarn dev:web

打开 http://localhost:4321，走中文入口在 /zh-CN，英文在 /en。

登录后你应该能看到这些页面：

• 媒体库：你的片子
• 浏览：网盘里的文件夹
• 挂载：管理网盘连接
• 弹幕：弹幕开关和样式
• 播放：点开视频后的页面

接下来干什么

1. 把网盘挂上来
2. 找个视频播一下
3. 想要整齐的片单就扫进媒体库

常用命令

命令	干什么
yarn dev:web	开发模式跑主应用（4321 端口）
yarn build:web	打包主应用
yarn docs:dev	本地预览这份文档
yarn typecheck	检查类型
yarn lint	检查代码风格