科研 Skill

中国传统音乐数字化

arts-chinese-traditional-music

将简谱、工尺谱、减字谱转写为MusicXML/kern,做宫调判别与旋律统计分析。适用于民歌色彩区划、曲牌比较与古谱打谱研究。

发布者 Codar安全审核通过v0.1.0更新于 2026-11-18

SKILL.md

中国传统音乐研究与乐谱数字化(Chinese Traditional Music Research & Notation Encoding)

适用场景

  • 将简谱、工尺谱(含昆曲曲谱、俗字谱)、古琴减字谱等转写为可计算的编码格式,建立可检索的曲谱语料库。
  • 对民歌、器乐曲、戏曲唱腔做五声调式(宫商角徵羽)与“七声三种音阶”(清乐、雅乐、燕乐)判别,统计主音、骨干音与终止式。
  • 比较同一曲牌或板式(如京剧西皮/二黄、昆曲南北曲牌)的不同版本,分析“依字行腔”中字调与旋律走向的关系。
  • 民歌色彩区划研究:按地域抽取旋律特征(音程分布、音阶结构、句式),做聚类与地图可视化。
  • 古谱打谱的数字化记录:保留原谱符号、版本异文与打谱者的节奏解释,供校勘复核。

边界与不适用

  • 通用的 MusicXML 读取、music21 基础分析、librosa 音频特征提取由其他 Plugin 覆盖(如 music21 / librosa 相关 Skill),此处只处理中国传统记谱与调式体系的特殊问题。
  • 演奏录音的速度、力度分析见 arts-performance-recording-analysis;田野录音档案规范见 arts-ethnomusicology-fieldwork。
  • 不替代打谱专家对古谱节奏的学术判断;自动转写结果只能作为待校勘的草稿。
  • 不提供受版权保护的现代出版乐谱全文,语料库发布需确认版权状态。

工作流

  1. 界定语料与版本

    • 输入:研究问题(如“陕北信天游的音阶结构”)、候选谱本清单(《中国民间歌曲集成》各省卷、《中国戏曲音乐集成》、《九宫大成南北词宫谱》、《纳书楹曲谱》、琴谱如《神奇秘谱》等)。
    • 操作:登记每首曲目的出处卷册、页码、采录者/记谱者、采录地、版本。
    • 产出:曲目元数据表。决策点:同曲多版本时,先确定“底本”与“参校本”。
  2. 选择编码方案

    • 简谱、工尺谱转为五线谱语义后可用 MusicXML 或 MEI;需大规模统计时推荐 Humdrum **kern(逐行文本,便于 grep 式分析)。
    • 必须额外保留原记谱信息:工尺字(上尺工凡六五乙)、板眼符号(板、眼、底板、腰板)、简谱首调“1=D”等调高标记。在 MEI 中可用注释或自定义属性;在 kern 中可增加 **gongche 等自定义 spine。
    • 减字谱:记录指法、徽位、弦序,音高与节奏解释分 spine 存放,以区分“谱面信息”与“打谱解释”。
    • 产出:编码规范文档(字段说明 + 示例)。
  3. 转写与校对

    • 简谱可手工录入或借助 OMR 工具后人工核对;工尺谱、减字谱目前基本依赖人工录入。
    • 双人独立录入 10%–20% 样本,计算一致率;不一致处回到原谱裁定。
    • 产出:编码文件 + 校勘记录表(曲目、小节、原谱、录入、裁定理由)。
  4. 调式与宫调分析

    • 统计音级出现频次(按时值加权)、首尾音、句末音,判定五声骨干与偏音(清角、变宫、闰、变徵)。
    • 依“以宫定调、以主音定式”的分析习惯,同时报告“宫音位置”与“调式主音”,避免只给西方大小调标签。
    • 戏曲唱腔另需标注板式、字位与行腔,统计字调(阴平/阳平/上/去,或方言调类)与旋律升降的对应率。
    • 决策点:调式归属存在争议(如徵/羽交替)时,如实报告多候选并说明依据。
  5. 跨曲目比较与可视化

    • 特征:音阶类型、音程直方图、旋律轮廓、句数句式、终止音。
    • 方法:层次聚类、主成分分析,按采录地绘地图。
    • 产出:图表 + 特征矩阵 CSV。
  6. 解释与回到文献

    • 将计算结果与已有区划理论、乐种史料对照;差异需检查是否来自记谱者习惯(如统一记为“1=C”)而非音乐本身。

