v1.14.0

片匣 v1.14.0

相比 v1.13.1，本次补上登录会话、服务端防窥锁定与两步验证，把访问控制收成
「一个令牌 + 一个开关」，并新增 .strm 网络串流播放。

升级必读：升级后单文件版本认证令牌在data目录access_token.txt；本机不再免令牌；配置自动迁移，媒体库无需重建。

新增

登录与访问

• 令牌换会话：登录一次 7 天内免输（HttpOnly Cookie），可登出、踢掉其它设备、查看登录记录
• 访问保护收成一个开关：本机 / 手机 / NAS 一视同仁都要令牌；桌面版启动用一次性短链自动登录，依然无感
• 令牌默认只显示掩码：点「显示」需再输一次令牌，明文 30 秒自动隐藏
• 「立即登出并更换令牌」一次完成轮换 + 吊销全部会话
• 手机扫码登录：二维码内是一次性短链（5 分钟、用一次失效），不再携带长期令牌

防窥（隐私锁）

• 服务端锁定：空闲 10 分钟自动锁、Ctrl+Shift+H 老板键、可设启动即遮挡
• 锁定期间内容接口返回 423，刷新 / 重开标签页都绕不过
• 锁定后刷新直接显示锁屏页，不再先闪一下封面；跟随浅色主题与四种语言
• 解锁用快速解锁码（4 位以上）或访问令牌，任一即可

两步验证

• 标准 TOTP，兼容 Google / 微软 / 1Password / Aegis；启用时发放 8 个一次性恢复码
• 兼容微软验证器：发行方与账号名改为 ASCII、校验窗口 ±60 秒、输入兼容全角与分隔符
• 只在登录时需要；事务 API Key 作为机器凭据不受影响

自动化

• 事务 API Key：可命名、只读 / 完整权限、单独吊销、记录最近使用；磁盘只存 SHA-256

部署与文档

• 首次向导 4 步（语言 / 媒体库 / 访问方式 / 完成）；容器内自动列出已挂载目录，可多选
• /api/docs 改为内置页面：不依赖任何 CDN，离线 / 国内网络可打开
• 反向代理可解析真实客户端 IP；令牌写入 data/access_token.txt，日志只打掩码

播放

• .strm 网络串流：mp4 直链默认 302 直连，防盗链自动转服务端代理；HLS 由服务端改写分片后播放；观看时长照常统计

升级

• Windows：覆盖 AVM-1.14.0.exe，沿用 data/
• Docker / NAS：docker compose pull && docker compose up -d
• 可选：开启「重启后保持登录」（server.session_persist）

v1.13.1

片匣 v1.13.1 版本说明

相比 v1.13.0 的变更。本版新增 Docker / NAS 一键部署 与 网页播放兼容层（浏览器不支持的容器会自动快速转封装），并修复社区反馈的远程访问令牌 401、首页搜索框无响应等问题。

🐳 Docker / NAS 部署（新增）

提供官方多架构镜像（linux/amd64 + linux/arm64），群晖 / 威联通 / Unraid / TrueNAS 上无需编译：

docker run -d --name avm \
  -p 8770:8770 \
  -e TZ=Asia/Shanghai \
  -e PUID=1000 -e PGID=1000 \
  -v /path/to/data:/data \
  -v /path/to/media:/media:ro \
  --shm-size=256m \
  --restart unless-stopped \
  ghcr.io/dengji85/avm:latest

• 镜像内置 ffmpeg（抽帧/预览）与 chromium（av-wiki 抓取），开箱可用；
• 数据（数据库 / 配置 / 封面 / 头像 / 预览）全在 /data 卷，升级只换镜像、库自动迁移；
• Windows 单文件 exe 同样由 Actions 自动构建并附加到 Release。

镜像标签怎么选：latest = 最近一次正式发布（稳定，推荐）；main = main 分支最新构建（含尚未发布的修复，想尝鲜可用）；1.13.1 = 固定版本。

