桌面应用音视频【免费下载链接】lrcgetUtility for mass-downloading LRC synced lyrics for your offline music library.项目地址https://gitcode.com/gh_mirrors/lr/lrcget点击查看免费下载本文以仓库根目录的 AGENTS.md 为入口系统梳理 LRCGET 的总体技术栈、前端Vue 3与后端Rust架构文档的阅读路径、各核心模块的实现要点以及开发者在修改代码前后必须遵守的维护与验证流程。读完本文你将掌握如何快速定位一个功能在前端组件、composable 与后端命令中的落点知道在哪里补充架构文档、何时运行cargo check与前端检查命令并能基于仓库真实源码理解 LRCGET 的库扫描、歌词存储、播放与 LRCLIB 集成设计。一、AGENTS.md面向开发者的架构入口指引AGENTS.md 是 LRCGET 仓库为开发者尤其是 Agent 与协作者准备的第一份阅读清单。全文虽短但承担了三个关键职责一句话定位项目LRCGET 是一款带同步歌词支持的桌面音乐播放器a desktop music player with synced lyrics support核心业务是从 LRCLIB 批量获取 LRC 同步歌词并服务于离线音乐库。给出技术栈Tauri v2Rust 后端 Vue 3 前端。规定开发纪律动手前必须先读架构文档前端读 src/ARCHITECTURE.md后端读 src-tauri/ARCHITECTURE.md完成改动后按需同步更新这两份架构文档涉及后端的改动必须在src-tauri/目录下运行cargo check验证仅改前端则无需额外检查。这份文档实际上把理解项目与质量保障制度化架构文档不是摆设而是被要求与代码同步演进的活文档。下文将按照它的指引分别深入前后端两份架构文档及其背后的真实实现。二、项目全景LRCGET 是什么按 README.md 的描述LRCGET 是一个用于批量下载 LRC 同步歌词的桌面工具扫描指定目录下的所有音乐文件尝试从 LRCLIB 服务获取歌词并以与音乐文件同名、同目录的.lrc文件形式保存。它也是 LRCLIB 服务的官方客户端README.md。当前仓库后端版本为2.1.0见 src-tauri/Cargo.toml。从仓库结构与源码看LRCGET 已从纯下载工具演进为完整的桌面音乐播放器前端Vue 3 Vite Tailwind CSS承载库浏览、播放、歌词编辑与后端通信后端RustTauri v2承担 SQLite 持久化、音频播放Kira、元数据解析与 LRCLIB API 集成数据模型核心是lyricsfiles表——所有歌词数据的唯一持久化事实来源single source of truth详见下文第五节。三、前端架构src/ARCHITECTURE.md 解读3.1 技术栈与代码质量基线src/ARCHITECTURE.md 明确了前端技术栈Vue 3script setup语法、Vite、Tailwind CSS、Vue Final Modal弹窗、Floating Vue浮层、Vue Toastification通知、TanStack Vue Virtual虚拟列表、CodeMirror歌词代码编辑器、unplugin-icons Iconify Material Design Icons。这些依赖均可在 package.json 中核对。代码质量方面项目使用 ESLint含 Vue 插件 Prettier。架构文档给出的检查命令为npm run lint检查与npm run format格式化对应 package.json 中的 scripts。3.2 五大核心模式架构文档总结的五个核心模式是理解前端代码组织方式的钥匙模式实现方式Shell 弹窗主工作区 弹窗式任务不使用路由无 routerComposable 状态模块级 ref 单例不引入 store 库后端持有持久化状态来自 Rust 命令返回前端仅做最小缓存事件驱动更新后端主动推送扫描/播放事件虚拟化列表基于tanstack/vue-virtual支撑大型曲库3.3 目录结构与状态管理前端目录组织见 src/ARCHITECTURE.md 的 Project Structure 一节核心分层为src/components/common/通用控件、icons/自定义图标、library/库视图 歌词编辑/搜索、now-playing/播放控制src/composables/共享状态播放器、下载器、搜索、编辑src/utils/工具函数歌词解析、时长格式化、lint。状态管理采用模块级 ref composable设计上的单例各 composable 职责如下Composable职责useGlobalState()isHotkey、themeMode、lrclibInstanceusePlayer()playingTrack、status、duration、progress、volume同时支持库曲目有id与文件曲目有file_path监听player-state事件useDownloader()下载队列与进度启动时由 App.vue 启动循环useExporter()批量导出队列与进度由 ExportViewer 弹窗使用useSearchLibrary()Tracks/Albums/Artists 三标签页共享的搜索文本与过滤条件useSearchLyrics()歌词搜索弹窗状态useEditLyricsV2()歌词编辑弹窗状态useLibraryNavigation()跨标签页导航点击专辑/艺术家名跳转并打开对应实体视图启动流程main.js→ Vue 应用初始化 →App.vue调用get_init()判断初始化状态 → 未初始化显示 ChooseDirectory.vue目录选择已初始化显示 Library.vue主界面。随后加载配置、应用主题、启动下载循环。这一流程在 src/main.js 与 src/App.vue 中均有实现佐证。3.4 歌词工作流前端歌词相关功能是 LRCGET 的核心架构文档列出的工作流包括展示LyricsViewer.vue同步歌词/PlainLyricsViewer.vue纯文本歌词点击可seek()跳转搜索SearchLyrics.vuePreview.vue完成 LRCLIB 查询有词级高亮时启用规范化normalizeLrclibLyrics()在 LRCLIB 缺少直接字段时从lyricsfile推导 plain/synced/instrumental 三类内容编辑/发布EditLyricsV2.vue 提供 CodeMirror 同步视图 词级时间线发布逻辑在useEditLyricsV2Publish.js导出在useEditLyricsV2Export.js同步标签页支持拖拽与 Ctrl/Cmd 多选批量操作键盘快捷键KeyboardShortcutsModal.vue提供完整快捷键参考定义集中在composables/edit-lyrics-v2/keyboardShortcuts.js批量导出LibraryHeader.vue→ExportViewer.vue→useExporter()队列 → 逐曲调用export_track_lyrics我的 LRCLIBmy-lrclib/目录承载预览、编辑、发布、举报等用户工作流。3.5 前端测试基线前端测试框架为 Vitest命令为npm test单次或npm run test:watch监听模式。测试文件与被测源码同目录放置例如word-tokenizer.test.js对应word-tokenizer.js仓库中 src/utils/word-tokenizer.test.js 即为此约定的实例。架构文档同时注明涉及解析、分词、转换等分支逻辑的工具函数应补充测试Vue 组件测试尚未搭建。四、后端架构src-tauri/ARCHITECTURE.md 解读4.1 技术栈与依赖后端技术栈为Tauri v2Rust SQLite Kira音频 LRCLIB API。关键依赖见 src-tauri/Cargo.tomlrusqliterusqlite_migrationSQLite 访问与迁移lofty音频标签读写嵌入歌词导出kirasymphonia音频播放与解码reqwestLRCLIB HTTP 客户端rayon并行处理xxhash-rust文件内容哈希扫描用regexLRC 解析。后端核心模式包括全局AppState含MutexConnection与MutexPlayer、ServiceAccesstrait读写数据库、异步app.emit()事件、所有 FFI 命令集中于main.rs、单遍流式扫描100 文件/批、手动 sidecar.txt/.lrc与内嵌元数据导出。4.2 状态管理与数据库架构src-tauri/src/state.rs 实现了AppState与ServiceAccessstruct AppState { db: MutexOptionConnection, // SQLite player: MutexOptionPlayer, // Kira audio queued_notifications: MutexVecNotify, } trait ServiceAccess { fn dbF, T(self, f: F) - T; // 只读 fn db_mutF, T(self, f: F) - T; // 可变 }数据库通过rusqlite_migration演进仓库中 src-tauri/migrations/ 目录保存了 v1–v16 的 SQL 迁移文件。要点lyricsfiles表迁移 v9 引入是歌词数据的唯一事实来源保存 YAML 歌词与 tracks 解耦含轨道元数据、存在性字段has_plain_lyrics、has_synced_lyrics、has_word_synced_lyrics、instrumental与可选的 LRCLIB 来源字段lrclib_instance、lrclib_idtrack_id为 NULL 表示无本地轨道关联的独立 LRCLIB 歌词。迁移 v14用ALTER TABLE DROP COLUMNSQLite 3.35.0移除tracks表中的遗留歌词列txt_lyrics、lrc_lyrics、instrumental及存在性字段强制库重置自此歌词数据全部归入lyricsfiles。迁移 v16新增 SQLite FTS5 虚拟表tracks_fts、albums_fts、artists_fts用于全文检索见 src-tauri/migrations/16-add_fts5_search/up.sql。4.3 增量扫描scanner 模块扫描模块src-tauri/src/scanner/实现了增量/部分扫描流程① 将所有既有曲目标记为 pendingscan_status0② 单遍流式扫描——globwalk边发现边处理按 100 文件一批批量处理③ 删除仍为 pending 的曲目磁盘文件已移除。两种检测模式Hash默认对文件前 64KB 计算 xxhash3见 src-tauri/src/scanner/hasher.rs可检测文件移动、跨平台时间戳差异Metadata仅用 mtime size更快仅 stat()但在文件移动且元数据变化时可能产生重复条目适合单文件系统下几乎不移动的大型静态库。架构文档与 src-tauri/FS_REFACTORING_PLAN.md 记录的性能改进旧方案需要两遍全目录遍历先统计文件数、再处理10 万文件在 HDD 上会额外多出约 60–90 秒单遍流式扫描可节省 HDD 30–90 秒、SSD 5–10 秒内存占用从约 200MB 降至约 10MB批处理。扫描进度通过scan-progress事件实时推送含phase: processing | updating、progress、filesProcessed、filesTotal、message完成后发送scan-complete含totalFiles、added、modified、deleted、moved、unchanged、isInitialScan、durationMs。前端在 src/components/Library.vue 中监听并展示这些事件。4.4 FTS5 搜索与回退机制库内搜索曲目、专辑、艺术家基于 FTS5 虚拟表做分词前缀匹配。查询构建函数utils::build_fts_query()对输入做归一化去除变音符、移除标点、转小写并将每个 token 转为前缀查询例如Love Way→love* way*。运行时通过fts5_enabled()检查虚拟表是否存在若不可用则透明回退到对*_lower列的LIKE查询。结果排序FTS5 可用时按rank相关度否则按*_lower字母序。4.5 自定义 LRC 解析器后端自研了轻量级 LRC 解析器 src-tauri/src/parser/lrc.rs取代外部lrccrate。原因原 crate 只支持 1–2 位小数秒厘秒会静默丢弃[01:35.492]这类 3 位毫秒时间戳的行造成数据丢失。自研解析器支持 1–3 位小数精度[mm:ss.x]1 位 分秒×100ms[mm:ss.xx]2 位 厘秒×10ms[mm:ss.xxx]3 位 毫秒×1ms。该解析器还支持一行多时间戳如[00:01.00][00:03.00] Repeated text、ID 标签[ti:Title]、[ar:Artist]、[au:instrumental]、按时间戳自动排序以及通过[au:instrumental]标记的纯音乐识别。仓库中 src-tauri/src/parser/lrc.rs 内置了覆盖上述场景的单元测试如 3 位毫秒解析、多时间戳、排序、instrumental 检测可作为行为契约参考。4.6 LRCLIB API 客户端与工作量证明src-tauri/src/lrclib/实现了 LRCLIB 各端点search、get、get_by_id、publish、flag、request_challenge。其中发布/举报采用challenge-response 工作量证明PoW流程请求 challenge获得 prefix 与目标哈希求解 SHA256 PoW寻找 nonce 使hash(prefix nonce) target实现见 src-tauri/src/lrclib/challenge_solver.rs携带 token 提交。安全要点还包括请求携带 user-agent、数据库存放于系统应用数据目录app_data_dir。4.7 统一播放模型与命令/事件清单后端引入统一的PlayableTrack类型同时支持数据库曲目与文件拾取曲目使歌词编辑器能为扫描曲目完整功能、任意文件完整功能以及无音频曲目禁用播放、仅手动编辑时间戳提供播放能力。播放状态由main.rs中约 40ms 的后台循环通过player-state事件推送音量从config_data加载set_volume()更新播放器并持久化配置。命令全部集中在 src-tauri/src/main.rs按域划分库scan_library、uninitialize_library、数据查询get_track(s)、get_album(s)、get_artist(s)等、歌词download_lyrics、search_lyrics、apply_lyrics、save_lyrics、publish_lyrics、export_lyrics、flag_lyrics、prepare_lrclib_lyricsfile、refresh_lrclib_lyricsfile等、播放与配置play_track、pause/resume/seek/stop_track、set_volume、get/set_config等。后端→前端事件包括scan-progress、scan-complete、player-state、reload-track-id、publish-lyrics-progress、flag-lyrics-progress。五、Lyricsfile 格式歌词数据的唯一事实来源理解 LRCGET 必须理解lyricsfile格式。仓库根目录的 LYRICSFILE_CONCEPT.md 给出了完整规范前端src/utils/lyricsfile.js与后端src-tauri/src/lyricsfile.rs提供 YAML 处理实现。lyricsfile是版本化 YAML 文档version: 1.0顶层字段为metadata必填、lines可选同步行数组与plain可选多行纯文本version: 1.0 metadata: title: Song Title artist: Artist Name album: Album Name duration_ms: 245000 offset_ms: 0 language: en instrumental: false lines: - text: Synced line here start_ms: 12000 end_ms: 15500 plain: | Song Title [Verse 1] Synced line here关键字段与规则要点metadata中title、artist必填album、duration_ms、offset_ms默认 0、languageISO 639-1、instrumental默认 false可选lines[].start_ms必填、end_ms可选lines[].words为词级同步数组word.text需包含尾部空格最后一个词除外供逐词卡拉OK式高亮纯音乐曲目instrumental: true且lines与plain均为空或省略plain使用 YAML 字面块标量|精确保留换行与空格。该格式允许表达四种用法仅未同步歌词、同步 定制纯文本含自定义标题、空行与注释、纯音乐、词级同步歌词LYRICSFILE_CONCEPT.md 均有完整示例。在后端lyricsfiles表是该格式的持久化载体歌词存在性过滤基于lyricsfiles.has_*_lyrics布尔字段LEFT JOIN COALESCE。孤儿的lyricsfilestrack_id IS NULL在曲目重新入库时会被自动重新挂接匹配条件为归一化后的track_artist_name_lowertrack_title_lowertrack_album_name_lower精确匹配且时长差在 ±2 秒内见 src-tauri/ARCHITECTURE.md 的 Orphaned Lyricsfile Reattachment 一节。这一设计保证曲目临时删除再入库时用户对歌词的编辑不会被覆盖也避免了从 sidecar 文件重复导入。六、开发工作流修改前后必须做什么按 AGENTS.md 的要求LRCGET 的日常开发遵循固定节奏动手前根据任务类型通读对应架构文档——前端任务读 src/ARCHITECTURE.md后端任务读 src-tauri/ARCHITECTURE.md快速理解模块落点与既有模式例如状态应放进哪个 composable、命令应放main.rs哪个域。修改后若改动涉及架构层面新增模块、改变数据流、增删命令/事件需同步更新对应ARCHITECTURE.md保持文档与代码一致。验证后端改动在src-tauri/目录运行cargo check示例cd src-tauri cargo check具体执行路径视仓库克隆位置而定前端改动运行npm run lint代码检查与npm run format格式化见 package.json涉及复杂工具函数的改动按 src/ARCHITECTURE.md 的测试约定补充 Vitest 测试npm test。开发环境与构建依据 README.md先按 Tauri 各平台前置要求准备环境Windows 需 Visual Studio C Build Tools、Rust 1.81.0、NodeJS v16.18.0随后cd lrcget npm install npm run tauri dev # 开发模式 npm run tauri build # 构建发布版构建产物位于./src-tauri/target/release/。Linux 下若音频无法播放README.md 建议安装pipewire-alsa包。七、小结一份文档如何串起整个项目回到 AGENTS.md它真正的价值在于把先读架构文档、后改代码、同步更新文档、按端执行检查的流程固化下来。沿它的指引理解项目→ 两份ARCHITECTURE.md分别给出了前端 Composable 状态模式、歌词工作流、Vitest 测试约定以及后端 AppState/ServiceAccess、增量扫描、FTS5 搜索、自定义 LRC 解析器、LRCLIB PoW 客户端定位功能→ 前端在components/、composables/、utils/中按名检索后端在src-tauri/src/按域检索命令全部收敛于main.rs保障质量→ 后端cargo check、前端npm run lint/format/test架构文档随代码演进。对于任何新加入 LRCGET 的开发者或 Agent这是从零到上手的最短路径。赞分享桌面应用音视频【免费下载链接】lrcgetUtility for mass-downloading LRC synced lyrics for your offline music library.项目地址https://gitcode.com/gh_mirrors/lr/lrcget点击查看免费下载相关推荐lrcget 前端架构详解Vue 3 Tauri Webview 下的音乐库浏览、播放与歌词编辑体系lrcget 前端架构详解Vue 3 Tauri Webview 下的音乐库浏览、播放与歌词编辑体系 本文基于仓库内 src/ARCHITECTURE.m桌面应用音视频Fantastic-admin 框架开发指南从 AGENTS.md 读懂 Vue 3 后台管理系统的工程全貌Fantastic admin 框架开发指南从 AGENTS.md 读懂 Vue 3 后台管理系统的工程全貌 导读本文以仓库根目录 AGENTS.md 为骨前端AI 技能Readest 端到端测试体系详解Playwright Web 与 WebdriverIO Tauri 双车道架构实战Readest 端到端测试体系详解Playwright Web 与 WebdriverIO Tauri 双车道架构实战 Readest 是一个跨平台的现代电子桌面应用跨平台前端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考