Agent Skills
返回列表
音乐 Web 壁纸构建

音乐 Web 壁纸构建

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_98943edd/create-music-web-wallpaper。

技能介绍

要解决什么问题

Wallpaper Engine 的 Web 壁纸 跑在 CEF 里,和普通 Chrome 页不一样:音频、属性回调、可视化、多分辨率都要在引擎里实测。自己做「专辑播放器 + LRC + 曲库」时,还容易踩坑——素材路径散乱、歌词双语时间轴误修、署名藏在仓库里、没验就收工。

这个技能把流程收成可对话的分阶段交付:先对齐曲名、艺人、素材路径、歌词格式和性能偏好,再选 Web 架构,而不是硬推 Scene 转换。

技能如何工作

  • 按需读 reference:改项目前看 wallpaper-engine-web.md;收封面/音频/歌词时看 catalog-and-assets.md;动 LRC 前看 lyrics.md;第三方素材与发布前看 credits-and-rights.md;交付前看 acceptance.md。
  • 素材清点与曲库:对用户提供的文件跑 inventory,核对重复哈希、音轨与 LRC 配对、编码与时间戳;用稳定相对路径建 catalog(曲 ID、音频/歌词路径、封面、配色、权利信息),选中文件复制进项目,不引用订阅者访问不到的本地目录。
  • 歌词策略保守:默认标准 LRC——解析时间戳、排序、按点显示;不默认做双语时间轴重对齐,只在格式明确多语、播放实测错位且用户同意时才做可逆修正。
  • 先打通一条闭环再抛光:单封面、单曲目能出声,播放/暂停/seek/音量、歌词跟唱、列表与 About/Credits 可见;再按需加封面动效、模糊底、可视化、拖拽面板、多语言等(用户点选才做)。
  • 状态与交互有明规则:例如换专辑筛选不打断当前播放;shuffle 单轮不重复;主题/音量/低占用模式等持久化;低占用只关昂贵效果。
  • 署名与校验:界面内必须有可访问的素材来源视图;区分壁纸作者、灵感来源(如确属 OriginalCube 布局时注明)、工具署名;跑 validator 并在 Wallpaper Engine 实机验证,不以普通浏览器为准。

适用边界

粉丝向、非官方作品须如实标注;不得替用户静默换图、不得从无授权源抓音频/歌词。空项目可用 assets/starter/ 脚手架(Apache-2.0),发布前替换占位并保留 LICENSE/NOTICE。无 Python 时找可用运行时,勿手搓整套脚手架。

使用场景

  • 已有一批 FLAC/封面/LRC,要在 WE 里做可切歌、可 seek 的专辑播放器壁纸
  • 双语 LRC 时间轴对不齐,需要先用播放实测再决定是否做可逆修正
  • 准备上架 Workshop 前,要补齐界面内 Credits 并跑 validator + 引擎实机验收
  • 曲库文件夹命名混乱,需要先 inventory 再建稳定 catalog 并复制进项目目录

适合人员

  • 熟悉 Wallpaper Engine 的创作者,想把自有曲库做成可发布的 Web 音乐壁纸
  • 会写 HTML/CSS/JS 的前端,需要按 WE 约束拆分播放、歌词、可视化与属性桥
  • 改版或 fork 过社区专辑壁纸,需要规范素材清点、署名与不误伤普通 LRC 的流程
  • 担心 CEF 与浏览器表现不一致,坚持在引擎内验证音频与交互后再交付的制作者