help.md

Malody Catch Editor 帮助文档

适用版本：Beta v1.11.2 仓库维护状态：Release candidate（最后核对 2026-09-19） 其他文档：文档总索引

本文按界面中的功能位置说明用途、使用方法和默认快捷键。第一次使用时，建议按“快速上手”走一遍，再按菜单查找具体功能。

快速上手

1. 从 File -> Open Chart... 打开 .mc 谱面，或从 File -> Open Folder... / Open Imported Charts... 选择谱面。
2. 在右侧工具栏选择 Note 面板，选择 Place Note 后在中央画布左键放置音符。
3. 用鼠标滚轮上下浏览谱面；按住 Ctrl 滚轮缩放时间轴；左侧 Zoom 也可以调整纵向缩放。
4. 按 Space 播放/暂停，或使用左侧 Play 按钮。
5. 需要精确放置时，在右侧 Time Division 选择拍线分度，并开启 Grid Snap。
6. 编辑完成后用 File -> Save 保存 .mc，或用 File -> Export .mcz... 导出 Malody 谱面包。

主程序文档

主界面区域

• 顶部菜单栏：包含文件、编辑、视图、设置、播放、工具、插件和帮助入口。
• 顶部工具栏：Note / BPM / Meta 打开并聚焦对应编辑面板；Curve 启动或关闭原生曲线编辑工具；Panels（多窗口模式）恢复被关闭的面板；Quantize Paste to 1/288 显示并切换粘贴颜色模式；Plugins 打开插件管理器。
• Navigation 面板：显示谱面密度曲线、播放按钮、纵向缩放，以及外部插件提供的快捷按钮。
• Realtime Preview 面板：实时预览当前谱面效果。
• Chart Workspace：不可关闭的中央谱面画布与时间密度导航条。
• Note Input、Timing & Grid、Playback Speed、Range Select、Mirror Flip、Curve Tools、Plugin Tools：按功能组成中等粒度工具块；BPM & Timing 和 Metadata 保持独立面板。
• Chart Statistics 统计面板：展示全 note 数、常规 note 数、rain 数量、奖励音符数与理论 Max Combo，默认停靠在 Navigation 下方，两种窗口模式均可用。

可组合面板布局

