电子乐谱阅读器 CG Suite / Lyra

本指南将系统介绍兼顾高对比度舞台视认性、超低能耗、稳定翻页、手写批注以及内置悬浮声学工具的专业 PDF 电子乐谱功能。

适用范围

电子乐谱库与全屏阅读器在 Classical Guitar Suite (CG Suite)（menu_book 乐谱标签页）与 Lyra Score（主界面）中通用。在开启 Google Drive 云端同步（Lyra_Scores 文件夹）后，乐谱原件、手写批注、书签及节目单可在这两款应用间双向互通。

Pulsar Tuner 说明

Pulsar Tuner 专注于调音与练习，未搭载乐谱库及 PDF 阅读器。如需浏览和管理电子乐谱，请使用 Lyra Score 或 Classical Guitar Suite (CG Suite)。

Web 网页版（PWA）主要限制说明

受限于浏览器安全沙箱及本地存储隔离机制，Web 网页版（PWA）的电子乐谱功能存在以下限制：

• 无法将乐谱保存至本地（必须关联 Google Drive / 仅支持云端加载）： 浏览器环境无法将 PDF 乐谱文件持久化保存至本地磁盘，亦不支持离线缓存。因此，在 Web 版中使用乐谱功能必须连接 Google Drive。乐谱始终从 Google Drive 实时下载加载，无法在无网络离线环境（如飞行模式的演出舞台或地下录音室）中打开。同时，固定离线保留及缓存容量管理等功能在 Web 版中不可用。
• 不支持在乐谱上手写批注或编辑： 钢笔、荧光笔、橡皮擦、文字输入、指法印章等绘图功能为移动端原生应用（iOS / Android）独占功能。Web 版仅提供纯阅读模式（可正常查看在其他设备上提前绘制的已有批注，但无法在 Web 版上新增或修改）。
• 不支持 IMSLP 内嵌浏览器直接抓取导入： 内嵌 WebView 浏览器的自动解析导入功能在 Web 端不可用。请在外部浏览器中下载 PDF 乐谱后，通过常规的文件或文件夹选择方式导入。
• 不支持通过系统“分享”直接接收乐谱： 通过操作系统共享面板直接发送 PDF 文件的功能仅支持移动原生应用。
• 不支持硬件级自动变暗（省电暗度调节）： 由于浏览器无权调用操作系统的屏幕亮度硬件控制 API，硬件级自动屏幕变暗功能已禁用。

如需在正式演出舞台上获得 100% 稳定的离线体验，或在日常练琴时进行精细的手写指法批注，强烈建议使用 iOS、Android 或 Windows 原生客户端。

乐谱库主界面与顶部工具栏图标

乐谱库（主界面）的顶部工具栏集中了快速整理、云端同步、添加乐谱及本地存储管理的核心入口。

图标	功能名称	支持平台	主要用途
create_new_folder	从文件夹批量导入	PC / Web / Mac / Windows	一键深度扫描指定文件夹下的所有 PDF 乐谱并智能提取元数据
storage	存储与缓存管理	iOS / Android / Windows（Web/PWA 版隐藏）	查看本地离线缓存占用、设定存储上限与留存天数、一键清理临时文件
cloud_done / cloud_queue	Google Drive 云端同步	全平台（Web 版必须连接）	执行即时双向云端同步（未连接时启动引导向导）
tune	显示与排序设置	全平台	排序方式、最近使用显示、垂直/水平翻页、留白裁切、横屏多页排版、标签管理
add	添加乐谱	全平台	从本地设备选取 PDF 或通过内置 IMSLP 检索下载公版古典吉他谱
more_vert	更多菜单	全平台	查阅官方使用指南（Web 网页手册）或进入个人中心

点击存储图标（storage）（原生应用独占）

受浏览器安全沙箱限制，Web 网页版（PWA）不支持本地缓存持久化。该图标仅在 iOS、Android 和 Windows 原生应用中显示。

点击将弹出 “存储与缓存管理” 面板，可执行以下设置与监控：

1. 云端同步状态与账号：
   • 快速开启或关闭 Google Drive 同步开关（cloud_done / cloud_off）。
   • 查看当前绑定的 Google 账号邮箱，并可直达同步高级配置。
