milmil入门
首次设置
安装后 — 注册账户，然后添加并扫描你的第一个媒体库。
milmil 启动后，你需要完成三个简短的任务才能开始观看：在注册向导中创建管理员账户，然后在主界面添加并扫描第一个媒体库。只有第一个任务是引导式向导 — 后两个步骤是在「媒体库」区域执行的常规操作。
创建管理员账户
首次打开 milmil 时，应用会自动跳转到 /setup 页面。这是一个单屏注册向导。
输入用户名和强密码并提交。milmil 将创建管理员账户并直接登录。目前只支持一个管理员账户 — 之后可在设置中另行创建普通用户。
请设置强密码。在没有数据库访问权限的情况下，无法找回密码。
跳过 UI： 你可通过环境变量自动配置管理员账户。在首次启动前，在 api/.env 中设置 ADMIN_USER 和 ADMIN_PASSWORD。若用户表为空，milmil 将在启动时自动创建管理员账户，向导随后会直接跳转到登录页。首次启动后请删除这两个变量，以免密码明文遗留在磁盘上。
添加第一个媒体库
注册后你将进入主页。此步骤没有应用内向导 — 需要手动添加媒体库：
- 从侧边栏打开「媒体库」。
- 点击「添加媒体库」。
- 填写表单（存储后端 + 路径或连接信息）并保存。
milmil 支持多种存储后端：
最简单的方式 — 提供动画文件夹的路径：
/media/anime如果使用 Docker，此路径须与容器卷挂载一致（例如，若 .env 中的 MEDIA_DIR 指向宿主机上的动画文件夹，则容器内挂载路径应为 /media/anime）。
扫描媒体库
新建的媒体库保存后不会自动扫描。要触发首次扫描：
- 打开「媒体库」页面。
- 点击进入刚添加的媒体库。
- 点击「扫描」。
（或等待已配置的自动扫描间隔触发。）
扫描流程：
- 遍历目录树，发现媒体文件
- 使用 FFmpeg 提取元数据（编码格式、分辨率、时长、字幕）
- 通过 DandanPlay、Bangumi 和 AniList 将文件匹配到动画条目
- 用封面图、标题和简介丰富剧集信息
大型媒体库的首次扫描可能需要数分钟。进度会在 UI 中实时显示。
元数据匹配
milmil 使用多提供商匹配流水线：
- DandanPlay 哈希 — 最精确，通过文件哈希匹配
- Bangumi — 基于 Bangumi 数据库的标题匹配
- AniList — 备选标题匹配
- TMDB — 兜底交叉参照
未匹配的文件可在媒体库详情页手动匹配。