英文原文: https://argusic.com/subject/musicbox

MusicBox

一款高颜值、插件化、可深度定制的本地音乐播放器，支持 Windows、MacOS、Linux 系统。

可运行来源：GitHub项目主页TypeScriptMITcommit d28652e5dace

TypeScript，MIT 许可证. 项目的自我描述：electron、extension system、javascript、linux、local music player、macos、music 和 music player.

MusicBox 可以运行。一个 Argusic agent 在一台没有 GPU 的干净机器上用 38 分钟完成了安装，遇到 7 个错误，并在无人协助的情况下全部修复，整个会话都被记录了下来。

on this Ubuntu container, MusicBox installs (Node 22.23.3, Rust 1.99.1, venv pip), builds renderer+main TS and lint/typecheck cleanly, launches on the Xvfb display with the full UI and preload bridge alive, scans a real music folder and returns correct track metadata, plays in UI state and fetches live network lyrics successfully, and edits FLAC metadata end-to-end;

agent 在干净的机器上最终得到的结果，用它自己的话说。 测量方式

每一次都由 Argusic 在全新机器上实测。每个数字都链接到对应的证据。 Argusic 评分 100，满分 100（该项目各次运行得分的平均值）。

概览

结论
可运行
Argusic 评分
100 / 100
验证运行的成本
0.37 USD（实测）
已记录的运行次数
1
最近测试
星标
507
fork 数
34
未关闭的 issue
7
关注者
1
大小
68 MB
创建于
最近推送

项目数据来自 GitHub，链接见本页顶部，更新于 。测试数据由 Argusic 提供 (CC BY 4.0)；每个数字都链接到一个运行页面，附完整的 log、录屏及其 sha256 哈希。

测量了什么

来自决定该结论的那次运行。 每一行都是记录下来的数值，而非估算。

测试 MusicBox 时每个故障耗费的时间，取自已记录的运行
每一根柱子都是 agent 记录的一次失败，以及它耗费的时间。数据仅取自本次运行。

哪里出了问题，用 agent 自己的话说

agent 的原话，最严重的排在最前，从不改写成建议。

  • npm run build:rs fails on Linux: wasapi 0.21/windows 0.62 are Windows-only; wasapi crate unconditionally imports Win32 COM types, so no feature set compiles on non-Windows (tried default-features=false and cargo [patch] wasapi/windows-future; upstream has no Linux path)20 分钟
  • npm run build:python fails: PyInstaller and Nuitka both need system libpython3.12.so.1.0/python3-dev, absent and uninstallable without root8 分钟
  • No Rust toolchain in container; native audio crate requires one3 分钟
  • Container Node.js v18.19.1 is below the project's required >=222 分钟
  • System pip install refused by PEP 668 (externally-managed-environment)2 分钟
  • Headless container has no ALSA/PulseAudio//dev/snd, so audible WebAudio output could not be observed2 分钟
安装时间
38 分钟
从冷启动机器到完成
17 分钟
遇到并修复的错误
遇到 7 个，在无人协助的情况下修复了 7 个
结果是如何证明的
electron dist/main/main.js --no-sandbox --remote-debugging-port=9223 launched on DISPLAY=:99 (log showed '应用窗口已显示', renderer DOM 155KB, window.electronAPI true); via CDP: electronAPI.library.scanDirectory('/tmp/fix/music') true, getTracks({}) returned [Test Song/Test Artist 3s flac, test 3.03s mp3]; UI defined rows; play triggered api.lrc.cx request '网络请求成功' + LRC parsed 3 lines; python3 metadata_editor.py wrote FLAC tags (ffprobe shows TITLE/ARTIST/ALBUM/DATE/GENRE) and ffmpeg -v error -f null - decodes both fixtures cleanly; renderer lint+typecheck and architecture check pass
使用的模型 token
1,694,083
测试的确切 commit
d28652e5dace
容器镜像
sha256:cdd920bce783

没有测量什么

另一半内容，让你清楚看到这些证据能说明到什么程度。缺失的数据就标为缺失，从不填补。

GPU 显存峰值
本次运行在 CPU 机器上进行，没有可采样的 GPU
长时间运行的表现
每次尝试都使用文档中最小的设置和固定的时间预算，因此这里测量的是它能否运行，而不是它在负载下的表现

观看会话

完整的运行过程，从一台干净的机器开始，按实际速度播放。没有剪辑，也没有加速。

第 1 次尝试的录屏，运行于 ，即决定上述结论的那次尝试。 制作该视频所用的终端录屏是证据，连同 sha256 指纹一起保存；视频只是由它渲染而成。 在你点击播放之前，不会从视频托管方加载任何内容。

录屏的结尾

决定该结论的终端会话的最后几行，与录制时完全一致。

