☁️ Primuse 歌单云端管理中心

Cloudflare Pages + D1 Serverless 跨设备歌单备份、复制与智能合并平台

API 同步端点 ● 运行就绪

在 Primuse App「设置」-「同步」-「歌单同步」中配置此端点地址:

加载中...

音乐源清单端点(App 只需再保存这一个 URL,源的管理全在这里):

加载中...

支持自动备份(POST)、拉取恢复(GET)、跨设备一键复制(Copy)与同名去重合并(Merge)。

已同步设备与歌单库
正在加载设备列表...
🎛️ 音乐源管理 rev -
这里增删改,App 里只读:客户端只保存这一个 URL,拉一次清单就拿到可用源、最新体检结论和该设备的界面文案。 体检判据是真出声:搜索命中 → 解析直链 → Range 取前 64KB → 校验音频字节魔数,只有"能访问"不算可用。 判为不可用的源会被自动停用并给出删除建议;runner_missing / no_sample / unsupported 这类"没法下结论"的情况不会停用任何源。
这个令牌是什么:服务端写接口的唯一凭证。 清单读取是开放的(App 也走它,所以不需要令牌);但增删改源、启停、体检、改首页文案、动样本池这些 写操作一律要 Authorization: Bearer <令牌> —— 这个后台是 CORS: * 的公网页面, 没有它任何人都能改音源、把全站用户的播放带偏。没配令牌时写接口直接 503(fail closed),不会退化成"谁都能改"。
去哪拿:Cloudflare 控制台 → Pages → 本项目 → Settings → Environment variables → 变量 SOURCES_ADMIN_TOKEN。 那里只存不回显明文;本机仓库的 .deploy-secrets.txt(已 gitignore)留有明文,忘了就从那里取,或重新设一个再 wrangler pages secret put。 另有低权限的 SOURCES_CHECK_TOKEN,只够调 check-one / check-plan,适合给"只想让它体检别想改源"的人。
「记住令牌」做什么:把它写进本标签页的 sessionStorage,之后每次点写操作自动带上,省去反复粘贴。 它不落 localStorage、不进磁盘、关闭标签页即消失,刷新页面就要重填 —— 令牌泄漏的窗口只有一次会话那么长。
点击「刷新清单」加载音源
🧪 体检样本池(probe_samples_v1)
体检要"真出声"就得先有一首真实的歌去解析取流。会搜索的线路每次命中都会把歌曲 id 攒进这里(每平台上限 24 个), 洛雪 js 音源不会搜索,就靠这份池子被体检。某个平台的池子是空的、而这个平台的源又没有一个会搜 —— 服务端就只能报未检出(no_sample):这不是"源坏了",是我们手上没它的考题,所以既不停用也不加载进 App。 填一个该平台的真实歌曲 id(网易云 / QQ / 酷狗 / 酷我 / 咪咕的歌单页地址里那串数字),再对那条源点"用歌曲 id 复测", 结论就从"未检出"变成真的能播或不能播。
还没读取。