2. 本地存储细分用量（单机专属）：
   • 直观显示当前设备已缓存乐谱的总容量（MB/GB）。
   • 固定保留乐谱（push_pin）：固定至离线收藏、受到绝对保护免遭清理的乐谱数量与占用。
   • 临时缓存乐谱（arrow_circle_down）：近期阅读时自动按需加载并临时暂存的文件数量与占用。
3. 缓存上限容量设定（单机专属）：
   • 可在 500 MB / 1 GB（默认） / 2 GB / 5 GB / 无限制 之间自由切换。
   • 达到上限时，系统将遵循 LRU 机制按时间先后安全释放未固定的临时缓存，绝不挤占设备空间。
4. 缓存保留期限（TTL）：
   • 可设定为 7 天 / 30 天（默认） / 90 天 / 180 天 / 永不过期。
   • 超过设定天数未被打开的临时乐谱将在后台静默自动清理。
5. 一键清空全部临时缓存：
   • 在完整保留重要固定乐谱及手写笔迹的前提下，立即释放所有临时缓存，快速腾出存储空间。

点击云端图标（cloud_done / cloud_queue）

图标外观及响应行为根据与 Google Drive 的连接状态动态切换：

• 未连接状态（cloud_queue 空心线框图标）：
  • 点击将启动云端同步设置向导。
  • 引导您登录 Google 账号并在网盘中自动创建 Lyra_Scores 专属同步文件夹，实现跨平台无缝协同。
• 已连接状态（cloud_done 实体蓝色对勾图标）：
  • 点击立即触发即时双向云端同步。
  • 毫秒级差分比对本地与云端，双向上传/下载最新收录的乐谱原件、手写批注、书签及节目单。
  • 同步完毕后自动弹出同步报告，明确告知已更新、新增或下载的曲目详情。

点击设置图标（tune）

打开 “显示设置” 面板，集中管理乐谱库列表与阅读器的默认行为：

1. 排序规则：
   • 支持在 曲名排序（sort_by_alpha 拼音/字母顺序） 与 作曲家排序（person） 间一键切换。右侧快速索引栏（A–Z）实时随之联动。
2. “最近使用”轮播区：
   • 控制乐谱库顶部“最近打开的乐谱”横向轮播模块的显隐开关，并可自定义显示数量（1～10 首）。
3. 阅读器滚动方向：
   • 垂直滚动（swap_vert）：上下平滑连贯翻滚的现代阅读体验。
   • 水平翻页（swap_horiz）：模拟传统纸质乐谱左右翻篇的经典模式。
4. 垂直裁切页面留白（0% ～ 25%）：
   • 在纵向连续滚动模式下生效，通过滑块可精准裁切掉 PDF 上下 0% 至 25% 的多余空白天头地脚，令五线谱音轨紧凑贴合。
5. 横屏多页排版布局：
   • 自定义在平板电脑或桌面横屏显示下的页面拼版方式：
     • 单页视图（crop_portrait）：单页放大撑满可视宽度。
     • 跨页双联（auto_stories）：左右并列展开双页，犹如真实实体乐谱。
     • 四页平铺网格（grid_view）：同屏呈现四页，方便鸟瞰全曲宏观结构。
6. 标签管理入口（label_outline）：
   • 点击可直接呼出标签管理面板，进行分类创建与调色。

点击添加乐谱图标（add）

呼出底部操作菜单，选取乐谱录入源：

1. upload_file 从设备中选取：
   • 调起操作系统原生文件选择器，单份或批量选取手机、平板或电脑中的 PDF 乐谱。
   • 文件名若遵循 作曲家 - 曲名.pdf 格式，系统将自动拆解并预填曲目元数据。
2. public 在 IMSLP 中检索（原生应用独占）：
   • 唤起内置 IMSLP 浏览器，直接在庞大的公版乐谱库中检索古典吉他大师经典与练习曲，下载时全自动解析曲名与作曲家并存入乐谱库（Web 与 Windows 版提供外部浏览器指引）。

---

搜索、标签与快捷筛选

面对庞大的曲库收藏，通过实时搜索栏、编制筛选芯片、多彩自定义标签与侧边拼音/字母索引栏，让目标曲目触手可及。

实时智能搜索栏（search）

