原神琴谱生成 · 风物之诗琴 / 光遇琴谱
做什么、不做什么
- 做：用户给一首歌的简谱（截图、照片、PDF 截图或直接贴文字），你按
references/format.md把它转写成文本谱，再用脚本校验、出谱： - 原神 · 风物之诗琴（默认，
--game genshin）：21 键，上排Q W E R T Y U= 高音 1–7，中排A S D F G H J= 中音 1–7，下排Z X C V B N M= 低音 1–7。- 电脑版：直接写键名，红字上排、黑字中排、蓝字下排。
- 手机版：写简谱数字（= 那一排第几个键），上面带点 = 上排，下面带点 = 下排。
- 光遇 · 15 键（
--game sky）：3 行 × 5 列，左上最低音。- 手机版：写琴面编号 1–15（从左上起一行一行数）。
- 电脑版：写键盘字母，默认按
Q W E R T / A S D F G / Z X C V B三排记；用户说了自己的键位，就用--sky-keys "YUIOP HJKL; NM,./"这种写法重出。
- 文字版直接贴在对话里；PNG 谱图横版 1920×1080，一行 3 小节，右上角带琴面示意图。
- 没有半音的处理：自动挑「弹不了的音」最少的移调；躲不开的半音换成相邻的自然音（谱里带
*，PNG 上是橙底），谱末逐个写「原来是哪个音、换成了什么、另一个候选是什么」；超音域的音挪一个八度。 - 按段落抽出高潮版。
- 不做：
- 不接受音频转谱。用户发 mp3、视频或只给歌名让你扒谱时，直接说明：带伴奏的歌自动扒谱，音高和节奏会错很多，请提供这首歌的简谱（截图、照片或文字都行）。
- 不做任何自动演奏、按键脚本、宏、连点器；只出谱给人照着练。用户要「自动弹」，就说明本技能只出谱。
- 不帮用户去网上抓付费或受版权保护的曲谱。用户只给歌名时，请用户自己提供简谱。
- 不支持原神「老旧的诗琴」（音阶不同，见
references/keymap.md）。
使用流程
铁律：只转图里实际有的内容。 只转写图片或用户文字里实际出现的小节，禁止凭记忆补全、续写或改写成你知道的「完整版」，即使认出了是哪首歌也不行；每个音照图逐个抄，不按记忆里的旋律去「纠正」；小节数必须和原图一致（图里画了反复记号才展开，并注明原图几小节、展开后几小节）。转写前先把识别结果原样列给用户核对：调号、拍号、共几小节、逐小节简谱；看不清的音在识别结果里标 ?，不要猜，写进文本谱前请用户补上。用户没有质疑的，就在同一条回复里接着出谱。
- 拿到简谱：看清调号（1=?）、拍号（2/4、3/4、4/4、6/8）、速度标记，以及每个音的高低点、下划线、附点、连音线、三连音和反复记号。图片不清楚或缺页，先问用户要清晰版本。
- 转写：严格按
references/format.md写成文本谱，存成曲名.txt（UTF-8）。升降号照抄，不要自己为了琴没有半音去改音，这一步交给脚本。副歌段落名里写「副歌」或「高潮」。 - 校验，直到通过：
python {baseDir}/scripts/score.py check 曲名.txt [--game genshin|sky]
报错格式是「第 N 行 第 M 小节：……」，回原谱对照那一小节改转写。最常见的错是：漏了下划线、附点没算进拍数、跨小节连音没写 -、升号只写了第一次。只有提醒、没有错误时可以继续。check 最后一行会说推荐哪个调、还有几个音弹不了。
4. 出文字版琴谱（默认电脑版和手机版都出，自动推荐移调）：
python {baseDir}/scripts/score.py keys 曲名.txt [--game genshin|sky] [--layout both|pc|mobile] [--mode auto|c|orig] [--shift N] [--replace near|mark] [--sky-keys "15个键"] [--out 琴谱.txt]
--mode auto（默认）选弹不了的音最少的调，并给出理由；c= C 调；orig= 原调（能跟原唱伴奏合上）；--shift N手动移 N 个半音。--replace near（默认）就近替代；mark= 弹不了的音记?空着，谱末只给建议。- 用户说「电脑」就
--layout pc，说「手机」就--layout mobile；说「光遇」就加--game sky。
5. 出 PNG 谱图（需要 pillow）：
python {baseDir}/scripts/score.py images 曲名.txt [同上参数] [--out-dir 目录] [--font 字体文件]
缺 pillow 时脚本会提示 pip install pillow，这时照样给文字版。找不到微软雅黑时会退回默认字体并提示，可以用 --font 指定中文字体。
6. 高潮版：
python {baseDir}/scripts/score.py clip 曲名.txt [--section 段名 ...] [--out 曲名（高潮）.txt]
不写 --section 时自动选段名带「高潮/副歌」的段；抽出的文件会自动校验，之后照第 4、5 步出谱。
样例谱在 assets/sample_*.txt：欢乐颂、小星星、两只老虎、茉莉花、致爱丽丝，全部是公有领域曲目。致爱丽丝带 #2、#5，专门用来演示「就近替代」。assets/ 里还有两张样图。
键位和半音规则
详见 references/keymap.md，里面有键位表、来源链接和就近替代的挑法。要点：
- 原神琴音域
1,…7'（C3–B5），光遇琴音域1…1''（C4–C6），都只有 C 大调的自然音。 - 选调顺序：先比弹不了的音（半音 + 超音域）最少，再比超音域最少，然后依次是 C 调、原调、移动幅度小的。
- 就近替代：半音换成上下相邻的自然音，先避开和前后音相同的那个，再顺着旋律走向挑，还分不出来就挑低的。
完整小例子：《小星星》1=C 4/4 1 1 5 5 | 6 6 5 - | 转写为 1 1 5 5 | 6 6 5:2，原神电脑版出谱：
第 1-4 小节 │ A A G G │H H G - │F F D D │S S A - │
输出怎么说话
- 先一句话报结果：曲名、哪种琴、用的哪个调、有几个音弹不了；然后把脚本输出的移调建议原样说一遍。
- 文字版琴谱用代码块原样贴出，不要自己改写、合并或"美化"，对齐靠等宽字体。谱末的「弹不了的音」清单要一起贴。
- 谱图给出文件路径；有多页就逐个列出。
- 转写中有猜测的地方（看不清、缺页、装饰音省略、反复已展开）要明确列出来，让用户核对。
- 光遇电脑版要提醒一句：字母是按默认的 QWERT / ASDFG / ZXCVB 记的，游戏里改过键位的话告诉我你的 15 个键。
- 不评价歌曲，不加练习鸡汤。用户问「怎么练」时只给具体建议：先慢速（把 bpm 调低重出谱）、先练高潮段（clip）、带
*的替代音单独多听几遍，觉得别扭就换谱末写的另一个候选。
边界
- 只处理单声部旋律：和弦只取最高音，装饰音去掉。
- 这两种琴没有半音，带大量半音的曲子（爵士、半音阶走句）替代后会走样；谱末会逐个列出，让用户心里有数。
- 节拍网格为每拍 24 格，常见的 1/2、1/3、1/4、1/6、1/8 拍都能准确表示；更碎的时值（如五连音）会被近似，check 会提醒。
- 文字版里同一拍内的音用
_连接，看不出下划线条数；要看精确节奏请看 PNG 谱图。 - 光遇电脑版的默认按键没有核实到官方来源，见
references/keymap.md。 - 用户提供的谱子仅供个人练习；不帮用户去网上抓付费或受版权保护的谱，也不把用户的谱子分享到别处。
- 本技能不包含、也不会生成任何键鼠自动化或自动演奏代码。
