专为音乐人、敬拜团队和乐队设计的自托管网页歌谱应用。支持 ChordPro 格式，提供实时移调、歌单管理和舞台优化界面。 ## ✨ 核心功能 - **实时移调** — 一键升降调，和弦自动对齐歌词，支持复杂和弦（如 `D/F#`、`C2(no3)`） - **歌单管理** — 创建演出歌单，添加已移调的歌曲，持久化保存 - **响应式界面** — 桌面双栏 / 平板顶部菜单 / 手机单栏，舞台使用完美适配 - **字体缩放** — A- / A+ 实时调整字号，长歌一屏显示 - **PDF 导出** — 一键生成干净的双栏歌谱 PDF ## 📖 使用方法 ### 1. 添加歌曲 将 `.cho`（ChordPro）格式的歌曲文件放入数据目录/songs 即可自动识别。 **ChordPro 格式示例：** ``` {title: Amazing Grace} {artist: John Newton} {key: G} {tempo: 72} {time: 3/4} {start_of_verse: Verse 1} A[G]mazing [G7]grace how [C]sweet the [G]sound That [G]saved a [Em]wretch like [D]me {end_of_verse} {start_of_chorus: Chorus} [G]I once was [G7]lost but [C]now am [G]found Was [G]blind but [Em]now [D]I [G]see {end_of_chorus} ``` **支持的 ChordPro 指令：** | 指令 | 说明 | | --------------------------------------------- | ------------------ | | `{title: 歌名}` 或 `{t: 歌名}` | 歌曲标题 | | `{artist: 艺人}` | 艺术家/作者 | | `{key: G}` | 原调 | | `{tempo: 120}` | BPM | | `{time: 4/4}` | 拍号 | | `{start_of_verse: 名称}` / `{end_of_verse}` | 主歌段落 | | `{start_of_chorus: 名称}` / `{end_of_chorus}` | 副歌段落 | | `[Am]歌词` | 在歌词上方标注和弦 | ### 2. 移调 打开歌曲后，点击右上角的 **TRANSPOSE** 区域的 **`-`** / **`+`** 按钮即可升降半音。移调后和弦会自动重新对齐歌词位置。 ### 3. 管理歌单 1. 点击侧边栏 **SETLISTS (SHARED)** 旁的 **`+`** 按钮创建新歌单 2. 打开歌曲后，点击右上角 **「Add to Setlist」** 将当前歌曲（含移调信息）添加到歌单 3. 歌单数据自动持久化，重启不丢失 ### 4. 字体缩放 点击右上角的 **A-** / **A+** 按钮调整歌词和和弦的字号大小，适合不同屏幕距离和视力需求。 ### 5. PDF 导出 点击右上角的 **🖨 PDF** 按钮，生成干净的双栏歌谱 PDF，去除所有 UI 元素，适合打印。