在线用户手册

MIDI Manager 用户手册

完整的 MIDI Manager 1.x 工作流程:初始设置、持久化 Source Index、增量 Technical MIDI Scan、审核、安全整理、播放、软盘 IMG 操作以及 Library Health。

安装与安全规则: 按照相应平台的指南安装 MIDI Manager。安装后先使用少量复制出的测试文件,熟悉整个操作流程再处理正式曲库。 Linux 安装手册 Windows 安装手册

安装与安全规则

按照相应平台的指南安装 MIDI Manager。安装后先使用少量复制出的测试文件,熟悉整个操作流程再处理正式曲库。

MIDI 源文件夹/曲库根目录

原始或尚未整理的 MIDI/KAR 文件集合。Source Index 会清点此文件夹,Technical MIDI Scan 会读取其中的文件。

Organized Library 输出根目录

另选一个文件夹来保存经确认文件的安全副本。切勿将其设为源文件夹。

MIDI 归档根目录

归档操作使用的可选位置。清理任何文件之前,请先查看操作预览。

生成文件文件夹

存放 IMG 文件、报告、CSV/JSON 导出文件和维护报告的位置。

首次启动:设置文件夹、语言、主题和播放

打开 Settings → Settings。先配置应用程序路径;除非需要专业调整,否则保持 Advanced settings 折叠。

  1. Theme 和 Language 可随时更改。目前的截图采用 Light 主题和英文界面标签。
  2. Startup page 决定启动后打开的页面,推荐默认使用 Dashboard。
  3. 为源文件和 Organized Library 输出分别选择不同的文件夹。MIDI archive 和 Generated files 文件夹为可选项。
  4. 如需使用 FluidSynth 播放,请选择 SoundFont 文件。MIDI Manager 不附带 SoundFont。
  5. 单击 Apply Settings,等待状态栏确认设置已保存。
  6. 公开截图中会刻意隐藏私有的本地文件路径。

Organizer 分析批次大小

控制 Library Organizer 每批分析多少个符合条件的源文件。它只改变批次大小,不改变文件安全规则。

曲风/艺术家处理批次大小

控制流派和艺术家维护试验每次处理的艺术家数量。

数据库备份保留数量

设置 MIDI Manager 保留多少份经过验证的自动数据库备份。它不会删除 MIDI/KAR 文件。

Trial / Free 模式与许可证激活

打开 Settings → Licensing。此页面显示应用版本、许可证状态和等级、主要版本兼容性、Organized Library 限额及此计算机的 Device ID。

升级和在线帮助

许可证操作

移除本地许可证

仅移除此计算机本地保存的已签名许可证,不会释放服务器上的激活名额;请使用设备转移或释放功能。

功能授权

显示当前许可证等级中哪些功能已启用、被阻止或受到限制,并说明原因。

释放或转移此计算机

通过在线许可服务释放当前设备的激活,以便根据许可条款转移许可证。

功能访问权限:各项授权的含义

Licensing 页面列出当前许可等级的功能授权。下面的描述沿用 MIDI Manager 1.2.2 的功能名称和解释。

核心应用访问权限

在许可证未被阻止且有效时允许运行应用。通常所有有效许可证等级均包含此权限。

搜索和浏览 MIDI/KAR 文件

允许浏览、筛选和搜索已建立索引的 MIDI/KAR 文件。这是 MIDI Manager 的基本功能。

MIDI/KAR 播放

允许在应用内播放 MIDI/KAR。播放仍取决于配置的 SoundFont 和播放设置。

Organized Library

允许访问 Organized Library 的浏览和播放流程。

Organized Library 高级播放队列

允许使用 Organized Library 的高级播放队列控制,包括将所选文件加入队列、播放队列及清空队列。

基础 Library Organizer

允许在当前许可证等级的限制内进行基本 Library Organizer 操作,例如检查文件并建立 Organized Library。

批量 Library Organizer

允许使用 Library Organizer 处理较大规模的文件集合。由于能够处理明显更大的集合,此功能面向付费等级。

Copy Guard 归档工具

允许使用 Copy Guard 归档工具,将经过验证的源文件移动到已配置的 MIDI Archive。此操作影响较大,通常仅面向 Professional 许可证。

创建完整的 3.5 英寸磁盘映像