在乐谱库顶部的搜索输入框中输入关键字即可瞬间过滤：

• 多维度联合匹配：同步检索“曲名（标题）”、“作曲家”、“改编者”以及“已绑定的标签名称”。
• 一键清空（clear）：轻触右侧清空按钮立刻恢复完整的全量曲目清单。

标签与编制筛选芯片

紧挨搜索栏下方陈列着一行可横向滑动的胶囊芯片栏：

• library_music 全部：重置当前所有过滤条件，恢复全景视图。
• 标准编制标签：轻按即可快速按吉他编制分流：独奏（person）、二重奏（group）、三重奏、四重奏、合奏、协奏曲或其他。
• 自定义分类标签：由用户亲手设立的业务标签（如“巴洛克”、“练琴中”、“2026独奏会”、“心水珍藏”等）均会化作互动芯片，点选即可精准隔离特定保留曲目。
• 彩色徽章映射：每张乐谱卡片上亦会常驻醒目的专属颜色小徽章，一目了然。

标签管理与专属调色板

点击芯片栏最右侧的“管理”（settings_outlined）或在设置菜单（tune）中进入“标签管理”：

1. 新建个性标签：依练习与演出习惯键入任意分类名称。
2. 挑选标识色彩：从专属调色盘中挑选红、蓝、绿、琥珀、紫罗兰等辨识度高的主题色。
3. 为乐谱关联标签：在卡片菜单的“编辑”（edit）弹窗中勾选多枚标签进行组合归类。
4. 重命名与移除：随时对曲库范围内的废弃标签实施全局修改或删除。

拼音/字母索引导航栏（A–Z）

当处于未执行搜索过滤的常态列表时，屏幕最右缘常驻纵向索引条：

• 轻触或手指沿条目上下划动，列表即刻精准锚定跳转至对应首字母的乐谱区间。
• 自动跟随当前的排序偏好生效（若按作曲家排序则定位作者首字母，若按曲名排序则定位曲目首字母）。

---

乐谱导入与文件夹批量扫描

在乐谱库界面中，可通过多种灵活途径添入 PDF 乐谱。系统内置基于 SHA-256 哈希校验的防重机制，自动跳过重复文件。

1. 选择 PDF 文件（单选 / 批量多选）：点击添加按钮（add），单曲或批量选择设备内的 PDF 文件导入。
2. 系统“分享”直接接收：在系统浏览器、网盘或邮件客户端中直接将 PDF 分享至本应用。
3. 文件夹批量导入（拥有大量乐谱用户的首选）：
   • 对于在电脑中拥有大量乐谱分类的用户，推荐在电脑浏览器上打开 Web 网页版（PWA 版） 或 Windows 客户端，使用 “从文件夹批量导入” 功能。
   • 系统将深度扫描目标文件夹下的所有 PDF，一键完成乐谱注册并批量自动同步至 Google Drive（注：在 Web 版中导入的乐谱不保存在浏览器本地，将直接上传至 Google Drive）。

乐谱标题与作曲家智能提取机制

在导入文件或文件夹时，系统会自动解析规范的命名结构，自动填充 曲名（标题） 与 作曲家 ：

• 基于文件名的提取（作曲家 - 曲名.pdf 格式）：
  • 文件名中带有空格连字符（-、–、—）时，前半段将被提取为作曲家，后半段提取为标题（下划线 _ 自动转为空格）。
  • 示例：Villa-Lobos - Etude No.1.pdf → 作曲家：Villa-Lobos ／ 标题：Etude No.1
  • 若无连字符（如 Lagrima.pdf），则去除后缀后的文件名直接作为标题。
• 基于分类子文件夹补全：
  • 若电脑中的乐谱按照作曲家分目录存放（如 Bach/Prelude_BWV998.pdf），且文件名未写明作曲家时，父目录名称（Bach）将自动填入“作曲家”栏。

---

乐谱元数据管理与编辑规范

导入曲库的乐谱支持绑定详尽的元数据信息，涵盖曲名、作曲家、改编者（编曲）、演奏编制、个性化标签以及备忘录笔记。除了导入时的文件名智能提取外，您可随时对各项信息进行补充与修正。

元数据编辑途径（3 处快捷入口）

