刮削与整理

手动刮削：提交、查看与处理结果

1. 进入“手动刮削”，填写文件或目录路径；Docker 使用“浏览容器路径”，Windows 本机可使用文件选择器。
2. 选定刮削预设，点击“启动 JavSP”。选择目录时，先等待扫描完成，找到的影片会陆续出现在任务队列中。
3. 在任务队列查看状态、扫描数量和阶段进度。支持按状态、关键词、大小和时间筛选，并分页查看。
4. 打开“详情”，先看最终结果，再展开数据源和图片日志。单个爬虫失败不代表整个任务失败；以最终是否取得必需资料并完成整理为准。

什么时候重试，什么时候处理文件？

• 只有图片失败：在任务详情中重试图片；封面还可从任务详情发起搜索、选择候选或上传，不必反复创建整部影片任务。
• 资料错误：在详情中编辑影片资料并保存；需要同步媒体库时按提示刷新。先核对番号与来源，避免把错误资料写回。
• 整理目标冲突：检查已有输出文件或剧照目录是否属于完整入库或未完成残留；不要把“删除任务记录”当作清理输出。
• 停止和删除：运行中的任务先停止再删除。删除记录不会自动撤销整理；可用的“还原”操作依赖该任务保存的整理记录与实际文件状态。

封面墙与隐私模式

在“概览 → 我的媒体库”按封面浏览已刮削的影片。同一影片的任务会合并显示，可搜索番号、片名或女优，按刮削时间或发行时间排序、分页浏览，也可批量删除记录。这里展示的是刮削记录中的影片，不会自动扫描整个磁盘。

打开“隐私模式”后，封面墙、详情海报和剧照会模糊显示，刷新页面后仍然生效。开关保存在当前浏览器，不影响磁盘上的图片和 Emby / Jellyfin 中的显示。

影片评论

打开影片详情即可查看同番号的公开评论。点击右上角头像进入“个人中心”，设置用户名和 6 位数字 PIN，即可创建匿名评论身份，无需邮箱或第三方账号。用户名不区分大小写，公开显示为“用户名#四位标识”；同名但 PIN 不同的用户会有不同的标识。

点击个人头像上的铅笔更换头像。弹窗支持按女优名字搜索，头像去除黑边后居中裁切。普通评论直接发布，疑似广告进入待审核，命中禁用词会提示修改。个人中心可查看自己的待审核、已发布和已隐藏评论。

在其他设备的个人中心选择“登录已有身份”，输入相同的用户名和 PIN，即可恢复头像与评论记录。请妥善记住 PIN，遗忘后无法找回。JavSP 的登录账号与评论身份分别管理；同一组用户名和 PIN 会被视为同一人，请勿分享。

评论支持点赞和取消点赞，每个评论身份只计一次。创建或登录评论身份、发表评论、点赞和举报时，会显示 Cloudflare 安全验证窗口，请按提示完成验证。验证过期、验证失败或无法连接时，不会提交操作；服务端还会限制操作频率。修改头像后，新评论使用新头像，旧评论保留发表时的头像。

评论由独立的 Cloudflare Workers + D1 服务处理和保存，Ubuntu 后台支持表格搜索、排序、多选、过滤设置和举报处理。删除的评论进入回收站，默认 30 天后自动清理，保留期内可以恢复。打开详情时，浏览器只向评论服务查询当前番号，不会上传影片文件、封面、文件路径或 JavSP WEB 登录信息。创建或登录评论身份时，用户名和 PIN 通过 HTTPS 交给评论服务验证；PIN 不保存也不公开。JavSP 只保存登录凭据与公开资料。发表评论时会发送评论内容和评论凭据，公开署名由服务端确定；服务使用 IP 的不可逆摘要限制频繁提交。

默认接口为 https://comments.rtioo.com。需要自行部署时，可用环境变量 JAVSP_COMMENTS_URL 指定其他评论服务；设为空字符串并重启可关闭评论区。Docker 修改环境变量后需重新创建容器。评论服务暂时无法访问时，不影响浏览影片和刮削。

“手动刮削”适合跟踪当前队列。任务日志摘要可复制，详细调试日志见排错章节。

挂载盘、STRM 与分 P 文件

CloudDrive2、WebDAV 等挂载目录仍按普通路径提交；先确保服务端能列出目录，Docker 内能通过挂载路径读到文件。目录枚举慢时查看扫描任务，避免连续点击启动创建重复扫描。