允许创建 DSDD/DSHD 类型的完整 3.5 英寸磁盘映像。通常属于 Personal 功能。

IMG Viewer

允许在应用内打开并检查磁盘映像。Personal 许可证仅能只读查看 IMG,Professional 许可证可使用完整 IMG 工作流程。

IMG Viewer:提取、播放与重写

允许从 IMG 中提取和播放文件、添加或删除文件,以及保存重写后的 IMG 磁盘映像。由于会修改或导出映像内容,此流程仅面向 Professional 许可证。

Project Health 和语言验证

允许在 Maintenance 中执行 Project Health 与语言文件验证。这些是诊断检查,不会执行修改归档内容的修复操作。

高级维护工具

允许使用高级维护和修复工具。这些工具可能影响本地资料库或数据库的较大部分,通常仅面向 Professional 许可证。

许可证转移流程

允许安全地转移许可证,包括先释放当前已授权的计算机,再激活另一台计算机。

Dashboard:一览 MIDI 曲库

Dashboard 是曲库的只读信息中心,同时显示 Organized Library、源文件、分析、归档、复核、兼容性、歌词和播放等关键数据;它不会用快捷按钮取代各个操作页面。

各项任务的位置

1.2.2 Professional 界面使用下列准确的导航位置。历史截图或发行说明中的旧名称不应作为导航指令。

Dashboard

查看文件集状态和健康状况。

Analyze

Source Index、Technical MIDI Scan 和源文件清单。

Review

Review Queue 和 Failed analysis。

Organize

安全地分析、规划、审查、复制并验证。

Library

在 Organized Library 中搜索,以及使用 MIDI by Device。

MIDI Player

Playback Queue 和 MIDI 播放。

Floppy Image Studio

创建并检查软盘 IMG 文件。

Settings

Settings、Licensing 和 Library Health。

Dashboard 的八个面板

以下是 1.2.2 Dashboard 中显示的八个面板。每个面板的 ? 按钮会在此打开对应的说明。

仪表板:已整理曲库

显示受管理的输出曲库,包括文件总数、艺术家、收藏、文件扩展名、总大小以及缺失的受管理文件。

仪表板:歌词与卡拉 OK

将 Organized Library 分为内嵌歌词、由 MIDI Manager 添加或导入的歌词、确认无歌词、歌词状态未分类、同步歌词以及适用于卡拉 OK 的文件。

仪表板:未整理来源

实际扫描已配置来源文件夹中的 .mid、.midi 和 .kar 文件,并结合索引与歌词分类信息,不会把未知记录视为无歌词。

仪表板:分析

汇总 Technical MIDI Scan 已完成、失败和剩余的任务,以及分析和质量指标覆盖情况。

仪表板:MIDI 归档

按扩展名和大小统计已配置实际 MIDI Archive 中的文件,并报告归档文件夹是否可访问。

仪表板:审核与关注

显示 Review Queue、Failed analysis、缺失的 Organized Library 记录以及可能需要处理的数据库健康指标。

仪表板:MIDI 兼容性

以固定的两行三列布局汇总 GM、GS、XG 及 Yamaha、Roland、Korg 的兼容性证据。

仪表板:播放

在打开 MIDI Player 前显示 Playback Queue,以及歌词和卡拉 OK 的准备情况。

仪表板指标详解

打开此参考部分,可查看仪表板诊断使用的各项分析与覆盖率指标。点击某项指标旁的 ? 链接会自动打开本部分。

Analyze → Analyze Library:Source Index 与 Technical MIDI Scan

Analyze 有两个选项卡。Analyze Library 包含步骤 1 Source Index 和步骤 2 Technical MIDI Scan;Source inventory 用于高级查询已索引的来源记录。现有数据库的刷新和重新评估位于 Settings → Library Health。

MIDI/KAR 文件总数

数据库中已发现并存储的 MIDI 和 KAR 文件总数。

基础元数据补充

基础补充会保存轨道数、速度、音符及基本 MIDI 结构等核心元数据。

深度分析已完成

已完成高级 MIDI 智能分析的文件,包括质量评分、模式分析、硬件检测、力度分析和复杂度指标。

深度分析已处理

包括深度分析成功的文件,以及被判定为深度分析失败的文件。

深度分析待处理

已建立索引但尚未由深度分析工作程序处理的文件。

深度分析失败