• View -> Enable Floating Windows：切换是否使用 ADS 可组合工作区，设置会在重启后保留。默认启用。
• 关闭浮动窗口后，界面恢复为引入 ADS 前的固定四栏布局：Navigation、Realtime Preview、Chart Workspace 和最右侧单一编辑栏；顶部 Note / BPM / Meta 仍按旧方式切换右栏内容，不显示停靠标题、标签、拆分手柄或浮动入口。
• 固定布局下 Chart Statistics 面板位于左侧 Navigation 栏底部，可点击标题栏箭头折叠/展开。
• 固定布局的右侧编辑栏只提供按需显示的纵向滚动条，可直接用滚轮上下浏览；横向滚动条始终禁用。Timing、Playback Speed、Range、Mirror、Curve 和 Plugin Tools 回到 Note 栏的原顺序，格式化颜色快捷按钮会在同一栏内展开插件 GUI。
• 经典四栏与多窗口 ADS 分别保存自己的布局。切换时会恢复目标模式上次的状态：多窗口保留停靠位置、标签、浮窗和面板开关；经典模式保留四栏宽度、Note/BPM/Meta 右栏页和嵌入式插件区开关，二者不会互相覆盖。
• 经典工作台可通过 View -> Move View... 将 Navigation、Realtime Preview、Note、BPM 或 Metadata 移到 Primary Sidebar、Auxiliary Sidebar 或 Bottom Panel；Reset View Location 将所选视图送回默认区域，位置会随经典布局保存。
• 拖动普通面板标题或标签可以改变停靠位置；BPM、Meta 等完整面板仍可组合成标签页。
• 将面板拖离主窗口即可变成独立浮动窗口；浮动面板仍可拖回主窗口或与其他浮动面板组合。
• Note 输入、时间网格、播放速度、范围、镜像、曲线和插件工具停靠时按原右侧栏顺序纵向展开，同时可见且不使用切换标签；只有拖离停靠区后才成为独立窗口。
• 将工具块拖回其他工具块的边缘会恢复 splitter 组合，不会变成只能显示其中一个的切换标签。Curve Tools 和 Plugin Tools 默认关闭，分别由 Curve 开关和插件快捷按钮打开。
• 工具块停靠在侧栏时显示紧凑的 22px 分段标题，整条标题均可拖动，右侧 ⠿ 用于提示拖拽；拖出后使用独立窗口标题栏并恢复自由缩放，重新停靠后回到紧凑高度。拖动过程中轮廓会随当前落点变化，可在松开前确认停靠范围。
• Chart Workspace 主编辑区不可关闭、移动或浮动，并保留最低可用编辑尺寸；即使旧版保存了关闭状态，恢复布局时也会自动重新打开。拖到编辑区上的面板只能落在其左侧或右侧，不会把编辑区切成上下小块或与其合并为标签。
• 普通面板关闭后可从顶部 Panels、View -> Panels 或 Note / BPM / Meta 按钮立即重新打开；Reopen All Closed Panels 可一次恢复全部关闭面板。
• 关闭紧凑工具块后，其他已停靠工具块的模块外框和内部控件都会保持自然高度；释放空间由 Note/BPM/Meta 等普通编辑面板吸收。独立浮动窗口不受此高度限制，可自由缩放并在内容过长时滚动。
• View -> Panels -> Reset Panel Layout：只重置当前模式的布局，不会删除另一模式已经保存的状态。
• 主窗口大小以及当前模式的布局会在正常退出时保存，并在下次启动时恢复。
• 长面板内容会在面板内部滚动，不再强制增大主窗口的最小高度。

File 文件菜单

• File -> Open Chart...：打开单个 .mc 或 .mcz 谱面。快捷键：Ctrl+O。
• File -> Open Folder...：打开一个文件夹并从其中选择 .mc 谱面，适合一个歌曲文件夹内有多个难度时使用。
• File -> Open Imported Charts...：打开本地已导入谱面库。快捷键：Ctrl+Shift+O。
• File -> Save：保存当前谱面到原始 .mc 文件。快捷键：Ctrl+S。
• File -> Save As...：另存为新的 .mc 文件。
• File -> Refresh Chart：从源文件重新加载当前谱面。快捷键：F5；存在未保存修改时会先询问是否保存。
• File -> Export .mcz...：导出 Malody 可导入的 .mcz 谱面包，会打包谱面、音频、背景等必要资源。
• File -> Switch Difficulty...：在同一目录或已导入歌曲中切换其他难度谱面。
• File -> Exit：退出程序。快捷键：Ctrl+Q。关闭主窗口同样会结束整个程序，包括隐藏的浮动面板和日志终端进程。

保存 .mc、覆盖已有资源/sidecar 及发布最终 .mcz 使用原子替换，写入或提交失败时不会 主动截断旧文件。编辑期间程序会以短防抖 间隔更新独立工作副本；上次异常退出且存在未保存修改时，下次启动会询问是否恢复。恢复副本 只用于会话安全，不会在未确认保存时覆盖源谱面。打开或切换新谱面失败/取消时，当前会话 和恢复副本会继续保留。

Edit 编辑菜单

• Edit -> Undo：撤销上一步编辑。快捷键：Ctrl+Z。
• Edit -> Redo：重做撤销的编辑。快捷键：Ctrl+Y。
• Edit -> Copy：复制当前选中的音符。快捷键：Ctrl+C。如果没有选中音符，第一次按下会记录参考线处的区间起点，移动视图后再次按下会复制区间内音符。
• Edit -> Paste：进入粘贴预览。快捷键：Ctrl+V。拖动预览可调整位置，点击画布左上角 Confirm 确认，点击 Cancel 或按 Esc 取消。
• Edit -> Delete：删除当前选中的音符或插件工具中的选中对象。快捷键：Delete。
• Edit -> Quantize Paste to 1/288：手动开启后，将粘贴的普通/Rain 音符起点和 Rain 终点舍入到 1/288 并以分母 288 保存，使粘贴后的 Note 统一使用 /288 蓝色。默认关闭；关闭时优先保留各 Note 原分母，原分母无法精确表达新拍点时才自动约分。