依据具体场景，可通过以下 3 种途径呼出“编辑乐谱信息”弹窗：

1. 导入乐谱时（新建注册）：
   • 从设备选取文件、通过系统“分享”接收或自 IMSLP 检索下载完成时，编辑弹窗将自动弹出。可在正式存入曲库前核对并微调解析出的曲名、作者及编制。
2. 在乐谱库列表中（卡片菜单）：
   • 点击乐谱卡片右侧的更多操作图标（more_vert），选择 “编辑（edit）”。
3. 在乐谱阅读器中（日常练琴或排练时）：
   • 全屏阅读乐谱时轻触屏幕中央唤出 HUD 顶部控制条，点击右上角菜单（more_vert）并选择 “编辑乐谱信息（edit_note）”。无需中断演奏退出阅读界面，即可就地修改指法备忘、标签或署名。

可编辑元数据字段一览

字段	必填	作用与录入建议
曲名（标题）	是	乐谱的正式名称。在乐谱卡片、曲库列表与全屏顶栏醒目呈现。
拼音 / 排序检索键	选填	拼音或音序索引助记词（如 Aranjuez 或 Alhambra）。用于曲名 A–Z 字母排序及右侧索引导航条的定位。
作曲家（Composers）	选填	作曲家姓名与拼音排序键。支持多人共同署名（共创/联合创作）。以可单独移除的芯片（Chip）形式呈现。
改编者 / 编曲（Arrangers）	选填	古典吉他独奏与重奏的核心信息。与作曲家相同，全面支持多人登记与专属排序键。
编制类型（Instrumentation）	选填	划分为：独奏（Solo）、二重奏（Duo）、三重奏（Trio）、四重奏（Quartet）、合奏（Ensemble）、协奏曲（Concerto） 或 其他（Other）。
标签（Tags）	选填	自由分类标记（如巴洛克、音乐会、练习中、降D调弦）。支持从既有标签中一键点选添加。
备忘录（Memo）	选填	多行自由文本栏，用于记录版本出处、指法注意事项、演奏速度目标或登台演艺日志。
固定乐谱（常驻离线缓存）	选填	开启后免受本地存储策略的自动淘汰，确保登台无网络时 100% 离线秒开（iOS / Android / Windows 原生客户端）。
替换 PDF 源文件	选填	通过顶部的“替换 PDF”按钮，可在完整保留既有元数据、手写标注涂鸦及书签的前提下，将底层文件替换为更高清的扫描版或新版谱面。

作曲家与改编者的多人登记与历史下拉快捷选取

吉他曲目常存在改编、民歌采风整理或多位大师联合编曲的情形。

• 基于芯片（Chip）的多人登记：
  • 在输入框中键入姓名后点击 添加（add），或直接用逗号（, 或 ，）分隔多个姓名批量录入。每位作者将生成独立小徽章，轻触“×”即可随时移除。
• 历史已录入人物下拉点选（大幅减少重复键入）：
  • 凡是在曲库中登记过的作曲家与改编者，均会自动收入历史下拉清单中（点击输入栏右侧的下拉图标 arrow_drop_down_circle_outlined 展开）。
  • 点选目标作者即可秒级带入姓名与预存的拼音排序码，杜绝大小写或拼写分歧（如“F. Tarrega”与“Francisco Tárrega”），构建规范严谨的个人藏谱库。

元数据在系统中的应用与映射场景

录入与更新的元数据将在整套应用体系中发挥联动效应：

1. 乐谱库卡片列表：
   • 标题主显，副标题自动格式化呈现为优雅规范的 作曲家 (编: 改编者) 署名样式，并带有编制与标签徽章。
2. 排列排序与 A–Z 拼音/字母侧边索引栏：
   • 在显示设置（tune）中切换“按曲名”或“按作曲家”排序时，精确按拼音排序键排列；划动屏幕右侧垂直字母条即可毫秒级跳转到对应声母或字母区间。
3. 全局毫秒级动态检索（search）：
   • 搜索词将同时深度比对标题、所有关联的作曲家、改编者、标签与备忘录正文，即输即显。
4. 编制分类与标签筛选芯片栏：
   • 编制与标签同顶部横向芯片条实时联动，点选对应编制或标签即刻过滤目标乐谱。