这些文件仍保留在索引中。只有高级分析失败,通常是因为文件损坏、格式不正确或实际上不是 MIDI 文件。

审核队列

Review Queue 是安全的暂存列表。它不会删除、移动或修改 MIDI 文件。

已整理曲库文件

统计在已配置 Organized Library 输出文件夹中实际找到的 MIDI/KAR 文件。

已整理曲库艺术家

统计包含已整理 MIDI/KAR 文件的第一级艺术家文件夹。

播放队列

Playback Queue 是安全的试听队列。它不会删除、移动或修改 MIDI 文件。

质量评分

质量评分根据结构、力度变化、复杂度和音乐丰富程度估计 MIDI 的实用价值。

Yamaha / XG

Yamaha 检测依据 SysEx 制造商 ID 和 XG 模式信号。

Roland / GS

Roland 检测依据 SysEx 制造商 ID 和 GS 模式信号。

Korg / GM

Korg 检测依据制造商 ID。GM 表示 General MIDI 重置或模式的使用情况。

Analyze → Analyze Library:Source Index 与 Technical MIDI Scan

Analyze 包含两个选项卡。Analyze Library 提供步骤1 Source Index 和步骤2 Technical MIDI Scan;Source inventory 用于高级查询已索引的源记录。已有数据库的刷新和重新评估位于 Settings → Library Health。

步骤1:Source Index

Source Index 查找受支持的 MIDI 和 KAR 文件,并创建或更新本地数据库记录。它记录文件名、路径和基本来源信息,而不是完整的 MIDI 分析。

  1. 首次配置后,以及新增、替换、移动或删除源文件后,请运行 Update Source Index。
  2. Source Index 会记录内容指纹和实际源文件状态。只改变文件路径时会进行对应调整,不会强制对未改变的 MIDI 数据重新运行 Technical MIDI Scan。
  3. 打开 Analyze 时,大型曲库只执行有限的快速检查。已完成的 Source Index 在重启应用后仍然有效;打开 Analyze 不会递归扫描整个源文件夹树。
  4. 实际运行 Source Index 时,完成报告会显示精确的文件发现数量,以及新增、移动/重命名、更改、移除、保留和失败项目数量。
  5. 在 Technical MIDI Scan 之前运行 Source Index。之后单个源文件的变化不会让整个索引失效。

分析:来源清单

针对已建立索引的来源或未整理记录进行高级搜索,以供诊断及整理前检查。常规曲库搜索位于 Library。

步骤 2:Technical MIDI Scan

步骤 2 Technical MIDI Scan 仅打开已建立索引但当前技术分析缺失或过期的 MIDI/KAR 文件。它保存供 Review、Organize、Library 和 File Detail 使用的技术、质量、协议、设备和依据数据。

  1. Start / Resume Analysis 仅处理当前 Technical MIDI Scan 流程中结果尚未更新的记录。未更改的有效结果将被重用。
  2. 如果内容指纹未改变,仅移动文件无需重新分析。内容改变的文件会重新分析一次。
  3. 新准备的文件会直接从头到尾处理,而不是先准备数千条记录,因此进度从实际完成的文件开始显示。
  4. Stop Safely 在停止前完成并保存当前文件。Start / Resume 从剩余文件继续,已完成的工作会保留。
  5. 运行期间,状态会显示本次运行已处理完成的文件、剩余文件、速度、预计时间以及当前文件。
  6. 失败项进入最终状态,不会无限重试。再次尝试前请检查 Failed analysis,或修复源文件及其路径。

了解所有分析计数器

Indexed

Source Index 创建的所有数据库记录。

Deep complete

已成功完成完整深度分析的文件。

Deep failed

已进入深度分析阶段但无法完成的文件。

Source/parser failed

在深度分析前无法打开或解析的文件,例如缺失或格式错误的文件。

为什么步骤2的按钮可能显示为灰色

分析可信度、评分说明以及编曲和伴奏轨兼容性

Review、Library 与 File Detail

需要人工处理的文件可使用 Review → Review Queue 或 Review → Failed analysis。正常浏览与搜索使用 Library → Organized Library。Analyze → Source inventory 是索引源记录的高级诊断视图。

待审核队列

有意加入队列、留待稍后审核的文件。移除队列中的一行不会删除 MIDI/KAR 文件。