容器不会继承宿主机的代理设置。刮削需要走代理时，请在 compose 里显式声明 HTTP_PROXY / HTTPS_PROXY（建议同时设 NO_PROXY=localhost,127.0.0.1），详见 docs/Docker部署.md。

▶ 网页播放兼容层：MKV 等容器自动转封装

以前 MKV、AC3 / DTS 音轨的影片网页播不了，只能换系统播放器。现在播放失败时会自动快速重封装为 MP4（-c:v copy 只复制视频流、不重新编码，几乎不耗 CPU）：

• 首次播放这类片子会显示「正在准备播放」与进度条，转好后同一部片再播直接命中缓存；
• HEVC / 10bit 等需要真转码的行为不变，仍提示用系统播放器；
• 缓存位于 data/remux，可在 设置 → 网页播放 查看 / 清理（默认上限 4 GB，超限自动清理最久未访问的）；
• 不需要的话，可在同一面板关闭「播放失败时自动转封装」。

🔧 社区反馈修复

• 远程访问令牌 401（#1）：令牌此前只随接口请求头发送，而封面、头像、播放流是浏览器直接请求的 URL，无法携带自定义请求头 —— 于是远程访问时出现「设置能改能保存，封面与播放却全部 401」。现在令牌同时写入 Cookie，打开页面会自动补写，无需重新填写。
• 首页搜索框回车无响应（#1）：此前回车只更新关键词、不切换视图，停在首页看不出任何变化；现在回车会自动跳到影片库展示结果。

📄 文档

• README 新增 Docker / NAS 部署章节与镜像标签说明（中英日繁四语言）；
• docs/Docker部署.md 补充容器代理配置（HTTP_PROXY / HTTPS_PROXY / NO_PROXY）。

升级方式

下载 AVM-1.13.1.exe 覆盖旧版即可，沿用原 data/ 目录（数据库会自动迁移，无需重新建库）。
Docker 用户执行 docker compose pull && docker compose up -d。

提示：网页播放首次遇到 MKV 类影片时需要等待转封装（只复制视频流），属正常现象；缓存可在「设置 → 网页播放」中清理。

release: v1.13.0（文件生命周期管理 + 修复 issue #1/#3/#4）

片匣 v1.13.0

本版新增文件生命周期管理（删除默认进回收站、缺失宽限期），并集中修复社区反馈的 issue #1 / #3 / #4。

🗑 删除更安全：默认进回收站

以前删除影片文件是永久删除，删错无法找回。现在删除分三种：

方式	行为	可否恢复
从库中移除	只删数据库记录，磁盘文件原样保留	文件一直都在，重新扫描即可找回
删除到回收站	把文件移入系统回收站，再移除记录	可从回收站还原（推荐）
删除影片和文件	永久删除磁盘文件	不可恢复，请谨慎

• 回收站不可用时不会删除文件，只移除记录并提示。
• 画廊多选后，批量栏也可「移出媒体库 / 删除到回收站」。
• 默认行为可在 设置 → 媒体库 → 扫描规则 → 删除文件时移入回收站 调整。

⏳ 文件消失不再"一扫就没"：30 天宽限期

1. 文件从磁盘消失 → 先标记为缺失并记录首次缺失时间；
2. 默认保留 30 天（可调），期间把文件搬回原处再扫描即自动恢复；
3. 超过宽限期才清理记录——全程不会删除磁盘上的视频。

另新增 数据健康页 → 快速核对缺失：只检查已入库路径是否还在，不遍历目录，几万条也秒级。

🔧 社区反馈修复

• 本地 NFO 自动导入（#4）：扫描后自动读取同目录 .nfo / .json；文件名解析不出番号的影片，只要目录里有 NFO 也能导入并回写番号；批量刮削同样覆盖无番号影片。
• 移动 / 重命名文件后无法播放（#3）：扫描识别"移动 / 改名"并原地更新路径，不再留失效条目；播放与主文件选择跳过失效记录；缺失判定限定在本次扫描的根目录内。
• 批量刮削无效（#3）：批量栏新增「重新刮削（覆盖）」，可修正名称异常等已有字段。
• 日志页筛选 / 翻页失效（#3）：修复查询参数传递错误。
• AI 设置保存无效（#1）：AI 面板保存逻辑此前未实现，现已补全。
• 数据源顺序不持久化（#1）：设置页按你保存的顺序显示，不再"复原"。

