Repository navigation
Releases
Releases · huaidj/acemusic-batch-downloader
v1.10.2 - store package fix
1.10.2(商店包修正)
- store zip 現在會剝掉 manifest 的
key/update_url;Chrome Web Store 上傳不再被「清单文件中不得包含 key 字段」擋下。 - 完整包保留固定 ID;版本 1.10.2;單元 563/563、e2e 31/31。
Store package fix
- The store zip now strips
key/update_urlfrom the manifest, so the Chrome Web Store accepts the upload. - The full package keeps the fixed ID. Tests: 563/563 unit, 31/31 e2e.
v1.10.1 — 啟動與 Hub 快取優化 · Faster startup & Hub cache
v1.10.1 · 啟動與 Hub 快取優化 / Faster startup & Hub cache
中文
支援三種接入方式
- ACE 網站面板:在 acemusic.ai/create 下載自己的分軌、MIDI、MusicXML、MP3、WAV、封面;自動命名與分類、一鍵整理、命名爐、獨立播放器。
- MCP:本機
ode agent\mcp.mjs(stdio,20+ 工具:�ce_download、�ce_locate、�ce_wait_new_song、�ce_tidy…);站點 session 失效時自動改走 官方遠端 MCP(OAuth 2.1,一次授權、自動續約),歌單與 mp3/wav/midi/封面仍可下載。 - CLI + Hub:
ode agent\cli.mjs …;常駐 Hub 127.0.0.1:8788(job 佇列、SSE、多 agent 共用)。
這一版改了什麼
- CLI 啟動:create/music 兩份大契約改為按需載入,status --json 由約 290 ms 降到 190–250 ms。
- Hub 短效快取:/library、/download-index 4 秒內重複請求直接回上次結果,面板輪詢由每次 300–600 ms 降到 9–35 ms;任何 POST 或新事件立即失效。
- 測試:單元 563/563、e2e 31/31。
安裝:Chrome/Edge → chrome://extensions → 開發人員模式 → 載入未封裝(repo 根目錄);或使用 *-full.zip 內的 更新本機工具.cmd。完整功能:docs/PROJECT.md。
English
Three ways to use it
- ACE website panel: batch-download your own stems, MIDI, MusicXML, MP3/WAV and covers on acemusic.ai/create, with auto-naming, one-click tidy, naming furnace and a standalone player.
- MCP: local stdio server (
ode agent\mcp.mjs, 20+ tools such as �ce_download, �ce_locate, �ce_wait_new_song, �ce_tidy); when the site session expires it falls back to the official remote MCP (OAuth 2.1, authorize once, auto-refresh) for song lists and mp3/wav/midi/covers. - CLI + Hub:
ode agent\cli.mjs … plus a resident Hub at 127.0.0.1:8788 (job queue, SSE, shared by agents).
What changed in v1.10.1
- CLI startup: the large Create/Music contracts load on demand; status --json went from ~290 ms to 190–250 ms.
- Hub cache: /library and /download-index reuse a result for 4 seconds; repeated panel polling dropped from 300–600 ms to 9–35 ms. Any POST or new event invalidates immediately.
- Tests: 563/563 unit, 31/31 e2e.
Install: Chrome/Edge → chrome://extensions → Developer mode → Load unpacked (repo root); or use 更新本機工具.cmd from the full package. Full feature guide: docs/PROJECT.md.
Assets: �cemusic-batch-downloader-1.10.1-store.zip(Chrome Web Store 用 / for the store)· �cemusic-batch-downloader-1.10.1-full.zip(完整本機工具 / full local tools)
v1.10.0 — 官方遠端 MCP 兜底(OAuth 2.1)
v1.9.5 — 保護 節目 資料夾
1.9.5
修正:節目\ 裡的成品(電臺節目/母帶)會被一鍵整理當成「未分類音檔」搬進 _未對應\音頻分類找回,並在 音頻分類 建硬連結檢視。
節目現在跟收藏/整理輸出/已點讚一樣是受保護資料夾:歸檔、分類、去重、檔案索引、音頻分析全部跳過。- 實測:
classify-files跑完 moved 0,節目兩份檔案原位不動;索引 1,556 個檔案中來自節目的 0 個。
v1.9.4 — 取名器 v3(讀書語料+句法)
1.9.4 — 取名器 v3
- 依音頻特徵(BPM/Camelot/能量)挑詞,詞與詞必須有來源關係才配對(共同 tag、同勢力、裝置主題相符)。
- 四位靈感子代理讀《靈感電子百科大全》各章後產出的語料:抽象 54、具體 66、短語 55、荒謬並置 53、句法 8 組、動詞 20、荒謬配對 16。
- 句法層:{抽象}的{具體}、在{具體}裡{動詞}、把{抽象}{動詞}成{具體}、{抽象}是{具體}、給{抽象}的{具體}、沒有{具體}的{抽象}、{數字}{單位}的{抽象}、{具體}在{動詞}。
- 同家族(同名不同 take)共用基底名 + 變體標記(II/III 或原檔名描述),檔名保證唯一。
- 兩本書平衡:夜城類 >45%、電子百科類 >55% 都會被壓低,避免整批同一世界觀。
- 測試 553/553;dist/-1.9.4-.zip。
v1.9.3 — 面板重新命名這批/白話日誌摘要/播放器托盤
1.9.3
- 面板「維護」新增 重新命名這批:背景跑
named-copy,只回一句摘要。 - 新增 日誌摘要(預設收起+「打開摘要檔」):白話摘要寫在曲庫根目錄
_整理摘要.md,完整機器紀錄在%LOCALAPPDATA%\AceMusicDL\logs\activity.jsonl。 - 一鍵整理完成只回一句話,下載/分類/複製/改名全部背景安靜執行。
- CLI
activity;native host 1.2.1 新增named-copy/activity/open-file。 - 播放器改成托盤:
player\start.ps1預設只留系統匣圖示,右鍵可「調整參數…」、顯示/隱藏/重啟;node cli.mjs player --tray。
v1.9.2 — 改名WAV 交付(詞庫命名/封面/硬連結)
1.9.2 / 1.9.1
一鍵整理接上「改名WAV」與「硬連結」,並補上 WAV 證據修補。
- 改名WAV 交付:
named-copy用《夜城人物事典》《靈感電子百科大全》抽出的詞庫組合中文+英文名,輸出到改名WAV(複製式、來源不動),名字尾綴生成時間;_命名日誌.json可倒查原本是哪個檔。 - AIFF + 封面 + 藝人:
export-aiff把 成品WAV(或--liked已點讚)轉成 AIFF(PCM 不重算),寫入 ID3v2.4 標題、VooDooBoys藝人與封面;-map_metadata -1不搬來源 metadata。 - 省硬碟:
hardlink-dedupe把收藏/已點讚裡與母帶內容完全相同(大小+sha256)的副本改成硬連結,同碟才做、跨碟退回複製;一鍵整理已內建這步。 - 一鍵整理:新增
namedcopy、hardlinks兩步(可用config.json的naming.enabled/hardlinks.enabled關閉);downloadDir可把曲庫指到別的磁碟。 - 證據修補:
repair-evidence用[8hex]尾碼或唯一歌名把 WAV 證據補回agent-state.json;本機索引也會用檔名證據補強。 - 單元測試 553/553。
升級
- 擴充功能:商店更新,或開發者模式載入本 repo 後按「重新載入」。
- CLI/MCP:直接使用此 repo 的
agent/。
v1.9.0 — 獨立播放器全功能化
1.9.0 — 獨立播放器全功能化
- BPM/調性/能量:新增
/api/analysis,把整理管線的分析快取對到實際音檔;曲庫表格多出 BPM 與 Camelot 調性兩欄(可點標題排序),詳細面板顯示 BPM/調性/能量,並新增 BPM 區間與調性篩選。沒分析資料顯示「—」/「未分析」,播放器只讀快取、不觸發分析。只回前端看得到的檔案 ID(實測 988/1266),避免多送一萬筆別名。 - 佇列操作:每首歌可「下一首播放」(插到目前曲目後面、不重複),佇列可上下移動、單獨移除,順序照舊保存。
- M3U8 匯出/匯入:
GET /api/playlists/<id>/m3u會給含絕對路徑的.m3u8(Rekordbox/Serato/Mixxx 可直接載入);POST /api/playlists/import把路徑對回曲庫(先比絕對路徑、失效才用唯一檔名),不在曲庫的路徑逐條回報,匯入也走版本遞增不會跟其他視窗打架。 - 鍵盤快捷鍵:J/L 前後 5 秒、M 靜音、F 收藏、Q 開關佇列、/ 搜尋、? 快捷鍵說明(另有 Space、Alt+←/→、Esc)。修正事件來源不是元素時
closest會拋錯。 - 睡眠計時:15/30/60/90 分鐘,到時自動暫停並提示。
- 測試:單元 553/553(新增分析與 M3U 3 個、播放器守門與 watch 已點讚共 6 個);另用隔離服務+headless Chrome 做互動冒煙 7/7(排序、調性篩選、?、睡眠、佇列、M3U 按鈕)。
v1.8.10 — 整理不重複跑、背景整理補上已點讚
1.8.10 — 整理不重複跑、背景整理補上已點讚
- 一鍵整理不再疊羅漢:連續觸發(下載完自動整理、面板按鈕、CLI、Hub、MCP)會合併。跑的那一輪持有
%LOCALAPPDATA%\AceMusicDL\tidy-run.lock;其他觸發不排隊等曲庫租約、也不各自跑完整管線,只寫tidy-pending.json,讓那一輪結束後最多補跑一輪(只吃一次,避免無限循環)。持有者行程已死留下的過期鎖自動清除;釋放時比對 token,不會刪掉別人的鎖。 - 修正實測問題:同一次下載完成後 1 分鐘內來了 3 個 tidy-all,靠租約排隊各跑約 5 分鐘,並重複產生
(2)…(8)同名副本。現在最多一輪+一次補跑。 cli.mjs tidy-all --background先看有沒有人在跑:有就只登記、不另開行程;合併掉的那次不寫tidy-status.json的done(面板進度條仍跟真正在跑的那一輪)。- 背景整理 daemon(
watch.mjs)補上「已點讚」步驟:先前只做到收藏夾,新點讚/取消點讚的副本不會更新;現在是 … → 收藏 → 已點讚(AI 命名)。 - 整理狀態的
favorites步驟多記noWav/pruned/prunedDirs,看得出「只有 MP3 沒有母帶」與清掉多少舊版雜檔。 - 新增 6 個單元測試(tidy-guard 5、watch 已點讚 1),全套 550/550 通過;實機驗證:跑到一半再觸發 → 合併、結束後
passes: 2補跑一輪,pending 與鎖都正確釋放。
v1.8.9 — 收藏夾改成平的 WAV 母帶
1.8.9 — 收藏夾改成平的 WAV 母帶
- 收藏夾改版:不再
收藏\<歌名>\一歌一資料夾,也不再複製 MP3/分軌/MIDI/MusicXML/封面,改成ai音樂\收藏\<歌名>.wav平鋪一層,每首歌只留一個成品 WAV 母帶(索引裡 verified 優先、再來 recorded;分軌與損壞檔不收)。 - 站點只有 MP3 的歌沒有母帶可收,計入新欄位
noWav;檔案仍在成品MP3/已點讚。 - 舊版
收藏\<歌名>\子資料夾與其中的雜檔會在下次整理時清掉:只刪「清單記過、大小沒變」的我們放的副本,使用者自己改過或自己放的一律保留,資料夾空了才移除(回報pruned/prunedDirs)。 - 清單升級
ace_favorites_manifest_v2(layout: "flat-wav"、每首記錄file);歌名變更時把我們沒被改過的舊副本原地改名,不重複複製。同名不同內容仍不覆寫(--force才覆寫並先歸檔)。 - CLI
favorites摘要新增「更新/改名/沒有 WAV/清掉舊版雜檔」;MCPace_collect_favorites說明同步。 - 單元測試 544/544 通過(收藏夾測試改寫為 WAV 母帶語意,含舊佈局清理與 fallback 防護)。