5. 全屏乐谱阅读器（HUD 顶部状态条）：
   • 顶部控制条实时呈现当前作品名称与作曲/改编信息，方便排练时即时确认。
6. 合成本地标注的 PDF 导出与打印（print）：
   • 导出带有手写指法涂鸦的 PDF 时，曲名与创作者信息将自动写入 PDF 文件标准文档属性中。
7. 演出曲目单（Setlist）管理：
   • 编排音乐会曲目单时，乐谱的原生信息直接继承至节目表，形成条理明晰的演出时序。
8. 跨设备云端实时同步：
   • 所有元数据均经由 Firestore 与 Google Drive 管道毫秒级同步，手机端修改，平板与 PC 端即刻生效。

---

Google Drive 云端同步规范与注意事项

在向导中开启 Google Drive 关联 后，导入的 PDF 乐谱与手写图层将自动备份至您的个人网盘（默认路径：Lyra_Scores 文件夹），在 iOS、Android、Web (PWA) 与 Windows 间保持同步。为常弹曲目添加固定（置顶）标记，可防止本地离线缓存被系统自动清理（注：离线缓存与固定保留为 iOS / Android / Windows 原生应用专属功能；Web 版始终直接从 Google Drive 实时拉取）。

切勿直接向 Google Drive 的 Lyra_Scores/ 文件夹手动粘贴文件

为保护用户云盘其他个人隐私文件的绝对安全，本应用严格遵循权限最小化原则（仅申请 drive.file 权限）。在此受限机制下，应用仅有权读取和处理“由应用自身创建或上传的文件”。

若您通过 Google Drive 网页端或桌面网盘同步盘直接向 Lyra_Scores/ 文件夹手动拖入 PDF，应用将无法识别亦无法将其读入乐谱库。

💡 大批量乐谱上传建议： 在电脑浏览器中访问 Web 版（PWA 版） 并登录账户，点击应用内的 “从文件夹批量导入”。通过此合规通道上传的文件将自动安全同步到所有移动设备。

图：乐谱库主视图（编制筛选、字母快速索引栏与演出节目单）

---

IMSLP（国际乐谱库项目）直连导入

可在应用内直接检索并导入处于公有领域的经典古典乐谱。

1. 在添加菜单中选择 从 IMSLP 查找，并阅读签署版权遵守声明。
2. 在内置浏览器中检索曲目或作曲家，点选对应版本进入 PDF 下载流（正常通过倒计时免责页）。
3. 捕获到 PDF 数据流后，系统自动校验并弹出注册窗口，曲名与作曲家均已预先填好。

图：IMSLP 乐谱自动捕获与元数据提取

---

全屏阅读、手势翻页与蓝牙踏板联动

轻触乐谱即可进入全屏乐谱阅读器。为保持演练专注，开启 3 秒后上下导航栏（HUD）将自动淡出。

触控手势与 80% 步进滚动

• 轻触屏幕中央：呼出或隐藏顶部工具栏与底部翻页滑块。
• 轻触屏幕右侧 / 左侧边缘：翻至下一页 / 上一页。
• 宽度自适应与 80% 步进翻页：在小尺寸平板或手机横屏时放大五线谱。垂直翻页时每次步进屏幕高度的 80%，并在顶部保留上一视野下端 20% 的内容，伴随一抹短暂的青色引导虚线（600ms），确保视线换行不中断。

顶部工具栏（HUD）常用按钮

• arrow_back 返回：返回乐谱库（未同步的笔迹与阅读位置就地保存）。
• bookmark_border / bookmark 书签：乐章快速标记与跳转。
• brightness_6 / brightness_2 一键变暗：点击开闭，长按可选 Eco 节能 / Stage 舞台琥珀暖光 / Night 极夜 预设。
• crop 白边裁剪：去除 PDF 周围无用白边，压缩垂直间距。
• playlist_play 演奏顺序模式：基于切分标记（CutPoint）按反复、D.C. 实际顺序翻页。
• edit 手写批注模式 ／ content_cut 切分点编辑 ／ print 导出带批注 PDF

底部控制栏（滚动方向、单屏显示页数与声学小工具）

屏幕底部常驻半透明控制栏，便于在演奏或练习过程中快速切换翻页方式、滚动方向、多页并排布局及开启一体化声学小工具。