✨ 其他改进

• 女优资料插件默认全部启用，开箱即可抓取。
• 常用在线站点预置，详情页无需先保存设置即可一键打开。
• 扫描忽略下载临时文件（.part .tmp .!qB .aria2 .crdownload 等），半成品不入库。
• 「重复影片」体检改用内容指纹判定，等大分卷不再被误报。

升级方式

1. 下载 AVM-1.13.0.exe，覆盖旧版即可；
2. 沿用原 data/ 目录（数据库自动迁移，无需重新建库）。

提示：升级后第一次扫描时，历史遗留的缺失记录会补上缺失时间并从宽限期起算，不会立即被清理。

v1.12.2

🐞 紧急修复

修复在线刮削全面失效（v1.12.1 严重问题）

v1.12.1 在解析网页编码时误用了 resp.charset_encoding——这个属性属于 urllib3，requests 的 Response 上并不存在。结果是：每次请求明明返回了 200，却在解码这一步报错并被内部吞掉，表现为所有在线数据源一律「返回空」，在线刮削完全不可用。

现改为按「响应头声明 → 网页内声明 → UTF-8」的顺序解码。

女优资料补全速度优化

• 负缓存：「查无此人」6 小时内不再重复试探，避免每次点击都把同样的失败重跑一遍。
• 只处理缺资料的女优，跳过已完整条目（批量补全从「全表重跑」改为「仅补缺口」）。
• wiki_actress 收敛：超时上限 12s、重试 ≤2、UTF-8 解码、搜索候选截断，避免单女优最坏 75s 拖垮整批

🔍 问题更好查

连通性测试不再只有一句「返回空」，失败原因现在能区分：

• HTTP 404 番号不存在 / 403 反爬被拒 / 请求超时 / 代理连接失败 / SSL 错误
• 本地 NFO 不再误报故障：库里没有这部片、或目录下没有 .nfo 时，标注「非数据源故障」
• 区分「跳过」与「故障」：番号类型不在某源收录范围时（如 avwiki 只收录素人片），标注「自动跳过，非故障」，不再因反爬 / 404 标红

升级方式

覆盖 AVM-***.exe，沿用旧 data/ 目录即可，无需重新建库。

v1.12.1

片匣 v1.12.1 版本说明

🎬 播放体验

• 播放支持预览图：播放器进度条 hover（移动端滑动）即可显示该时刻的预览帧；可在设置中调整「预览图密度」（帧数），对新生成影片生效，也可一键按新密度重生成全部预览。
• 视频抽帧封面：影片缺少封面时，自动从视频抽帧生成临时占位封面，后续刮削到正式海报会自动覆盖。
• 音量手势优化：播放时支持手势调节音量，体验更顺手。
• 片单即点即播升级为可放大 / 全屏的播放弹框，连续队列更沉浸。

🧑‍🎤 女优资料体系

• 新增女优资料插件：从维基百科抓取并整篇保存女优简介，批量拉取 gfriends 头像并支持大图查看。
• 女优档案页（身高 / 三围 / 生日 / 头像）改用更可靠方式抓取，资料不再缺失。
• 影片详情点女优以弹框打开，可看简介与头像大图，不丢失当前详情页。

🚀 首次使用 & 年度回顾

• 首次启动引导：选语言 + 添加媒体库目录，末步一键扫描即可开用；设置页可「重新运行首次引导」。
• 年度回顾页：基于观看与收藏数据生成年度观影报告，入口在侧边栏。

🕸 刮削提速与智能化