分析失败

分析最终状态为失败的文件。内容在后台加载;如果耗时明显,将显示 Please wait 提示。

按设备浏览 MIDI

按检测到的制造商、模式及兼容性证据浏览已分析的 MIDI 文件,例如 Yamaha/XG、Roland/GS 和 Korg/GM。

Recognition 2.0:优先使用本地证据识别曲目

Recognition 综合文件名和内嵌元数据,推测艺术家及曲名。文件夹上下文、去除卡拉OK后缀和标题括号内容也可作为辅助证据。系统只选择证据能够支持的最可靠身份,不会把每个看似合理的结果都自动确认。

重新评估现有曲库

打开 Settings → Library Health → Advanced maintenance → Library intelligence & metadata。Re-evaluate Library 会按当前规则重新评估 Recognition 的判断,无需新建个人资料或数据库。

Library Organizer:分析、复核、规划、执行与验证

Recognition 综合文件名和内嵌元数据提出艺术家及曲名假设,并在可用时使用本地参考证据。Library Organizer 将分析、规划、复核、修正副本规划、执行和归档清理分开处理。即使 Technical MIDI Scan 仍在处理其他文件,也可以先处理状态为 current-DONE 的部分;待处理、过期和失败记录会被排除。

  1. 1 整理分析:处理下一批符合条件且状态为 current-DONE 的源文件。分析器将每个结果标为 Auto-safe、needs review 或 skipped。
  2. 2 规划安全副本:为仍待处理的 Auto-safe 结果建立只复制的计划。规划阶段不会复制、移动或删除任何源文件。
  3. 3 Review:检查待复核清单,批准有参考证据支持的识别,或保留/修改自己对艺术家及曲名的判断。
  4. 4 修正副本:对批准的手动修正使用 Plan manual metadata corrections,对已保存的复核批准使用 Plan reviewed identifications。已有的未完成复核计划会重新载入,不会悄悄创建不同的作业。
  5. 5 执行并验证:载入已批准的复制作业,执行计划中的副本,并验证 Organized Library 中的目标文件。源文件保留在原处。

可以安全复制

艺术家和标题的证据足够可靠,可以制定安全复制计划。执行前请始终审查计划。

需要审查

匹配结果存在歧义或不完整。复制前必须由人工判断。

已跳过

此行被有意排除在自动复制之外,例如匹配依据较弱或不适用。

归档与清理有意分开

Library → Organized Library:浏览和搜索管理中的曲库

Library 是管理曲库的工作区域。您可以浏览和搜索 Organized Library、查看详情、收藏、歌词和元数据,并按 Device 打开 MIDI,而不必切换到单独的顶层 Search 页面。

将选中文件移入 MIDI Archive

把选中文件从已配置的 Organized Library 实际移动到 MIDI Archive。先完成路径限制、名称冲突处理以及字节和哈希验证,然后才核对数据库与索引;如发生失败,将保留或恢复原始状态。

MIDI Player 和播放队列

MIDI Player 是专用播放工作区,管理 Playback Queue 和共用播放控制。队列操作不会删除 MIDI/KAR 文件。

MIDI 播放器

打开 Playback Queue 并使用共用 MIDI 播放控件。队列操作绝不会删除来源文件或 Organized Library 中的文件。

Disk Image Creator 磁盘映像创建器

Disk Image Creator 将 Organized Library 或 Review Queue 中选定的文件打包为 FAT12 格式的 3.5 英寸软盘映像。

  1. 从 Organized Library 或 Review Queue 将文件加入 Disk Image Basket。
  2. 选择 3.5" DS/DD 720 KB 或 3.5" DS/HD 1.44 MB,使用键盘、模拟器或 Gotek 所需格式。
  3. Pack Basket 会分配磁盘编号和位置,但此时还不会写入 IMG 文件。
  4. 核对预计及分配的磁盘数量、超大文件和排列顺序。
  5. Create IMG Files 会打开保存对话框。选择输出文件夹及清晰的基本名称,例如 POP1-001。
  6. 应用会创建按编号排列的 IMG 文件系列及配套清单。

FAT12 8.3 文件名和配套清单

IMG Viewer:Single IMG 和 Folder Catalog

