dsh-musictheory

在大语言模型辅助音乐创作和理论分析时，经常会出现音高计算、升降号标记和同音异名拼写等高频错误，例如错误给出 C4 的频率、将 G# 大三和弦拼写为 G# C D# 而非正确的 G# B# D#，或是在生成 F# 大调音阶时遗漏 E#。dsh-musictheory 插件正是为了解决这些确定性错误而设计，它提供了一套零运行时依赖的纯数学工具箱，通过精确的 12-TET 算术确保每次计算都得到一致且正确的结果。

该插件的核心能力在于其全面的音乐理论解析和生成功能：用户可以解析任意格式的音名并获取其 MIDI 数字、八度、精确频率及所有常规同音异名；将任意频率转换为最近的音符信息；构建多达 26 种类型的和弦（包括大三、小三、减七、增七等），并得到正确的字母拼写和音高；以及生成 17 种音阶（如大调、和声小调、多利亚调式、布鲁斯音阶等），确保每个音符的拼写符合音乐理论规范。所有工具都支持可选的 A4 参考频率，以适应历史或替代调律需求。

dsh-musictheory 特别适合音乐软件开发者、音乐理论研究人员、教育工具构建者，以及任何需要在应用中集成可靠、精确音乐理论计算的项目。它通过结构化的错误处理和详尽的单元测试，确保输入验证和计算稳定性，为音乐相关的大语言模型应用提供了坚实的数学基础。