• 智能跳过数据源：按番号类型自动跳过不可能命中的源——FC2 跳过 javbus/avwiki；素人片（MFC/SIRO/…）跳过 javbus；普通商业片跳过 avwiki，避免无谓等待。素人厂牌表内置 130+ 前缀，可在 config.json 的 scraper.amateur_prefixes 扩展。
• 本地 nfo 优先：有本地 nfo/json 时离线 0 毫秒命中且作为权威数据，缺失字段再由在线源补齐；无 nfo 时自动走在线源。
• javbus 快速失败：详情页 / 搜索兜底改短超时（10s、不重试），修复单部片在线源超时时干等 40~60s 的问题（实测普通片 54.8s → 14.6s）。
• 女优资料缓存：同女优只抓一次（含负缓存），重复刮削大幅加速（实测同一女优第 2 部片 13.8s → 2.3s）。
• avwiki 沉底 + 提速：仅素人片命中，抓取等待上限下调，避免普通番号为其空转。

🖥 界面与设置

• 详情页站点入口优化：常用站点前 3 个直接平铺可点，更多站点 hover 展开。
• 历史页播放可配置：设置 → 外观 新增「进入历史自动播放」「打开播放列表后自动播放」两项开关。
• 站点预设更新：MissAV 更名为 123av，新增 Jable。
• 总览页「拖拽新文件到此」区域支持点击触发扫描（此前点击无响应）。

⚡ 性能

• 后台刮削 / 头像抓取改为线程池并发，大库处理更快。

升级方式

覆盖 AVM-1.12.1.exe 并沿用旧 data/ 目录即可，无需重新建库。

v1.11.0

片匣 AVM v1.11.0 发布

本次为「管理 → 刮削 → 统计 → 分析 → 片单」产品理念的集中落地，重点补齐片单策展、远程/移动端观看、升级体验三方面能力。

🎴 片单策展

系统片单：内置「播放最多 / 评分最高 / 群星荟萃 / 最近入库」四个预置片单，自动聚合、不可误删。
智能片单多选：按类型 / 女优 / 系列 + 状态多条件组合（AND/OR）自动生成，移动端改用底部抽屉。
片单即点即播：观看进度自动记住，下饭不挑设备。
📡 远程访问 + 移动端视频

远程访问独立 Tab：多地址点击切换生成二维码，手机扫码即开；Token 自定义鉴权 + 防火墙放行提示。
移动端兼容：窄屏收藏/播放按钮常驻，片单菜单改浮层，触屏可点。
⏫ 升级变更

检查更新：关于页「前往下载」改为「检查更新」，墙内自动走代理+镜像加速、限流重试；检查失败给「前往 Releases」链接。
升级只需复制一个 exe：单文件 AVM.exe，覆盖旧版即可，data/ 原地保留。

v1.9.0

片匣 · AVM v1.9.0

发布日期：2026-08-09

✨ 新功能

• AV-Wiki 源后台自动抓取：程序自管理常驻 headless Chrome，完全后台运行，无需手动开浏览器，首次运行即可绕过反爬验证页，可纳入常规后台采集任务。
• 素人片封面补全：JavBus 源详情页缺封面时自动回退取图，实测为库存补回大量此前缺失的素人片封面。

🔧 改进

• 筛选侧栏体验升级：类型 / 标记 / 评分 / 年份等常用维度置顶常驻；女优 / 厂商 / 系列等长尾维度默认折叠（展示前 12 热门 + 总数角标）；组内条目过多时显示组内搜索框；已选条件自动置顶。

📦 下载与安装

1. 下载 AVM-win64-v1.9.0.zip 并解压到任意目录（建议非系统盘，如 D:\AVM\）。
2. 双击 AVM.exe 启动，程序会自动打开浏览器进入 Web UI。
3. 数据（库文件 / 封面 / 配置）保存在 AVM.exe 同级的 data/ 目录，整体拷贝即可备份迁移。

发布包已包含前端静态资源与全部后端模块，无需安装 Python 或 Node。
AV-Wiki 后台抓取功能需在设置中配置本机 Chrome 调试端口（需本机安装 Chrome）。

片匣 v1.0.0

fix: 修正打包命令为 python build.py，并忽略发布用 zip