👑 管理员发布速查手册

Cloudflare R2 单曲目录与资源发布规范

规范化管理 R2 存储桶中的音乐资源，实现曲目、封面、歌词、MV 与时间轴画卷的自动识别与极速发布。

📂 一、单曲标准目录树状图 (一歌一目录)

在 Cloudflare R2 存储桶 liuyun-media 中，所有单曲均以分类为一级目录，以 歌曲名-作者名 为独立子目录：

现代诗/ # 一级分类目录 (现代诗 / 中文歌曲 / 诗词歌曲 / 日语歌曲 / 英文歌曲 / 翻唱歌曲 / BGM纯音乐) └── 一剪梅-红藕香残玉簟秋-李清照/ # 二级单曲目录：[歌曲名-作者名] 或 [歌曲名] ├── audio.mp3 # ★ 音频主文件 (MP3 格式) ├── cover.jpg # ★ 默认高清封面图片 (JPG/PNG) ├── lyrics.srt # ☆ 同步滚动歌词/字幕文件 (SRT 或 LRC 格式) ├── video.mp4 # ☆ MV / 动态背景视频 (MP4 格式) ├── info.txt # ☆ 歌曲背景介绍、词作赏析与心语故事 (UTF-8 纯文本) ├── 00-00-00.jpg # 🎬 时间轴画卷: 0分00秒起始淡入帧 ├── 00-00-12.jpg # 🎬 时间轴画卷: 0分12秒自动转场插画 ├── 00-00-28.jpg # 🎬 时间轴画卷: 0分28秒自动转场插画 └── 00-00-45.jpg # 🎬 时间轴画卷: 0分45秒自动转场插画 (支持多张)

📋 二、文件命名与格式规范清单

文件名称	要求等级	推荐格式	作用说明与特效呈现
audio.mp3	必选	MP3 (320kbps)	曲目音频主文件，播放器音源输入。
cover.jpg	必选	JPG / PNG (1:1 高清)	曲库列表封面、播放器默认唱片与全屏高斯模糊背景。
lyrics.srt	可选	SRT / LRC (UTF-8)	同步逐句滚动字幕，支持水墨晕染/落樱漫舞等 4 种动效切换。
video.mp4	可选	MP4 (H.264 编码)	MV 视频。上传后，播放界面右上角会自动点亮 [MV] 切换胶囊！
info.txt	可选	TXT (UTF-8)	歌曲心语与诗词赏析。可在前台登录管理员后直接在线编辑并一键保存到 R2。
HH-MM-SS.jpg	可选	JPG / PNG (16:9 或 1:1)	时间轴动态画卷：以时间命名（如 `00-00-15.jpg` 表示第 15 秒转场）。音频播放至该时刻自动呈现电影级淡入淡出与呼吸推镜！

🎬 三、时间轴画卷插画命名规则

当歌曲有多张场景配图想随音乐时间自动切换时，支持以下 3 种命名规则（任选一种即可）：

① 标准格式（推荐）：00-00-00.jpg（0秒）、00-00-15.jpg（15秒）、00-01-30.jpg（1分30秒）

② 分秒格式：00-00.jpg、00-25.jpg、02-10.jpg

③ 纯秒数格式：0.jpg、30.jpg、75.jpg

🚀 四、极速发布新歌曲流程

本地整理单曲包

新建文件夹 歌曲名-作者名，放入 audio.mp3、cover.jpg，可选放入 video.mp4 与 lyrics.srt。

上传至 Cloudflare R2

打开 Cloudflare 控制台 -> R2 -> 存储桶 liuyun-media，进入对应分类目录（如 中文歌曲/），直接将单曲文件夹拖拽上传。

刷新页面即刻上线

打开 CookieTune 网页，曲库列表中立刻出现新歌；点击进入播放器可一键在线补充编辑 info.txt 故事！