View 视图菜单

• View -> Enable Floating Windows：启用 ADS 停靠、拆分和浮动；关闭时使用引入 ADS 前的固定四栏布局和单一可纵向滚动的右栏。
• View -> Panels：多窗口模式下可显示/隐藏各面板、执行 Show Main Editor、Reopen All Closed Panels 或重置布局；经典模式下仍保留当前经典布局的重置入口。
• View -> Color Notes：按音符拍型/分度给音符上色，便于检查节奏密度。
• View -> Color Timeline Divisions：按时间轴分度给网格线着色。
• View -> Timeline Division Color Advanced Settings...：设置分度线颜色规则。可选择 Classic、All 或自定义常见分度/额外分度。
• View -> Hyperfruit Outline：显示红果/高密度音符的描边提示。
• View -> Vertical Flip：切换谱面下落方向/垂直显示方向。
• View -> Show Background Image：显示或隐藏谱面背景图。
• View -> Background Color：设置画布背景色，包含 Black、White、Gray 和 Custom...。

Settings 设置菜单

• Settings -> Note Size...：调整无皮肤或回退绘制时的音符大小。加载皮肤时，音符大小主要由皮肤校准控制。
• Settings -> Calibrate Skin...：校准当前皮肤缩放，让皮肤素材与编辑画布对齐。
• Settings -> Outline Settings...：设置音符描边宽度与颜色。
• Settings -> Note Sound Volume...：调整编辑时音符音效音量。
• Settings -> Session Settings...：设置编辑会话选项，包括自动保存间隔和音频校正测试开关。
• Settings -> Skin：选择可用皮肤。皮肤来自程序目录的 skins 或内置默认皮肤资源。
• Settings -> Note Sound：选择编辑音符时播放的按键音；选择 None 可关闭音效。
• Settings -> Keyboard Shortcuts...：自定义可配置快捷键。清空输入框可禁用对应快捷键，Reset 恢复单项默认值，Reset All 恢复全部默认值。录入新组合键会替换旧快捷键；连续录入可构成最多四段序列，支持 Ctrl+Shift+O 和 Alt+↑ 等组合；画布专属按键暂未纳入统一自定义管理。
• Settings -> Language：切换界面语言。

Playback 播放菜单

• Playback -> Play/Pause：播放或暂停当前谱面音频。快捷键：Space。
• Playback -> Speed：快捷选择 0.25×、0.5×、0.75×、1×、1.5×、2×。
• 右侧 Playback Speed 工具块提供相同的快捷按钮和 0.1×–10× 手动输入；倍速会立即应用并在重启后保留。

播放时画布会跟随播放头自动滚动；手动滚动或拖动时间位置后会暂时关闭自动滚动。

Tools 工具菜单

• Tools -> Grid Settings...：设置横向网格吸附，包含是否启用吸附和每行网格数量，范围为 4-64。
• Tools -> Log Settings...：设置日志输出，包括 JSON 日志、详细日志等。
• Tools -> Export Diagnostics Report...：导出诊断报告，便于反馈问题或分析性能。

Help 帮助菜单

• Help -> Check for Updates...：检查 GitHub 发布页是否有新版本。
• Help -> Help Documentation...：打开本文档。
• Help -> About...：查看程序信息。
• Help -> Version Information...：查看版本信息与更新说明。
• Help -> Logs...：查看日志列表，支持刷新、打开选中日志、打开当前日志和打开日志文件夹。

Note 工具面板

以下功能块停靠时组成可调整高度的纵向工具栏，也可以独立拆分、拖动和浮动：

