[Slacker-LLC]

修了什么（2026-10-18 真机上复现的四个文件预览问题）

现象	根因	修法
图库标题带 hash 前缀；guest 文件左右滑动切到别的目录的图	标题取的是缓存副本的文件名（<sha256>-<name>）；"兄弟文件"是列整个共享缓存目录，里面混着所有目录/会话的副本	新增 GuestFileCache（缓存命名只此一处）和 ImageGalleryPlan：兄弟文件来自 guest 原目录的列表，标题用原文件名；非当前页的图按需拉取（ImageGalleryItem.ensureReady）
预览 .svg 显示成另一张图	① Coil 没有 SVG 解码器；② svg 被图库的扩展名白名单过滤掉，当前图下标为 -1，Pager 把它夹成 0，显示的就是目录里的第一张	接入 coil-svg（SvgDecoder，Apache-2.0，已写入 THIRD_PARTY_LICENSES）；ImageGalleryPlan.order 保证当前图一定在列表里、类型判断统一走 fileCategoryFor；全屏查看器改用 App 的 ImageLoader，解码器一致。没有用 WebView 画 SVG（现有 WebView 允许 JS 和 file 访问，不适合不可信 SVG）
.tar.gz 报错	压缩包预览把所有格式都交给 ZipFile	新增 ArchiveReader：按文件头魔数识别 zip / tar / tar.gz / 单文件 gz 并列出条目（ustar prefix、GNU 长名、pax 头、base-256 大小、校验和校验；最多 2000 条，扫描上限 256 MiB）。bzip2、xz、7z、RAR、zstd、deb、rpm 明确提示"不支持"，不再报 zip 错误
.odt 只有降级显示	OFFICE 类只有 docx/xlsx/pptx 的转换器	OfficeToMarkdown 增加 ODT：标题、段落、嵌套列表、表格、链接、粗体/斜体/等宽、预格式化块，跳过脚注与批注；转成 Markdown 后沿用现有渲染。.ods/.odp 评估后不做（表格/幻灯片需要单独的转换器），保持"不能预览，可用其他应用打开"，提示文案改成明确说明

验证

已验证

• :app:compileDebugKotlin 通过。
• 针对性单测 24 个全过（ImageGalleryPlanTest、ArchiveReaderTest、OfficeToMarkdownTest；沙箱包其余测试也跑过，无回归）。覆盖：svg 当前图不再丢、标题无 hash 前缀、兄弟文件只来自原目录且缓存路径与 GuestFileCache 一致、其它目录/会话的缓存副本不会混入；tar / tar.gz / 单文件 gz / zip、bzip2·xz·7z·RAR 魔数 → 不支持、zip 扩展名但内容不是 zip → 报错、tar 头损坏 → 报错、超过 2000 条 → 截断并标记；ODT 的各类结构、被跳过的脚注、无 content.xml → null。
• Release 包（含 R8、lintVitalRelease）从提交 f1b2b6bc 构建成功，生产密钥签名（证书 SHA-256 c029f611…df856），与手机上已装的是同一签名。
• 完整 lint / 全量测试交给 CI。

未验证（真机）

• 11:02 我把这个 release 包装到了手机 f0e2ff6f，但 11:38 手机上的 App 被别的 agent 用另一份构建覆盖（APK 哈希与我的不同），之后抓到的截图（标题仍带 hash）来自那份构建，不能算本 PR 的结果。为免和对方互相覆盖、打断对方正在跑的任务，没有再装一次。所以四项预览在真机 release 包上的复测目前都没有完成：图库标题 / 滑动范围、svg、tar.gz 列表、odt 渲染。
• ODT 渲染只用单测里手写的最小 XML 验证过，没有用 LibreOffice 生成的真实文件（如 t.odt）在设备上看过排版。
• .ods/.odp 的"不支持"提示文案未在设备上看过。

已知限制

• 很小的 SVG 会按 Coil 的上限放大解码（最大约 4096 px 宽，约 33 MB 位图）；没有额外加 SVG 解码尺寸上限。

🤖 Generated with Claude Code