• 取消慢扫描：点击“停止扫描”停止后续任务创建；挂载盘响应慢时，停止操作也可能需要等待。已经加入队列的影片任务需分别停止。
• STRM：预设默认最小匹配大小为 232MiB。STRM 是很小的文本文件，可在“扫描器”勾选“STRM 忽略最小文件大小”，其他视频仍遵守大小限制。
• 分 P：同番号的 ABC-123-1.mp4、ABC-123-2.mp4 可作为分段识别。分段编号必须明确且不重复；一个目录里的广告视频不能因为共同目录名而被当作分 P。
• 批量选择：本机文件选择器支持一次多选。多选后手动修改路径会取消原多选列表。Docker 当前浏览器选择目录或单文件，不上传本地影片。

广告混入时优先检查“影片分类”规则，并启用“仅扫描匹配影片分类”。先试扫少量文件，确认广告被排除、正常影片仍能识别。

刮削预设：识别规则、来源与整理方式

管理员可在“刮削预设”新建、编辑和删除预设，选择可视化表单或完整 config.yml。修改并保存后，新任务会使用新设置；已经创建的任务仍使用原设置。

分类为什么会影响数据源？

高优先级规则先匹配。正则需包含 (?P<avid>...)，avid_format 决定生成的番号。分类 ID 与“爬虫”中的来源列表对应；例如自定义“无码”规则先匹配了 FC2，实际使用的是“无码”来源，而不是 FC2 来源。遇到此类问题先调整优先级或该分类的数据源。

“跳过已有 NFO 的目录”检查的是扫描输入目录，不保证输出目标没有冲突。“仅扫描匹配影片分类”适合过滤无关视频，但前提是规则能识别你要保留的影片。新规则先用少量文件验证。

需要 AI 翻译标题或简介时，先在“系统设置 → AI 接入”打开“启用 AI 刮削”总开关，再在当前预设的“翻译器”中选择字段并勾选“启用 AI 翻译”。无需在预设“爬虫”中开启 AI 刮削，原翻译引擎配置也会保留。详见 AI 翻译设置。

已有影片覆盖方式

在“文件夹整理”中选择冲突处理策略。“从不”保留已有影片、封面和 NFO，跳过整理并保留源文件；“总是”替换已有版本；“按文件大小”保留较大的影片；“仅保留最新”比较文件修改时间，保留较新的影片。大小或时间相同时保留已有版本。多段影片统一检查，只要有一段需要保留就跳过整部影片，避免混合不同版本。同一文件名的不同视频扩展名也会参与比较；已有目录不会被整体删除。

保留已有影片时对应图片与资料不改写。替换已有影片后，任务不提供“还原文件”，避免清理原有资料。关闭“移动文件到整理目录”时，上述策略不参与原地资料更新。

输出模板和硬链接有文件系统要求，使用前核对输入与输出磁盘及权限。更多核心字段说明可查阅 JavSP Wiki。

爬虫与网络：先单独测试，再运行整批

1. 进入“爬虫配置”，选择具体爬虫，输入一个确定存在的番号并运行测试。
2. 查看抓取字段和运行输出：是否取得标题、封面，是否出现 403、超时或解析异常。
3. 在“刮削预设 → 爬虫”调整该分类使用的数据源与顺序；爬虫配置页管理代码，预设页决定任务使用哪些爬虫。
4. 自定义爬虫保存后再单独测试；仅保存代码不代表能抓到资料。内置爬虫只读，可移除和恢复。

代理地址由运行 JavSP WEB 的机器使用。Docker 中 127.0.0.1 指向容器，宿主机代理需填写容器能访问的地址。HTTPS 证书失败时检查站点域名、系统时间和代理证书，不要关闭证书校验。403 表示站点拒绝访问，还应检查网络出口和该站点的登录 Cookie。

代理使用自签名证书时，可将可信的 PEM 格式 .crt 文件只读挂载到容器的 /usr/local/share/ca-certificates/ 后重启。若自行改用非 root 用户运行容器，需要在构建镜像时安装证书。同步 Cookie 成功只说明读到了登录信息，站点仍可能要求重新登录或验证。

需要 AI 帮你制作爬虫时，在对话中说明目标站点和要提取的资料，检查生成的代码后再确认保存。保存后先测试一个番号，确认能取得资料，再用于批量刮削。