5 分钟首次建库向导

欢迎使用 Javdex！本篇教程将带领你在 5 分钟内，将电脑磁盘里的分散视频整理成一个井井有条、拥有完整封面和演员档案的影片资料库。

第 1 步：创建或配置你的第一个媒体库

安装并首次打开 Javdex 后，系统会自动为你准备一个名为“默认媒体库”的空白库。你也可以立即新建专属媒体库：

点击左侧边栏底部的 “设置” 图标，进入 “媒体库” 设置页。
在左侧媒体库列表中，点击 “+ 新建媒体库”：
- 媒体库名称：例如填写 我的影视库。
- 图标与颜色：为该库挑选一个专属的辨识徽标与颜色。
切换至 “来源目录” 标签页，点击 “添加目录”：
- 挑选存放影片的本地硬盘分区或网络共享文件夹（如 D:\Movies）。
- 系统会自动在选定目录下写入一个微小的 .javdex-root 标识文件，用于唯一追踪该目录的设备与挂载身份。
检查扫描配置：
- 自动合并同番号资源：默认为开启（同一番号的多个文件自动归入同一影片记录）。
- 最小时长过滤：默认为 30 分钟（避免误将样片或花絮当作正片入库）。
- 读取本地已有的 NFO：默认为开启（若此前用其他工具整理过，可直接复用现有 NFO 与海报）。

添加目录完成后，即可启动扫描：

在媒体库设置的“来源目录”页点击 “立即扫描”，或者直接在顶部导航栏点击 “扫描” 按钮。
扫描引擎自动处理逻辑：
- 智能识别 12 种主流视频文件及 .strm 流文件。
- 自动过滤 sample 样片、trailer 预告片与隐藏文件夹。
- 通过 11 级番号正则管线提取标准番号（如 SSIS-001, FC2-PPV-1234567）。
- 快速解析视频头部，跳过低于 30 分钟的短视频。
查看扫描结果与待办：
- 扫描完成后，无争议的影片会直接入库展示在“影片”列表。
- 若左侧边栏的 “待办中心 (/pending)” 出现了数字角标，说明扫描发现了需要人工确认的文件（如：文件名番号与同目录 NFO 番号不符，或同一番号存在归属冲突）。点击待办中心核对确认即可。

只有文件名的条目，需要通过“刮削（Scraping）”自动补充官方封面、剧情简介、发行日期、导演与出演演员：

选择刮削插件：
- 前往 “设置 -> 刮削插件”。Javdex 内置了 JavDB、JavLibrary、MetaTube（需自建服务）、Xslist 与 Gfriends（头像源）等插件。
- 若你的网络环境需要代理才能访问特定站点，请在 “设置 -> 网络” 中填入你的本地 HTTP 代理地址（如 http://127.0.0.1:7890）。
执行刮削：
- 单部刮削：进入任意一部未刮削影片的详情页，点击右上角的 “重新刮削” 按钮。
- 批量刮削：在影片列表中，按住键盘 Shift 键可连续勾选多部影片，或点击工具栏的“全选”，然后点击底部的 “刮削所选” 启动批量任务。
完成资料入库：
- 刮削成功后，影片海报、演职员信息、评分、标签与高清样张画廊将自动呈现。
- 演员头像会自动通过本地 MediaPipe 人脸检测算法进行智能构图居中裁切。

现在，你可以享受整理后的影片库了：

多维筛选与跨库搜索：
- 在列表页顶部工具栏，使用 “筛选” 弹出面板，快速筛选“已刮削 / 未刮削”、“含中文字幕 / 无字幕”、“本地视频 / STRM 流”以及自定义标签。
- 随时按下快捷键 Ctrl + K（Mac 上为 Cmd + K）唤起全局搜索，秒级检索任意番号、片名或演员。
在应用内直接播放：
- 点击影片封面上的播放按钮，或在详情页点击“播放”。
- 系统将唤起基于 libmpv 的原生渲染播放器，支持原画硬解、音轨切换、内嵌/外挂字幕加载与倍速播放。
- 点击播放器顶部的“收起”，播放器会无缝收缩为底部常驻的迷你画中画，你可以一边观看，一边继续在库中浏览其他作品。
（进阶）开启实时 AI 日中字幕：
- 观看生肉无字幕影片时，在播放器右侧设置抽屉中打开“AI 字幕”。
- 首次使用需在“设置 -> AI 服务 -> 本地模型”下载 Kotoba Whisper 与翻译大模型权重，之后即可在播放时全离线生成中日双语字幕！