IMG Viewer 打开 FAT12 IMG 文件,在有清单时使用清单,并提供两种互补视图。

  1. Single IMG 显示映像元数据、容量、正式名称/显示名称、大小、簇、属性和原始 8.3 文件名。
  2. Open IMG 选择一个映像。Reload 重新读取当前映像;Open Folder 打开它所在的文件夹。
  3. Folder Catalog 扫描文件夹内所有 IMG 文件,也可选择包含子文件夹。
  4. Disk overview 显示状态、磁盘编号、文件名、格式和文件数量。
  5. Master contents 汇总所有已扫描磁盘。双击主列表中的某一行,即可在 Single IMG 中打开对应磁盘。
  6. 每个磁盘的警告和错误会单独汇总;详细诊断请查看 Problem Report。

报告与导出

Reports 选项卡使用当前 Folder Catalog 的扫描结果。报告涵盖完整扫描目录,而不只是筛选后可见的行。

每盘 PDF:磁盘顺序

按 IMG 实际顺序列出文件:磁盘、位置、正式曲名及 8.3 文件名。

每盘 PDF:艺术家/曲名

各磁盘仍分别列出,但在各盘内部按艺术家/曲名排序。

主目录 PDF

为所有扫描的 IMG 文件生成按字母排序的查询索引,并标出磁盘及位置。

问题报告 PDF

将技术警告和错误与查询索引报告分开。扫描无异常时会说明未发现警告或错误。

Gotek 槽位索引 PDF

提供槽位数据时,为 Gotek/USB 工作流程生成按槽位组织的索引。

主目录 CSV

将主目录导出为方便电子表格使用的表格。

JSON 清单

导出结构化的目录、磁盘、顺序及文件名映射数据。

流派恢复、在线艺术家分析与流派筛选

流派数据属于可选的附加信息,不会改变 MIDI/KAR 文件内容。

Settings → Library Health

打开 Settings → Library Health。先运行简化的 Library Health 检查。只有需要 Database、Organized Library check、Library intelligence & metadata、Organized Library planning、Organized Library reset 或 Archive & cleanup 时才展开 Advanced maintenance。

资料库健康状态中的内容

资料库健康状态

检查过期记录,只修复经过验证的安全问题,或审查需要您决定的项目。

数据库

用于特殊维护情况的数据库结构修复和压缩工具。

已整理资料库检查

使用 Check library、Apply safe corrections 和 Show details,将受管理的记录与已整理的实际文件进行对比。

资料库智能分析与元数据

就地更新旧版分析,重新评估 Recognition 身份识别,补充歌词并维护来源于参考资料的元数据。

已整理资料库规划

预览规范化操作,创建和导出执行计划,并核对实际的已整理资料库。

归档与清理

检查已配置的 MIDI Archive,并准备以先归档为原则的安全清理。

清空 Organized Library:有意执行的重置

详细的资料库健康维护操作

需要执行某项维护操作时,请打开此参考说明。预览和诊断操作为只读;可能更改数据库或文件的操作会明确说明其保护措施。

Library Health → 检查曲库

扫描数据库路径并分类问题,不更改记录或 MIDI 文件。

Library Health → 修复安全问题

只删除在新备份之后再次确认可安全清理的过期测试或技术记录。

Library Health → 审核问题

查看尚未解决的过期记录,并逐项决定处理方式。

Database → 修复数据库结构

安全检查和修复本地数据库结构。如果结构正常,则不做任何修改,也不创建修复备份。确需修复时,MIDI Manager 会先创建经过验证的安全备份,然后再补齐缺失的本地表、列或索引。绝不会更改 MIDI/KAR 文件。

Database → 优化 / 压缩数据库

先创建经过验证的备份,仅清理数据库中确认过期的数据,对 WAL 执行检查点,再通过经过验证的压缩副本重建 SQLite。独占维护会备份、执行 WAL 检查点、清除已验证的过期派生数据、使用 VACUUM INTO 生成压缩候选副本、检查完整性和外键,并仅在验证通过后替换活动数据库。绝不会删除 MIDI/KAR 文件。

曲库智能分析与元数据 → 刷新分析数据库

对当前配置文件中每个已索引的 MIDI/KAR 记录重新运行现行本地分析流程。首先创建经过验证的数据库备份。保留现有用户状态,不移动或重命名 MIDI 文件。

曲库智能分析与元数据 → 重新评估曲库

