MStruct: Technical Note

MStruct is a text-based system for describing and presenting musical structure, developed by Polymath9 and inspired by simai notation and LaTeX. It records harmonic and structural analysis in time order. It combines chord symbols, Roman numerals, analytical tags and musical settings in measures and timed slots. This technical note defines the document model and gives an entry-by-entry reference for basic events, chord notation, Roman notation, tags, recording timelines and search queries. Source examples accompany the syntax descriptions. The search reference pairs queries with concrete matching and nonmatching passages and explains each result. The note also describes rule-bundle identity, compatible updates and historical interpretation. A chapter on rendering records the vertical grid, alignment, range continuity and horizontal layout of the score. The complete English text is followed by the complete Chinese text. MStruct 是由 Polymath9 开发、受 simai 记法(Notations of simai) 和 LaTeX 启发的基于文本的音乐结构描述与呈现系统。它按时间顺序记录和声与结构分析。它以小节和带时值的槽位组织和弦记号、罗马数字、分析标签及音乐设置。本文定义文档模型,并按条目说明基础事件、和弦记号、罗马数字、标签、录音时间轴和搜索查询。语法说明配有源码示例。搜索部分逐条列出具体匹配与不匹配的片段,并解释结果。本文还说明规则包的身份、兼容更新和历史解释方式。渲染规则章记录谱面的纵向 Grid、对齐方式、范围连续性与横向布局。英文全文在前,中文全文在后。