PDF 钢琴简谱去色

要解决什么问题

不少钢琴谱 PDF 在黑色指法标注之外，还会用红色数字简谱（右手）和蓝色数字简谱（左手）叠在五线谱或歌词上。打印、投影或做黑白练习稿时，这些彩色层往往干扰阅读；手工在 PDF 里逐页擦除又费时且难保证一致。

本技能针对这类版式：在尽量保留黑色指法数字的前提下，批量去掉红、蓝简谱层，并输出可继续分发或打印的合并 PDF。

工作方式

流程按页处理，典型步骤如下：

1. 拆分 PDF：多页文档拆成单页文件，便于并行检查中间结果。
2. 页面转图：将每页渲染为 PNG（依赖 pdf2image 与 Poppler），为像素级颜色处理做准备。
3. 去除彩色简谱：两阶段图像算法——

- 激进删除：用宽松阈值抓取红/蓝像素（例如红色侧 R > 130、绿色侧 G < 100 等组合；蓝色侧 B 明显高于 R、G）。
- 恢复：在原图深色区域（RGB < 120）若被误涂白，则把像素还原，避免指法号被擦掉。

1. 转回 PDF 并合并：处理后的图片逐页成 PDF，再合并为 {原文件名}_黑白版本.pdf 或你指定的输出名。

中间目录通常包括 pdf-pages/、pdf-images/、pdf-processed-images/、pdf-processed-pdfs/，便于对照某一页是否去色过度或残留彩字。

适用边界与注意点

• 算法针对红/蓝数字简谱 + 黑色指法这类配色优化；若谱面用其它颜色编码或彩字与指法在色相上接近，可能需要调阈值或人工复核。
• 大体积 PDF 会多花几分钟，且会保留中间文件——适合需要可追溯、可抽检的批处理，而不是「只留最终文件」的极简流水线。
• 本流程是去色与清理版面，不会识别音符语义，也不会自动排版或 OCR 歌词。