• Note Input：放置、删除、选择、复制以及插件提供的 Note 放置动作。
• Timing & Grid：Time Division、横向网格吸附和网格设置。
• Playback Speed：常用倍速快捷切换，以及 0.1×–10× 精确输入；可像范围和镜像工具一样拆分、拖动和浮动。
• Range Select：大范围拍点输入、当前时间填入、范围覆盖层和范围选择。
• Mirror Flip：镜像轴、参考线、预览和执行翻转。
• Curve Tools：曲线锚点、选择目标、连接、提交和重置；启用顶部 Curve 时自动打开。
• Plugin Tools：由插件动作元数据生成的宿主 GUI；原生插件面板默认加入同一纵向工具区。

工具块中的拍点输入、下拉选择和数值输入会统一跟随明暗主题；暗色模式下不会使用系统默认白色输入背景。

Grid Settings、范围选择、镜像执行、曲线操作、复制、BPM/Meta 和插件执行等动作按钮使用内容驱动的固定尺寸，不会随侧栏或浮动窗口宽度拉伸；需要显示长内容的输入框和下拉框仍会自适应可用宽度。

• Place Note：普通音符放置模式。左键空白处放置音符；左键已有音符可选中并拖动。
• Place Rain：雨音符放置模式。第一次左键设置起点，第二次左键设置终点；终点必须晚于起点。
• Delete Mode：删除模式。左键已有音符会删除该音符。
• Select Mode：选择模式。左键点击选择音符，拖拽框选多个音符。
• Place Anchor：启动原生曲线工具并进入锚点放置模式。
• Copy：与 Edit -> Copy 相同。
• Time Division：设置时间分度，影响音符放置、播放头吸附、粘贴预览和曲线生成密度。可手动输入，最大会限制到 96。
• Grid Snap：开启后横向位置吸附到网格。
• Grid Settings...：设置横向网格数量。
• Mirror Flip：按指定 Axis X 镜像翻转选中音符。Show Guide 显示可拖动参考线，Show Preview 显示翻转预览，Flip Selected 执行翻转。
• 原生曲线控制：启用 Curve 或 Place Anchor 后出现，包含锚点放置、曲线显示、折线模式、音符吸附、选择目标、提交、连接、断开、删除和重置。

统计面板

Chart Statistics 面板展示当前谱面的统计信息（音频 note 不进入任何统计口径）：

• 全部音符：常规 note 数 + rain 数量（每个 rain 计 1 个）。
• 常规音符：NORMAL 音符数量。
• Rain 数量：RAIN 音符数量。
• 奖励音符：按官方 Rain 奖励算法生成的奖励 note 总数（与画布上的 Rain 奖励预览点完全一致）。
• 最大连击（Max Combo）：常规音符 + 奖励音符。rain 本体不计入连击，因为 rain 在游玩时由其奖励 note 构成。

点击面板底部 详细统计... 可打开非模态详细统计窗口；该窗口不阻塞主窗口操作，会随谱面编辑刷新。

统计在音符增删改、Rain 尾部拖动、撤销/重做等编辑后自动刷新。大谱面分析在后台基于谱面快照执行，因此连续编辑时结果可能短暂延后；旧快照结果不会覆盖新谱面。

BPM & Timing 面板

• BPM 列表：显示当前谱面所有 BPM 点，格式为 小节:分子/分母 BPM。
• Time：输入 BPM 点位置，例如 0:1/1。
• BPM：输入 BPM 数值。
• Add/Update：未选中列表项时添加 BPM；选中列表项时更新该 BPM。
• Remove：删除选中的 BPM。

Metadata 面板

用于编辑谱面元信息。字段修改后会自动保存到当前会话，也可以点击 Save 手动保存。

