diff --git a/MUSIC_DECRYPT_PLAN.md b/MUSIC_DECRYPT_PLAN.md new file mode 100644 index 0000000..c9bb6d3 --- /dev/null +++ b/MUSIC_DECRYPT_PLAN.md @@ -0,0 +1,667 @@ +# 音乐模块 · 本地音乐解密规划(Music Decrypt Plan) + +> 状态:**P0 + P1a + P1c 已实施并完成真机端到端验证**(2026-09-27:网易云解密 + QQ音乐离线解密 + 文件夹批量 + musicex 在线取密钥,用真实 192kHz/24bit `.mflac` 样本跑通全链路;Rust 单测 204 项全库通过) +> 定位:音乐模块的「本地解密」子能力,不是独立模块——挂靠 `music` 模块新增「解密」页签,Rust 侧新增 `music/decrypt/` 子模块;`ncm` 与 `qmc` 均为纯 Rust 离线引擎,QQ 按「内嵌 ekey 离线 → musicex 在线取密钥」分层(Frida 降为 P2 兜底) +> 日期:2026-09-27(同日修订:QQ 分层重排、ncm 算法细节补全) +> 关联文档:`AI_DEV_GUIDE.md`(模块注册 / IPC 范式——注意 specta 绑定见 `lib.rs` 的 `export_bindings()`)、`MUSIC_REMOTE_PLAN.md`(规划文档范式) +> 参考项目与**许可分档**: +> - `taurusxin/ncmdump`(,**MIT**)——§3.1 全部算法细节的对照物,**可逐行对照**。 +> - `QQKWKG-TriMusicDecrypt`(QKKDecrypt,,**GPLv3**)——只取平台矩阵与坑清单。 +> - `ownlight6/qmc-decoder`(,**GPLv3**)——只取 QMC/musicex/ekey 的**格式与协议知识**()。 +> - GPLv3 两仓:**只读文档与行为,严禁抄代码**。 + +--- + +## 0. 结论先行 + +1. **范围收敛到两平台**(本轮显式指定):网易云 `.ncm` + QQ音乐 QMC 系列。酷狗/酷我明确出栈,不进任何分期。 +2. **两条技术路线,全部纯 Rust,零新增运行时依赖**: + - ncm → **Rust 原生**(`aes 0.8` / `cbc 0.1` / `base64 0.22` 已在依赖;`ecb` crate 不在依赖树,ECB 手写 16 字节块循环,零新增 crate)。 + - QQ → **Rust 原生三层路由**(详见 §3.2):① 尾部内嵌 ekey 的文件纯离线可解;② musicex 文件读本机凭据调 `GetEVkey` API;③ 前两层都不成立才用 Frida 注入兜底。 + - **本节原有的「Frida 主链」判断已作废**:它把「需要客户端在跑」与「需要 Frida 注入」绑成了一件事。实际只有第③层需要注入,而前两层覆盖绝大多数真实文件。改分层后**不再需要便携 Python、不再需要 `pip install frida`、不再受杀软与 mangled 符号版本漂移影响**。 +3. **UI 是音乐模块第 4 个页签「解密」**:`useModuleTabs` 加一项 + `DecryptPanel.vue` + 独立轻量 store,命令与事件挂进现有 music 命令族,完全照抄下载任务的「先回 taskId、进度走事件」范式。 +4. **许可边界分三档**:`ncmdump` 是 MIT,**可逐行对照**;QKKDecrypt 与 `qmc-decoder` 是 GPLv3 + FFmpeg GPL,**只沉淀格式/协议知识与坑清单,实现逐行重写**。 +5. **工作量**:P0(网易云 + 页签全链路)约 **2 个工作日**;P1a(QQ 离线 + API,纯 Rust)约 **2~3 个工作日**;P1b(Frida 兜底,按需)另计。 + +```mermaid +flowchart LR + subgraph FE["前端 · 解密页签"] + A["DecryptPanel.vue
文件选择 / 任务列表 / 状态卡"] + S["decryptStore.ts
任务状态 + 事件监听"] + end + subgraph R["Rust · music/decrypt/"] + C["commands.rs
run / cancel"] + N["ncm.rs
网易云离线引擎"] + Q["qq.rs
QMC 三层路由(P1)"] + end + subgraph QQS["QQ 三层(P1)"] + L1["① 尾部内嵌 ekey
纯离线"] + L2["② musicex → 本机凭据
GetEVkey API"] + L3["③ Frida 兜底
(P1b,按需)"] + end + O["savedir/decrypted/"] + A --> S --> C + C --> N --> O + C --> Q --> L1 --> O + Q --> L2 --> O + Q -.-> L3 -.-> O + Q -.->|"music-decrypt-event"| S + N -.-> S +``` + +--- + +## 1. 需求解构 + +| 用户原话 | 解构 | 落点 | +|---|---|---| +| 在音乐模块添加解密 Tabs | 音乐模块第 4 个页签 | §5.2 | +| 解密各平台的加密格式 | 收敛为 QQ音乐 + 网易云(本轮显式指定) | §3 | +| 最小路径实现 | 砍掉:转码、元数据回填、封面提取、拖拽、酷狗酷我、并发调优、历史持久化 | §7 P2 清单 | +| 可参考 QKKDecrypt | 对齐思路与坑,不搬 GPLv3 代码 | §3.3 | + +--- + +## 2. 现状勘察(2026-09-27 从仓库实际读取) + +### 2.1 已具备的基建(直接复用) + +| 能力 | 现有实现 | 复用方式 | +|---|---|---| +| Tab 体系 | `useModuleTabs`(`MusicModule.vue:78`,alwaysVisible 模式,标题栏浮动切换器自动接管) | 加 `{ value: 'decrypt', label: '解密' }` 一项 | +| 任务 + 事件范式 | `music_download` / `music-download-event`(`commands.rs:187`、`constants.rs:107`) | 解密照抄:先回 taskId,进度推事件 | +| 便携 Python + pip 镜像 | `runtime.rs`(清华源 `PIP_INDEX_URL`,`mod.rs:77`) | QQ sidecar 的 frida 安装、Python 就绪检查 | +| 加密依赖 | `Cargo.toml` 已有 `aes = "0.8"`、`cbc = "0.1"`、`base64 = "0.22"` | ncm 的 AES-128-ECB 手写循环,零新增依赖 | +| specta 绑定 | `lib.rs export_bindings()` 两处 `collect_commands!` | 新命令两处同步登记(`lib.rs:300` 注释明确要求) | +| 文件选择对话框 | `@tauri-apps/plugin-dialog`(`MusicModule.vue:4` 已 import) | 页签内直接用,不加 Rust 命令 | +| 输出目录 | 默认 `savedir`(设置页「本地下载目录」) | 解密默认输出 `savedir/decrypted/` | +| 播放引擎 | symphonia(`Cargo.toml:115`) | 解出的 flac/mp3/ogg 可直接进曲库试听 | + +### 2.2 关键缺口(需新增) + +| 缺口 | 说明 | +|---|---| +| ncm 解密实现 | 纯算法,约 200 行 + 单测 | +| QQ 运行期 sidecar | Frida 注入 + `EncAndDesMediaFile` 调用序列,按参考思路重写 | +| 解密任务 store | 下载任务在 `musicStore`;解密需独立轻量 store(页签切换会卸载组件,监听器必须挂 store) | +| frida 依赖安装 | `pip install frida`(wheel 带原生扩展,走现有镜像),需一条安装命令 + 进度事件 | + +--- + +## 3. 技术选型 + +### 3.1 网易云 `.ncm`:Rust 原生离线 + +**为什么不进 Python**: + +- ncm 是纯文件级算法,不需要任何进程配合;塞进 Python 等于把 200 行算法绑上「必须先装运行时」的前置。 +- 便携 Python 是按需安装(musicdl 才触发),解密不应被它卡住——Rust 路线开箱即用。 +- Rust 侧可直接 `cargo test`,对照样本文件做回归。 + +**算法要点**(对照 MIT 协议的 `ncmdump`(`src/ncmcrypt.cpp`)逐条独立重写。下面每一条都是**会写错的地方**,不是梗概): + +**① 容器结构** + +``` +0x00 magic 8B "CTENFDAM"(即 43 54 45 4E 46 44 41 4D) +0x08 2B 0x02 0x00 → 跳过 +0x0A key_len 4B LE +0x0E key_data key_len B (XOR 0x64 → AES-128-ECB → 得 RC4 密钥盒种子) +... meta_len 4B LE +... meta_data meta_len B (XOR 0x63 → 去 22B 前缀 → base64 → AES-128-ECB → 去 6B 前缀 → JSON) +... 5B 跳过(CRC32 4B + 图片版本 1B) +... cover_len 4B LE +... img_len 4B LE +... img_data img_len B (内嵌封面:PNG 或 JPEG) +... 跳 cover_len - img_len +... audio 剩余全部 (改性 RC4) +``` + +**② 两个 XOR 常量不同**(原文档误合并成一个 `0x64`) + +| 段 | XOR 常量 | 加密方式 | 解密后处理 | +|---|---|---|---| +| key 段 | `0x64` | AES-128-ECB | **跳过前 17 字节**(`neteasecloudmusic`),其余即 RC4 密钥盒种子 | +| meta 段 | `0x63` | AES-128-ECB(先 base64 解码) | 跳过前 6 字节(`music:`),其余为 JSON | + +**③ AES-128-ECB 解密**:**key 段与 meta 段用两个不同的 16 字节密钥**——`sCoreKey` = ASCII `neteasecloudmusi`(即 17 字节前缀 `neteasecloudmusic\0` 的前 16 字节)、`sModifyKey` = ASCII `#14ljk_!\]&0U<'(`。**收尾不是"去前缀",而是 PKCS#7 风格 padding**:逐 16 字节块解密,最后一字节即 padding 长度(`> 16` 时视作 0),去掉 padding 后再手动跳前缀。 + +> 易错点:**「AES 密钥」与「要剥掉的前缀」是两个东西**。`neteasecloudmusic` 既是被剥的 17 字节前缀(含结尾 NUL),其前 16 字节又是 key 段的 AES 密钥;meta 段则两者都不同。混用不报错、只会全解错(实现里分别命名为 `CORE_KEY` / `CORE_AES_KEY` / `MODIFY_KEY`)。 + +**④ meta 段的两层前缀**:原始数据前 22 字节是字面量 `163 key(Don't modify):`,**先剥掉它**,再对余下部分 base64 解码,才喂给 AES。 + +**⑤ 音频段是「改性 RC4」** + +- 密钥盒用参考实现的 KSA:`swap = keybox[i]`;`c = (swap + last_byte + key[key_offset]) & 0xff`,`key_offset` 触 keyLen 归零循环取 key,`keybox[i] = keybox[c]`、`keybox[c] = swap`、`last_byte = c`。**照抄即可,但注意 `last_byte` 在模 256 下是恒等变形(结果与标准 RC4 逐字节相同),它既不是"关键差异",也不能作为验证手段**——见 §6.25。 +- 明文按 `0x8000` 字节一块循环,块内 `j = (i + 1) & 0xff`,`plain[i] = cipher[i] ^ keybox[(keybox[(keybox[j] + j) & 0xff] + keybox[j]) & 0xff]`。块之间不重置密钥盒、也不额外跳字节——`i` 是块内下标。 +- **块边界必须由"读满一块"确定**(`read_full`),不能用 `Read::read` 的短读结果,否则相位错位、中途变噪声(§6.24)。 +- **不存在"每 0x8000 字节后跳过 5 字节间隔"**(原文档此条有误)。`0x8000` 是块大小,`5` 是 §① 里跳过的 CRC32 + 图片版本。 + +**⑥ 输出扩展名由音频首帧魔数决定,不是 meta 的 `format` 字段**(原文档此条说反了):首个解密块以 `ID3`(`0x49 0x44 0x33`)开头 → `.mp3`,否则 → `.flac`。meta 的 `format` 只用于另一件事——**判断该不该回填标签/封面时的格式分支**。 + +**⑦ 顺手可得的元数据**:meta JSON 含 `musicName` / `artist`(二维数组,取每项第 0 个元素并用 `/` 连接)/ `album` / `bitrate` / `duration`,且封面字节已在上面的 `img_data` 里读出。**P0 已实现封面单独落盘**(`<歌名>.cover.png|jpg`,按魔数定扩展名);**写进音频标签**仍留 P2——那需要 `lofty` 且要按 mp3/flac/m4a 分派容器,属于「增强」而非「能播」。 + +**⑧ 失败处理**:魔数不符 / `key_len <= 0` / 块不足 16 字节 → 返回可读错误(`Err(String)`),**per-file 失败不 panic、不中断整批**。 + +### 3.2 QQ音乐:Rust 原生三层路由(**本节已重写**) + +**原判断作废的理由**:原文把「需要 QQ 客户端在跑」与「需要 Frida 注入」绑成了一件事。二者其实独立——ekey(解密密钥)有三种存储形态,只有第三种才需要注入。前两层覆盖真实曲库的绝大多数文件,且都是纯 Rust。 + +**QMC 加密本体**(与 ncm 同构:字节流密码 + 可选密钥): + +| 方案 | 密钥来源 | 适用 | +|---|---|---| +| QMC1 | 固定种子,**无需密钥** | 旧版 `.qmc0` / `.qmc3` / `.qmcflac` / `.qmcogg` | +| QMC2 | ekey(base64 + TC-TEA 加密),密钥 ≤300B 走 Map XOR,>300B 走改性 RC4 | `.mgg` / `.mflac` 全系 | + +**ekey 的三种存储形态 → 三层路由**: + +| 层 | 形态 | 需要客户端? | 实现方式 | +|---|---|---|---| +| **①** | **尾部内嵌 ekey**:QTag 格式(ekey + 歌曲 ID + `QTag` 魔术)或 V1 格式(文件末尾 4 字节为 key 长度,key 在其前) | ❌ 不需要 | **纯 Rust 离线**,从文件尾直接提取 | +| **②** | **musicex 尾部**(QQ 客户端 ≥ 19.57 / Win 22.x):尾部 192B 只存 song_id + media_mid + filename,**ekey 不落盘** | ✅ 需运行且已登录 | **纯 Rust**:读凭据 → 调 API 取 ekey | +| **③** | 客户端内部导出(方案原文所选) | ✅ | Python sidecar + Frida attach `QQMusicCommon.dll` | + +**第②层的完整链路**(全部可在 Rust 内完成,`windows-sys` 只差一个 feature): + +1. 尾部检测:读末 8 字节,为 `"musicex\0"` 即 musicex;再向前读 `footer_size + 8` 解析完整 footer(`0x00` song_id u32LE、`0x0C` media_mid UTF-16LE 60B、`0x48` filename UTF-16LE 68B、`0xC0` footer_size、`0xC8` magic)。 +2. 取 `uin`:读 `%APPDATA%\Tencent\QQMusic\QQMusicServiceConfig.ini` 的 `[Account] Uin`(明文 INI)。 +3. 取 `authst`:**`authst` 在 Windows 上不落盘**,仅在运行中的 `QQMusic.exe` 进程内存里。用 `CreateToolhelp32Snapshot` + `Process32FirstW/NextW` 定位进程 → `OpenProcess(PROCESS_QUERY_INFORMATION | PROCESS_VM_READ)` → `VirtualQueryEx` 遍历可读区(只需 `MEM_COMMIT`,跳过 `MEM_MAPPED`)→ `ReadProcessMemory` 按 1MB 分块 → 搜 `"authst":"` 取其后 Base64URL 串。实测约 0.5 秒。 +4. 调 API:`POST https://u.y.qq.com/cgi-bin/musicu.fcg`,`req_1.module = "music.vkey.GetEVkey"`、`method = "CgiGetEVkey"`;`param.filename` **必须带 `.mgg`/`.mflac` 后缀**、`param.songtype` **必须为 1**(否则返回 `104005`)、`param.platform = "27"`(Windows)。响应取 `req_1.data.midurlinfo[0].ekey`。 + +> 三处易错点:`MEMORY_BASIC_INFORMATION` 在 Win10 1803+ 有 2 字节 `PartitionId` 插在 `AllocationProtect` 与 `RegionSize` 之间,**漏掉会导致 `state` 读成 `protect`、所有内存区被跳过**;`filename` 不带扩展名返回空 ekey;`authst` 有效期约 22.3 小时会过期。 + +**前置检查与降级出口**(UI 状态卡据此渲染):QQ 未运行或未登录 → 提示"请启动并登录 QQ 音乐后重试";层①②均失败的文件才落到③;Frida 不可用时报可读错误并给排除指引,**不自动拉起 QQ 客户端**。 + +**③(P1b,按需)的形态**若将来要做:`qq_decrypt.py` 走 `include_str!` 内置(与 `bridge.rs:17` 的 `BRIDGE_SCRIPT` 同范式),一次进程 attach 一批文件,stdout JSON-Lines 回报进度;导出符号是 mangled name(`?Open@EncAndDesMediaFile@@…`),**按子串 `EncAndDesMediaFile` 模糊匹配,严禁硬编码地址或 RVA**。 + +**输出扩展名**(不能按输入扩展名机械映射):`.qmc0`→`.mp3`、`.qmc3`→`.mp3`、`.qmc2`→`.ogg`、`.qmcogg`→`.ogg`、`.qmcflac`→`.flac`、`.mgg`/`.mgg0`/`.mgg1`/`.mggl`→`.ogg`、`.mflac`/`.mflac0`/`.mflach`→`.flac`(均以首帧魔数兜底校验)。**`.mmp4` 的产物容器(m4a 还是 mp4)尚未独立证实,实施 P1 时必须用真机样本确认后再定**。 + +### 3.3 许可边界(必须遵守,三档口径) + +- **MIT(可逐行对照)**:`taurusxin/ncmdump`(网易云 ncm 算法本体)。可直接对照 `src/ncmcrypt.cpp` 实现,仅需保留版权声明。 +- **GPLv3(只读文档与行为,严禁抄代码)**:`QQKWKG-TriMusicDecrypt`(+ FFmpeg GPL)、`ownlight6/qmc-decoder`。**整段搬代码 = 给本仓库引入 GPL 传染。** 允许的是:阅读其调用序列、常量、格式与协议说明后**独立重写**——本文档 §3.1 / §3.2 沉淀的正是这类非代码知识。 +- **合规口径**(UI 底部放一行):仅处理用户本人拥有合法访问权限的本地文件,不用于批量分发或规避付费授权。 + +--- + +## 4. 接口契约 + +### 4.1 Tauri 命令 + +```rust +// 任务 +music_decrypt_run(task_id, files?, folder?, root?, out_dir?, in_place?) -> Result<(), String> +music_decrypt_cancel(task_id: String) -> Result +// 预览与状态 +music_decrypt_scan(folder: String, root: Option) -> Result +music_decrypt_qq_status() -> Result // 只读本机,不发网络请求 +``` + +`QqOnlineStatus` 字段:`{ running, loggedIn, uin, ready, message, steps }`。 +**`authst` 不下发到前端**——它只活在后端内存里用于调接口。 + +- **注册是 3 处,不是 2 处**(实测仓库现状): + 1. `music/mod.rs` 的 `pub use commands::{...}` re-export(约 `mod.rs:48`); + 2. `lib.rs` 的 `collect_commands![]`(`export_bindings()` 内,`lib.rs:205`); + 3. `lib.rs` 的 `generate_handler![]`(`run()` 内,`lib.rs:348`)。 + 漏第 2 处 = 运行时能调但 `bindings.ts` 缺类型;漏第 1、3 处 = 编译失败或调用失败。 +- 前端沿用本模块既有范式(`musicStore.ts` 全用原生 `invoke` + 手写类型,不用 `commands`),故解密 store 同样用 `invoke`。 + +### 4.2 事件 `music-decrypt-event`(登记进 `constants.rs` 音乐分组) + +```typescript +type MusicDecryptEvent = // 注意:只有 tag 是 kebab-case,**字段名仍是 snake_case** + | { type: 'start'; task_id: string; total: number } + | { type: 'file'; task_id: string; index: number; name: string; + status: 'ok' | 'error' | 'unsupported'; + message: string | null; // 失败原因,或成功时的备注(平台 / 密钥形态 / 元数据摘要) + output: string | null; // 主产物 + cover: string | null } // 单独落盘的封面(网易云带内嵌封面时才有) + | { type: 'progress'; task_id: string; done: number; total: number; + bytes_done: number; bytes_total: number; name: string } + | { type: 'finished'; task_id: string; ok: number; failed: number; cancelled: number } +``` + +> **字段名是 snake_case 而非 camelCase**:`DecryptEvent` 上只有 `#[serde(tag = "type", rename_all = "kebab-case")]` +> 作用在 tag 上,变体字段名原样输出。前端 `decryptStore.ts` 的 `RawEvent` 必须照此声明 +> ——两边不一致时不会编译报错,只会表现为「任务建好了但进度永不动」。 +> Rust 侧有 `event_json_contract` 单测把形状钉死(§6.23)。 +> +> 结果态没有 `already`:P0 不做「已解密过则跳过」(同一文件重解会产出 `_1` 后缀的新文件), +> 语义比"猜哪份产物属于哪次输入"更可预测。 + +> 原先的 `deps-install` 事件随 `music_decrypt_install_deps` 一起取消——三层路由后不再需要 `pip install frida`。 +> 注意前端 `musicStore.ts:419` 是**硬编码事件名字符串**、并未引用前端常量表,故解密 store 同样硬编码,仅 Rust 侧登记常量。 + +### 4.3 文件识别(用户不选平台) + +按扩展名路由,魔数校验兜底: + +| 扩展名 | 路线 | +|---|---| +| `.ncm` | 网易云离线引擎(按内容魔数识别,不依赖后缀) | +| `.mgg` / `.mgg0` / `.mgg1` / `.mggl` / `.mflac` / `.mflac0` / `.mflach` / `.mmp4` / `.qmc0` / `.qmc2` / `.qmc3` / `.qmcflac` / `.qmcogg` | QQ 引擎(按尾部形态决定是否联网) | +| 其他 | 散选时保留为 `unsupported`;文件夹扫描时直接跳过 | + +> 后缀矩阵原文档只列了 3 个,会**静默漏掉用户曲库里的常见文件**,故过滤列表与路由表**一次写全**。 +> 实际判定以**内容**为准(§4.5),后缀只用于文件对话框的过滤器。 + +### 4.3.1 QQ 音乐:是否需要登录? + +这是使用者最常问的一点,所以结论放在前面: + +| 文件来源 | 扩展名 | 需要 QQ 音乐登录? | +|---|---|---| +| QQ 客户端 **≤ 19.51** 下载 | `.qmc0` `.qmc3` `.qmcflac` `.qmcogg` | **不需要** | +| QQ 客户端较旧版本下载(QTag / V1 尾部) | `.mgg` `.mflac` | **不需要** | +| QQ 客户端 **≥ 19.57** 下载(musicex 尾部) | `.mgg` `.mflac` `.mmp4` | **需要**:客户端运行 + 已登录 | +| 网易云(任何版本) | `.ncm` | **不需要** | + +**为什么新版必须登录**:从 19.57 起,QQ 音乐不再把解密密钥(ekey)写进文件, +只在文件末尾留 192 字节元数据;客户端自己也是在播放/下载时拿本机登录态 +(`uin` + `authst`)向服务器实时换取密钥。第三方要解开同一个文件,只能复刻这一步。 + +**这里的实现方式**:只读本机凭据(INI 里的 `uin` + 运行中 `QQMusic.exe` 内存里的 `authst`), +再调官方 `music.vkey.GetEVkey` 接口取密钥——**不注入进程、不改写文件、不做任何反检测**。 + +**操作步骤**(与 UI 状态卡里的文案一致): + +1. 在电脑上启动 QQ 音乐客户端(Windows 版)。 +2. 用它登录你的账号,并**保持客户端开着**(`authst` 只存在于运行期内存)。 +3. 回到「解密」页点「重新检测」,状态变为「已就绪」即可解密 musicex 文件。 +4. 若提示未取到登录令牌:先在客户端里**播放任意一首歌**触发一次网络请求,再重新检测。 +5. 仍失败则试过**以管理员身份运行**本应用(读其他进程内存可能需要更高权限)。 +6. 登录令牌约 **22.3 小时**过期;过期后重新检测即可,无需重装。 + +**UI 呈现**:状态卡显示三态(未运行 / 未登录 / 已就绪)+ QQ 号 + 「重新检测」按钮; +未就绪时折叠区里就是上面这 6 条步骤。上方那句"旧版文件与 `.ncm` 本来就不需要登录" +也会一并显示,避免用户误以为自己必须登录才能用这个功能。 + +### 4.4 输出路径规则 + +- **就地模式(`in_place = true`,文件夹批量的默认)**:产物与源文件**同目录同名**, + 仅按格式改扩展名(`Pop/a.mflac` → `Pop/a.flac`)。符合"就地解出来"的直觉, + 也天然不会与其他目录的同名文件冲突。此时 `out_dir` 不参与写盘。 +- **指定输出目录(`in_place = false`)**:默认根目录 `savedir/decrypted/`, + 并**按 `root` 还原相对目录结构**(`Pop/2026/b.ncm` → `out/Pop/2026/b.flac`)。 + 散选文件没有相对目录,平铺到根目录。 +- **同名去重**:即使还原了目录结构,同一目录内仍可能撞名(如 `.mgg` 与 `.mgg1` 同基名)。 + 规则:优先用原名,已存在(磁盘上或本批内已占位)则追加 `_1` / `_2`… +- **输入输出相交保护**:非就地模式下,若某输入文件已位于输出目录内则剔除, + 避免"解出来再解"无限膨胀;全被剔除时报错并提示可改用「就地解密」。 +- 扩展名以**音频首帧魔数**决定(ncm 见 §3.1⑥,QMC 见 §3.2 末),不信任输入扩展名; + 魔数认不出时才回退到输入后缀映射。 + +### 4.5 文件夹批量 + +命令参数的关系: + +| 参数 | 含义 | +|---|---| +| `folder` | **文件夹批量入口**:Rust 侧递归扫描该目录 | +| `root` | 计算相对路径的基准(决定输出目录里还原哪几层) | +| `files` | 散选文件列表(`folder` 为空时使用) | +| `in_place` | 就地解密(默认 `true`,见 §4.4) | +| `music_decrypt_scan` | 只扫描不解密,返回 `{ total, ncm, qmc }` 供 UI 预览 | + +**平台判定按内容,不按后缀**(`scan::route`): + +1. 读 8 字节魔数,命中 `CTENFDAM` → 网易云; +2. 否则读尾部判 QMC 形态:后缀在 QMC 家族里 → QQ音乐; +3. 后缀不认识时,只有**明确**的尾部形态(QTag / V1 / musicex)才认领—— + 否则任何末尾凑巧不是 `QTag` 的文件都会被判成"QMC1",噪声太大。 + +理由:同一曲库里 `.ncm` / `.mflac` / `.qmcflac` / `.mgg` 混放是常态,且 QQ 还有 +`.mgg0` / `.mflac0` 等变体,靠后缀枚举必然漏。代价是**认不出的文件会被跳过**, +所以扫描数可能少于用户预期——因此 UI 先调 `music_decrypt_scan` 显示 +"找到 N 个 · 网易云 x · QQ音乐 y",让用户在开跑前就能判断是否符合预期。 + +--- + +## 5. 架构与模块设计 + +### 5.1 Rust 侧 `src-tauri/src/music/decrypt/`(已实施的实际结构) + +``` +decrypt/ + mod.rs // 任务表(Mutex>)、工作线程 + 节流事件转发、事件契约 + common.rs // 两引擎公共件:DecryptError、魔数定格式、同名去重、读满一块 + ncm.rs // 网易云离线引擎(AES-ECB + RC4 变体 + meta/封面) + qmc.rs // QQ:QMC1 静态密钥 / QMC2 Map / QMC2 RC4 / tc_tea / 尾部形态 + 流密码 + qq_footer.rs // musicex 尾部解析(纯,可单测) + qq_credentials.rs // 凭据:INI 解析(纯)+ 进程内存取 authst(平台胶水) + qq_memscan.rs // Windows 专用:ToolHelp 枚举进程 + VirtualQueryEx/ReadProcessMemory(只读) + qq_ekey.rs // GetEVkey 请求组装与响应解析(纯,可单测) + qq_online.rs // 编排:musicex → 凭据 → 取密钥 → 解密;probe_status() + scan.rs // 文件夹递归扫描 + 内容优先的平台路由 + commands.rs // run / cancel / scan / qq_status(四条命令) +``` + +平台判定与密钥来源的**分工**:`scan.rs` 只决定"这文件归哪个引擎"; +`qmc.rs` 决定"密钥从哪来"(内嵌 / 静态);只有尾部是 musicex 时, +调度层才把 `KeyRequired` 交给 `qq_online.rs` 转在线路径——这样离线路径保持零网络依赖。 + +`mod.rs` 挂到 `music/mod.rs` 的子模块列表;事件常量加进 `constants.rs` 音乐分组。 + +### 5.2 前端 + +``` +src/modules/music/components/DecryptPanel.vue // 页签内容 +src/stores/decryptStore.ts // 任务列表 + 事件监听(照 musicUploadStore 范式) +MusicModule.vue // tabs 加一项 + +index.ts // searchItems 加「音乐解密」(tab: 'decrypt') +``` + +**P0 / P1a / P1c UI 形态**(已实施): + +- 顶部操作行:**选择文件夹** | 选择文件(dialog 多选,按 §4.3 全后缀过滤)| **就地解密开关** | 取消 / 清空记录 +- **QQ 音乐在线解密状态卡**:状态点(三态)+ 一句话状态 + QQ 号 + **重新检测** + 折叠的**操作步骤**; + 未就绪时折叠区里就是 §4.3.1 那 6 条,并附一句"旧版文件与 `.ncm` 本来就不需要登录" +- 输出目录行:就地模式下置灰并显示"与源文件同目录" +- **文件夹扫描预览条**:显示"找到 N 个 · 网易云 x · QQ音乐 y" + 开始解密按钮 +- 中部任务表:任务头(文件夹路径 / 进度条 / `bytes_done/bytes_total` / 打开产物目录)| + 文件行(文件名 | 平台徽标 | 状态徽章 | 打开产物目录 | 打开封面 | 备注或失败原因) +- 空态用 `StateBlock variant="empty"`;进度条结构恒定(完成后保留满格,不整块消失) +- 底部一行合规说明 + +### 5.3 数据流 + +与下载链路同构:前端 → `music_decrypt_run` → Rust 建 taskId 即回 → 后台执行 → `music-decrypt-event` → `decryptStore` 更新 → 列表刷新。页签切换组件卸载不影响任务(监听在 store)。 + +--- + +## 6. 关键实现细节与已知的坑 + +**ncm**(编号对应 §3.1 的条目号) + +1. `aes 0.8` 只有块原语、`ecb` crate 不在依赖树:ECB 手写 16 字节块循环(`cipher::BlockDecrypt::decrypt_block`)。**不要**为此引入 `ecb` crate。 +2. **两段 XOR 常量不同**(`0x64` key / `0x63` meta)。照抄成同一个常量 = 必然失败。 +3. **PKCS#7 风格 padding**:AES-ECB 收尾取最后一字节为 padding 长度(`> 16` 视作 0),不是“去前缀”。 +4. **改性 RC4 KSA 的 `last_byte` 累加**(照抄参考实现即可,但别误解它): + 式子 `c = (swap + last_byte + key[key_offset]) & 0xff` 在模 256 下**恰好化简为标准 RC4**, + 实测两者密钥盒逐字节相同(256/256)。因此它**不是**"与标准 RC4 的关键差异", + 也不能靠与标准 RC4 比对来验证实现——验证只能靠固定向量(见 §6.25)。 + `key_offset` 触 keyLen 归零循环取 key 这一点照抄。 +5. **音频块之间不跳字节**,`0x8000` 只是块大小;`i` 是块内下标。原文档的"每 0x8000 跳过 5 字节"是错的(那 5 字节在 §① 的头部里,且已单独处理)。**但块边界必须由"读满一块"确定**,不能用 `Read::read` 的短读结果(见 §6.24)。 +6. **输出扩展名看音频首帧魔数**(`ID3` → `.mp3`,否则 `.flac`),不看 meta 的 `format`。 + 实现比这条更宽一点:还识别 `fLaC` / `OggS` / `RIFF..WAVE` / `ftyp` / `wvpk`, + 给 P1 的 QQ 产物复用(ncmdump 的兜底同为 flac)。 +7. meta 段是**两层前缀**:先剥 22 字节 `163 key(Don't modify):`,再 base64,再 AES,再剥 6 字节 `music:`。 +8. **流式处理**:`0x8000` 块逐块读→解→写,禁止整文件读入内存(`.mmp4` 可能很大)。大文件下需按已处理字节数推 `progress`。 +9. **单测不依赖真实样本**:真实 FLAC 最小样本进不了仓库。改为对**中间产物**断言——AES-ECB 往返、KSA 密钥盒已知值、padding 剥离、魔数→扩展名判定、以及"自造一个合法 ncm 容器(用同一套算法正向构造)再解回来"的往返测试。真机样本走手动自测。 +10. 魔数/解析失败走 per-file `Err`,**不 panic、不中断整批**。 + +**QQ(P1)** + +11. 第①层(QTag / V1)**完全离线**,不要因为"QQ 文件"就先去连客户端——先用尾部分支判形态再决定要不要读凭据。 +12. 第②层的 `authst` **只在 `QQMusic.exe` 运行期内存里**,不落盘;`uin` 在 `QQMusicServiceConfig.ini` 可明文读。`MEMORY_BASIC_INFORMATION` 的 2 字节 `PartitionId`(Win10 1803+)**必须包含**,否则 `state` 会读成 `protect`、所有内存区被跳过。 +13. API 三处必须:`filename` 带 `.mgg`/`.mflac` 后缀、`songtype = 1`、`module = music.vkey.GetEVkey`(不是 `GetVkey`)。否则 `104005` 或 ekey 为空。 +14. `authst` 约 22.3 小时过期:失败文案要给"重新登录 QQ 音乐"的出口,而不是只报网络错误。 +15. 第③层(Frida):必须**先启动 QQ 音乐**再 attach,`QQMusicCommon.dll` 打开主界面即加载;导出符号是 mangled name,**按子串 `EncAndDesMediaFile` 模糊匹配,严禁硬编码地址或 RVA**;被杀软拦截只给排除指引,**不做反检测动作**;批量时客户端 UI 可能短暂卡顿,属预期。 +16. `path_sensitive_mflac` 变体(同名文件不同目录内容不同)P1 不处理:报错带全路径,遇到再迭代。 +17. `.mmp4` 产物容器未证实,P1 先用真机样本确认再定(见 §3.2 末)。 + +**工程** + +18. 新命令登记 **3 处**:`music/mod.rs` re-export、`lib.rs` 的 `collect_commands![]`、`lib.rs` 的 `generate_handler![]`(见 §4.1)。 +19. `music-decrypt-event` 常量进 `constants.rs` 音乐分组;前端沿用硬编码字符串(与 `musicStore.ts:419` 一致)。 +20. 解密 store 必须独立于组件生命周期:Tabs 非 active 会卸载内容,事件监听挂 store 不挂组件。 +21. **输出同名去重 + 输入输出相交保护**(见 §4.4)——原文档缺失,不做会静默覆盖用户文件。 +22. 三层路由后**不再需要便携 Python 与 frida**,`music_decrypt_install_deps` 命令取消;QQ 未登录的错误出口走状态卡提示。 + +**实施中新增确认的坑(2026-09-27 实测)** + +23. **事件字段名是 snake_case**(不是 camelCase)。`#[serde(tag = ..., rename_all = "kebab-case")]` + 只作用于 tag,变体字段名原样输出。前后端不一致时**不报错**,只表现为进度不动。 + Rust 侧 `event_json_contract` 单测钉死 JSON 形状。 +24. **音频块边界必须用"读满一块"而非 `Read::read` 的返回值**。`BufReader::read` 会短读, + 块边界一漂移,解密式里的「块内偏移 `i`」就与加密侧错位,表现为**文件从中间某处起全是噪声** + (实测首个坏字节落在 32418,仍在第一大块内),前半段却完全正常,极难排查。 + 已加 `read_full()` 专门处理。 +25. **`last_byte` 累加在模 256 下是恒等变形**:`c = swap + last_byte + key` 与标准 RC4 的 + `j += s[i] + key` 结果**逐字节相同**(已实测 256/256 一致)。所以: + - 不能靠"与标准 RC4 比对"来验证密钥盒实现; + - 也**不要**以为它是"改性 RC4 的关键差异"而据此改写(本计划早期的 §6.4 表述即由此误导)。 + 真正的验证手段是**固定向量**(`key_box_matches_reference_vectors` / + `keystream_matches_reference_vector`)。 +26. **`MODIFY_KEY` 是 16 字节而非 17**(`aes::Aes128` 的密钥长度就是 16); + `CORE_KEY` 的 17 字节是**解密后要剥掉的前缀**,与 AES 密钥不是同一个东西 + (AES 密钥是它的前 16 字节)。两者混用不会编译报错,只会全解错。 +27. **合成容器单测的 key 段必须带 `neteasecloudmusic` 前缀**——否则解密端剥前缀后拿到错种子。 + 这个坑一度被"单循环 KSA"的错误实现掩盖(两边同时错、往返仍然自洽)。 + +**P1a(QQ 离线)实施中新增确认的坑** + +28. **QMC2 Map 密码的 `scramble` 必须用 `wrapping_shl/shr`**(对移位量取模), + 不能写成 `u8::rotate_left/rotate_right`——后者会在内部再取一次模,结果**不同**。 + 被 Apache 参考实现的原向量抓到(若不比对向量,会产出"能跑但全错"的解密)。 +29. **tc_tea 不是 TEA-ECB,而是 TEA 变体 + 自定义 CBC**:块与密钥字都是**大端**、 + 16 轮(非 32)、单轮是 `((v<<4)+k1) ^ (sum+v) ^ ((v>>5)+k2)`, + 且明文前置 `1+pad+2` 字节头、尾部 7 字节 0 自校验。照 TEA-ECB 写会解出**部分可读的乱码** + (表现极具迷惑性:能看到明文碎片)。尾部 0 校验正是"密钥对不对"的权威判据。 +30. **V1 尾部判定不能只看长度**:任意加密数据末尾都可能凑出 `0 0x7FFF`(严格大于)**,不是 `>=`;写成 `>=` 会在回绕点差一字节。 + +**P1c(musicex 在线)实施中新增确认的点** + +33. **`MEMORY_BASIC_INFORMATION` 的 `PartitionId`(Win10 1803+)**:直接沿用 + `windows-sys` 的结构体即可,但**自己手写 `#[repr(C)]` 时千万别漏**——漏了会让 + `RegionSize`/`State`/`Protect` 全部读错偏移,`VirtualQueryEx` 返回的 `State` + 读成 `Protect`(如 `0x04` 而非 `0x1000`),于是所有内存区被跳过、永远扫不到 token。 +34. **`getEVkey` 的三个"必须"**:`filename` 带扩展名、`songtype=1`、 + `module=music.vkey.GetEVkey`(不是 `GetVkey`)。任一写错都只是"拿不到 ekey", + 不会报错——所以请求体用纯函数组装并单测锁死(`qq_ekey::build_evkey_request`)。 +35. **`authst` 会过期(约 22.3 小时)**:失败文案必须给"重新登录 / 重新检测"的出口, + 否则用户会以为是网络问题。响应里的 `expiration` 已带进产物备注。 +36. **单元测试不要真的发网络请求**:本机一旦登录成功,测试就会去连 QQ 服务器, + 导致测试变慢变脆。改为验证"请求体能正确构造"+"`#!Qk` 头守卫"+"尾部能被解析出 + `media_mid`/`filename`"三段——真实响应留给真机端到端。 +37. **musicex 音频段要校验 `#!Qk` 头**:尾部像 musicex 不代表内容真是 QMC2 密文; + 没有这道守卫会把任意文件"解"成垃圾却报告成功。 + +**真机端到端验证后修正(2026-09-27)** + +38. **`#!Qk` 不是 QMC2 密文的通用魔术**(推翻第 37 条的做法):真机 musicex 样本 + (Avicii - Heaven,197MB `.mflac`)的密文头是 **`51 74 03 75`**,按"必须以 `#!Qk` + 开头"写的守卫会把**完全合法的文件误拒**。 + 正确做法是**用解密结果判定密钥是否正确**:用取到的密钥解出前 16 字节, + 看是否是已知音频魔术(`fLaC` / `OggS` / `ID3` / `ftyp`…)——密钥错时它是随机噪声, + 几乎不可能凑巧命中;命中即说明密钥对、文件也对。 + 这也是"内容优先"原则的又一次应用:**不要用猜测的密文特征做判据,要用能验证的结果。** +39. **文档给的 musicex 字段偏移在真样本上是对的**:`0x0C` media_mid(60B UTF-16LE)、 + `0x48` filename(68B UTF-16LE)、`0xC0` footer_size、`0xC8` magic 全部命中, + 尾部实测 192 字节、padding 区有 13 个非零字节(所以不能假设 padding 全 0)。 +40. **真机样本的规模提醒**:`.mflac` 可达 197MB / 192kHz / 24bit。 + `qq_online` 目前把音频段整段读入内存再解密(探针与生产路径都是), + 在这个量级下可用,但如果将来遇到多 G 的文件,应改成分块解密 + 流式写盘 + (`qmc` 的流密码本身已支持任意偏移)。 + +--- + +## 7. 分阶段计划 + +### P0 — 网易云 + 解密页签全链路(约 2 天)**✅ 已实施(2026-09-27)** + +- [x] `useModuleTabs` + `TabsContent` 接「解密」页签;`index.ts` 搜索条目 +- [x] `decrypt/ncm.rs`:§3.1 全部要点 + 单测(**18 项通过**) +- [x] `decrypt/mod.rs` + `commands.rs`:run / cancel + 事件发射;**三处**登记;`constants.rs` 事件常量 +- [x] `decryptStore.ts` + `DecryptPanel.vue`:选文件 → 批量任务 → 进度 → 打开输出目录 +- [x] 输出同名去重 + 输入输出相交保护(§4.4) +- [x] 封面单独落盘(`<歌名>.cover.png|jpg`)——标签回填仍留 P2(`lofty` 需按容器分派) +- [ ] **自测:真实 `.ncm` 样本解出**(需人工用真机样本验证;仓库内样本有版权且体积大,故算法靠 §6.9 的中间产物单测 + 合成容器往返覆盖) +- **验收**:页签选 10 个 ncm 全部解出、失败有原因、切页签不丢任务、播放器直接可播 + +**已交付文件**: + +| 文件 | 内容 | +|---|---| +| `src-tauri/src/music/decrypt/ncm.rs` | 网易云离线引擎(容器解析 / AES-ECB / 密钥盒 / 流式解密 / 魔数定格式 / 封面 / 同名去重)+ 单测 | +| `src-tauri/src/music/decrypt/mod.rs` | 任务表、工作线程 + 节流事件转发、`DecryptEvent` 契约(含 JSON 形状单测) | +| `src-tauri/src/music/decrypt/commands.rs` | `music_decrypt_run` / `music_decrypt_cancel` + 输出目录解析与相交保护 | +| `src/stores/decryptStore.ts` | 任务状态 + 事件监听(挂 store,不随组件卸载) | +| `src/modules/music/components/DecryptPanel.vue` | 页签 UI | +| `music/mod.rs` · `lib.rs` · `constants.rs` | 子模块挂载、`MusicManager.decrypt` 字段、三处命令登记、事件常量 | + +### P1a — QQ 离线解密 + 文件夹批量(**✅ 已实施,纯 Rust,无 Python/frida**) + +- [x] `decrypt/qmc.rs`:QMC1 静态密钥表 / QMC2 Map 密码 / QMC2 RC4 变体 / tc_tea(TEA 变体 + 自定义 CBC) +- [x] 第①层:QTag 与 V1 尾部 ekey 提取 → **离线解密** +- [x] `decrypt/scan.rs`:递归扫描 + 内容优先的平台路由 + 保留相对目录结构 +- [x] **文件夹批量**:`folder` / `root` / `in_place` 三个参数 + `music_decrypt_scan` 预览命令 +- [x] `decrypt/common.rs`:两引擎统一的错误类型、魔数定格式、同名去重、读满一块 +- [x] 单测 **56 项**(模块合计 174 项全库通过),含参考实现的原始测试向量 +- [ ] 第②层 musicex + `GetEVkey` API(**未实施**,见 P1c) +- [ ] 真实 `.mflac/.mgg/.qmcflac` 样本自测(需人工;仓库内不放版权样本) + +**已交付文件(P1a 增量)**: + +| 文件 | 内容 | +|---|---| +| `src-tauri/src/music/decrypt/qmc.rs` | QMC 全套离线算法 + 尾部形态判定 | +| `src-tauri/src/music/decrypt/scan.rs` | 文件夹递归扫描与平台路由 | +| `src-tauri/src/music/decrypt/common.rs` | 两引擎公共件 | + +**算法来源(全部宽松许可,均有原始向量锁行为)**: + +| 部分 | 来源 | 许可 | +|---|---|---| +| QMC1 静态密钥表 + 掩码规则 | `jixunmoe/qmc-decode` | MIT | +| QMC2 密钥派生 / Map / RC4 / 尾部形态 | `bczhc/qmc-dec`(`qmc2-crypto`) | Apache-2.0 | +| tc_tea | `tc_tea` crate | MIT/Apache-2.0 | + +### P1b — Frida 兜底(按需,不计入本轮) + +- [ ] `qq_decrypt.py`(`include_str!`):attach → `EncAndDesMediaFile` 调用序列 → 批量 → JSON-Lines 进度 +- [ ] `decrypt/qq_frida.rs`:前置检查、spawn、逐行读转发事件 +- **触发条件**:仅当 §3.2 的第③层文件在真实用户场景中被确认存在且前两层无法覆盖时才做 + +### P1c — musicex 联网取 ekey(**✅ 已实施**) + +- [x] `qq_footer.rs`:musicex 尾部解析(song_id / media_mid / filename) +- [x] `qq_credentials.rs`:读 `%APPDATA%\Tencent\QQMusic\QQMusicServiceConfig.ini` 的 `uin` + 扫进程内存取 `authst` +- [x] `qq_memscan.rs`(Windows):`CreateToolhelp32Snapshot` + `OpenProcess` + `VirtualQueryEx` + `ReadProcessMemory`(**只读**) +- [x] `qq_ekey.rs`:`GetEVkey` 请求组装与响应解析(`filename` 带扩展名 / `songtype=1` / `platform="27"`) +- [x] `qq_online.rs`:编排 + `probe_status()` 在线能力探测 +- [x] `music_decrypt_qq_status` 命令 + UI 状态卡(含**逐步操作说明**) +- [x] `windows-sys` 增开 `Win32_System_Diagnostics_ToolHelp` 与 `..._Debug` +- [x] **本机实测**:`probe_status()` 返回 `running=true logged_in=true uin=1154027699 ready=true` —— 内存扫描确实取到了 `authst` +- [x] **端到端已用真机样本跑通**(2026-09-27,见下) + +#### 真机端到端验证记录(首个 musicex 样本) + +样本:`C:\Users\Administrator\Music\Heaven - Avicii_EM.mflac`(197,104,516 字节, +尾部 `musicex\0`,`song_id=233102682`,`media_mid=003iTvi44A6RMs`, +`filename=AIM0002ELI6a1wXJDo.mflac`) + +| 环节 | 实测结果 | +|---|---| +| 尾部解析 | song_id / quality1=2 / quality2=11 / media_mid / filename 全部正确 | +| 凭据 | 返回 `running=true logged_in=true uin=1154027699 ready=true` | +| `GetEVkey` | **成功**,拿到 704 字符 ekey;`expiration=80400`(22.3 小时,与文档一致) | +| ekey → 密钥 | 解密出 **512 字节**原始密钥 → 命中 **RC4 变体**(>300 字节)分支 | +| 音频段 | 197,104,324 字节(= 文件大小 − 192 字节尾部,完全吻合) | +| 解密结果 | 首帧 `66 4c 61 43` = **`fLaC`** ✅ | +| 产物校验(`lofty`) | **277.261 秒 · 192000 Hz · 24 bit · 2 声道 · 5686 kbps** —— 192kHz/24bit Hi-Res 无损 | + +**验证方式**:`examples/decrypt_musicex_probe.rs` 走真实链路(读内存凭据 → 真实 +HTTP 请求 → 解密),再用 `examples/verify_audio.rs` 交给项目同款解析器确认产物合法。 +两个 example 都保留,供后续 QQ 改协议时快速定位。 + +**这次验证推翻了一个错误假设**:样本的密文头是 `51 74 03 75`,**不是**文档里提到的 +`#!Qk`。原先按"密文必须以 `#!Qk` 开头"写的守卫会把完全合法的文件误拒——已改为 +**用解密结果判定**(解出的前 16 字节是否为已知音频魔术),见 §6.38。 + +**凭据可用性已知限制**: + +| 维度 | 情况 | +|---|---| +| `uin` 来源 | INI 明文,稳定 | +| `authst` 来源 | 仅运行期内存;**QQ 音乐必须开着且已登录** | +| 有效期 | 约 22.3 小时(响应 `expiration` 字段,已带进产物备注) | +| 权限 | 读他人进程内存可能需管理员;失败文案已提示 | +| 是否注入 | **否**,纯只读——这是它与 Frida 兜底的本质区别 | + +### P2 — 按需增强(不进本轮) + +- **ID3 / FLAC / MP4 标签回填**(用 `lofty`,按容器分派;meta JSON 已在解密时解析出来) +- 解密完成 →「加入本地曲库」/ 上传飞牛(复用 `musicUploadStore`) +- 拖拽文件进页签、解密历史持久化 +- 酷狗 / 酷我(除非再次明确要求) +- QQ 变体适配(path_sensitive_mflac) + +> **变更**:原计划把「封面提取 / ID3 标签回填」一起从 P2 提前到 P0。**实际只提前了封面提取**—— +> 封面字节在解析容器时顺手就读出来了,落盘是十几行,且不做就"能播但难用"。 +> 标签回填仍留 P2:它需要 `lofty` 且要按 mp3/flac/m4a 分派容器,属于增强而非可用性门槛。 + +--- + +## 8. 风险与开放问题 + +| 风险 | 影响 | 对策 | +|---|---|---| +| QQ 改 musicex 尾部/API 协议 | 第②层失效 | 协议字段集中在 `qq_footer` / `qq_ekey` 两处;错误文案带原始响应码;关注 qmc-decoder issue | +| `authst` 提取被安全软件拦截 | 第②层失效 | **只读**内存、不注入;失败给"以管理员身份运行"出口 | +| **musicex 端到端** | ~~真实响应字段可能与文档不符~~ **已验证通过**(真机 197MB 样本,产物为合法 192kHz/24bit FLAC) | 保留 `examples/decrypt_musicex_probe.rs` + `verify_audio.rs`,QQ 改协议时可快速定位 | +| `authst` 过期(22.3h) | 第②层短期失效 | 错误文案给"重新登录/重新检测"出口;有效期带进产物备注 | +| QQ 版本升级改 mangled 导出符号 | 仅第③层(Frida)失效 | 子串模糊匹配;第③层不在实施范围,影响面已缩小 | +| 真实样本不足导致算法细节偏差 | 解出错文件 | **已用参考实现的原始测试向量交叉验证**(QMC1 掩码 / Map / RC4 / tc_tea / ekey 端到端) | +| GPLv3 边界被无意破坏 | 许可风险 | 三档口径见 §3.3;QMC 只取 MIT / Apache-2.0 两份来源的**代码与数据** | +| 网易云改 ncm 格式 | 个别文件失败 | per-file error 不中断整批 | +| 同名文件落盘互相覆盖 | **用户文件丢失** | §4.4 同名去重 + 相交保护 | +| 文件夹扫描漏文件(内容认不出) | 用户以为解完了 | UI 先出 `music_decrypt_scan` 预览数量 | + +**开放问题**: + +1. 解密输出默认就地(文件夹批量)或 `savedir/decrypted/`(散选);独立设置项留 P2。 +2. QQ 未运行时是否自动拉起?**离线层与 `.ncm` 完全不需要客户端**;只有 musicex 需要, + 当前选择"只提示、不自动拉"(客户端要登录,自动拉起也解决不了登录态)。 +3. `.mmp4` 的产物容器(m4a / mp4)待真机样本确认——当前靠首帧 `ftyp` 魔数判定,认不出时按后缀落 `m4a`。 + (`.mflac` 已实测确认:产物为 192kHz/24bit 的 `.flac`。) +4. ~~musicex 端到端未验证~~ **已解决**(2026-09-27,真机样本跑通,见 P1c 的验证记录)。 +5. `.mflac0` / `.mgg1` 等变体按 QMC2 处理,但**未用真实样本验证**过其尾部形态与 `.mflac` / `.mgg` 一致。 +6. 微信登录的 QQ 音乐 (`tmeLoginType=3`):实现上 `authst` 与 QQ 登录通用, + 但 `login_type` 目前固定发 `1`(QQ 登录实测可用)——若真机发现微信登录取不到 ekey,需按凭据来源推断。 +7. **大文件内存占用**:`qq_online` 目前整段读入内存解密;197MB 实测可用, + 但 `.mflac` 可以更大。若遇到多 G 文件,应改流式(`qmc` 的流密码已支持任意偏移)。 + +--- + +## 附录 A:参考项目对照(只取思路) + +### A.1 QKKDecrypt 实测结论(2026-09-27 深读 `main@938b22d`,来自其源码而非猜测) + +**最重要的一条**:该项目 QQ 路径**完全不解析 QMC 加密格式**——它把原始加密文件整包交给 QQ 自己的 DLL 解密,因此不受 static/map cipher 变体影响。**代价是强依赖四项**:QQ 客户端运行 + `QQMusicCommon.dll` 已加载 + **管理员权限**(`cli.py::_require_admin()`,非管理员直接 `return 2` 并打印"已禁止继续使用")+ mangled 名/编译器版本不变。**这四项与它的"回退"一起,正是我们改走 §3.2 分层路由的原因。** + +| QKKDecrypt 文件 | 可借鉴 | 不可借鉴 | +|---|---|---| +| `platforms/qq/adapter.py` | `SUPPORTED_SUFFIXES` 仅 `.mflac/.mgg/.mmp4`;前置检查项;ASCII 暂存 | +| `qq/runtime/qqmusic_decrypt.py` | `EncAndDesMediaFile` 的 3 组候选 mangled 名、NativeFunction 全 `thiscall` 签名、调用序(`Memory.alloc(0x28)` → ctor → `allocUtf16String` → `Open(..,1,0)` → `GetSize` → `Read` → dtor) | **硬编码**;整文件读入内存;未校验 `Open`/`Read` 返回值 | +| `qq/runtime/frida_decrypt_gateway.py` | 进程查找用**子串匹配** `"qqmusic"`;**每批次只 attach 一次**并缓存 session | 无 session 重连(QQ 中途重启即失效) | +| `qq/variant_adapter.py` | "路径敏感型 mflac"→**解密前先复制到纯 ASCII 路径**(`pick_safe_tmp_dir`:盘根 `_qqmusic_tmp` → 项目根 → `tempfile.gettempdir()`) | 只实装了这一个变体 | +| `qq/internal_direct.py` / `qq/export_fallback.py` | — | **存在但未接入主流程 = 死代码**,不可当作可用的回退能力承诺 | +| `platforms/netease/adapter.py` | 输出扩展白名单法 | **它没有自研 ncm 算法**——直接 `from ncmdump import NeteaseCloudMusicFile` 委托 PyPI 的 `ncmdump-py`;且 `predicted_extension()` 会**多解密一遍**(性能坑) | +| `Application/decrypt_service.py` | 事件粒度 = **逐文件 `index`/`total`**;`file_finished.result ∈ success/failed/already_decrypted` | 事件种类过多(20+) | +| `cover_art_service.py` | "本地同名图 → 缓存 → 联网"的 local-first 顺序 | **给网易云产物做封面兜底时查的是 QQ 音乐 API** | +| `THIRD_PARTY_LICENSES.md` | 合规口径与风险表述 | 内置 FFmpeg 为 `--enable-gpl --enable-version3` 构建 → 传染面比"仓库 GPLv3"更大 | + +**对本文档的两处直接修正**: + +1. **"输出扩展名看音频首帧魔数"得到双重印证**——QKKDecrypt 的最终扩展名同样**不取映射表**,而是 `detect_audio_container()` 从实际字节判定(`fLaC`/`OggS`/`RIFF..WAVE`/`ID3`/`0xFF 0xFB|0xF3|0xF2`/偏移 4 处 `ftyp`)。故 §3.2 的输出扩展名表仅作**声明/预期**用,实际以魔数为准。 +2. **`.mgg` 解出后它强制归一为 `.m4a`**(`normalize_target_format` 把 `ogg→m4a`)。本项目**不跟**这个行为——`Cargo.toml:112` 已确认 symphonia 默认特性含 `ogg/vorbis`,直接落 `.ogg` 即可播,保持"所见即所得"(§3.1 原口径)。 +3. QKKDecrypt 不支持 `.mflac0/.mgg1/.mflac1/.qmc*`——**我们的扩展面比它宽**(§4.3),但格式知识来源是 qmc-decoder 的**文档**(GPLv3,不抄代码)。 + +### A.2 借鉴到 P0 的一条设计(**最终未采用,附理由**) + +QKKDecrypt 的 `file_finished.result` 含 `already_decrypted` 与 `stopped_by_user` 两个态。 +**`stopped_by_user` 已采纳**(取消后 `finished.cancelled > 0`,任务落为"已取消")。 +**`already_decrypted` 决定不做**:它要判断"某份已存在的产物是否就是本次输入的产物", +在扁平输出目录里只能靠文件名猜,猜错就静默跳过用户的文件——代价大于收益。 +P0 改为**永不跳过**:目标名被占用就写 `<名>_1.`,宁可多一份产物也不丢工作。 +(`ncm::unique_output` 同时处理"磁盘上已存在"与"本批次内已占用"两种情况。) diff --git a/MUSIC_REMOTE_PLAN.md b/MUSIC_REMOTE_PLAN.md new file mode 100644 index 0000000..977cb62 --- /dev/null +++ b/MUSIC_REMOTE_PLAN.md @@ -0,0 +1,303 @@ +# 音乐模块 · 手机端连接与控制规划(Music Remote Plan) + +> 状态:**规划中**(未开始实施) +> 定位:音乐模块的"手机互联"子能力,不是独立模块——挂靠 `music` 模块,Rust 侧新增 `music/remote/` 子系统 +> 日期:2026-09-25 +> 关联文档:`AI_DEV_GUIDE.md`(模块注册 / IPC 范式——注意其未涵盖 specta,绑定范例见 `lib.rs` 的 `export_bindings()`)、`TERMINAL_MODULE_PLAN.md`(规划文档范式) +> 对端文档:`F:\AtieProject\LFMusic\PLAN.md`(手机端 LFMusic 的功能与实现规划,协议以本文 §4(协议)/ §5(实现)为准) + +--- + +## 0. 结论先行 + +四个关键判断,先摆在这里,后文展开论证: + +1. **"获取电脑端正在播放的内容(不管是不是 Thing 播的)"必须走 GSMTC**(`GlobalSystemMediaTransportControlsSessionManager`),而不是扩展现有的 `smtc.rs`。`smtc.rs` 以"Thing → 系统"的元数据/进度上报为主(`ISystemMediaTransportControlsInterop::GetForWindow`),并经 `TypedEventHandler` 接收系统按钮回传(双向)——但它只管自己这条会话;要读到**系统里所有应用的媒体会话**(网易云、QQ 音乐、浏览器、Thing 自己……),唯一官方通道是 GSMTC 的全局会话管理器。两者方向相反、互不冲突,`smtc.rs` 原样保留。 + +2. **控制链路统一走 GSMTC 的 `Try*Async`,Thing 自己不特殊处理**。手机发的播放/暂停/切歌 → Thing 的 GSMTC 调用 → 系统把按钮事件派发给目标会话。Thing 自己因为已在 `smtc.rs` 注册了 SMTC 会话并有按钮事件回传链路(`music-smtc-button` → 前端执行),这条环路是现成的,**对 Thing 自身会话近乎零新增执行代码**(需补的是 cmd-ack 语义与派发时序定义,见 §4.2 / §5.2)。不要为 Thing 自建"直通 AudioEngine"的旁路——多一条路径就多一类不一致(P1 若延迟体感明显再优化)。 + +3. **局域网服务用 axum(已有依赖)新增 HTTP + WebSocket 双通道,发现用"电脑广播 beacon + 手动扫码"双保险**。axum 已在 `download_engine/server.rs` 和 `feiniu/proxy.rs` 两处落地,范式现成。发现协议不选 mDNS 做 P0 主路径:Android/iOS 的 mDNS 栈碎片化、路由器 AP 隔离下失效、iOS 后台受限;而电脑端周期性 UDP 广播 + 手机被动监听实现最简、权限最友好,配合二维码手动配对兜底已覆盖 99% 场景。mDNS 降级为 P1 增强。 + +4. **安全按"配对制"设计,不做裸奔**。首次连接用一次性配对码(Thing 弹窗展示,手机扫码/手输),换取长期设备 token;token 两侧持久化(Thing 侧入 keyring,手机侧入系统安全存储),后续连接 WS 握手鉴权,设置页可随时撤销设备。局域网明文 HTTP 在 P0 可接受(风险面:同网段已配对 token 泄露才会被利用),TLS 自签放 P2。 + +**工作量估算**:P0(系统会话捕获 + LAN 服务 + 发现配对 + 基础遥控)约 6~9 个工作日;P1(mDNS、多会话切换、系统音量、投播)约 5~8 个工作日;P2(TLS、队列投播完善)按需。 + +--- + +## 1. 需求解构 + +用户需求拆成可执行的规格: + +| 用户原话 | 解构为 | 落点 | +|---|---|---| +| 「手机端 app 打开后自动连接局域网电脑上的 Thing」 | 电脑端局域网服务(HTTP+WS)+ 自动发现(UDP beacon)+ 配对与鉴权 | §3.2 / §3.3 / §3.4 | +| 「可以获取到电脑端正在播放的内容(不管是 Thing 自己播放的,或是其他应用播放的)」 | GSMTC 全局会话监视:当前活跃会话的元数据、进度、播放状态、封面 | §3.1 / §5.2 | +| 「显示例如歌曲名,歌手,专辑,封面,进度」 | `NowPlaying` 状态模型 + WS 增量推送 + 封面 HTTP 端点 | §4 / §5.2 | +| 「控制等等」 | 播放/暂停/上一首/下一首/seek/停止,走 GSMTC `Try*Async`;音量 P1 | §3.1 / §5.3 | +| (自然延伸,非本次明说) | 投播:手机选歌 → 电脑播放(Thing 曲库播放队列控制) | §7 P2 | +| 「打开后自动连接」的边界 | 首次需用户在电脑设置页点「连接手机」弹出配对码/二维码,5 分钟内完成一次配对;此后已配对设备才自动重连 | §3.4 / 对端文档 §5.1 | + +--- + +## 2. 现状勘察(2026-09-25 从仓库实际读取) + +### 2.1 已具备的基建(直接复用) + +| 能力 | 现有实现 | 本功能可复用的部分 | +|---|---|---| +| 播放引擎 | `music/audio/engine.rs`:`AudioEngine`(symphonia + cpal/WASAPI 独立线程),`AudioState` 快照 + `music-audio-ended` / `music-audio-error` 事件 | Thing 自身播放状态的事实来源;封面/元数据兜底可直读播放队列 | +| SMTC 上报 | `music/smtc.rs`:`SmtcController`(GetForWindow 全字段上报 + 系统按钮事件 `music-smtc-button` 回传前端) | **零改动保留**;它让 Thing 拥有一条标准 SMTC 会话,GSMTC 控制才能作用到 Thing 自己 | +| HTTP 服务范式 | `download_engine/server.rs`、`feiniu/proxy.rs` 均为 axum + `tokio::net` | 新 LAN 服务照抄此范式(`axum::serve` + tokio) | +| WebSocket | `tokio-tungstenite 0.24` 已在依赖树 | 备选;WS 通道直接用 axum 的 `ws` feature 更统一 | +| 凭据存储 | `secrets.rs`(keyring + Windows 凭据管理器)、`music/secrets.rs` | 设备 token / 配对密钥持久化 | +| 类型绑定 | tauri-specta 自动生成 `src/lib/bindings.ts` | remote 命令与消息类型走 specta,前端零手写类型 | +| 设置持久化 | `MusicManager::load_settings / save_settings`(settings.json + 500ms 缓存) | remote 开关/端口等设置项追加到 `MusicSettings` | +| 日志 | `logger.rs` 统一日志 | remote 全链路日志 | + +### 2.2 关键缺口(需新增) + +| 缺口 | 现状 | 方案 | +|---|---|---| +| 系统媒体会话读取 | 无。`windows` crate 未开 `Media_Control` feature | 开启 feature,新增 `music/remote/glsmtc.rs`(见 §3.1) | +| 局域网服务 | axum 仅用于本机/代理场景,无对外 LAN 端点 | 新增 `music/remote/server.rs`,监听 `0.0.0.0` | +| 设备发现 | 无 | 新增 `music/remote/discovery.rs`(UDP beacon) | +| 配对与设备管理 | 无 | 新增 `music/remote/pairing.rs` | +| 二维码渲染 | 无 | 前端引入 `qrcode`/`qr-code-styling`(纯前端生成即可) | + +--- + +## 3. 技术选型 + +### 3.1 系统媒体捕获:GSMTC + +Windows 10 1809+ 的 `Windows.Media.Control` 命名空间是**唯一**能枚举/监视/控制系统全部 SMTC 会话的公开 API。凡是有标准系统集成(SMTC)的播放器——网易云、QQ 音乐、foobar2000、浏览器、以及 Thing 自己——都会出现在会话列表里。 + +Rust 侧路径:`windows` crate(当前 0.52)增加 `"Media_Control"` feature,类型位于 `windows::Media::Control`: + +```rust +use windows::Media::Control::{ + GlobalSystemMediaTransportControlsSessionManager, + GlobalSystemMediaTransportControlsSession, +}; +``` + +核心 API 清单: + +| API | 用途 | +|---|---| +| `SessionManager::RequestAsync()` | 取全局管理器单例(惰性初始化,失败则整个能力降级关闭) | +| `manager.GetSessions()` | 枚举所有会话——**同步**返回 `IVectorView`(0.52 投影无 Async 版本,计划原文 `GetSessionsAsync` 有误,以实测为准) | +| `manager.GetCurrentSession()` | 当前"活跃"会话(系统自动判定:最近操作的会话);**同步**,无会话时 ABI 返回 null → windows-rs 投影为 `Err(E_POINTER)`,按"无会话"分支处理。**实测修正:WinRT 没有 `SetCurrentSessionAsync`**——P1 多会话切换采用 Thing 侧"选中覆盖"(§7),不修改系统判定 | +| `session.SourceAppUserModelId` | 来源应用标识(用于显示"正在播放的应用",也作为会话 key) | +| `session.TryGetMediaPropertiesAsync()` | 元数据:Title / Artist / AlbumTitle / AlbumArtist / **Thumbnail** | +| `session.GetTimelineProperties()` | Position / EndTime / **LastUpdatedTime**(进度推算基准,见 §6.4) | +| `session.GetPlaybackInfo()` | PlaybackStatus / Controls(`IsPlayEnabled` 等能力位)/ PlaybackRate | +| `TryPlayAsync` / `TryPauseAsync` / `TryStopAsync` / `TrySkipNextAsync` / `TrySkipPreviousAsync` | 控制(即手机端全部按钮的实现) | +| `TryChangePlaybackPositionAsync(ticks)` | seek(仅当会话 `IsSeekEnabled`) | +| 事件:`CurrentSessionChanged` / `MediaPropertiesChanged` / `TimelinePropertiesChanged` / `PlaybackInfoChanged` / `SessionsChanged` | 状态变更推送源 | + +**线程与套间**(沿用 `smtc.rs` 已验证的范式,但有一处关键差异): + +- 初始化(`RequestAsync`)与事件订阅在**主线程**执行(`run_on_main_thread` 抛过去),与 `smtc.rs` 一致。 +- **`Try*Async` 的 `.get()` 阻塞等待必须放专用工作线程**,不能在主线程 `.get()`——STA 上阻塞等待 WinRT async 有死锁风险,而 `smtc.rs` 那种"fire-and-forget 更新属性"不涉及等待所以没踩到。设计上:主线程只做"发起",等待统一丢给 `tokio::task::spawn_blocking` 或专用线程。 +- 所有 GSMTC 对象是 agile 的,跨线程传引用安全(与 smtc.rs 注释同源结论)。 + +**失败策略**:与 `smtc.rs` 同哲学——GSMTC 任何一步失败只记日志,不影响播放;GSMTC 初始化失败时整个"远程查看/控制其他应用"能力降级为"仅 Thing 自身"(可从 `AudioEngine.state()` 兜底聚合,见 §5.2)。 + +### 3.2 局域网服务:axum HTTP + WebSocket + +单端口(默认候选 **26124**,被占则 +1 重试至 26139,实际端口写进 beacon 与二维码): + +| 端点 | 方法 | 用途 | +|---|---|---| +| `/ws` | GET(Upgrade) | 主通道:鉴权、状态推送(server→client)、控制指令(client→server) | +| `/api/state` | GET | REST 兜底快照(WS 不可用/调试用),Bearer token 鉴权 | +| `/cover/:hash` | GET | 封面字节流(内存缓存,`hash` 由状态推送携带,`?v=` 控制刷新),Bearer token(query 参数 `t=`,`` 标签无法带 header);**访问日志不打印 query**,token 不落日志 | +| `/pair` | POST | 配对:`{ pairingCode, deviceName }` → `{ token, deviceId }` | + +WS 承载双向消息(协议见 §4.2);HTTP 承载资源(封面)与低频操作。全部监听 `0.0.0.0`。 + +**防火墙注意**:首次监听 LAN 端口 Windows 会弹防火墙授权(专用网络勾选即可)。在设置页 remote 开关旁给出说明文案;不做 `netsh` 自动加规则(改系统防火墙属于越权行为,且需要管理员)。 + +### 3.3 设备发现:UDP beacon(P0 主)+ 扫码兜底(P0)+ mDNS(P1) + +| 方案 | 机制 | 判断 | +|---|---|---| +| **UDP beacon(推荐 P0)** | 电脑每 3s 向 `255.255.255.255:26123` 与各网卡定向广播地址发 JSON 包:`{ "service": "thing-music", "deviceId", "name", "port", "protoVer" }`;手机监听 26123 被动收集 | 实现最简(一个 tokio interval + UdpSocket);手机端只需 bind 收包,**Android 免多播权限问题,iOS 不触发 multicast entitlement**(仍会触发本地网络权限弹窗,属正常) | +| 扫码/手输(P0 兜底) | Thing 设置页展示二维码:`thingmusic://connect?ip=…&port=…&code=…`;手机扫码或手输 IP+配对码 | AP 隔离下 beacon 不可达时的最后手段;同时它就是配对入口(见 §3.4) | +| mDNS(P1 增强) | `mdns-sd` crate 注册 `_thingmusic._tcp.local.`,手机 browse | 生态标准、后台发现友好;但依赖各端 mDNS 栈质量,放 P1 不阻塞 | + +beacon 里**不含**任何敏感信息(无 token、无配对码),只描述"这里有一个 Thing 音乐服务"。手机端根据 deviceId 去重。 + +### 3.4 安全与配对 + +流程(对齐业界遥控 App 的标准做法): + +1. 手机端发起配对:beacon 得到 ip:port 后 POST `/pair`,携带 6 位一次性配对码 + 设备名。 +2. 配对码由 Thing 侧生成:用户在设置页点击「连接手机」→ 弹窗展示 6 位码 + 二维码(码内含 ip/port/code,扫码即完成 1、2 两步),有效期 5 分钟,一次性。 +3. 校验通过 → 生成 32 字节随机 hex 设备 token,返回手机;Thing 侧持久化 `{deviceId, deviceName, token}` 到 keyring(复用 `secrets.rs` 范式),列表落 settings。 +4. 后续连接:WS 握手首条消息 `hello { token }`(或 HTTP `Authorization: Bearer`),校验失败 3 次即拉黑该 IP 60s;`/pair` 的配对码校验执行同一限速(防 6 位码爆破,配对响应也只在成功时下发 token)。 +5. 设置页设备列表:展示在线/离线、最后连接时间,可撤销(吊销 token)。 + +P2 增强:自签 TLS(`rcgen` 生成 + `rustls`,二维码里带证书指纹)。P0 明文 HTTP 的风险面评估:同局域网内明文嗅探只能看到 token 之后的媒体元数据;token 本身仅在配对响应中明文传输一次,可接受。 + +--- + +## 4. 状态模型与协议设计 + +### 4.1 `NowPlaying`(核心状态, specta 类型双端共享) + +```typescript +interface NowPlaying { + sessionId: string // 会话 key(SourceAppUserModelId;Thing 自身 = "thing.self") + sourceApp: string // 来源应用显示名(AUMID 末段或注册表友好名) + isThing: boolean // 是否 Thing 自身播放(决定封面/元数据兜底来源) + title: string + artist: string + album: string + coverHash: string | null // 封面缓存键;封面从 /cover/:hash 拉 + status: 'playing' | 'paused' | 'stopped' + durationSec: number + positionSec: number // 推送时刻的位置 + positionUpdatedAtMs: number // 电脑时钟毫秒(源自 TimelineProperties.LastUpdatedTime,见 §6.4);仅供校准,手机端 elapsed 一律以本地收包时刻起算(见 §6.10) + playbackRate: number + canControl: { play: boolean; pause: boolean; next: boolean; prev: boolean; seek: boolean } + deviceId: string // 电脑标识(多电脑预留) +} +``` + +### 4.2 WS 消息(JSON,`type` 字段区分) + +| 方向 | type | 载荷 | 时机 | +|---|---|---|---| +| c→s | `hello` | `{ token, deviceName, protoVer }` | 连接后首条;失败即断开 | +| s→c | `welcome` | `{ deviceId, deviceName, protoVer }` | 鉴权通过 | +| s→c | `state` | `NowPlaying`(全量) | 连接后、以及任何变更(见 §6.3 节流;**由 `cmd` 触发的变更立即推一帧,绕过节流**) | +| c→s | `cmd` | `{ id, action, args? }`,action ∈ `play / pause / toggle / next / prev / stop / seek(posSec)` | 用户操作 | +| s→c | `cmd-ack` | `{ id, ok, error? }` | 回执语义 = **"指令已被接受/派发"**(GSMTC 路径 = Try*Async 完成;前端兜底路径 = 事件已投递),不代表播放状态已切换;UI 轻提示,真实状态以随后的 `state` 为准 | +| c→s | `ping` / s→c `pong` | `{ ts }` | 30s 心跳,双向判活 | + +版本策略:`protoVer` 从 1 起,不匹配时 `welcome` 带最新版本号,手机端提示升级。 + +--- + +## 5. 架构与模块设计 + +### 5.1 Rust 侧:`src-tauri/src/music/remote/` + +``` +src-tauri/src/music/remote/ +├── mod.rs # RemoteManager:manage() 进 State;启动/停止服务与 beacon;开关状态 +├── server.rs # axum app:路由 /ws /api/state /cover /pair;WS 会话表(fanout 广播) +├── glsmtc.rs # GsmtcMonitor:GSMTC 初始化、事件订阅 → 聚合 NowPlaying → 广播 +├── discovery.rs # UdpBeacon:3s 周期广播(255.255.255.255 + 各网卡定向广播) +├── pairing.rs # 配对码生成/校验、设备 token 签发、设备表(keyring + settings) +└── proto.rs # NowPlaying / WS 消息类型(serde + specta,前端 bindings 自动生成) +``` + +数据流: + +``` +GSMTC 事件(主线程订阅)──→ GsmtcMonitor 聚合/节流 ──→ Server 广播到全部 WS 客户端 +AudioEngine.state()(兜底聚合,isThing 时封面/元数据来源之一)┘ +手机 cmd ──→ server.rs ──→ glsmtc.rs(spawn_blocking 调 Try*Async)──→ 系统派发给目标会话 + └─ Thing 自身会话:SMTC 按钮 → smtc.rs 既有链路 → 前端 feiniuStore 执行(既有链路,约束见 §5.2) +``` + +`MusicManager` 增加 `remote: RemoteManager` 字段(或平级 manage,倾向后者,避免 MusicManager 继续膨胀);`lib.rs` 注册 `remote_*` 系列命令: + +| 命令 | 用途 | +|---|---| +| `remote_get_config` / `remote_set_enabled` | 开关(MusicSettings 追加 `remote_enabled`、`remote_port`) | +| `remote_status` | 服务状态、端口、在线设备 | +| `remote_start_pairing` | 生成配对码 + 二维码 payload(前端渲染二维码) | +| `remote_cancel_pairing` | 取消 | +| `remote_list_devices` / `remote_revoke_device` | 设备管理 | + +### 5.2 双来源聚合规则(GSMTC 为主,AudioEngine 兜底) + +- GSMTC 可用:一切以 GSMTC 当前会话为准。Thing 自身播放时它就是一条普通会话(`SourceAppUserModelId` 识别后标 `isThing: true`)。 +- GSMTC 无会话但 `AudioEngine` 在播放(GSMTC 初始化失败或会话丢失的兜底):从 `AudioEngine.state()` + 播放队列聚合出 `NowPlaying`(`isThing: true`);控制指令由 server 复用 `music-smtc-button` 事件(同名、同 payload)emit 给前端执行。**既有架构约束**:队列控制逻辑(toggle/next/prev/播放模式)在前端 `feiniuStore`,AudioEngine 本身只有 play/set_playing/seek/stop——兜底路径依赖 WebView 存活,WebView 未就绪时直接回 `cmd-ack { ok: false, error: "frontend-unavailable" }`。 +- 两者都无:`status: 'stopped'`,手机端显示"电脑未在播放"。 + +### 5.3 前端侧 + +- `src/modules/music/components/settings/RemoteSettings.vue`:总开关、端口、设备列表(在线状态/撤销)、「连接手机」按钮 → 配对码 + 二维码(`qrcode` 库,5s 轮询 status 刷新倒计时/在线态)。 +- 状态存放:P0 用 RemoteSettings **组件本地状态**(5s 轮询 `remote_status`),不扩 musicStore——当前无其他消费方;遥控 UI 出现共享需求时再入 store。 +- `constants.rs`:`REMOTE_WS_*` 等消息类型常量(如需要);本功能的"事件"主要是 WS 而非 Tauri event,前端基本只走 invoke + bindings。 + +### 5.4 生命周期 + +- 随应用启动初始化(不随模块启用——music 默认启用且常驻),`remote_enabled = false` 时仅不启服务/beacon,GSMTC 监视可保持惰性。 +- 应用退出:axum graceful shutdown、beacon 停发(`cleanup_on_exit` 挂钩,参照 `MusicManager::cleanup_on_exit` 范式)。 +- 系统休眠/网络切换:WS 断开由心跳判活;beacon 无状态持续广播即可,无需额外处理。 + +--- + +## 6. 关键实现细节与已知的坑 + +1. **GSMTC 在非打包桌面应用可用**(unpackaged desktop app 明确支持,1809+)。不要被"WinRT 需要 package identity"的泛泛说法劝退——GSMTC 不在受限之列,开源社区大量此类工具可佐证。**2026-09-25 已实证**:`examples/gsmtc_probe.rs`(unpackaged 控制台进程)跑通,读到当前会话元数据/状态/时间轴,核心假设成立。 +2. **封面(Thumbnail)是 `RandomAccessStreamReference`**:`OpenReadAsync()` → 按 `ContentType`(image/png|jpeg)读全量字节 → 以 `hash(sourceApp + title + album + 尺寸)` 为键存内存 LRU(上限 ~20 张)。推送里只带 `coverHash`,封面走 HTTP 拉取,避免 WS 帧被几百 KB 图片打爆。 +3. **事件风暴节流**:`TimelinePropertiesChanged` 在部分播放器上高频触发(每次内部时钟更新都发)。聚合层统一节流:任何状态变更合并后**最快 1Hz** 推送 `state`;进度靠手机端 `positionSec + elapsed` 本地推算(`status=playing` 时每秒 +1,收到新 `state` 校准),不依赖高频推送。**例外**:由 `cmd` 触发的状态变更立即推一帧(绕过 1Hz 节流),避免按钮"没反应"的体感——节流仅约束进度等自然高频变更。 +4. **进度推算基准用 `TimelineProperties.LastUpdatedTime`**,不要用"收到事件的本地时刻"——事件分发有延迟,`LastUpdatedTime` 是播放器侧的权威时间戳。(本条约束 **Thing 侧**把 GSMTC 事件组装成 `positionSec/positionUpdatedAtMs` 的动作;**手机侧** elapsed 的起算基准见 §6.10,两层不要混用。) +5. **会话 key 的稳定性**:GSMTC 无显式 sessionId,用 `SourceAppUserModelId` 作 key;同一应用双会话(极少见)时后者覆盖前者,P1 的多会话切换再处理。 +6. **`Try*Async` 的返回值不可全信**:部分播放器对不可用操作静默成功,回执只做 UI 轻提示,真实状态以下一帧 `state` 为准(`canControl` 能力位已尽力过滤)。 +7. **AUMID → 友好名**:`SourceAppUserModelId` 是 `PackageFamilyName!App` 或注册表 AUMID,显示名需查 `Get-StartApps` 等价逻辑(注册表 `HKCU\Software\Classes\AppUserModelId`);先显示末段兜底,友好名缓存 LRU。 +8. **防火墙弹窗只出现一次**(每个 exe 路径 × 网络类型),开发期 `tauri dev` 与正式版 exe 路径不同会各弹一次,属预期。 +9. **Windows 通知区域"媒体"浮层与 GSMTC 互不干扰**:`smtc.rs` 的上报会话照常工作;手机控制 Thing 自身时,系统面板同步可见,是 feature 不是 bug。 +10. **进度推算的时钟基准分两层,不要混用**:Thing 侧组装 `positionSec/positionUpdatedAtMs` 用 `TimelineProperties.LastUpdatedTime`(§6.4);手机侧 `elapsed` **一律以本地收到该条 `state` 的时刻起算**,禁止拿 `positionUpdatedAtMs` 与手机本机时间直接做差——电脑时钟偏差(手动对时/休眠漂移可差数秒以上)会整体拖偏进度条。手机端检测到两端时钟偏差 >5s 时冻结推算、只显示基准值,等待下一条 `state` 校准。两端时钟正常时(NTP 同步)此方案残差 ≤ 推送延迟(LAN 上 <1s,且播放中 ~1Hz 校准)。 + +--- + +## 7. 分阶段计划 + +### P0:可用版本(目标:手机能看到并控制电脑当前播放) + +- [x] `windows` crate 开 `Media_Control` feature;10 行探测 demo 验证 GSMTC 在本机可用 —— **2026-09-25 实测通过**(`examples/gsmtc_probe.rs`,unpackaged 控制台进程:读到 1 会话 + 元数据/状态/时间轴全通;注意 `GetSessions`/`GetCurrentSession` 是同步 API,见 §3.1) +- [x] `remote/proto.rs`:类型定义(serde,未进 specta——WS 对端是手机,Thing 前端不消费)+ 单测(序列化往返/时间换算/会话 key)——**2026-09-26 完成,8 单测全绿** +- [x] `remote/glsmtc.rs`:初始化、事件订阅、`NowPlaying` 聚合、封面 LRU、节流(1Hz + cmd Force 例外)——**完成**;订阅 P0 只挂 Manager 级两事件 + 500ms 节拍轮询(会话级事件需随会话订阅/退订,列入 P1) +- [x] `remote/server.rs`:axum 路由 + WS 会话表 + 广播 + 心跳判活 + Bearer/hello 鉴权(+ /pair 限速、封面 token 走 query)——**完成** +- [x] `remote/discovery.rs`:UDP beacon(GetAdaptersAddresses 各网卡定向广播)——**完成** +- [x] `remote/pairing.rs`:配对码 + token 签发 + 设备表(keyring `music-remote-token-*`)——**完成**(单测含限速) +- [x] 控制指令:play/pause/toggle/next/prev/stop/seek → `Try*Async`(spawn_blocking);**Thing 自身 seek 直通 AudioEngine**(SMTC 回环无 seek 通道)——**完成** +- [x] 命令注册(collect_commands + generate_handler 双处)+ `RemoteSettings.vue`(开关/配对二维码/设备列表;qrcode 库前端生成)——**完成**;改为组件本地状态,不扩 musicStore(当前无其他消费方,需要时再入 store) +- [x] `AudioEngine` 兜底聚合(+ `SmtcMetaCache` 回填标题/歌手/专辑)——**完成** +- [x] 运行时冒烟(2026-09-26):自启绑定 `0.0.0.0:26124` ✓、beacon 实收(`addrs=["192.168.110.40"]`、deviceId 落盘)✓、`/api/state` 401 ✓、`/pair` 错码 403 ✓、日志「GSMTC 已初始化(专用线程 MTA)」✓、运行时 bindings 导出含 remote 命令 ✓ +- [x] 联调:**真机 E2E 完成(2026-09-26)**——LFMusic 真机客户端全流程实测:配对码 142919 → `/pair` 成功(192.168.110.27)→ WS hello 鉴权 → state 推送(封面/元数据/thing.self/能力位)→ 播放暂停上下首控制生效 → App 重启后自动重连。过程修复:手机端 deviceId 语义(存电脑 id 而非 Thing 分配的行 id)与对端显示名两处关联 bug +- [ ] P0 验收口径(联调时执行):遥控界面显示 GSMTC `GetCurrentSession` 判定的活跃会话("最近操作"语义,多会话切换只留 UI 入口);进度推算按 §6.10 时钟基准联调;`cmd` 后 1s 内看到状态变化 + +### P1:体验完善 —— **2026-09-26 除两项暂缓外全部完成** + +- [ ] mDNS 发现(mdns-sd 注册 `_thingmusic._tcp`)——**暂缓**:beacon 在目标网络 100% 可用且扫码兜底已覆盖;双端 mDNS(含 Android MulticastLock/Kotlin 桥)成本高、当前无失效场景驱动,等 beacon 实际失效案例再做 +- [x] 多会话列表与手动切换——**完成**:`sessions` WS 消息(watch 变化推送 + 连接首帧)+ `select` 动作(**WinRT 无 SetCurrentSession,实测修正**:Thing 侧选中覆盖,空 id = 跟随系统 current;选中会话消失自动回落);手机端 chips UI(高亮 `isCurrent`)+「跟随系统」 +- [x] **会话级事件精细化订阅**——**完成**:`SessionSubs` 随目标会话换绑 `MediaPropertiesChanged`/`TimelinePropertiesChanged`/`PlaybackInfoChanged`(切换时先退订后订阅,线程退出统一清理);Manager 级两事件 + 500ms 节拍轮询保留为保底 +- [x] 系统音量控制 + 手机端音量条——**完成**:`volume.rs`(MMDevice → `IAudioEndpointVolume`,每次现取 COM 对象避免 Send/Sync 争议);监视线程 500ms 轮询进 `NowPlaying.volume/muted`(指纹纳入、变化即推);`volume` 动作 0~1、**>0 自动解除静音**;手机端 🔊 音量条(松手发送) +- [x] Thing 直通控制路径评估——**评估结论:落地直通**:`isThing` 按钮类指令直接 emit `music-smtc-button`(跳过 GSMTC→系统→SMTC 回环,少一跳系统派发延迟);seek 本就直通 AudioEngine;非 Thing 会话仍走 GSMTC `Try*Async`。系统面板同步不受影响(面板状态由前端持续上报 smtc.rs)。**真机复测**:非 Thing 路径(QQMusic 播放恢复)通过;isThing 直通与 P0 事件链同码,待 Thing 下次自身播放时自然覆盖 +- [x] AUMID 友好名缓存、封面本地持久化缓存——**完成**:`friendly_name`(`HKCU\Software\Classes\AppUserModelId\\DisplayName` 查询 + 128 条缓存,查不到退回 AUMID 简化段;路径形 AUMID 跳过注册表);`CoverStore` 写透 `{app_data}/remote_covers`(内存+磁盘双层 LRU 各 20 张,冷启动可回源)。**真机复测**:友好名生效(QQMusic / Microsoft.ZuneMusic);持久化目录已创建,落盘写入待下次取到封面时自然验证(当前可见会话均无缩略图) +- [ ] 手机端通知栏/锁屏媒体控件联动(LFMusic 侧 native-audio / MediaSession,见对端文档)——**暂缓**:被 LFMusic M1(集成 `tauri-plugin-native-audio`)阻塞,M1 完成后按对端文档回填 + +### P2:增强(按需) + +- [ ] 自签 TLS(rcgen + rustls,二维码带证书指纹) +- [ ] 投播:手机浏览 Thing 曲库 → 远程下发放进 Thing 播放队列(`/queue` 端点 + AudioEngine 队列 API 暴露) +- [ ] 歌词推送(Thing 已有 lyric 能力,同步到手机端滚动显示) +- [ ] 多电脑:beacon 天然支持,配对表按 deviceId 区分,UI 侧完善 + +--- + +## 8. 风险与开放问题 + +| 风险/问题 | 影响 | 对策 | +|---|---|---| +| GSMTC 某播放器不上报专辑/封面(上报方行为,非 bug) | 手机端显示缺字段 | UI 兜底占位;Thing 自身播放时从曲库元数据补全(lofty 已有) | +| 路由器 AP 隔离导致广播不可达 | 手机发现不了电脑 | 扫码/手输 IP 兜底(P0 已含);mDNS 同样受影响,不是银弹 | +| 防火墙/杀软拦截 LAN 监听 | 手机连不上 | 设置页说明 + 连接失败诊断提示(检测本机端口监听、提示放行) | +| 手机休眠断 WS | 状态不实时 | 心跳 + 重连退避(手机端职责,见对端文档);恢复前台即拉 `/api/state` 快照 | +| `TryChangePlaybackPositionAsync` 部分应用不支持 | seek 无效 | `canControl.seek` 能力位隐藏进度条拖动 | +| 多网段/VPN 虚拟网卡产生杂音 beacon | 发现列表脏数据 | beacon 携带本机各网卡地址,手机端按连通性优选;显示名可区分 | + +**开放问题**(实施前确认): +1. 是否需要"电脑端显示已连接手机"的托盘/OSD 提示?(倾向 P1,托盘菜单加一行在线设备数即可) +2. 投播的队列控制 API 形态(P2 前与 LFMusic 端一起定)。 +3. 遥控界面是否需要歌词显示?用户需求"显示音乐信息"是否含歌词——Thing 已有 lyric 能力,但"歌词推送"列在 P2,需两端确认是否提前。 +4. 音量控制是否提前到 P0?用户"控制电脑端"可能隐含音量——当前计划在 P1(`IAudioEndpointVolume`)。 diff --git a/bun.lock b/bun.lock index 5e82b96..61a62ea 100644 --- a/bun.lock +++ b/bun.lock @@ -24,6 +24,7 @@ "clsx": "^2.1.1", "pinia": "^3.0.4", "pinyin-pro": "^3.28.2", + "qrcode": "^1.5.4", "reka-ui": "^2.10.1", "tailwind-merge": "^3.6.0", "tailwindcss": "^4.3.2", @@ -34,6 +35,7 @@ "devDependencies": { "@tauri-apps/cli": "^2", "@types/node": "^26.1.1", + "@types/qrcode": "^1.5.6", "@vitejs/plugin-vue": "^5.2.1", "@vue/eslint-config-typescript": "^14.9.0", "eslint": "^10.11.0", @@ -296,6 +298,8 @@ "@types/node": ["@types/node@26.1.1", "https://registry.npmmirror.com/@types/node/-/node-26.1.1.tgz", { "dependencies": { "undici-types": "~8.3.0" } }, "sha512-nxAkRSVkN1Y0JC1W8ky/fTfkGsMmcrRsbx+3XoZE+rMOX71kLYTV7fLXpqud1GpbpP5TuffXFqfX7fH2GgZREw=="], + "@types/qrcode": ["@types/qrcode@1.5.6", "https://registry.npmmirror.com/@types/qrcode/-/qrcode-1.5.6.tgz", { "dependencies": { "@types/node": "*" } }, "sha512-te7NQcV2BOvdj2b1hCAHzAoMNuj65kNBMz0KBaxM6c3VGBOhU0dURQKOtH8CFNI/dsKkwlv32p26qYQTWoB5bw=="], + "@types/sortablejs": ["@types/sortablejs@1.15.9", "https://registry.npmmirror.com/@types/sortablejs/-/sortablejs-1.15.9.tgz", {}, "sha512-7HP+rZGE2p886PKV9c9OJzLBI6BBJu1O7lJGYnPyG3fS4/duUCcngkNCjsLwIMV+WMqANe3tt4irrXHSIe68OQ=="], "@types/web-bluetooth": ["@types/web-bluetooth@0.0.21", "https://registry.npmmirror.com/@types/web-bluetooth/-/web-bluetooth-0.0.21.tgz", {}, "sha512-oIQLCGWtcFZy2JW77j9k8nHzAOpqMHLQejDA48XXMWH6tjCQHz5RCFz1bzsmROyL6PUm+LLnUiI4BCn221inxA=="], @@ -386,6 +390,10 @@ "alien-signals": ["alien-signals@1.0.13", "https://registry.npmmirror.com/alien-signals/-/alien-signals-1.0.13.tgz", {}, "sha512-OGj9yyTnJEttvzhTUWuscOvtqxq5vrhF7vL9oS0xJ2mK0ItPYP1/y+vCFebfxoEyAz0++1AIwJ5CMr+Fk3nDmg=="], + "ansi-regex": ["ansi-regex@5.0.1", "https://registry.npmmirror.com/ansi-regex/-/ansi-regex-5.0.1.tgz", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="], + + "ansi-styles": ["ansi-styles@4.3.0", "https://registry.npmmirror.com/ansi-styles/-/ansi-styles-4.3.0.tgz", { "dependencies": { "color-convert": "^2.0.1" } }, "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg=="], + "aria-hidden": ["aria-hidden@1.2.6", "https://registry.npmmirror.com/aria-hidden/-/aria-hidden-1.2.6.tgz", { "dependencies": { "tslib": "^2.0.0" } }, "sha512-ik3ZgC9dY/lYVVM++OISsaYDeg1tb0VtP5uL3ouh1koGOaUMDPpbFIei4JkFimWUFPn90sbMNMXQAIVOlnYKJA=="], "balanced-match": ["balanced-match@4.0.4", "https://registry.npmmirror.com/balanced-match/-/balanced-match-4.0.4.tgz", {}, "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA=="], @@ -400,10 +408,18 @@ "cacheable": ["cacheable@2.5.0", "https://registry.npmmirror.com/cacheable/-/cacheable-2.5.0.tgz", { "dependencies": { "@cacheable/memory": "^2.2.0", "@cacheable/utils": "^2.5.0", "hookified": "^1.15.0", "keyv": "^5.6.0", "qified": "^0.10.1" } }, "sha512-60cyAOytib/OzBw1JNSoSV/boK1AtHryDIjvVBk7XbN4ugfkM3+Sry7fEjNgPMGgOjuaZPAp8ruZ0Cxafwyq9g=="], + "camelcase": ["camelcase@5.3.1", "https://registry.npmmirror.com/camelcase/-/camelcase-5.3.1.tgz", {}, "sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg=="], + "class-variance-authority": ["class-variance-authority@0.7.1", "https://registry.npmmirror.com/class-variance-authority/-/class-variance-authority-0.7.1.tgz", { "dependencies": { "clsx": "^2.1.1" } }, "sha512-Ka+9Trutv7G8M6WT6SeiRWz792K5qEqIGEGzXKhAE6xOWAY6pPH8U+9IY3oCMv6kqTmLsv7Xh/2w2RigkePMsg=="], + "cliui": ["cliui@6.0.0", "https://registry.npmmirror.com/cliui/-/cliui-6.0.0.tgz", { "dependencies": { "string-width": "^4.2.0", "strip-ansi": "^6.0.0", "wrap-ansi": "^6.2.0" } }, "sha512-t6wbgtoCXvAzst7QgXxJYqPt0usEfbgQdftEPbLL/cvv6HPE5VgvqCuAIDR0NgU52ds6rFwqrgakNLrHEjCbrQ=="], + "clsx": ["clsx@2.1.1", "https://registry.npmmirror.com/clsx/-/clsx-2.1.1.tgz", {}, "sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA=="], + "color-convert": ["color-convert@2.0.1", "https://registry.npmmirror.com/color-convert/-/color-convert-2.0.1.tgz", { "dependencies": { "color-name": "~1.1.4" } }, "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ=="], + + "color-name": ["color-name@1.1.4", "https://registry.npmmirror.com/color-name/-/color-name-1.1.4.tgz", {}, "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA=="], + "copy-anything": ["copy-anything@4.0.5", "https://registry.npmmirror.com/copy-anything/-/copy-anything-4.0.5.tgz", { "dependencies": { "is-what": "^5.2.0" } }, "sha512-7Vv6asjS4gMOuILabD3l739tsaxFQmC+a7pLZm02zyvs8p977bL3zEgq3yDk5rn9B0PbYgIv++jmHcuUab4RhA=="], "cross-spawn": ["cross-spawn@7.0.6", "https://registry.npmmirror.com/cross-spawn/-/cross-spawn-7.0.6.tgz", { "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", "which": "^2.0.1" } }, "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA=="], @@ -416,12 +432,18 @@ "debug": ["debug@4.4.3", "https://registry.npmmirror.com/debug/-/debug-4.4.3.tgz", { "dependencies": { "ms": "^2.1.3" }, "peerDependencies": { "supports-color": "*" }, "optionalPeers": ["supports-color"] }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="], + "decamelize": ["decamelize@1.2.0", "https://registry.npmmirror.com/decamelize/-/decamelize-1.2.0.tgz", {}, "sha512-z2S+W9X73hAUUki+N+9Za2lBlun89zigOyGrsax+KUQ6wKW4ZoWpEYBkGhQjwAjjDCkWxhY0VKEhk8wzY7F5cA=="], + "deep-is": ["deep-is@0.1.4", "https://registry.npmmirror.com/deep-is/-/deep-is-0.1.4.tgz", {}, "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ=="], "defu": ["defu@6.1.7", "https://registry.npmmirror.com/defu/-/defu-6.1.7.tgz", {}, "sha512-7z22QmUWiQ/2d0KkdYmANbRUVABpZ9SNYyH5vx6PZ+nE5bcC0l7uFvEfHlyld/HcGBFTL536ClDt3DEcSlEJAQ=="], "detect-libc": ["detect-libc@2.1.2", "https://registry.npmmirror.com/detect-libc/-/detect-libc-2.1.2.tgz", {}, "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ=="], + "dijkstrajs": ["dijkstrajs@1.0.3", "https://registry.npmmirror.com/dijkstrajs/-/dijkstrajs-1.0.3.tgz", {}, "sha512-qiSlmBq9+BCdCA/L46dw8Uy93mloxsPSbwnm5yrKn2vMPiy8KyAskTF6zuV/j5BMsmOGZDPs7KjU+mjb670kfA=="], + + "emoji-regex": ["emoji-regex@8.0.0", "https://registry.npmmirror.com/emoji-regex/-/emoji-regex-8.0.0.tgz", {}, "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A=="], + "enhanced-resolve": ["enhanced-resolve@5.21.6", "https://registry.npmmirror.com/enhanced-resolve/-/enhanced-resolve-5.21.6.tgz", { "dependencies": { "graceful-fs": "^4.2.4", "tapable": "^2.3.3" } }, "sha512-aNnGCvbJ/RIyWo1IuhNdVjnNF+EjH9wpzpNHt+ci/m9He9LJvUN8wrCcXjp9cWsGNAuvSpVFTx/vraAFQ8qGjQ=="], "entities": ["entities@7.0.1", "https://registry.npmmirror.com/entities/-/entities-7.0.1.tgz", {}, "sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA=="], @@ -474,6 +496,8 @@ "fsevents": ["fsevents@2.3.3", "https://registry.npmmirror.com/fsevents/-/fsevents-2.3.3.tgz", { "os": "darwin" }, "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw=="], + "get-caller-file": ["get-caller-file@2.0.5", "https://registry.npmmirror.com/get-caller-file/-/get-caller-file-2.0.5.tgz", {}, "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg=="], + "glob-parent": ["glob-parent@6.0.2", "https://registry.npmmirror.com/glob-parent/-/glob-parent-6.0.2.tgz", { "dependencies": { "is-glob": "^4.0.3" } }, "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A=="], "graceful-fs": ["graceful-fs@4.2.11", "https://registry.npmmirror.com/graceful-fs/-/graceful-fs-4.2.11.tgz", {}, "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ=="], @@ -492,6 +516,8 @@ "is-extglob": ["is-extglob@2.1.1", "https://registry.npmmirror.com/is-extglob/-/is-extglob-2.1.1.tgz", {}, "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ=="], + "is-fullwidth-code-point": ["is-fullwidth-code-point@3.0.0", "https://registry.npmmirror.com/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", {}, "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg=="], + "is-glob": ["is-glob@4.0.3", "https://registry.npmmirror.com/is-glob/-/is-glob-4.0.3.tgz", { "dependencies": { "is-extglob": "^2.1.1" } }, "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg=="], "is-number": ["is-number@7.0.0", "https://registry.npmmirror.com/is-number/-/is-number-7.0.0.tgz", {}, "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng=="], @@ -564,6 +590,8 @@ "p-locate": ["p-locate@5.0.0", "https://registry.npmmirror.com/p-locate/-/p-locate-5.0.0.tgz", { "dependencies": { "p-limit": "^3.0.2" } }, "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw=="], + "p-try": ["p-try@2.2.0", "https://registry.npmmirror.com/p-try/-/p-try-2.2.0.tgz", {}, "sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ=="], + "path-browserify": ["path-browserify@1.0.1", "https://registry.npmmirror.com/path-browserify/-/path-browserify-1.0.1.tgz", {}, "sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g=="], "path-exists": ["path-exists@4.0.0", "https://registry.npmmirror.com/path-exists/-/path-exists-4.0.0.tgz", {}, "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w=="], @@ -580,6 +608,8 @@ "pinyin-pro": ["pinyin-pro@3.29.4", "https://registry.npmmirror.com/pinyin-pro/-/pinyin-pro-3.29.4.tgz", {}, "sha512-SPXpDT2cHEy+d26V1RXYMlVzXN42hotFAak1fzyWPi4o2dKXb61UqD4pzxDJHwk6gbv8vQ6EfErd+hYX0Qhzug=="], + "pngjs": ["pngjs@5.0.0", "https://registry.npmmirror.com/pngjs/-/pngjs-5.0.0.tgz", {}, "sha512-40QW5YalBNfQo5yRYmiw7Yz6TKKVr3h6970B2YE+3fQpsWcrbj1PzJgxeJ19DRQjhMbKPIuMY8rFaXc8moolVw=="], + "postcss": ["postcss@8.5.19", "https://registry.npmmirror.com/postcss/-/postcss-8.5.19.tgz", { "dependencies": { "nanoid": "^3.3.12", "picocolors": "^1.1.1", "source-map-js": "^1.2.1" } }, "sha512-Mz8SaolMd8nB+G13WkORcxQKHZ/NE4xXevtkJHVuG+guo9/wYKlIMTKAqGdEmYOXR2ijPjTYNHssizdaVSUNdQ=="], "postcss-selector-parser": ["postcss-selector-parser@7.1.6", "https://registry.npmmirror.com/postcss-selector-parser/-/postcss-selector-parser-7.1.6.tgz", { "dependencies": { "cssesc": "^3.0.0", "util-deprecate": "^1.0.2" } }, "sha512-7qASPzhKF2l2KLboRZux8CCTRMdGiV08vWmyKzPz22qZ7ZjQBOeY7rNzNoCLSUiftJ7HUq0GERHmxw/t0dCdMw=="], @@ -590,10 +620,16 @@ "qified": ["qified@0.10.1", "https://registry.npmmirror.com/qified/-/qified-0.10.1.tgz", { "dependencies": { "hookified": "^2.1.1" } }, "sha512-+Owyggi9IxT1ePKGafcI87ubSmxol6smwJ+RAHDQlx9+9cPwFWDiKFFCPuWhr9ignlGpZ9vDQLw67N4dcTVFEA=="], + "qrcode": ["qrcode@1.5.4", "https://registry.npmmirror.com/qrcode/-/qrcode-1.5.4.tgz", { "dependencies": { "dijkstrajs": "^1.0.1", "pngjs": "^5.0.0", "yargs": "^15.3.1" }, "bin": { "qrcode": "bin/qrcode" } }, "sha512-1ca71Zgiu6ORjHqFBDpnSMTR2ReToX4l1Au1VFLyVeBTFavzQnv5JxMFr3ukHVKpSrSA2MCk0lNJSykjUfz7Zg=="], + "queue-microtask": ["queue-microtask@1.2.3", "https://registry.npmmirror.com/queue-microtask/-/queue-microtask-1.2.3.tgz", {}, "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A=="], "reka-ui": ["reka-ui@2.10.1", "https://registry.npmmirror.com/reka-ui/-/reka-ui-2.10.1.tgz", { "dependencies": { "@floating-ui/dom": "^1.6.13", "@floating-ui/vue": "^1.1.6", "@internationalized/date": "^3.5.0", "@internationalized/number": "^3.5.0", "@tanstack/vue-virtual": "^3.12.0", "@vueuse/core": "^14.1.0", "@vueuse/shared": "^14.1.0", "aria-hidden": "^1.2.4", "defu": "^6.1.5", "ohash": "^2.0.11" }, "peerDependencies": { "vue": ">= 3.4.0" } }, "sha512-drcOQ4rQtDYAcGCsyQBqQg8QQ+H3B+zDaMJU0h8KPEPMa7g9BHu3zcOi4OB39XJSWizceFoNO0Z9tctSGLOXqg=="], + "require-directory": ["require-directory@2.1.1", "https://registry.npmmirror.com/require-directory/-/require-directory-2.1.1.tgz", {}, "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q=="], + + "require-main-filename": ["require-main-filename@2.0.0", "https://registry.npmmirror.com/require-main-filename/-/require-main-filename-2.0.0.tgz", {}, "sha512-NKN5kMDylKuldxYLSUfrbo5Tuzh4hd+2E8NPPX02mZtn1VuREQToYe/ZdlJy+J3uCpfaiGF05e7B8W0iXbQHmg=="], + "reusify": ["reusify@1.1.0", "https://registry.npmmirror.com/reusify/-/reusify-1.1.0.tgz", {}, "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw=="], "rfdc": ["rfdc@1.4.1", "https://registry.npmmirror.com/rfdc/-/rfdc-1.4.1.tgz", {}, "sha512-q1b3N5QkRUWUl7iyylaaj3kOpIT0N2i9MqIEQXP73GVsN9cw3fdx8X63cEmWhJGi2PPCF23Ijp7ktmd39rawIA=="], @@ -604,6 +640,8 @@ "semver": ["semver@7.8.5", "https://registry.npmmirror.com/semver/-/semver-7.8.5.tgz", { "bin": { "semver": "bin/semver.js" } }, "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA=="], + "set-blocking": ["set-blocking@2.0.0", "https://registry.npmmirror.com/set-blocking/-/set-blocking-2.0.0.tgz", {}, "sha512-KiKBS8AnWGEyLzofFfmvKwpdPzqiy16LvQfK3yv/fVH7Bj13/wl3JSR1J+rfgRE9q7xUJK4qvgS8raSOeLUehw=="], + "shebang-command": ["shebang-command@2.0.0", "https://registry.npmmirror.com/shebang-command/-/shebang-command-2.0.0.tgz", { "dependencies": { "shebang-regex": "^3.0.0" } }, "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA=="], "shebang-regex": ["shebang-regex@3.0.0", "https://registry.npmmirror.com/shebang-regex/-/shebang-regex-3.0.0.tgz", {}, "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A=="], @@ -612,6 +650,10 @@ "speakingurl": ["speakingurl@14.0.1", "https://registry.npmmirror.com/speakingurl/-/speakingurl-14.0.1.tgz", {}, "sha512-1POYv7uv2gXoyGFpBCmpDVSNV74IfsWlDW216UPjbWufNf+bSU6GdbDsxdcxtfwb4xlI3yxzOTKClUosxARYrQ=="], + "string-width": ["string-width@4.2.3", "https://registry.npmmirror.com/string-width/-/string-width-4.2.3.tgz", { "dependencies": { "emoji-regex": "^8.0.0", "is-fullwidth-code-point": "^3.0.0", "strip-ansi": "^6.0.1" } }, "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g=="], + + "strip-ansi": ["strip-ansi@6.0.1", "https://registry.npmmirror.com/strip-ansi/-/strip-ansi-6.0.1.tgz", { "dependencies": { "ansi-regex": "^5.0.1" } }, "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A=="], + "superjson": ["superjson@2.2.6", "https://registry.npmmirror.com/superjson/-/superjson-2.2.6.tgz", { "dependencies": { "copy-anything": "^4" } }, "sha512-H+ue8Zo4vJmV2nRjpx86P35lzwDT3nItnIsocgumgr0hHMQ+ZGq5vrERg9kJBo5AWGmxZDhzDo+WVIJqkB0cGA=="], "tailwind-merge": ["tailwind-merge@3.6.0", "https://registry.npmmirror.com/tailwind-merge/-/tailwind-merge-3.6.0.tgz", {}, "sha512-uxL7qAVQriqRQPAyK3pj66VqskWqoZ37PW94jwOTwNfq/z9oyu1V+eqrZqtR2+fCiXdYOZe/Modt8GtvqNzu+w=="], @@ -660,10 +702,20 @@ "which": ["which@2.0.2", "https://registry.npmmirror.com/which/-/which-2.0.2.tgz", { "dependencies": { "isexe": "^2.0.0" }, "bin": { "node-which": "./bin/node-which" } }, "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA=="], + "which-module": ["which-module@2.0.1", "https://registry.npmmirror.com/which-module/-/which-module-2.0.1.tgz", {}, "sha512-iBdZ57RDvnOR9AGBhML2vFZf7h8vmBjhoaZqODJBFWHVtKkDmKuHai3cx5PgVMrX5YDNp27AofYbAwctSS+vhQ=="], + "word-wrap": ["word-wrap@1.2.5", "https://registry.npmmirror.com/word-wrap/-/word-wrap-1.2.5.tgz", {}, "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA=="], + "wrap-ansi": ["wrap-ansi@6.2.0", "https://registry.npmmirror.com/wrap-ansi/-/wrap-ansi-6.2.0.tgz", { "dependencies": { "ansi-styles": "^4.0.0", "string-width": "^4.1.0", "strip-ansi": "^6.0.0" } }, "sha512-r6lPcBGxZXlIcymEu7InxDMhdW0KDxpLgoFLcguasxCaJ/SOIZwINatK9KY/tf+ZrlywOKU0UDj3ATXUBfxJXA=="], + "xml-name-validator": ["xml-name-validator@5.0.0", "https://registry.npmmirror.com/xml-name-validator/-/xml-name-validator-5.0.0.tgz", {}, "sha512-EvGK8EJ3DhaHfbRlETOWAS5pO9MZITeauHKJyb8wyajUfQUenkIg2MvLDTZ4T/TgIcm3HU0TFBgWWboAZ30UHg=="], + "y18n": ["y18n@4.0.3", "https://registry.npmmirror.com/y18n/-/y18n-4.0.3.tgz", {}, "sha512-JKhqTOwSrqNA1NY5lSztJ1GrBiUodLMmIZuLiDaMRJ+itFd+ABVE8XBjOvIWL+rSqNDC74LCSFmlb/U4UZ4hJQ=="], + + "yargs": ["yargs@15.4.1", "https://registry.npmmirror.com/yargs/-/yargs-15.4.1.tgz", { "dependencies": { "cliui": "^6.0.0", "decamelize": "^1.2.0", "find-up": "^4.1.0", "get-caller-file": "^2.0.1", "require-directory": "^2.1.1", "require-main-filename": "^2.0.0", "set-blocking": "^2.0.0", "string-width": "^4.2.0", "which-module": "^2.0.0", "y18n": "^4.0.0", "yargs-parser": "^18.1.2" } }, "sha512-aePbxDmcYW++PaqBsJ+HYUFwCdv4LVvdnhBy78E57PIor8/OVvhMrADFFEDh8DHDFRv/O9i3lPhsENjO7QX0+A=="], + + "yargs-parser": ["yargs-parser@18.1.3", "https://registry.npmmirror.com/yargs-parser/-/yargs-parser-18.1.3.tgz", { "dependencies": { "camelcase": "^5.0.0", "decamelize": "^1.2.0" } }, "sha512-o50j0JeToy/4K6OZcaQmW6lyXXKhq7csREXcDwk2omFPJEwUNOVtJKvmDr9EI1fAJZUyZcRF7kxGBWmRXudrCQ=="], + "yocto-queue": ["yocto-queue@0.1.0", "https://registry.npmmirror.com/yocto-queue/-/yocto-queue-0.1.0.tgz", {}, "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q=="], "@eslint-community/eslint-utils/eslint-visitor-keys": ["eslint-visitor-keys@3.4.3", "https://registry.npmmirror.com/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz", {}, "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag=="], @@ -694,10 +746,18 @@ "reka-ui/@vueuse/shared": ["@vueuse/shared@14.3.0", "https://registry.npmmirror.com/@vueuse/shared/-/shared-14.3.0.tgz", { "peerDependencies": { "vue": "^3.5.0" } }, "sha512-bZpge9eSXwa4ToSiqJ7j6KRwhAsneMFoSz3LMWKQDkqimm3D/tbFlrklrs/IOqC8tEcYmXQZJ6N0UrjhBirVCg=="], + "yargs/find-up": ["find-up@4.1.0", "https://registry.npmmirror.com/find-up/-/find-up-4.1.0.tgz", { "dependencies": { "locate-path": "^5.0.0", "path-exists": "^4.0.0" } }, "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw=="], + "@vue/language-core/minimatch/brace-expansion": ["brace-expansion@2.1.2", "https://registry.npmmirror.com/brace-expansion/-/brace-expansion-2.1.2.tgz", { "dependencies": { "balanced-match": "^1.0.0" } }, "sha512-w5JZcKgdhDOgOwm8H+KgbosopHMuGcl6qbulwjtz3SM7I7P3yW1eAjzMPLrIE+NQ9vjgANKHWeMHnrT0OXW1oA=="], "reka-ui/@vueuse/core/@vueuse/metadata": ["@vueuse/metadata@14.3.0", "https://registry.npmmirror.com/@vueuse/metadata/-/metadata-14.3.0.tgz", {}, "sha512-BwxmbAzwAVF50+MW57GXOUEV61nFBGnlBvrTqj49PqWJu3uw7hdu72ztXeZ33RdZtDY6kO+bfCAE1PCn88Tktw=="], + "yargs/find-up/locate-path": ["locate-path@5.0.0", "https://registry.npmmirror.com/locate-path/-/locate-path-5.0.0.tgz", { "dependencies": { "p-locate": "^4.1.0" } }, "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g=="], + "@vue/language-core/minimatch/brace-expansion/balanced-match": ["balanced-match@1.0.2", "https://registry.npmmirror.com/balanced-match/-/balanced-match-1.0.2.tgz", {}, "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw=="], + + "yargs/find-up/locate-path/p-locate": ["p-locate@4.1.0", "https://registry.npmmirror.com/p-locate/-/p-locate-4.1.0.tgz", { "dependencies": { "p-limit": "^2.2.0" } }, "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A=="], + + "yargs/find-up/locate-path/p-locate/p-limit": ["p-limit@2.3.0", "https://registry.npmmirror.com/p-limit/-/p-limit-2.3.0.tgz", { "dependencies": { "p-try": "^2.0.0" } }, "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w=="], } } diff --git a/package.json b/package.json index caa7ad6..741a1b6 100644 --- a/package.json +++ b/package.json @@ -33,6 +33,7 @@ "clsx": "^2.1.1", "pinia": "^3.0.4", "pinyin-pro": "^3.28.2", + "qrcode": "^1.5.4", "reka-ui": "^2.10.1", "tailwind-merge": "^3.6.0", "tailwindcss": "^4.3.2", @@ -43,6 +44,7 @@ "devDependencies": { "@tauri-apps/cli": "^2", "@types/node": "^26.1.1", + "@types/qrcode": "^1.5.6", "@vitejs/plugin-vue": "^5.2.1", "@vue/eslint-config-typescript": "^14.9.0", "eslint": "^10.11.0", diff --git a/src-tauri/Cargo.lock b/src-tauri/Cargo.lock index 36e9a43..cd5c3cb 100644 --- a/src-tauri/Cargo.lock +++ b/src-tauri/Cargo.lock @@ -438,6 +438,7 @@ checksum = "edca88bc138befd0323b20752846e6587272d3b03b0343c8ea28a6f819e6e71f" dependencies = [ "async-trait", "axum-core 0.4.5", + "base64 0.22.1", "bytes", "futures-util", "http", @@ -456,8 +457,10 @@ dependencies = [ "serde_json", "serde_path_to_error", "serde_urlencoded", + "sha1 0.10.7", "sync_wrapper", "tokio", + "tokio-tungstenite", "tower", "tower-layer", "tower-service", diff --git a/src-tauri/Cargo.toml b/src-tauri/Cargo.toml index d6177cb..fab34cb 100644 --- a/src-tauri/Cargo.toml +++ b/src-tauri/Cargo.toml @@ -41,7 +41,7 @@ chrono = "0.4" reqwest = { version = "0.12", features = ["json", "stream", "multipart", "blocking"] } futures-util = "0.3" tokio = { version = "1", features = ["io-util", "time", "rt-multi-thread", "macros", "sync", "fs", "net"] } -axum = "0.7" +axum = { version = "0.7", features = ["ws"] } url = "2" zip = "2" dirs = "5" @@ -154,6 +154,12 @@ windows-sys = { version = "0.52", features = [ # 注意:0.52 起 ReadFile 定义在 Storage_FileSystem 但被 Win32_System_IO 特性门控, # 两个特性必须同时开启,否则导入会解析失败。 "Win32_System_IO", + # 音乐模块「解密」:QQ音乐新版 musicex 的 ekey 不落盘,只能联网取;而 + # authst 仅存在于 QQMusic.exe 运行期内存里 —— 需要进程枚举(ToolHelp: + # CreateToolhelp32Snapshot / Process32FirstW)与跨进程读内存 + # (Diagnostics::Debug::ReadProcessMemory + System::Memory::VirtualQueryEx)。 + "Win32_System_Diagnostics_ToolHelp", + "Win32_System_Diagnostics_Debug", ] } # Explorer ShellWindows COM:用于枚举已打开的资源管理器窗口并取当前路径 # (快速面板「用资源管理器打开」联动)。依赖 Win32_System_Com 特性。 @@ -180,6 +186,20 @@ windows = { version = "0.52", features = [ # 专辑与封面不送达,且会话挂在浏览器进程 AUMID 上只显示「未知应用」。 "Media", "Win32_System_WinRT", + # 音乐模块·手机遥控:GSMTC 全局会话管理器(Windows.Media.Control), + # 枚举/监视/控制系统全部 SMTC 会话(MUSIC_REMOTE_PLAN §3.1) + "Media_Control", + # 手机遥控·UDP beacon:GetAdaptersAddresses 枚举各网卡 IPv4/广播地址 + # (多网卡/VPN 场景下定向广播,MUSIC_REMOTE_PLAN §3.3)。 + # GetAdaptersAddresses 另受 Ndis + WinSock 两个 feature 门控(windows 0.52 源码 cfg) + "Win32_NetworkManagement_IpHelper", + "Win32_NetworkManagement_Ndis", + "Win32_Networking_WinSock", + # 手机遥控·P1 系统音量:MMDevice + IAudioEndpointVolume(Endpoints 有独立 feature 门控; + # IMMDevice::Activate 另需 Com_StructuredStorage) + "Win32_Media_Audio", + "Win32_Media_Audio_Endpoints", + "Win32_System_Com_StructuredStorage", "Security_Cryptography", # 划词取词的智能路径:UIA 直读焦点元素选区(IUIAutomation / ITextProvider) "Win32_UI_Accessibility", diff --git a/src-tauri/examples/decrypt_musicex_probe.rs b/src-tauri/examples/decrypt_musicex_probe.rs new file mode 100644 index 0000000..1d9dd38 --- /dev/null +++ b/src-tauri/examples/decrypt_musicex_probe.rs @@ -0,0 +1,83 @@ +//! **临时**端到端验证:对真实 musicex 样本走完整「取密钥 → 解密 → 校验」流程。 +//! +//! 用法(需要 QQ 音乐在运行且已登录): +//! ```text +//! cargo run --example decrypt_musicex_probe -- "C:\path\to\file.mflac" +//! ``` +//! 验证完即可删除本文件。 + +use thing_lib::music::decrypt::probe::{probe_musicex, ProbeOutcome}; + +fn main() { + let mut args = std::env::args().skip(1); + let path = args.next().expect( + "用法:decrypt_musicex_probe <文件路径> [输出目录]\n\ + 给了输出目录则会用**生产路径**真正写盘(生成可播放文件)", + ); + let out_dir = args.next(); + + match probe_musicex(std::path::Path::new(&path)) { + Ok(ProbeOutcome { + ekey_len, + key_len, + raw_key_bytes, + cipher_magic, + plain_magic, + decrypted_bytes, + guessed_format, + expiration_secs, + }) => { + println!("=== 成功 ==="); + println!("ekey 长度 : {ekey_len}"); + println!("派生密钥长度 : {key_len}"); + println!( + "密钥前 8 字节 : {:02x?}", + &raw_key_bytes[..raw_key_bytes.len().min(8)] + ); + println!("密文头 : {:02x?}", cipher_magic); + println!("解密后字节数 : {decrypted_bytes}"); + println!("明文首帧魔数 : {:02x?}", plain_magic); + println!("判定格式 : {guessed_format}"); + println!("ekey 有效期(秒) : {expiration_secs}"); + if guessed_format == "flac" && plain_magic.starts_with(b"fLaC") { + println!("=> 合法 FLAC 头,产物可播"); + } else { + println!("=> 头不合法,需要排查"); + } + } + Err(e) => { + println!("=== 失败 ==="); + println!("{e}"); + std::process::exit(1); + } + } + + // 可选:调用**生产路径**真正落盘(验证 decrypt_musicex 本身,而不只是核心算法) + if let Some(dir) = out_dir { + println!("\n=== 生产路径落盘 ==="); + match thing_lib::music::decrypt::qq_online::decrypt_musicex( + std::path::Path::new(&path), + std::path::Path::new(&dir), + "QQ音乐", + |done, total| { + if done == total { + println!("进度:{done} 字节(完成)"); + } + }, + ) { + Ok(outcome) => { + let size = std::fs::metadata(&outcome.output) + .map(|m| m.len()) + .unwrap_or(0); + println!("产物 : {}", outcome.output.display()); + println!("大小 : {size} 字节"); + println!("格式 : {}", outcome.format); + println!("备注 : {}", outcome.note); + } + Err(e) => { + println!("落盘失败:{e}"); + std::process::exit(1); + } + } + } +} diff --git a/src-tauri/examples/gsmtc_dump.rs b/src-tauri/examples/gsmtc_dump.rs new file mode 100644 index 0000000..ad38040 --- /dev/null +++ b/src-tauri/examples/gsmtc_dump.rs @@ -0,0 +1,59 @@ +//! 诊断:枚举全部 GSMTC 会话的时间轴原始值(判断"来源不提供进度"的形态)。 +//! +//! 运行:`cargo run --example gsmtc_dump` + +use std::time::{SystemTime, UNIX_EPOCH}; + +use windows::Media::Control::GlobalSystemMediaTransportControlsSessionManager; + +fn ticks_to_unix_ms(ticks: i64) -> i64 { + ticks / 10_000 - 62_135_596_800_000 +} + +fn main() -> windows::core::Result<()> { + let mgr = GlobalSystemMediaTransportControlsSessionManager::RequestAsync()?.get()?; + let sessions = mgr.GetSessions()?; + let now_ms = SystemTime::now() + .duration_since(UNIX_EPOCH) + .map(|d| d.as_millis() as i64) + .unwrap_or(0); + println!("now(unix ms) = {now_ms}"); + println!("sessions = {}", sessions.Size()?); + + for i in 0..sessions.Size()? { + let s = sessions.GetAt(i)?; + println!("--- [{}] {}", i, s.SourceAppUserModelId()?); + if let Ok(p) = s.TryGetMediaPropertiesAsync()?.get() { + println!( + " title={:?} artist={:?} album={:?}", + p.Title()?, + p.Artist()?, + p.AlbumTitle()? + ); + } + let info = s.GetPlaybackInfo()?; + println!(" status={:?}", info.PlaybackStatus()?); + if let Ok(c) = info.Controls() { + println!( + " controls play={} pause={} next={} prev={} seek={}", + c.IsPlayEnabled().unwrap_or(false), + c.IsPauseEnabled().unwrap_or(false), + c.IsNextEnabled().unwrap_or(false), + c.IsPreviousEnabled().unwrap_or(false), + c.IsPlaybackPositionEnabled().unwrap_or(false) + ); + } + let tl = s.GetTimelineProperties()?; + let pos = tl.Position()?.Duration; + let end = tl.EndTime().map(|t| t.Duration).unwrap_or(-1); + let upd = tl.LastUpdatedTime()?.UniversalTime; + let upd_ms = ticks_to_unix_ms(upd); + println!( + " position={}s end={}s lastUpdatedTicks={upd} -> unixMs={upd_ms} (deltaMs={})", + pos as f64 / 1e7, + end as f64 / 1e7, + upd_ms - now_ms + ); + } + Ok(()) +} diff --git a/src-tauri/examples/gsmtc_probe.rs b/src-tauri/examples/gsmtc_probe.rs new file mode 100644 index 0000000..6e7e6dc --- /dev/null +++ b/src-tauri/examples/gsmtc_probe.rs @@ -0,0 +1,38 @@ +//! GSMTC 可用性探测(MUSIC_REMOTE_PLAN §7 P0 第 1 项 / §6 第 1 条) +//! +//! 关键假设:GSMTC(Windows.Media.Control)在**非打包**桌面应用可用(Windows 10 1809+)。 +//! 本 example 以普通控制台进程运行(无 package identity),跑通即证明假设成立。 +//! +//! 运行:`cargo run --example gsmtc_probe` +//! 建议先在任意播放器(网易云/浏览器/Thing)放一首歌,可看到当前会话的元数据与时间轴。 + +use windows::Media::Control::GlobalSystemMediaTransportControlsSessionManager; +use windows::core::Result; + +fn main() -> Result<()> { + // 1. 取全局会话管理器(失败 = 整个能力需降级,见计划 §3.1 失败策略) + let mgr = GlobalSystemMediaTransportControlsSessionManager::RequestAsync()?.get()?; + + // 2. 枚举系统全部 SMTC 会话(注意:0.52 投影里 GetSessions/GetCurrentSession 是同步的) + let sessions = mgr.GetSessions()?; + println!("[ok] GSMTC 可用(unpackaged),当前会话数: {}", sessions.Size()?); + + // 3. 当前活跃会话的元数据 / 播放状态 / 时间轴 + // 无会话时 ABI 返回 null → windows-rs 投影为 Err(E_POINTER),按"无会话"处理 + match mgr.GetCurrentSession() { + Ok(cur) => { + println!("current: {}", cur.SourceAppUserModelId()?); + let p = cur.TryGetMediaPropertiesAsync()?.get()?; + println!(" {} - {} | album: {}", p.Artist()?, p.Title()?, p.AlbumTitle()?); + println!(" status: {:?}", cur.GetPlaybackInfo()?.PlaybackStatus()?); + let tl = cur.GetTimelineProperties()?; + println!( + " position(ticks): {} | lastUpdated(ticks): {}", + tl.Position()?.Duration, + tl.LastUpdatedTime()?.UniversalTime + ); + } + Err(e) => println!("current session: ({e})(先放一首歌再跑,可看完整元数据)"), + } + Ok(()) +} diff --git a/src-tauri/examples/verify_audio.rs b/src-tauri/examples/verify_audio.rs new file mode 100644 index 0000000..2009d18 --- /dev/null +++ b/src-tauri/examples/verify_audio.rs @@ -0,0 +1,41 @@ +//! **临时**校验:用产物解析器确认解密出来的文件是合法音频。 +//! +//! 用法:`cargo run --example verify_audio -- <文件路径>` + +fn main() { + let path = std::env::args() + .nth(1) + .expect("用法:verify_audio <文件路径>"); + let p = std::path::Path::new(&path); + + let size = std::fs::metadata(p).map(|m| m.len()).unwrap_or(0); + println!("文件 : {}", p.display()); + println!("大小 : {size} 字节"); + + // 1) 头部魔数 + let head = std::fs::read(p).map(|b| b[..16.min(b.len())].to_vec()); + match head { + Ok(h) => println!("首帧 : {:02x?}", h), + Err(e) => { + println!("读取失败:{e}"); + std::process::exit(1); + } + } + + // 2) 交给项目同款的解析器(lofty):能读出时长与格式才算真合法 + match lofty::probe::Probe::open(p).and_then(|probe| probe.read()) { + Ok(tagged) => { + use lofty::file::AudioFile; + let props = tagged.properties(); + println!("时长 : {:?}", props.duration()); + println!("码率 : {:?}", props.audio_bitrate()); + println!("采样率 : {:?}", props.sample_rate()); + println!("声道 : {:?}", props.channels()); + println!("=> lofty 成功解析,文件合法可播"); + } + Err(e) => { + println!("lofty 解析失败:{e}"); + std::process::exit(1); + } + } +} diff --git a/src-tauri/src/constants.rs b/src-tauri/src/constants.rs index b1ad318..359e12a 100644 --- a/src-tauri/src/constants.rs +++ b/src-tauri/src/constants.rs @@ -105,6 +105,9 @@ pub mod events { pub const TERMINAL_SETTINGS: &str = "terminal-settings"; // 音乐模块:下载任务事件(桥接事件行 → 前端,负载见 bridge.py _emit_event) pub const MUSIC_DOWNLOAD_EVENT: &str = "music-download-event"; + // 音乐模块:本地解密任务事件(负载见 music::decrypt::DecryptEvent) + // 与下载链路同构:命令先回 taskId,进度与逐文件结果都走这个事件。 + pub const MUSIC_DECRYPT_EVENT: &str = "music-decrypt-event"; // 音乐模块:Rust 侧播放引擎(music/audio)。曲目自然播完(缓冲也放完)后发出,无负载 pub const MUSIC_AUDIO_ENDED: &str = "music-audio-ended"; /// 音乐模块:Rust 侧播放失败(音源打不开 / 解码失败 / 输出设备异常),负载为错误文本 diff --git a/src-tauri/src/lib.rs b/src-tauri/src/lib.rs index 0f69fdd..741b7e9 100644 --- a/src-tauri/src/lib.rs +++ b/src-tauri/src/lib.rs @@ -7,7 +7,7 @@ mod download_engine; mod logger; mod mihomo_manager; mod monitor_kernel; -mod music; +pub mod music; mod network_monitor; mod osd_window; mod process_manager; @@ -58,14 +58,19 @@ use music::{ feiniu_media_prefix, feiniu_save_connection, feiniu_scan_local, feiniu_test_connection, music_audio_play, music_audio_seek, music_audio_set_playing, music_audio_set_volume, music_audio_state, music_audio_stop, - music_cancel_runtime_install, music_download, music_download_cancel, music_env_status, + music_cancel_runtime_install, music_decrypt_cancel, music_decrypt_qq_status, + music_decrypt_run, music_decrypt_scan, + music_download, music_download_cancel, music_env_status, music_get_settings, music_get_sources, music_install_runtime, music_parse_playlist, music_ping, music_resolve, music_save_settings, music_search, music_secret_get, music_secret_set, music_smtc_clear, music_smtc_update_metadata, music_smtc_update_playback_state, music_smtc_update_position, music_stop_bridge, music_update_musicdl, webdav_delete, webdav_get_secret, webdav_save_secret, webdav_test, - webdav_upload, AudioEngine, MusicManager, SmtcController, + webdav_upload, remote_cancel_pairing, remote_get_config, remote_list_devices, + remote_publish_queue, remote_revoke_device, remote_set_enabled, remote_start_pairing, + remote_status, + AudioEngine, MusicManager, RemoteManager, SmtcController, SmtcMetaCache, }; use network_monitor::network_status; use osd_window::{ @@ -240,6 +245,12 @@ fn export_bindings() { // music 播放引擎(Rust 侧播放,取代前端 + + + + +
@@ -1283,6 +1292,22 @@ const RESULT_GRID = { gridTemplateColumns: '24px 36px minmax(0,1fr) 108px 52px 9 + + + + + + 手机互联 + + + +

+ 手机上的 LFMusic 自动发现并连接本机,显示当前播放、远程控制(播放/暂停/切歌/进度)。 +

+ +
+
+ diff --git a/src/modules/music/components/DecryptPanel.vue b/src/modules/music/components/DecryptPanel.vue new file mode 100644 index 0000000..759dc80 --- /dev/null +++ b/src/modules/music/components/DecryptPanel.vue @@ -0,0 +1,505 @@ + + + diff --git a/src/modules/music/components/settings/RemoteSettings.vue b/src/modules/music/components/settings/RemoteSettings.vue new file mode 100644 index 0000000..d8ba648 --- /dev/null +++ b/src/modules/music/components/settings/RemoteSettings.vue @@ -0,0 +1,249 @@ + + + diff --git a/src/modules/music/index.ts b/src/modules/music/index.ts index ac4a482..b1cc654 100644 --- a/src/modules/music/index.ts +++ b/src/modules/music/index.ts @@ -14,6 +14,12 @@ const searchItems: SearchIndexItem[] = [ keywords: ['发现音乐', '搜索', '下载', '聚合', '在线', '网易云', 'qq', '酷狗'], tab: 'discover' }, + { + title: '音乐解密', + description: '解密本地加密音乐文件(网易云 .ncm;QQ音乐待支持)', + keywords: ['解密', 'decrypt', 'ncm', '网易云', '加密', 'mflac', 'mgg', 'qmc', '转换', '解锁'], + tab: 'decrypt' + }, { title: '音乐设置', description: '飞牛连接、播放缓存、下载目录与 Python 环境检查', diff --git a/src/stores/decryptStore.ts b/src/stores/decryptStore.ts new file mode 100644 index 0000000..641223d --- /dev/null +++ b/src/stores/decryptStore.ts @@ -0,0 +1,394 @@ +import { defineStore } from 'pinia' +import { computed, ref } from 'vue' +import { listen, type UnlistenFn } from '@tauri-apps/api/event' +import { invoke } from '@tauri-apps/api/core' +import { toast } from 'vue-sonner' +import { createLogger } from '@/lib/logger' + +const logger = createLogger('music-decrypt') + +/** 与 Rust `music::decrypt::FileStatus` 对应 */ +export type DecryptFileStatus = 'ok' | 'error' | 'unsupported' + +/** 任务行状态(前端自己的展示态,比 Rust 的 FileStatus 多「进行中」) */ +export type DecryptRowStatus = 'pending' | 'running' | DecryptFileStatus + +export interface DecryptRow { + /** 0-based,与后端 `file` 事件的 index 对齐 */ + index: number + /** 源文件绝对路径 */ + path: string + /** 文件名(展示用) */ + name: string + status: DecryptRowStatus + /** 失败原因 / 成功时的备注(平台、密钥形态、元数据摘要) */ + message?: string + /** 产物路径 */ + output?: string + /** 单独落盘的封面路径(网易云 ncm 带内嵌封面时才有) */ + cover?: string +} + +export interface DecryptTask { + taskId: string + status: 'running' | 'done' | 'cancelled' + total: number + /** 已完成文件数(含失败) */ + done: number + ok: number + failed: number + /** 被取消时未处理的文件数 */ + cancelled: number + rows: DecryptRow[] + /** 当前文件进度(字节) */ + bytesDone: number + bytesTotal: number + /** 当前正在处理的文件名 */ + currentName: string + startedAt: number + finishedAt?: number + /** 文件夹批量任务的源目录(散选任务为 undefined) */ + folder?: string +} + +/** `run()` 的入参 */ +export interface RunOptions { + /** 散选的文件列表 */ + files?: string[] + /** 文件夹批量:后端递归扫描该目录 */ + folder?: string + /** 相对路径基准(还原目录结构用),通常与 folder 相同 */ + root?: string + outDir: string + /** 就地解密:产物写在源文件同目录(文件夹批量推荐) */ + inPlace?: boolean +} + +/** 文件夹扫描预览结果(`music_decrypt_scan`) */ +export interface ScanSummary { + total: number + ncm: number + qmc: number +} + +/** + * QQ 音乐在线解密能力状态(`music_decrypt_qq_status`)。 + * + * 新版 `musicex` 格式的 ekey 不在文件里,必须拿本机已登录凭据联网换取, + * 所以这个状态决定了这部分文件能否解密。`authst` **不会**下发到前端。 + */ +export interface QqOnlineStatus { + /** QQMusic.exe 是否在运行 */ + running: boolean + /** 是否取到登录令牌(= 已登录且能读到内存) */ + loggedIn: boolean + /** 本机 QQ 号(仅展示) */ + uin: string | null + /** 是否具备在线取密钥的能力 */ + ready: boolean + message: string + /** 需要用户照做的步骤 */ + steps: string[] +} + +/** + * 与 Rust `music::decrypt::DecryptEvent` 对应(`#[serde(tag = "type", rename_all = "kebab-case")]`)。 + * 注意字段名由 serde 原样输出为 camelCase 之外的形式:Rust 侧字段是 + * `task_id`/`bytes_done`…,`DecryptEvent` 没加 `rename_all`(只有 tag 加了), + * 所以负载里是 **snake_case**。这里按实际收到的形状声明。 + */ +type RawEvent = + | { type: 'start'; task_id: string; total: number } + | { + type: 'file' + task_id: string + index: number + name: string + status: DecryptFileStatus + message: string | null + output: string | null + cover: string | null + } + | { + type: 'progress' + task_id: string + done: number + total: number + bytes_done: number + bytes_total: number + name: string + } + | { type: 'finished'; task_id: string; ok: number; failed: number; cancelled: number } + +/** 事件名(与 `constants.rs` 的 `MUSIC_DECRYPT_EVENT` 一致;前端侧沿用硬编码,见 musicStore 同款写法) */ +const EVENT = 'music-decrypt-event' + +export const useDecryptStore = defineStore('musicDecrypt', () => { + /** 时间倒序(最新任务在最前) */ + const tasks = ref([]) + /** 同时保留多少个任务(与下载任务的 MAX_TASKS 量级一致) */ + const MAX_TASKS = 20 + + const activeTask = computed(() => tasks.value.find((t) => t.status === 'running') ?? null) + const hasRunning = computed(() => tasks.value.some((t) => t.status === 'running')) + + let unlisten: UnlistenFn | null = null + + /** + * 事件监听**必须挂在 store**,不能挂组件:音乐模块的 Tabs 非 active 时会卸载 + * `TabsContent`,组件里的监听会随之失效,切回页签就丢进度。 + */ + async function ensureListener(): Promise { + if (unlisten) return + unlisten = await listen(EVENT, (e) => handleEvent(e.payload)) + } + + function handleEvent(ev: RawEvent): void { + const task = tasks.value.find((t) => t.taskId === ev.task_id) + if (!task) return + + if (ev.type === 'start') { + task.total = ev.total + // 补齐到 total:文件夹模式下后端会认领比 UI 预览更多的文件, + // 行数必须跟得上,否则后面的 file 事件找不到行。 + while (task.rows.length < ev.total) { + task.rows.push({ + index: task.rows.length, + path: '', + name: `#${task.rows.length + 1}`, + status: 'pending' as DecryptRowStatus + }) + } + if (task.rows[0] && task.rows[0].status === 'pending') task.rows[0].status = 'running' + return + } + + if (ev.type === 'progress') { + task.bytesDone = ev.bytes_done + task.bytesTotal = ev.bytes_total + task.currentName = ev.name + // done 由 progress 与 file 共同推进,取更大值避免回退 + if (ev.total > 0) { + task.total = ev.total + task.done = Math.max(task.done, Math.min(ev.done, ev.total)) + } + return + } + + if (ev.type === 'file') { + // 逐文件事件里的 name 是**权威**的(文件夹模式下前端并不预先知道清单), + // 因此行不存在时按事件补建。 + let row = task.rows[ev.index] + if (!row) { + while (task.rows.length <= ev.index) { + task.rows.push({ + index: task.rows.length, + path: '', + name: `#${task.rows.length + 1}`, + status: 'pending' as DecryptRowStatus + }) + } + row = task.rows[ev.index] + } + row.name = ev.name || row.name + row.status = ev.status + row.message = ev.message ?? undefined + row.output = ev.output ?? undefined + row.cover = ev.cover ?? undefined + task.done = Math.max(task.done, ev.index + 1) + // 成功/失败计数以 finished 为准,这里先按逐文件结果累积(UI 更跟手) + const ok = task.rows.filter((r) => r.status === 'ok').length + const failed = task.rows.filter((r) => r.status === 'error' || r.status === 'unsupported').length + task.ok = ok + task.failed = failed + // 下一行进入「进行中」 + const next = task.rows[ev.index + 1] + if (next && next.status === 'pending') next.status = 'running' + return + } + + if (ev.type === 'finished') { + task.ok = ev.ok + task.failed = ev.failed + task.cancelled = ev.cancelled + // cancelled 是「尚未处理」的数量;clamp 到 0 防止后端口径变化时进度为负 + task.done = Math.max(0, task.total - ev.cancelled) + task.status = ev.cancelled > 0 ? 'cancelled' : 'done' + task.finishedAt = Date.now() + task.bytesDone = 0 + task.bytesTotal = 0 + task.currentName = '' + for (const row of task.rows) { + if (row.status === 'running' || row.status === 'pending') row.status = 'pending' + } + // 收尾提示:任务表本身也是反馈,但用户可能已切走页签(监听在 store,仍然生效) + if (ev.cancelled > 0) { + toast.info(`解密已取消:成功 ${ev.ok} / 失败 ${ev.failed}`) + } else if (ev.failed > 0) { + toast.warning(`解密完成:成功 ${ev.ok} / 失败 ${ev.failed}`) + } else { + toast.success(`解密完成:共 ${ev.ok} 个文件`) + } + } + } + + /** + * 启动一批解密。 + * + * `taskId` 由前端生成(与 `music_download` 同款),后端只回 `Ok(())`, + * 逐文件结果全部走事件——所以这里必须**先**把任务与行建好,再 `invoke`, + * 否则第一批事件到达时找不到对应任务会被丢弃。 + * + * 两种输入二选一: + * - `folder`:文件夹批量(后端递归扫描,**内容判定优先**,会认领比 UI 列表更多的文件) + * - `files`:显式列表(散选) + */ + async function run(opts: RunOptions): Promise { + const { files, folder, root, outDir, inPlace } = opts + const plainFiles = files ?? [] + if (!folder && plainFiles.length === 0) throw new Error('未选择任何文件') + await ensureListener() + + // 文件夹模式下列表只用于预建行;真实清单以后端扫描为准, + // 因此这里先按已知信息建行,收到超出的 index 时再补行(见 handleEvent)。 + const initial = folder ? [] : plainFiles + const taskId = `decrypt-${Date.now()}-${Math.random().toString(36).slice(2, 8)}` + const task: DecryptTask = { + taskId, + status: 'running', + total: initial.length, + done: 0, + ok: 0, + failed: 0, + cancelled: 0, + rows: initial.map((path, index) => ({ + index, + path, + name: fileName(path), + status: 'pending' as DecryptRowStatus + })), + bytesDone: 0, + bytesTotal: 0, + currentName: folder ? folderName(folder) : '', + startedAt: Date.now(), + folder: folder ?? undefined + } + tasks.value.unshift(task) + if (tasks.value.length > MAX_TASKS) tasks.value = tasks.value.slice(0, MAX_TASKS) + + try { + await invoke('music_decrypt_run', { + taskId, + files: plainFiles.length > 0 ? plainFiles : null, + folder: folder ?? null, + root: root ?? null, + outDir, + inPlace: !!inPlace + }) + } catch (e) { + // 命令层拒绝(参数问题 / 全部在输出目录内 / 目录里没有加密文件):任务直接落定为失败 + task.status = 'done' + task.failed = Math.max(task.total, 1) + task.finishedAt = Date.now() + if (task.rows.length === 0) { + task.rows.push({ + index: 0, + path: folder ?? '', + name: folder ? folderName(folder) : '(未选择文件)', + status: 'error', + message: String(e) + }) + task.total = 1 + } else { + task.rows.forEach((r) => { + r.status = 'error' + r.message = String(e) + }) + } + logger.error(`启动解密任务失败:${e}`) + throw e + } + return taskId + } + + /** 请求取消(队列级:当前文件做完,剩余不再开始) */ + async function cancel(taskId: string): Promise { + await invoke('music_decrypt_cancel', { taskId }) + } + + /** + * 预览一个文件夹里有多少可解密文件(不解密)。 + * + * 内容判定在 Rust 侧完成(`scan::route`),因此结果比按后缀猜更准—— + * 用户能在开跑前看到"找到 N 个(网易云 x / QQ音乐 y)"。 + */ + async function scanFolder(folder: string, root?: string): Promise { + return (await invoke('music_decrypt_scan', { + folder, + root: root ?? null + })) as ScanSummary + } + + /** + * 探测 QQ 音乐在线能力(只读本机信息,不发网络请求)。 + * 结果缓存在 store 里,供页签状态卡渲染;用户可手动「重新检测」。 + */ + const qqStatus = ref(null) + const qqProbing = ref(false) + + async function probeQq(): Promise { + qqProbing.value = true + try { + qqStatus.value = (await invoke('music_decrypt_qq_status')) as QqOnlineStatus + return qqStatus.value + } catch (e) { + logger.error(`探测 QQ 音乐在线能力失败:${e}`) + return null + } finally { + qqProbing.value = false + } + } + + function clearFinished(): void { + tasks.value = tasks.value.filter((t) => t.status === 'running') + } + + function remove(taskId: string): void { + tasks.value = tasks.value.filter((t) => t.taskId !== taskId) + } + + /** 停止监听(模块卸载场景;正常使用无需调用) */ + function dispose(): void { + unlisten?.() + unlisten = null + } + + return { + tasks, + activeTask, + hasRunning, + run, + cancel, + scanFolder, + qqStatus, + qqProbing, + probeQq, + clearFinished, + remove, + dispose, + ensureListener + } +}) + +/** 从路径取文件名(同时兼容 Windows 反斜杠与 POSIX 斜杠) */ +function fileName(path: string): string { + const parts = path.split(/[\\/]/) + return parts[parts.length - 1] || path +} + +/** 从目录路径取最后一段作为显示名 */ +function folderName(path: string): string { + const trimmed = path.replace(/[\\/]+$/, '') + const parts = trimmed.split(/[\\/]/) + return parts[parts.length - 1] || trimmed +} diff --git a/src/stores/feiniuStore.ts b/src/stores/feiniuStore.ts index f1332f1..87d89e9 100644 --- a/src/stores/feiniuStore.ts +++ b/src/stores/feiniuStore.ts @@ -506,6 +506,8 @@ export const useFeiniuStore = defineStore('feiniu', () => { void ensureCacheStatus() // 系统媒体控件的按钮 → 播放器动作(原生 SMTC 事件,整个应用生命周期只订阅一次) setupSmtcButtons() + // 手机遥控选歌事件(同样只订阅一次) + setupRemoteJump() // 引擎事件(播完 / 失败),同样只订阅一次 setupAudioEvents() } @@ -1422,6 +1424,21 @@ export const useFeiniuStore = defineStore('feiniu', () => { playCurrent() } + /** + * 跳到队列指定条目(手机遥控「选歌」;`index` 是完整队列的绝对下标)。 + * 显式点选不走随机洗牌:用户要哪首就播哪首,同时把当前位置压栈供「上一首」回退。 + */ + function jumpTo(index: number) { + if (!Number.isInteger(index) || index < 0 || index >= queue.value.length) return + preview.value = null + dropPendingResume() + if (index !== queueIndex.value) { + historyStack.value.push(queueIndex.value) + } + queueIndex.value = index + playCurrent() + } + /** 跳转到指定秒数(时长未知时不动作,由 UI 提示) */ function seek(sec: number) { if (!engineActive) return @@ -1735,6 +1752,42 @@ export const useFeiniuStore = defineStore('feiniu', () => { }).catch((e) => logger.error(`订阅系统媒体按钮事件失败: ${e}`)) } + // ===== 手机遥控:队列下发 + 选歌(Thing 专属) ===== + + /** 下发给手机的队列片段上限(完整队列可到 4000 条,手机端只展示当前附近一段) */ + const REMOTE_QUEUE_MAX = 500 + let remoteQueueTimer: ReturnType | null = null + + /** 队列快照去抖下发(每项带绝对 `index`,服务端与手机端按它跳转) */ + function publishRemoteQueue() { + if (remoteQueueTimer) clearTimeout(remoteQueueTimer) + remoteQueueTimer = setTimeout(() => { + remoteQueueTimer = null + const all = queue.value + const idx = queueIndex.value + const start = + all.length <= REMOTE_QUEUE_MAX + ? 0 + : Math.max(0, Math.min(idx - 100, all.length - REMOTE_QUEUE_MAX)) + const items = all.slice(start, start + REMOTE_QUEUE_MAX).map((t, i) => ({ + index: start + i, + title: t.title || '', + artist: t.artistNames || '', + durationSec: (t.durationMs ?? 0) / 1000 + })) + void invoke('remote_publish_queue', { items, index: idx, total: all.length }).catch((e) => { + logger.error(`下发遥控队列失败: ${String(e)}`) + }) + }, 300) + } + + /** 手机端点选某首 → 跳过去(remote 服务把 `jump` 指令转成事件回来) */ + function setupRemoteJump() { + void listen('music-remote-jump', (e) => jumpTo(Number(e.payload))).catch((e) => + logger.error(`订阅遥控选歌事件失败: ${String(e)}`) + ) + } + // 曲目变化 → 元数据;播放/暂停 → 状态。用 watch 统一挂钩,避免在每条切歌分支 // (队列/试听/恢复播放/缓存播放)里各写一遍而漏掉某条路径。 watch(nowPlaying, () => { @@ -1749,6 +1802,11 @@ export const useFeiniuStore = defineStore('feiniu', () => { // 系统面板就一直缺封面(歌名/歌手/专辑正常),直到用户切歌才补上。 // 前缀到位后补投一次元数据即可(coverId 已随队列落盘,无需重取)。 watch(mediaPrefix, () => syncMediaMetadata()) + // 遥控队列下发:切歌 / 增删队列 → 去抖 300ms 发布(Thing 专属能力)。 + // 队列可能在这些 watch 挂上之前就恢复好了,启动时补发一次。 + watch(queue, publishRemoteQueue, { deep: true }) + watch(queueIndex, publishRemoteQueue) + publishRemoteQueue() const progress = computed(() => (duration.value > 0 ? (position.value / duration.value) * 100 : 0))