静态资源说明

教材正文已经插入统一的 <ResourcePlaceholder> 组件。每个组件都声明资源类型、标题、预期路径和用途。

替换流程

1. 根据 assets.manifest.json 找到待补资源。
2. 将文件放入 docs/public/assets/chXX/。
3. 文件名、路径与组件中的 asset 属性保持一致。
4. 补充准确的替代文本、来源、授权状态与制作说明。
5. 将清单中的 status 从 placeholder 改为 ready。
6. 执行 npm run check 和 npm run docs:build。

资源类型

类型	推荐格式	主要用途
键盘图、节奏图、结构图	SVG，必要时 PNG/WebP	键位、指法、拍点、曲式与流程图
谱例与工作表	SVG/PDF	简短自编谱例、练习表与可打印材料
音频	MP3/OGG	听辨、A/B 对比、分层练习
视频	MP4/WebM	手型、弹唱协调、现场合作与完整示范

版权要求

不得上传未获授权的完整商业曲谱、完整录音、完整歌词或整段受保护旋律。优先使用自编练习、公共领域材料、已授权资源或只呈现必要教学片段。