• Title / Original Title：标题与原始标题。
• Artist / Original Artist：曲师与原始曲师名。
• Difficulty：难度名。
• Chart Author：谱师。
• Audio (ogg)：选择或填写音频文件路径。选择非 OGG 音频（mp3/wav/flac/m4a/aac/wma/opus/aiff 等）时会自动转换为 OGG（带进度对话框，可取消），谱面始终引用 OGG 文件。选择无法解码的文件会弹窗提示且不改动谱面。
• Background：选择或填写背景图路径。PNG 与 JPG 按文件实际内容识别后原样导入；其他可解码的单帧图片（bmp/gif 等）会自动无损转换为 PNG（保留透明通道，并应用 JPEG EXIF 旋转信息）；包含多帧的动画图片（如动画 GIF）会保留原格式并弹窗提示；无法解码的文件会弹窗提示且不改动谱面。文件选择器的格式列表动态生成：核心格式（png/jpg/jpeg/bmp/gif）始终可用，其余条目跟随当前环境的 Qt 图像格式插件。
• Preview Time：试听预览时间，单位毫秒。
• First BPM：首个 BPM。
• Offset：音频偏移，单位毫秒。
• Fall Speed：谱面下落速度。

画布鼠标与键盘操作

• 鼠标滚轮：上下滚动谱面。
• Ctrl + 鼠标滚轮：缩放时间轴。
• 左键空白处：在 Place Note 模式下放置普通音符。
• 左键已有音符：选中并拖动音符。
• Ctrl + 左键音符：切换该音符的选中状态。
• Ctrl + 左键拖拽：框选音符。
• 右键画布：打开上下文菜单。
• 右键菜单 Play from Reference Time：从参考线时间开始播放。
• 右键菜单 Paste：在鼠标位置粘贴剪贴板音符。
• 右键菜单 Quantize Paste to 1/288：与顶部工具栏、Edit 菜单中的同名开关同步；粘贴预览左上角会显示当前 Timing: 1/288 状态。
• 右键菜单 Mirror Flip Selected (Center Line)：按默认中心线镜像翻转当前目标音符。
• 右键菜单 Edit Color (By Division)：批量设置目标音符的颜色分度，也可选择 Minimal Irregular (Red) 标记最小非常规分度。
• Esc：取消粘贴预览或区间复制状态。
• Delete：删除选中音符。

曲线工具与插件文档

Note Chain Assist 已由主程序内部的 C++ 模块实现，不依赖 Python 或插件进程。其他外部插件通常放在程序目录的 plugins 文件夹下，并需要对应的 *.plugin.json 描述文件和脚本/二进制文件。

Plugins 插件菜单

• Plugins -> Plugin Manager...：打开插件管理器。可查看插件启用状态、加载状态、名称、ID、版本、作者和能力；勾选 Enabled 后点击 Reload Plugins 应用；Open Plugins Folder 可打开插件目录。
• Plugins -> Plugin Actions：显示外部插件提供的菜单动作，例如颜色格式化。
• Plugins -> Plugin Panels：打开通用 Plugin Tools 或插件提供的原生 ADS 面板。两者都可与内置工具组合、拆分或浮动。
• Plugins -> Curve Edit Tool：启动或关闭原生曲线编辑工具，与顶部工具栏的 Curve 状态同步。
• Plugins -> Export Curve Style... / Import Curve Style...：导出或导入原生曲线的密度样式预设。
• Plugins -> Plugin Overlay Elements：控制插件叠加层显示内容，包括 Enable Overlay、Preview Notes、Control Points、Handles、Sample Points、Labels。

插件工具栏与侧栏入口

• 顶部主工具栏：Curve 启动/关闭原生曲线工具；Plugins 按钮打开插件管理器；带范围选择器的插件快捷动作会打开并聚焦 Plugin Tools GUI。
• 左侧 Plugin Shortcuts：显示外部插件提供的快捷按钮。不同插件会按分组显示，点击按钮执行对应动作。
• 右侧 Note 面板：原生曲线工具启用时显示曲线控制项。

原生曲线工具：Note Chain Assist

用途：在主画布上编辑曲线锚点与控制柄，再按指定密度生成一串真实的 Catch 普通音符。该工具完全运行在主程序内部，旧的 builtin.note_chain_assist Python 插件只保留兼容文件，不会再启动 Python 进程。

