Loc Gallery 4.0.0

Summary

稳定版 4.0：识别多段小 mdat 的 MP4 源，HLS 边切边播；机械盘友好的切片水位（2 分钟停 / 1 分钟续 / 近边续切）与拖进度 catchup 续切。

新增

• 多段 mdat 交错 MP4 检测（播放计划 v15），NJAV 类源自动 HLS
• HLS 切片水位控盘与 \POST /api/play/catchup/{video_id}\
• 状态接口 \produced_end_sec\ / \segment_seconds\

改进

• 切片仅看磁盘已切进度；ffmpeg 降优先级；直连加载文案优化

修复

• 误标标准格式导致直连扫盘极慢
• 拖到最后已切分片附近长时间等下一段

完整记录见 CHANGELOG.md。

Loc Gallery 3.3.0

概要

播放页列表可分页加载与连播预取，播放区滚轮快进可配置，设置页紧凑布局。

新增

• 播放列表 加载下一页（滚动/按钮），排序与筛选规则与列表页一致
• 连播到末尾自动拉下一页；刷新后定位到正在播放项
• 设置 滚轮快进/快退秒数（0 关闭）

改进

• 全局设置 流式紧凑布局，控件不再无意义拉宽

修复

• 列表加载后点击无法播放；播放中换片误清空已加载列表

完整变更见 CHANGELOG.md.

Loc Gallery 3.2.0

概要

播放页与标题：原生控件回归、列表右键删除连播、卡片标题智能截取。

新增

• 设置 缩略图进度条：自动 / 始终 / 从不；顶栏芯片可展开/收起详情
• 播放页 ?play= 刷新恢复；首页 / 与收藏/最近导航
• 播放列表 右键菜单 与网格一致

改进

• 播放器恢复 原生 <video controls>
• 卡片标题截到 (年份) 右括号；番号 XXX-NNN 规则不变
• 刷新 重载标题规则并重绘网格；播放页删除后刷新，删当前项 自动下一条

修复

• 仅刷新不重启时标题规则不生效
• 播放中删除/刷新时列表不更新或误关播放页

完整变更见 CHANGELOG.md。

Loc Gallery 3.1.0

概要

界面与浏览体验更新：顶栏导航、YouTube 夜间主题、响应式网格与智能分页。

新增

• 顶栏 首页 / 我的收藏 / 最近播放，视频库在导航末尾
• 每页：自适应、自定义条数、全部

改进

• 全站 YouTube 夜间风配色
• 缩略图网格 200–260px、最多 10 列
• WMV 等非 MP4 走 HLS（播放计划 v14，含于 master 自 3.0.0 后的提交）

修复

• 自适应分页在播放检测时打断 HTML5 播放
• 直连起播后再进入播放页

完整变更见 CHANGELOG.md。

Loc Gallery 3.0.0 (stable)

Loc Gallery 3.0.0?????

?????HTML5 ???????????????

??

• /api/stream ?????256KB ????????????????????????????????????????????? FileResponse??
• ?? / ??????????????????????????

??

• range_stream.py ???? Range ??
• ???HTML5 ???????HTML5 ??????
• /api/play/info ??????

??

• ??/????? <video>????? Range ??
• ?? keepalive ??????? seek ??????????

??

• ??????? stream 500
• ????????????
• ???????? video ???

????? CHANGELOG.md?

Loc Gallery 2.0.2

Loc Gallery 2.0.2

新增

• 播放页顶栏增加 收藏 / 取消收藏 按钮

修复

• HLS 边切边播 首次播放不从开头起播：hls.js 误判为直播跳到最新片段；现通过 startPosition: 0、清单注入 EVENT/START 标记及 ffmpeg event 播放列表类型修复

Loc Gallery 2.0.1

Loc Gallery 2.0.1

变更

• Python 包 avv_gallery 重命名为 loc_gallery，源码目录改为 src/loc_gallery/
• 更新所有 import、uvicorn 入口、文档、脚本与测试中的模块路径
• package-lock.json 与 demo 页面品牌统一为 Loc Gallery

升级说明

若你通过开发模式启动，请将 PYTHONPATH 指向 src 后使用：

python -m uvicorn loc_gallery.server:app --host 127.0.0.1 --port 3456

或直接运行 python restart.py（已自动使用新包名）。

Loc Gallery 2.0.0

Changelog

[2.0.0] - 2026-07-19

新增

• 多视频库：注册多个本地根目录，顶栏「选择视频库」切换；收藏、历史、缩略图、HLS 缓存、分类元数据按库隔离
• 视频库 API：GET/POST/PATCH/DELETE /api/libraries、激活、Windows 文件夹选择器
• 设置面板重构：视频库（现有 / 新增）+ 全局选项；PotPlayer 路径自动探测
• 播放列表排序：文件名自然排序、标题、时间、大小等；排序偏好本地保存
• HTML5 连播：按播放列表顺序自动播放下一集；上一个 / 下一个同步列表顺序
• 集成测试：tests/test_multi_library.py

改进

• 单库数据自动迁移至 data/libraries/lib-default/
• 现有 API 支持 ?library_id=；SSE 事件携带库 ID
• 播放与 PotPlayer 启动逻辑修复（路径校验、设置回退）

说明

• 应用版本号统一为 2.0.0（Python 包 avv_gallery）
• 全局设置保存在 data/settings.json；库列表在 data/libraries.json

[1.0.0] - 更早版本

• 本地视频画廊、缩略图队列、HTML5/HLS 播放、收藏与历史、伪装 MPEG-TS 支持等基础能力