音符跳跃·钢琴曲谱3D视频

概述

一条命令从曲谱生成全部素材（谱面、符头坐标、演奏时间、镜头、钢琴音轨），再渲染成视频。你不需要写任何代码，也不要改 src/ 里的动画代码。 只做三件事：准备曲谱 → 运行命令 → 检查报告。

需要：Node.js 18 以上（WorkBuddy 自带的就行）、本机装有 Chrome 或 Edge。不需要 ffmpeg、MuseScore、Python。

第 1 步：建项目（每台电脑只做一次）

node <本技能目录>/scripts/create.mjs <工作目录>/dancing-notes-project

它会复制模板并装依赖（约 250 MB，走国内镜像）。已经建过就直接复用，不要重复建。之后所有命令都在这个项目目录里运行。

第 2 步：准备曲谱（按顺序选第一个能用的）

1. 曲库里有：曲库/ 下有 小星星、欢乐颂、两只老虎、生日快乐、巴赫C大调前奏曲，直接用。
2. 用户给了文件：.musicxml / .xml / .mxl / .mei 直接用；用户给的简谱图片或文字，照着抄成 .jianpu.txt。
3. 只给了曲名：
   • 简单的儿歌、民歌、古典名曲旋律：先上网搜这首歌的简谱，照抄成 曲谱/<曲名>.jianpu.txt，格式见 [简谱格式](references/简谱格式.md)。左手可以按和弦写简单伴奏（每小节一个和弦：[1 5] - [1 5] -）。
   • 复杂钢琴曲：搜 MusicXML/MXL 下载，见 [找曲谱](references/找曲谱.md)。
   • 流行歌曲有版权：提醒用户，公开发布前要确认授权。

不确定的旋律不要凭记忆硬编。写完数一遍每小节的拍数。

第 3 步：生成素材

node scripts/build.mjs 曲谱/小星星.jianpu.txt

可选参数：--title 标题、--subtitle 副标题、--composer 作曲（简谱文件里写了就不用加）、--seconds 60（只做前 60 秒）、--tempo 0.9（整体放慢到 90%）、--audio 自己的音轨.wav（不用内置钢琴音，必须和谱面速度完全一致）。

看最后打印的报告：

• unmatched 必须是 0（不是 0 时脚本会直接报错退出）。
• attacks 是总起音数；upper / lower 是右手 / 左手的音数，跟曲谱大致对得上。
• musicDuration 是成片秒数。

报错时：读报错里写的小节号和原因，改曲谱文件再运行。最常见的是某小节拍数不对。同一个错误改两次还不对，就把报错原文告诉用户。

第 4 步：先出小样，再出成片

node scripts/render.mjs --preview            # 横屏前 8 秒小样，output/preview.mp4
node scripts/render.mjs --preview --vertical # 竖屏小样
node scripts/render.mjs                      # 横屏 1920×1080 成片，output/music-score.mp4
node scripts/render.mjs --vertical output/竖屏.mp4  # 竖屏 1080×1920（视频号/抖音/小红书）

用户没说横竖屏时：发视频号/抖音/小红书用竖屏，发 B 站/YouTube 用横屏。先给用户看小样，确认后再出成片。1 分钟成片在普通电脑上约 2–4 分钟。

交付时告诉用户

• 成片路径、时长、横屏还是竖屏。
• 报告里的音符数和 unmatched: 0。
• 音轨是内置合成钢琴音（声音和小球用同一份时间数据，不会错位）。
• 谱子来源（曲库 / 用户提供 / 从哪个网站下载 / 照哪份简谱抄的）。

出问题时

见 [排错](references/排错.md)。不要为了跑通去删音符、改校验脚本或改 src/ 里的代码。

致谢与许可

动画效果（小球、光环、轨迹、纸面彩光、景深）来自 Dancing Notes（言说新事，MIT）。本技能重写了素材流水线：自动对齐、简谱输入、内置钢琴音轨、换行飞跃、连音合并、竖屏。MIT 许可，见 LICENSE.txt。渲染用的 Remotion：个人、3 名员工以内的公司、非营利组织可免费商用，更大的公司需另购 Remotion 公司授权（以 Remotion 官方 LICENSE 为准）。

关于路路有为

本技能由路路有为（广州路路有为人工智能科技有限责任公司）出品。我们专注把 AI 接进真实的工作和生意，每个技能发布前都经过脚本自测和实测。想按你们的流程、模板和数据定制，在 SkillHub 搜索「路路有为」进入团队主页联系我们。