位置：

• 顶部主工具栏：Curve。
• Plugins -> Curve Edit Tool。
• 右侧 Note -> Place Anchor。
• 右侧 Note 面板中的原生曲线控制。
• 原生曲线工具启用时的画布右键菜单。
• Plugins -> Export Curve Style... / Import Curve Style...。

常用动作：

• Commit Curve → Notes：按每一段的密度将整条曲线提交为真实普通音符；已有同拍同位置音符不会重复生成。快捷键：曲线工具启用时按 Enter。
• Commit Context Segments -> Notes：在曲线段上右键，只提交右键命中的目标段；框选或已选择的段也会纳入右键目标。
• Anchor Placement：开启后左键空白处添加锚点；关闭时切换到选择模式。快捷键：曲线工具启用时按 A。
• Show Curve：显示或隐藏曲线、锚点及控制柄。
• Polyline Mode：在贝塞尔曲线和直线段之间切换；也可在目标段右键选择 Toggle Curve / Polyline。
• Snap Notes to Curve：拖动普通音符或粘贴预览时，在对应拍点将横向位置吸附到曲线；开启后自动进入选择模式。
• Select: Anchors / Select: Segments / Select: Notes：控制选择模式和框选能够命中的对象。选择音符时会按拍点和位置同步匹配最近且尚未使用的锚点。
• Connect Selected / Disconnect Selected：连接选中的锚点，或断开选中的曲线段。
• Delete Selected：删除选中的锚点或曲线段。Reset Curve 清空当前曲线工程。
• Generated Note Spacing：在曲线段右键菜单中设置提交后生成 Note 的拍点间隔。Follow Time Division 跟随右侧当前分度，也可固定为样式提供的 1/n；画布顶部只显示当前实际生效或已选曲线段的间隔，不再显示含义不清的可用分度列表。
• Export Curve Style... / Import Curve Style...：导出或导入密度分母列表等曲线样式设置。

画布操作：

• 左键拖动锚点或控制柄：移动节点/柄；锚点始终按拍点顺序组织。
• 开启 Anchor Placement 后左键空白处：在对应拍点插入锚点，并自动推断默认控制柄。
• 右键锚点：删除锚点。
• 双击锚点：切换平滑/折角状态。
• Shift + 拖动锚点到另一个锚点：连接节点。
• 选择模式下拖拽空白处：框选已启用的锚点、曲线段和音符目标。
• Esc：取消当前拖拽、连接或框选并清除曲线选择。
• Delete / Backspace：删除当前曲线选择；即使焦点位于主窗口或侧栏，主窗口级删除动作也会优先转发给已选锚点/曲线段。
• Ctrl+Z / Ctrl+Y：通过主程序统一撤销时间线撤销/重做曲线编辑和音符提交。

说明：

