Skip to content

玄览 0.8.34

Choose a tag to compare

@magicindex magicindex released this 13 Nov 09:04
· 73 commits to main since this release

玄览 0.8.34 发布说明

发布:2026-11-11 · 适用于飞牛 fnOS(amd64)

0.8.34 汇总 0.8.17 审查后的 P0/P1 修复与 P2/P3 改进,并包含 0.8.3 以来的索引维护、权限、
预览、隐藏项过滤、USB 外挂检索与设置页改动。

0.8.34

  • 首页新增 USB 状态指示:启用但未检测到显示「USB 未检测」,已挂载显示「USB N 个」,
    建索引中显示「USB 索引中」
  • /api/status 增加 USB 构建数量;USB 建索引期间首页保持「USB 建索引中」
  • 设置保存成功增加「设置已保存」提示
  • 未检测到 USB 挂载时点「立即重建 USB 索引」直接提示,不再显示假的“已开始重建”

0.8.33

  • 图片全屏预览跟随主题:亮色主题下使用浅灰背景、深色文字/按钮,暗色主题保持深色
  • 缩略图条、导航按钮、标题栏同步适配亮色主题

0.8.32

  • unix socket 对端校验收紧:只接受 root / 服务自身 uid / www-data uid,不再放行“任意 uid
    但 gid=www-data”的进程
  • 管理员判定以 x-trim-isadmin 头为准,只有未带该头时才用最小 uid≥1000 兜底;
    XL_ADMIN_FALLBACK=0 可完全关闭兜底
  • 请求级 admin 结论通过 TLS 传给 USB/文件权限判断
  • 新增 tests/api_test.py 并接入 make test,覆盖 admin 头优先级/兜底、JSON 校验、缩略图缓存头

0.8.31

  • 图片全屏预览背景改为不透明 #05080d,完全遮住后面的搜索列表,不再透出列表文字

0.8.30

  • 缩略图加载优化:
    • /api/thumb 返回 Cache-Control: private, max-age=86400,URL 带 mtime 版本号,重复
      打开预览命中浏览器缓存
    • 主图优先:主图 onload(或 700ms 兜底)后才开始加载缩略图,避免缩略图请求抢占 worker
    • 缩略图 ffmpeg 使用单线程 + fast_bilinear + -q:v 5;缩略图 fetchpriority=low,
      主图 high

0.8.29

  • 修复图片预览缩略图黑框:主图样式 max-width: calc(100% - 96px) 误作用到缩略图,
    桌面端缩略图被压成 0 宽;现在只作用于主图,缩略图按 100% 填充,桌面/手机均能正常显示

0.8.28

  • 图片预览底部增加缩略图条:按当前搜索结果顺序列出全部图片,当前项高亮,点击缩略图直接切换
  • 新增 /api/thumb:ffmpeg 生成 160px JPEG 并按路径+mtime+size 缓存,缩略图条不下载原图
  • 缩略图生成失败时回退原图,坏图弱化显示;切换时自动把当前缩略图滚到可视中间

0.8.27

  • 新增图片预览:点击图片结果全屏查看,左右按钮/方向键切换、Esc 或点背景关闭、下载当前图片
  • 预览列表直接使用当前搜索 items 过滤出的图片,不重新请求搜索接口,顺序一致;
    单张时切换按钮禁用,触摸端支持左右滑动

0.8.26

  • systemd unit 改为按实际安装路径生成:不再随包提供写死 /vol1 的 xuanlan.service,
    cmd/main 按 TRIM_APPDEST/TRIM_PKGVAR/TRIM_PKGETC 与端口生成 /etc/systemd/system/xuanlan.service
  • 目录子项索引:启动/重建时按 parent 建一次 child 链表,/api/dir 与检索范围展开只遍历
    直接子项,不再每次扫全量记录;卷根/路径查找按分量走 child 链表
  • 安装向导文案改为自动探测 /vol1–/vol8