使用最新的结构化内嵌身份识别规则重新扫描当前曲库,并保存只读的协调预览。

曲库智能分析与元数据 → 批量查找/补充歌词

先从相邻的 .lrc/.txt 文件补充当前曲库的歌词,再使用 MIDI/KAR 内嵌歌词。仍缺失的歌词可供手动查找,或以后通过已配置的提供方查询。

曲库智能分析与元数据 → 重建流派缓存

重建本地流派缓存,只补充严格匹配且安全的本地记录。

分析下一批艺术家

按照 Settings 中配置的批量大小,执行下一批艺术家的流派分析试运行。

Organized Library 规划 → 预览

模拟扫描 Organized Library 中已复制的文件,显示哪些目标路径将被规范化。不更改任何文件或数据库记录。

Organized Library 规划 → 制定执行计划

生成只读且避免名称冲突的执行计划,显示直接重命名和自动添加后缀的重命名操作。不更改文件或数据库记录。

Organized Library 规划 → 导出计划

将完整的只读防冲突执行计划以 TXT、TSV 和 JSON 格式导出至已配置的 Generated files 文件夹。不更改 MIDI 文件或数据库记录。

Organized Library 规划 → 建立核对计划

根据现有 Organized Library 索引及复制操作历史生成确定性的只读数据库核对计划。不更改文件或数据库记录。

归档与清理 → 预览

以只读方式预览已配置的 MIDI Archive,显示归档文件、来源归档操作、缺失的归档路径、仍指向已归档来源的索引记录及清理计划预览。不会删除、移动或更改任何内容。

删除选中的归档文件

经明确确认后,仅永久删除已配置 MIDI Archive 中选中的文件。实际删除成功后,只对受影响的文件执行数据库核对。

删除全部归档文件

永久删除已配置 MIDI Archive 的全部文件,而不只是当前页面上的文件。确认界面显示归档根目录、准确文件数和总字节数;大型任务提供进度,并可在各次原子删除之间执行 Stop safely。

最终删除后的数据库核对

永久删除归档文件后,MIDI Manager 先检查是否仍有大小和 BLAKE3 标识相符的其他受管理实体副本。如有,则将记录指向该副本;如无,则清除该文件的数据库数据。存在未经验证的剩余副本时,自动清除将被阻止。

支持诊断

只有启用支持工具后,支持诊断功能才会显示。它们不是常规菜单入口。

支持诊断 → 检查数据库结构

以只读方式检查本地数据库是否缺少表、列或索引。

支持诊断 → 运行项目健康检查

运行只读的项目健康诊断脚本并显示输出结果。

支持诊断 → 验证语言文件

验证语言 JSON 文件并显示验证器的输出。

常见问题

使用大型文件集前的新手检查清单

  1. 安装适合平台的版本,并阅读安装指南。
  2. 分别创建或选择源文件、Organized Library、归档和生成文件的文件夹。
  3. 选择具有合法使用权的 SoundFont,并用一个文件确认能正常播放。
  4. 查看 Trial / Free 限制,或激活并保存所需许可证。
  5. 运行 Source Index,并将发现和索引的文件数量与源文件夹进行比较。
  6. 运行 Technical MIDI Scan;需要时使用 Stop Safely,之后再继续。
  7. 检查 Deep complete、Deep failed、Source/parser failed 和 Remaining。
  8. 测试 Library → Organized Library、Review → Failed analysis 和 Review → Review Queue。分析后在 File Detail 中核对数据来源。
  9. 要重新评估现有资料库,请打开 Settings → Library Health → Library intelligence & metadata。选择 Re-evaluate Library,使用当前 Recognition 和分析流程生成只读预览。现有配置文件和数据库会保留,无需新建资料库或配置文件。
  10. 在 Library Organizer 中运行一次小规模整理分析,并检查 safe-to-copy、needs-review 和 skipped 的处理结果。
  11. 仅规划和执行已经审查的复制任务,并确认源文件未被修改。
  12. 确认 Organized Library 中的播放和播放队列功能正常。
  13. 创建一小组 IMG 文件并保留清单,在 Folder Catalog 中扫描,然后生成查找和问题报告。
  14. 在修复或清理前,先使用 Maintenance 的预览和检查功能。
  15. 保留独立备份,并在请求支持时记录应用程序版本。