• 曲线工具只生成和吸附普通 note；雨音符等特殊类型不作为曲线修改对象。
• 曲线数据使用 V3 JSON sidecar，存放在谱面工作副本旁的 .mcce-plugin/*.curve_tbd.json 中；保存谱面时会与源谱面同步，切换谱面时会事务式切换工程。
• V3 sidecar 会保留曲线/节点身份、分组、连接、控制柄、形状、密度模式及扩展元数据，并兼容读取旧 Python 插件的 anchors、handle 和 links 数据。
• 曲线预览本身不会修改谱面；只有执行整曲线或目标段提交后才会生成真实音符。

BPM 辅助文件

BPM 辅助文件用于存储 BPM 测量工具相关的元数据，包括 BPM 排除时间段和歌曲 BPM 信息。

文件位置：

• BPM 排除文件：.mcce-plugin/{谱面文件名}.bpm_excludes.json
• 歌曲 BPM 文件：.mcce-plugin/{谱面文件名}.song_bpm.json

这些文件会在保存、复制、导出/导入 MCZ 时自动同步，确保 BPM 相关数据不会丢失。

ChartFileSystem 注册表

ChartFileSystem 是一个集中式文件类型管理系统，用于 MCZ 打包时决定哪些文件应该被包含。它替代了之前的硬编码白名单，支持运行时动态注册/注销文件类型。

内置文件类型包括：

• .mc：谱面文件
• 音频格式：.ogg, .oga, .mp3, .wav, .flac, .m4a, .aac, .wma, .opus, .aif, .aiff, .mka（非 Vorbis OGG 的格式在作为谱面音乐导入时会被自动转换为 .ogg；仅接受 Vorbis 编码的 Ogg 容器，Opus 等其他编码的 Ogg 文件同样会被转码）
• 图片格式：.jpg, .jpeg, .png, .bmp, .webp, .gif, .tif, .tiff, .tga（背景图导入支持集：.png, .jpg, .jpeg, .bmp, .gif，按文件内容而非扩展名识别；非 PNG/JPG 的单帧图片导入时自动无损转换为 PNG，多帧动画保留原格式并提示。.webp/.tiff/.tga 依赖 Qt Image Formats 插件：转换层会自动识别 Qt 当前可解码的格式，文件选择器过滤器亦随插件动态扩展，.tif/.tiff/.tga 已纳入 .mcz 资源收集列表）
• 视频格式：.mp4, .mkv, .avi, .webm, .mov
• Sidecar 文件：.curve_tbd.json, .bpm_excludes.json, .song_bpm.json

内置插件：Note Color Formatter

用途：整理音符颜色分度字段，让按分度上色与颜色分组逻辑更统一。适合导入旧谱、批量编辑后快速清理颜色分度。

位置：

• 顶部插件工具栏：Format Note Colors 快捷按钮。
• 启用浮动窗口时：View -> Panels -> Plugin Tools / Plugins -> Plugin Panels -> Plugin Tools；关闭时同一 GUI 嵌入 Note 右栏。
• Plugins -> Plugin Actions。

使用方法：

1. 打开谱面。
2. 点击顶部 Format Note Colors，打开并聚焦可停靠的 Plugin Tools 面板。
3. 在常驻 GUI 中选择 Selected Notes、Beat Range 或 Entire Chart；选中范围会实时显示数量。
4. 选择拍点范围时，按大范围选择器相同的 整数 分子/分母 格式填写起止点，也可用 Now 读取当前播放时间。
5. 点击面板内的 Format Note Colors 执行。只格式化普通和 Rain 音符的起点颜色分度，不修改 Sound Note；整次修改作为一个可撤销动作写入主程序历史。

Plugins -> Plugin Actions 仍保留一次性范围对话框，适合不希望常驻面板时使用。

插件使用注意

• 如果插件菜单为空，先到 Plugins -> Plugin Manager... 检查插件是否启用、是否加载成功。
• 修改插件启用状态后，需要点击 Reload Plugins 才会应用。
• 外部进程插件仍依赖对应运行环境，例如 Python 插件需要系统 PATH 中能找到 python；原生 Note Chain Assist 不受此限制。
• 插件动作可能会批量修改谱面，执行前建议先保存或确认自动保存设置。

默认快捷键速查

功能	默认快捷键	位置
打开谱面	Ctrl+O	File -> Open Chart...
打开已导入谱面	Ctrl+Shift+O	File -> Open Imported Charts...
保存	Ctrl+S	File -> Save
退出	Ctrl+Q	File -> Exit
撤销	Ctrl+Z	Edit -> Undo
重做	Ctrl+Y	Edit -> Redo
复制	Ctrl+C	Edit -> Copy / 右侧 Note -> Copy
粘贴	Ctrl+V	Edit -> Paste
删除	Delete	Edit -> Delete
播放/暂停	Space	Playback -> Play/Pause
取消当前操作	Esc	画布
缩放时间轴	Ctrl + 鼠标滚轮	画布
切换曲线锚点放置	A	原生 Note Chain Assist 工具模式
提交整条曲线	Enter	原生 Note Chain Assist 工具模式