【免费下载链接】aonsokuA modern desktop client for Navidrome/Subsonic servers built with React and Electron.项目地址https://gitcode.com/gh_mirrors/ao/aonsoku点击查看免费下载Aonsoku 是一款基于 React 和 Electron 构建的 Navidrome / Subsonic 服务器现代桌面客户端。它内置了IDB 数据缓存、图片缓存与歌词缓存三套策略把常用数据存在本地 IndexedDB 和 Cache Storage 中让切歌更快、封面秒开、歌词即点即现。本文带你用 5 分钟读懂这些缓存是怎么工作的以及如何在设置中管理它们。为什么本地缓存对音乐客户端很重要Aonsoku 的所有音乐元数据都来自你的 Navidrome/Subsonic 服务器。每次打开专辑列表、加载封面、查看歌词理论上都是一次网络请求。在三种场景下没有缓存会很明显地拖慢体验 网络不稳定或服务器响应慢时页面需要反复等待️ 翻动大量专辑封面时每张图都要重新下载 反复查看歌词时每次都请求外部歌词服务。Aonsoku 的做法是数据类缓存走 IndexedDBIDB图片走浏览器原生 Cache Storage两者都可以在设置里独立开关。IDB 数据缓存IndexedDB 的轻量封装Aonsoku 使用 idb-keyval 这个极简库来操作 IndexedDB并在 idb.ts 中封装了一层idbStorage对外提供getItem/setItem/removeItem三个方法读不到或出错时安全回退为null。目前这套封装的主要消费者是播放器状态player.store.ts 会用idbStorage持久化迷你播放器mini-player的歌曲列表。也就是说你关闭应用再打开正在听的播放列表还在——这就是 IDB 数据缓存最直观的价值。歌词缓存键值设计与多级回退歌词缓存是 Aonsoku 中逻辑最完整的一块实现在 lyrics.ts。缓存键是怎么构造的歌词缓存键由 5 段拼接而成见 getLyricsCacheKeylyrics:艺术家:歌曲标题:synced|plain:internal|externalsynced/plain取决于你是否偏好同步歌词internal/external取决于服务器是否支持 OpenSubsonic 的 songLyrics 扩展。这意味着偏好不同或服务器类型不同时缓存不会互相串用。读取与写入流程若「启用歌词缓存」开启先按缓存键读 IDB命中直接返回未命中则优先请求服务器的getLyricsBySongId服务器没有同步歌词时回退到 LrcLib 外部服务任何一次成功拿到的歌词都会写回 IDB下次秒开。整个流程由lyricsCacheEnabled控制lyrics.ts关闭时读写函数直接变成空操作不会读、也不会写缓存。动画封面 URL 缓存省掉重复搜索除了静态歌词动画封面动态 MV 封面也有一套 IDB 缓存。artworkClient.ts 会先按animated-artwork:艺术家:专辑这样的归一化键查 IDB命中就直接返回动画流地址未命中才调用外部 artwork 搜索接口并把结果写回缓存。配合 use-animated-album-artwork.tsx 中的 React Query 配置staleTime设为无限、禁用重取同一张专辑的动画封面在整个会话期内只请求一次外部服务。图片缓存层Cache Storage Blob 本地化封面图片走的是另一条路线浏览器原生的 Cache Storage。核心逻辑在 image.ts 的getCachedImage先查名为images的缓存命中则把响应转成 Blob 并生成对象 URL未命中才fetch原始地址成功后cache.put存一份请求失败则安静降级为原始 URL不影响页面渲染。入口在 httpClient.ts 的getCoverArtUrl只有当「开启图片缓存」为 true 时封面才会经过这层缓存否则直接返回服务器 URL。媒体流缓存一个巧妙的_cb开关音乐流媒体本身没有本地副本但 Aonsoku 在 player.tsx 做了个巧思「媒体缓存」开启时流地址不带额外参数允许底层浏览器/Electron按 URL 复用与缓存关闭时会在 URL 上追加_cb时间戳做cache-busting强制每次拉取新的音频流。这样你既能享受缓存带来的流畅切换也能在需要强制刷新时一键回到无缓存模式。在哪里管理这三套缓存打开设置 → 内容 → 缓存页面caches.tsx你能看到四个开关/按钮选项作用默认值开启图片缓存封面走 Cache Storage 本地化随部署配置启用歌词缓存歌词读写 IDB开启媒体缓存控制音频流是否允许被缓存开启清除所有一键清空全部本地缓存—清除缓存的精确范围「清除所有」按钮调用的是 clearAll.ts 的clearAllCaches它只做三件事按前缀lyrics:和animated-artwork:删除 IDB 中对应的键不会误删其他 IDB 数据删除名为images的整个 Cache Storage通过 React Query 的removeQueries失效内存中的歌词与动画封面查询保证界面立即重新拉取。如果你的服务器更新了封面或歌词或者本地空间紧张点它一次即可干净地重开。总结三层缓存各司其职IDB 数据缓存迷你播放器播放列表、歌词、动画封面 URL基于 idb-keyval 轻量封装图片缓存Cache Storage 本地化封面 Blob失败自动降级永不阻塞 UI媒体缓存通过_cb参数决定音频流走缓存还是强制刷新。三套策略全部默认服务于同一目标——少一次请求快一秒体验并且都能在设置中自由开关兼顾了速度、隐私与磁盘空间的控制权。赞分享【免费下载链接】aonsokuA modern desktop client for Navidrome/Subsonic servers built with React and Electron.项目地址https://gitcode.com/gh_mirrors/ao/aonsoku点击查看免费下载相关推荐DeepSeek-V4-Fable革命性AI网络安全代理的完整入门指南DeepSeek V4 Fable革命性AI网络安全代理的完整入门指南 在当今数字化时代网络安全已成为保护企业和个人数据安全的关键防线。 DeepSeek免费在线图表编辑器Mermaid Live Editor完整使用指南免费在线图表编辑器Mermaid Live Editor完整使用指南 还在为复杂的图表制作软件而烦恼吗Mermaid Live Editor作为Mermai前端数据可视化Alcatraz缓存策略详解图片与网络数据缓存管理Alcatraz缓存策略详解图片与网络数据缓存管理 在使用Xcode进行开发时你是否遇到过反复下载相同插件和资源的问题Alcatraz作为Xcode的Pa开发工具上一篇CANN/ge HCCL子通信域配置参数下一篇Atlantafx 终极指南现代JavaFX界面美化完全教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考