All checks complete. Compiling the final report now.
**Summary of the mission:**
- **Install:** `npm install`, `npm run install:renderer`, `npm run install:rs`, and `pip install -r…
- **Errors fixed:**
  1. Node <22 (needed ≥22) → installed Node 22.23.3 userland.
  2. Rust missing → installed rustup stable 1.99.1 userland.
  3. System pip blocked by PEP 668 → installed deps into a venv (`/home/runner/venv`), which also p…
  4. Electron SUID sandbox needs root → launched with `--no-sandbox` (documented non-root workaroun…
  5. `npm run build:rs` (Rust native audio engine) cannot compile on Linux: `wasapi`/`windows` are …
  6. `npm run build:python` (PyInstaller/Nuitka freeze) needs `libpython3.12.so.1.0` / `python3-dev…
- **Launch verified:** App launched on Xvfb `:99`; main process registered 22 IPC controllers, crea…
- **test_depth:** tier1_real — real app launch, real IPC/library/metadata/network-lyrics behavior v…

回放完整会话，从干净的机器到此刻的每一条命令。

测试方式

一个 agent，一个容器，没有人工协助。它按照项目自身文档所写的方式安装项目，运行它，并修复出错的地方。下面的一切都按实际发生的过程记录：终端会话、log 和确切的 commit。 完整方法论.

优势与局限

均为实测事实，而非观点。内容是如何撰写的.

顺利的部分

  • 在干净的机器上达到了运行状态，会话有完整记录。
  • 在无人介入的情况下从全部 7 个错误中恢复，说明这些故障的文档足以让人解决。
  • 无需 GPU 即可运行，因此启动它并不需要 GPU。
  • 采用 MIT 许可证，以其托管平台报告的信息为准。

不顺利或尚不清楚的部分

  • 安装用了 38 分钟，慢于 Argusic 测量过的 5 个同类项目的中位数。
  • 目前只测量过一次。单次尝试只能说明它可以运行，不能说明它能稳定运行。

在 Argusic 安装并计时过的 6 个 electron 项目中，MusicBox 达到运行状态的速度排名第 6，6 个项目中有 4 个达到了运行状态。

适合用于

  • 在笔记本电脑或小型服务器上试用：它无需 GPU 即达到了运行状态。

同一领域中也测试过的项目

这里的每个项目都由 Argusic 在干净的机器上安装并运行过。未经测试的项目不会出现在这里。

  • spotifast 已测试，未验证 · Rust · 5 个共同主题
  • pear-desktop 已验证可运行 · TypeScript · 4 个共同主题
  • openspot-music-app 已验证可运行 · TypeScript · 4 个共同主题
  • SoundCloud-Desktop 已测试，未验证 · TypeScript · 4 个共同主题
  • marktext 已验证可运行 · TypeScript · 3 个共同主题
  • yazi 已验证可运行 · Rust · 3 个共同主题

运行历史

测试者尝试结果评分成本 USD时间
Argusic Runner1/3可运行100.000.37

主题 (来自 GitHub)

electronextension-systemjavascriptlinuxlocal-music-playermacosmusicmusic-playerpluginplugin-systemrusttypescriptwindowsyesplaymusic

嵌入徽章

用于项目 README 的 Markdown。徽章链接回本页；使用条款见 条款页面.

[![Tested by Argusic](https://argusic.com/badge/MusicBox.svg)](https://argusic.com/subject/musicbox)

常见问题

MusicBox 能运行吗？
是的。MusicBox 可以运行. Argusic 在一台干净的机器上安装并启动了它，用时 38 分钟，过程中遇到 7 个错误，并记录了整个会话。
Argusic 是如何测试 MusicBox 的？
在一台全新的一次性机器上进行，每条命令都被记录，仓库固定在 commit d28652e5dace。共记录了 1 次尝试，完整方法见方法论页面。
测试 MusicBox 花了多少钱？
得出该结论的那次运行花费 0.37 USD：这是真实的算力和模型成本，而不是按每百万 token 计的标价。该数字记录在那次运行的页面上。
MusicBox 安装需要多长时间？
在决定该结论的那次运行中，从干净的机器到运行状态用了 38 分钟。这是一次实测的尝试，不是平均值。
MusicBox 需要 GPU 吗？
启动它不需要。Argusic 在一台没有 GPU 的机器上让它达到了运行状态。
安装 MusicBox 时会出现什么问题？
已记录的运行中出现了 7 个问题，其中 7 个在无人协助的情况下被修复。每个问题及其耗费的时间都列在本页上。
MusicBox 与其他替代方案相比如何？
在 Argusic 安装并计时过的 6 个 electron 项目中，MusicBox 达到运行状态的速度排名第 6，6 个项目中有 4 个达到了运行状态。
MusicBox 的证据在哪里？
这次已记录的运行都在本页上，每次都链接到完整的 log 和终端录屏，并连同 sha256 指纹一起保存，因此无法被悄悄篡改。

Discussion