图标 / 标识	功能名称	主要作用
chevron_left / chevron_right	上一页 / 下一页	点击精准向前或向后翻动一页。
当前 / 总页数	页码徽章	显示当前页码与总页数。轻触可弹出“页面跳转弹窗”，直接输入页码即可瞬间直达。
swap_vert / swap_horiz	切换滚动方向	一键在垂直连续滚动与水平翻页模式之间无缝切换。
fit_screen / photo_size_select_actual_outlined	垂直视图切换	垂直滚动模式下显示。在 宽度自适应（横向撑满五线谱放大，联动 80% 步进翻页） 与 高度自适应（全页完整收纳于屏幕内） 之间切换。
crop_portrait / auto_stories / grid_view	横屏显示页数切换	水平翻页模式下显示。依次循环切换：单页（放大阅读） → 跨页双页（如纸质书左右并排） → 4页网格（鸟瞰整曲结构）。
tune / tune_outlined	声学小工具切换菜单	点击展开快捷菜单，一键唤出悬浮于乐谱之上的 小调音器、小节拍器、小录音机 或 小练习分析器（详情见后文）。当有小工具在运行时，图标将高亮显示。

• 页面滑动跳转栏（Scrubber 进度条）： 在呼出 HUD 菜单时，底部（垂直滚动时为屏幕右侧）将显示带有书签标记的滑动进度条。用手指拖动即可快速在长篇乐章间穿梭定位。

蓝牙翻页脚踏板兼容

支持标准 HID 键盘协议（发送 PageDown / PageUp、方向键、空格键等）的市售蓝牙脚踏板，无需繁琐设置即连即用。在自动变暗（防烧屏）生效期间，踏板第一脚仅唤醒高亮屏幕而不翻页，防止误翻。

---

手写批注、双层分离与切分点（CutPoint）

Web 版限制说明

手写批注与绘图工具（钢笔、荧光笔、橡皮擦、文字、音乐印章）为 iOS 与 Android 原生应用专属功能。在 Web 网页版（PWA）中不显示绘图工具栏，仅作为纯阅读器运行（支持查看其他设备上已绘制的批注）。

点击 edit 即可展开手写批注工具栏：

• pan_tool 阅读模式 ／ edit 钢笔 ／ border_color 荧光笔 ／ auto_fix_normal 橡皮擦
• title 文字工具 ／ stars 音乐与指法印章（p / i / m / a 指法、大横按标记、强弱记号等）
• undo 撤销 ／ redo 重做 ／ delete_sweep 整页清空
• 防误触与练习/演出分层：支持手写笔/手指触控切换，并可将日常细节练习笔记保留在“练习图层”，而在舞台上仅显示清晰纯净的“演出图层”。
• content_cut 切分点与节目单：在乐段间设置跳转切分点以编排曲目循环，或利用节目单功能按演出曲目连续翻阅。

图：手写批注工具栏与乐谱上的超薄悬浮声学小工具（胶囊条）

---

乐谱内置悬浮声学小工具

无需退出乐谱即可随时调音、对拍或试录，以 极薄毛玻璃悬浮胶囊栏（250×38px） 常驻于乐谱之上。轻点中央可展开详细弹窗，点击 tune 可打开设置。

• music_note 小调音器：显示音名、横向指针条（±3 音分合焦绿光）与音分数值。
• speed 小节拍器：播放/暂停、拍号指示、摇摆圆点与实时 BPM（支持敲击测速）。
• mic 小录音机：录音指示灯、电平表与秒数，方便随手检查乐句。
• track_changes 小练习分析器 CG Suite 专用：显示指法徽章（ami / im 等）与实时颗粒度（Evenness %）。

Lyra Score 与 Classical Guitar Suite 的小工具差异

在 Lyra Score 中，悬浮小工具按以下通用规范运行：

• 小调音器：运行于适合各种乐器的 宽频半音阶模式（40Hz–2100Hz）。
• 小录音机：采用通用手动的 [录音] → [停止] → 自动循环播放 模式（manualWithLoop）。
• 小练习分析器：为古典吉他右手专享，仅在 Classical Guitar Suite (CG Suite) 中提供。