0.8.25

  • USB 设备校验:结合 /sys/block/*/removable 与 USB 设备路径,非 USB 的 bind/内部盘挂到
    /vol00 时不再误收;sysfs 不可用时保守接受
  • 搜索限流:每 uid 每秒 20 次,2 字符查询每秒 5 次;超出返回 rate limited
  • USB 状态消息加锁,避免构建线程与设置/状态读取并发写
  • 快照打开时逐条校验 name_off/name_len 与 parent,损坏索引不再进入查询
  • 复制文件/目录只保留 0777 权限,不再保留 setuid/setgid

0.8.24

  • 自动探测 /vol1–/vol8 中实际挂载的卷,修复 GitHub #2「5 个内部卷只识别前 4 个」
  • 只认真实挂载点,/vol6、/vol7 这类残留空目录不会被误当卷
  • start.sh 未配置 ROOTS 时自动探测;xuanlan.conf 的 ROOTS 仍可覆盖
  • xuanlan serve 不带 --roots 时也按 /proc/self/mounts 自动探测

0.8.18 修复

  • ext4 裸扫目录块数组分配不足导致的堆越界(ASan 可稳定复现,旧版在部分卷上可能 abort)
  • 设置请求上限 16 KiB → 128 KiB,超限返回 413;检索范围上限 64 → 512,超限明确报错
  • 普通用户可以保存自己的检索范围,不再被全局字段整单拒绝
  • 复制目录到自身子目录会被拒绝,避免递归复制写满磁盘
  • FIFO/设备等特殊文件在读取与复制时直接拒绝,避免阻塞占死 worker
  • fanotify 内部队列满时触发整卷重建,不再静默丢事件
  • USB 路径检测开关同时控制挂载点变化重建;掉线自动关闭增加 2 次防抖
  • 设置页检索范围超过 512 项时前端直接提示

0.8.19 P2 改进

  • 搜索结果分页:每页 200 条,底部「加载更多」按 offset 续取
  • 目录列表展示后端 count/truncated,超过 4000 项时给出截断提示
  • 设置保存、文件操作、回收站的 JSON body 增加语法校验
  • USB 外挂盘默认只对管理员开放(检索/目录/预览/文件操作)
  • USB 索引每次挂载或服务重启都重建,避免复用过期快照
  • 构建进度按线程隔离;管理员判定缓存 60 秒刷新

0.8.20–0.8.23 后续修复

  • 0.8.20:USB 状态消息不再向普通账号暴露挂载路径(真机 U 盘测试发现)
  • 0.8.21:U 盘在检索范围树里按分区合并为单一根节点,展开时才列子目录
  • 0.8.22–0.8.23:检索范围树只显示目录,不再显示文件数量/「没有子目录」提示,
    展开深度放开到 32 层

重点更新

  • USB 外挂设备检索(0.8.13–0.8.17)
    • 默认关闭,首次需在「设置 → USB 外挂设备」手动开启
    • 自动识别 fnOS 外接存储(/vol00/...),按文件系统 UUID 单独建立 usb-<UUID>.idx
    • 掉线时自动关闭检索并清理 USB 索引,本地 /vol1–4 索引不受影响
    • 挂载点变化时删除旧路径索引并按新路径重建;检测开关可关闭
    • 搜索结果带 USB 标记;设置页提供「立即重建 USB 索引」
  • 隐藏项默认过滤(0.8.11–0.8.12)
    • 默认跳过 . / @ 开头目录,以及 Thumbs.db、desktop.ini、__MACOSX、
      $RECYCLE.BIN、System Volume Information 等系统杂项
    • 设置页可关闭;目录遍历、ext4 裸扫、fanotify 增量规则一致
    • 快照头记录扫描规则,升级后首次启动自动重建一次
  • 检索范围目录树三态(0.8.10)
    • 父级由子目录推导:全选显示勾、部分选中显示 -、全未选显示空框
    • 勾选继承逐级传递;半选节点点一下即全选;保存时收敛重复子项
  • 开机自启参数化(0.8.9)
    • xuanlan.service 改由随包 start.sh 读取 /vol1/@appconf/xuanlan/service_port
      与可选 xuanlan.conf,不再写死端口与索引卷
  • 设置页视觉整理(0.8.15–0.8.17)
    • 打开位置、打开方式关联、自动全盘扫描、USB 外挂设备、检索范围各成一张线框卡片
    • 卡片内外用中性灰分层(深色 #0e0f10 / #1b1d1f,浅色 #e7e8ea / #fbfbfc)
    • 关闭按钮改为 30px 圆形幽灵按钮,悬停才加深

0.8.3–0.8.8 变更

  • 0.8.8:打开方式关联默认值调整;文档服务/在线预览缺失时回退浏览器
  • 0.8.7:管理员权限放行收紧到自家目录,修复 0.8.6 越权显示
  • 0.8.6:管理员组按 root 语义通过 TrimACL,修复管理员搜不到可读文件
  • 0.8.5:新增富文本(HTML/RTF/Markdown)打开方式
  • 0.8.4:内置 EPUB 阅读器,兼容旧版 Android WebView
  • 0.8.3:Markdown 预览;修复旧版 Android WebView 浮层不可见

升级说明

  • 直接在应用中心使用新的 FPK 覆盖安装;升级回调会同步 xuanlan.service 并重启服务
  • 0.8.11 起索引默认忽略隐藏项,升级后首次启动会自动重建一次索引(旧条目随重建消失);
    需要保留隐藏目录内容时,到「设置 → 自动全盘扫描 → 忽略隐藏目录与系统杂项」关闭
  • USB 检索默认关闭;开启后只索引 /vol00 下当前挂载的外接设备,不并入本地索引
  • 端口与索引卷仍通过 /vol1/@appconf/xuanlan/service_port 与可选 xuanlan.conf 配置

软件包

  • 文件:xuanlan_0.8.34_amd64.fpk
  • 大小:935,215 字节(约 913 KB)
  • MD5:353858a25159b3abe8e6a88a85db286f
  • SHA-256:4477cff6828e52123021cbc0b928774df7b59179ebd46d18ec4944db065e6de2

下一步计划

  • unix socket 对端校验收紧、管理员判定改为以网关头为准
  • 工程化:HTTP API、USB 挂载模拟、ASan 回归接入 CI,更新过期截图

已知限制

  • USB 索引在启用、挂载变化或手动重建时扫描,没有 fanotify 实时增量;盘内新增文件需点
    「立即重建 USB 索引」或重新插拔
  • USB 识别依赖 fnOS 把外接存储挂在 /vol00 下;若官方调整挂载根路径需要同步修改
  • 单机单进程,不支持多副本与集群;索引不跨机器共享

完整历史见 CHANGELOG.md。