工具与数据源

  • 编码格式:MusicXML、MEI(Music Encoding Initiative,music-encoding.org)、Humdrum **kern(Humdrum Toolkit 与 humlib)。
  • 软件:MuseScore(简谱需插件或转五线谱录入)、Verovio(MEI/kern 渲染)、music21(读写 kern/MusicXML/MEI)。
  • 曲谱文献:《中国民族民间器乐曲集成》《中国民间歌曲集成》《中国戏曲音乐集成》《中国曲艺音乐集成》,《九宫大成南北词宫谱》,《琴曲集成》。
  • 文献检索:CNKI、中国音乐学院/中央音乐学院图书馆、中华经典古籍库、国家图书馆“中华古籍资源库”。
  • 已有数字语料:Essen Folksong Collection 中含部分中国民歌(kern 格式,随 Humdrum/music21 语料分发);CompMusic 项目的京剧唱腔语料(Jingju a cappella singing dataset)。

最小示例:从 kern 统计五声音级分布

# pip install music21
from collections import Counter
from music21 import converter

score = converter.parse("song.krn")   # Humdrum kern 文件
weights = Counter()
for n in score.flatten().notes:
    for p in n.pitches:
        weights[p.pitchClass] += float(n.quarterLength)

total = sum(weights.values())
for pc, w in sorted(weights.items(), key=lambda x: -x[1]):
    print(pc, round(w / total, 3))

# 候选宫音:寻找使“宫商角徵羽”五音权重之和最大的音级
PENTA = [0, 2, 4, 7, 9]
best = max(range(12), key=lambda g: sum(weights[(g + i) % 12] for i in PENTA))
coverage = sum(weights[(best + i) % 12] for i in PENTA) / total
print("候选宫音 pitch class:", best, "五声覆盖率:", round(coverage, 3))

说明:以上仅给出“宫音候选”与五声覆盖率,调式主音需结合句末音、终止音另行判断。

质量检查

  • 每首曲目可追溯到集成卷册/古谱版本与页码。
  • 原谱符号(工尺字、板眼、减字谱指法)在编码中有保留,未被“西化”丢失。
  • 抽样双录一致率已报告,校勘记录完整。
  • 调式判定同时报告宫音与主音,争议曲目给出多候选。
  • 区分记谱者习惯(统一调高、简化装饰音)造成的偏差与真实音乐差异。
  • 打谱/节奏解释与谱面信息分开存储并署名。
  • 语料公开前确认版权与出版社授权;集成类出版物不可整卷公开。

输出格式

  • 曲目元数据表:曲目ID、曲名、乐种/体裁、地区、采录/记谱者、出处卷册、页码、原记谱类型、编码文件名。
  • 分析结果表:曲目ID、宫音、调式主音、调式名(如“D徵调式”)、音阶类型、偏音、句数、终止音、备注。
  • 报告章节:语料说明 → 编码规范 → 校勘方法与一致率 → 调式/旋律分析 → 比较与可视化 → 讨论与局限。

参考规范与文献

  • 杨荫浏,《中国古代音乐史稿》,1981。
  • 黄翔鹏,《传统是一条河流》,1990。
  • 杜亚雄,《中国民族基本乐理》。
  • 苗晶、乔建中关于汉族民歌近似色彩区划分的研究(20 世纪 80 年代)。
  • 童忠良等,《中国传统乐理基础教程》。
  • Huron, D. (1994). The Humdrum Toolkit: Reference Manual.
  • Music Encoding Initiative, MEI Guidelines.

示例提示词

帮我把《中国民间歌曲集成·陕西卷》中 30 首信天游简谱编码为 kern,并统计各曲的宫音、调式主音与五声覆盖率。

所属插件

艺术学面向音乐学、美术学、设计学、戏剧与影视学研究:传统音乐与乐谱数字化、演奏分析与采录、作品著录与图像学、色彩构图计算、设计研究与用户实验、电影视听语言与产业数据。

安装该插件会一并获得同领域的 11 个 Skill / MCP。

同插件的其他科研 Skill

常见问题

中国传统音乐数字化能做什么?

将简谱、工尺谱、减字谱转写为MusicXML/kern,做宫调判别与旋律统计分析。适用于民歌色彩区划、曲牌比较与古谱打谱研究。

如何安装中国传统音乐数字化?

在科搭 Codar 左侧点击「插件」,在「组件」页签搜索「中国传统音乐数字化」并安装;在 Claude Code 或 Codex 中可以发送本页的安装提示词,或下载 Skill 包后解压到 ~/.claude/skills 或 ~/.codex/skills。

中国传统音乐数字化需要哪些权限?

该科研 Skill没有声明额外权限;执行具体操作时仍由 Agent 按自身规则请求确认。

中国传统音乐数字化经过官方审核吗?

是。SpeedSkills 收录的每个版本都会记录内容摘要与权限声明,当前版本已通过安全审核。