Repository navigation
玄览 0.8.34
玄览 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。