CVAT 音频标注工作区 Tooltip 快捷键修复与快捷键体系深度解析【免费下载链接】cvatComputer Vision Annotation Tool (CVAT) is a leading platform for building high-quality visual datasets for vision AI. It offers open-source, cloud, and enterprise products, as well as labeling services, for image, video, and 3D annotation with AI-assisted labeling, quality assurance, team collaboration, analytics, and developer APIs.项目地址: https://gitcode.com/GitHub_Trending/cvat/cvat导读本文围绕 CVATComputer Vision Annotation Tool变更记录中的一条修复条目展开音频标注工作区Audio Workspace中各个控件悬浮提示Tooltip此前显示的是写死的快捷键文本与实际生效的快捷键不一致本次修复让 Tooltip 直接读取当前生效的快捷键映射确保提示与真实行为始终同步。文章将从变更记录出发结合 cvat-ui/src/audio 下的组件源码梳理 CVAT 音频工作区的完整快捷键注册、归一化与展示链路并给出全部默认快捷键清单帮助标注人员与二次开发者理解并自定义音频标注快捷键。变更记录解读修了什么为什么重要本次变更记录位于 changelog.d/20260826_124341_aleksey.zinovyev_fix_audio_tooltips_shortcuts.md内容仅一条Fixed— Fixed audio control tooltips to show actual shortcuts.修复音频控件 Tooltip 显示实际快捷键的问题其问题本质是CVAT 允许用户在快捷键设置对话框中自定义任意快捷键包括与音频相关的快捷键。如果控件 Tooltip 中拼接的是源码里写死的默认序列如d、f那么一旦用户把AUDIO_FORWARD从f改成其他按键悬浮提示仍会显示旧的f造成提示与行为不一致的误导。本次修复的要点就是让 Tooltip 的文案来自 Redux 中实时维护的normalizedKeyMap而非硬编码字符串。从仓库源码可以确认该修复的落地方式顶栏容器 audio-top-bar.tsx 在渲染组件时从state.shortcuts.normalizedKeyMap中取出PLAY_PAUSE_AUDIO、AUDIO_BACKWARD、AUDIO_FORWARD、AUDIO_FAST_BACKWARD、AUDIO_FAST_FORWARD、AUDIO_UNDO、AUDIO_REDO等归一化后的快捷键字符串通过 props 传给底层组件底层组件再把这些字符串拼进CVATTooltip的title中。侧边栏组件如 controls-side-bar.tsx也以同样方式把CANCEL_AUDIO、CREATE_AUDIO_REGION、RECORD_AUDIO_REGION、EXTEND_AUDIO_REGION_FROM_LAST、SPLIT_AUDIO_INTERVAL_AT_PLAYBACK_POSITION、TOGGLE_AUDIO_LOOP等归一化快捷键传入各控件。因此无论用户如何自定义快捷键Tooltip 都会显示实际生效的组合。CVAT 快捷键体系从注册到展示的完整链路要理解这次修复需要先掌握 CVAT 前端快捷键从定义到显示的完整数据流。它由三个核心环节组成1. 组件级快捷键注册registerComponentShortcuts每个音频组件在自己文件内定义一个componentShortcuts对象字段结构遵循 mousetrap-react.tsx 中的KeyMapItem接口interface KeyMapItem { name: string; // 快捷键名称用于设置界面展示 description: string; // 功能描述 sequences: string[]; // 绑定的按键序列默认值 displayedSequences?: string[]; // 可选自定义展示序列 scope: ShortcutScope; // 生效作用域 nonActive?: boolean; applicable?: string[]; displayWeight?: number; }随后通过registerComponentShortcuts(componentShortcuts)把定义注入全局快捷键仓库。例如播放导航组件 audio-player-navigation.tsx 注册了五个快捷键PLAY_PAUSE_AUDIOspace、AUDIO_BACKWARDd、AUDIO_FORWARDf、AUDIO_FAST_BACKWARDc、AUDIO_FAST_FORWARDv作用域均为ShortcutScope.AUDIO_WORKSPACE_CONTROLS。2. 全局按键绑定GlobalHotKeys Mousetrap组件内部通过GlobalHotKeys组件将subKeyMap(componentShortcuts, keyMap)与处理函数交给 Mousetrap 绑定。从 mousetrap-react.tsx 的实现可见GlobalHotKeys在useEffect中遍历keyMap对每个sequences调用Mousetrap.bind并在组件卸载时unbind同时把定义写进模块级applicationKeyMap供全局查询用getApplicationKeyMap()可读取。值得注意的细节是Mousetrap.prototype.stopCallback当焦点位于input、select、textarea时快捷键不触发当有 Modal 打开时除SWITCH_SHORTCUTS、SWITCH_SETTINGS外的快捷键都会被屏蔽避免干扰弹窗交互。subKeyMap的作用是继承用户自定义它以组件默认的componentShortcuts为骨架用 Redux 中已注册的keyMap用户可能已修改序列覆盖同名项从而保证绑定的是用户配置后的实际按键。这正是Tooltip 显示实际快捷键与按键实际生效两者一致的前提——它们都源自同一份keyMap。3. 归一化展示normalizedKeyMapRedux 侧由 shortcuts-reducer.ts 维护normalizedKeyMap。每当有快捷键注册REGISTER_SHORTCUTS或用户更新序列UPDATE_SEQUENCE时reducer 都会调用formatShortcuts把原始序列如ctrlshiftz格式化为适合界面展示的字符串如CtrlShiftZfunction formatShortcuts(shortcuts: KeyMapItem): string { const list: string[] shortcuts.displayedSequences || (shortcuts.sequences as string[]); ... return [${list.map((shortcut) { // 拆分 、逐键首字母大写、arrowleft 等特殊键转为 Arrow Left }).join(, )}]; }同时mousetrap-react.tsx 定义了KeyMapItem中的displayedSequences可选字段——当默认序列不便直接展示时可以单独指定展示文本。conflictDetector见 shortcuts-reducer.ts还会在用户修改快捷键时检测冲突保证同一序列不会被多个功能同时占用。修复后的 Tooltip 展示链路为用户自定义序列 → ReduxkeyMap更新 → reducer 重新归一化normalizedKeyMap→ 容器组件读取并下发给控件 →CVATTooltip渲染实际快捷键。修复落地Tooltip 中的快捷键来自哪里下面以几个代表性控件为例说明修复后 Tooltip 的具体取数方式。播放导航按钮audio-player-navigation.tsx 中SeekButton结构体可携带shortcut字段指向 props 中的backwardShortcut、forwardShortcut、fastBackwardShortcut、fastForwardShortcut之一渲染时拼接为CVATTooltip title{${tooltip} ${shortcutValue}}。例如Short step backward的 Tooltip 会显示为Short step backward [D]若用户未修改默认键。这些 props 值来自容器 audio-top-bar.tsx 中读取的normalizedKeyMap.AUDIO_BACKWARD等字段。播放/暂停按钮同一文件 audio-player-navigation.tsx 将playPauseShortcut来自normalizedKeyMap.PLAY_PAUSE_AUDIO拼入Play ${playPauseShortcut}/Pause ${playPauseShortcut}。因此即使播放/暂停被改成其他按键悬浮提示也会同步变化。撤销/重做按钮audio-left-group.tsx 中CVATTooltip overlay{Undo: ${undoAction} ${undoShortcut}} ... CVATTooltip overlay{Redo: ${redoAction} ${redoShortcut}}其中undoShortcut/redoShortcut来自容器中normalizedKeyMap.AUDIO_UNDO ?? normalizedKeyMap.UNDO、normalizedKeyMap.AUDIO_REDO ?? normalizedKeyMap.REDO见 audio-top-bar.tsx——即音频专用快捷键优先回退到通用撤销/重做快捷键。光标与区间工具cursor-control.tsxCVATTooltip title{Cursor ${cursorShortkey}}其中cursorShortkey normalizedKeyMap.CANCEL_AUDIO。interval-region-control.tsxrenderAction统一把描述与快捷键拼接为CVATTooltip title{${description} ${shortcut}}三个动作按钮Draw / Record / Extend分别使用createRegionShortkey、recordRegionShortkey、extendRegionShortkey。loop-control.tsxCVATTooltip title{Loop interval playback${loop ? (on) : } ${loopShortcut}}。正是这些组件此前普遍使用组件内componentShortcuts的默认sequences拼接 Tooltip才会在用户自定义快捷键后出现提示失实修复后统一改为读取归一化映射问题随之消除。音频工作区默认快捷键完整清单以下快捷键默认值均取自当前仓库源码作用域为ShortcutScope.AUDIO_WORKSPACE_CONTROLS音频工作区控件或ShortcutScope.OBJECTS_SIDEBAR对象侧边栏。用户可在 CVAT 的快捷键设置对话框中修改任意一项修改后 Tooltip 与行为同步更新。顶栏播放控制audio-player-navigation.tsx快捷键 ID默认按键功能PLAY_PAUSE_AUDIOspace播放/暂停音频AUDIO_BACKWARDd短步进后退AUDIO_FORWARDf短步进前进AUDIO_FAST_BACKWARDc长步进后退AUDIO_FAST_FORWARDv长步进前进短/长步进的意图定义见同一文件的AUDIO_SEEK_INTENTS常量kind: stepsize: short | long具体步长由播放器实现决定播放器还支持直接跳转到音频起点/终点对应Jump to start / Jump to end按钮无默认快捷键。顶栏撤销/重做与保存audio-left-group.tsx、audio-save-annotations-button.tsx快捷键 ID默认按键功能AUDIO_UNDOctrlz撤销最近一次音频区间操作AUDIO_REDOctrlshiftz、ctrly重做被撤销的操作SAVE_ANNOTATIONSctrls保存音频标注侧边栏工具interval-region-control.tsx、cursor-control.tsx、loop-control.tsx、split-at-playhead-control.tsx快捷键 ID默认按键功能CANCEL_AUDIOesc取消当前激活的音频工具模式回到光标CREATE_AUDIO_REGIONn进入区间创建模式在波形上拖拽生成区间RECORD_AUDIO_REGIONshiftn切换实时录音式区间录制首次按下在当前位置标记起点再次按下或暂停结束EXTEND_AUDIO_REGION_FROM_LASTshifte从最近一个区间末尾无则从音频起点延伸到当前播放位置创建新区间TOGGLE_AUDIO_LOOPr切换活动音频区间的循环播放SPLIT_AUDIO_INTERVAL_AT_PLAYBACK_POSITIONaltm在当前位置拆分音频区间区间列表侧边栏audio-regions-list.tsx快捷键 ID默认按键功能AUDIO_SWITCH_ALL_LOCKt l锁定/解锁侧边栏全部区间AUDIO_SWITCH_LOCKl锁定/解锁当前活动区间AUDIO_SWITCH_ALL_PINNEDt p固定/取消固定全部未锁定区间AUDIO_SWITCH_PINNEDp固定/取消固定当前活动区间AUDIO_SWITCH_ALL_HIDDENt h隐藏/显示全部区间AUDIO_SWITCH_HIDDENh隐藏/显示当前活动区间AUDIO_DELETE_REGIONdel/shiftdel删除活动区间shift强制删除已锁定区间AUDIO_SET_PLAYBACK_TO_INTERVAL_STARTshiftd将播放位置定位到区间起点不改变播放状态AUDIO_SET_PLAYBACK_TO_INTERVAL_ENDshiftf将播放位置定位到区间终点不改变播放状态AUDIO_PLAY_INTERVAL_ONCEshiftspace将活动区间作为播放范围播放一次AUDIO_FIT_INTERVALi将活动区间适配进波形视口区间导航与编辑辅助use-interval-navigation.tstab/shifttab用于在区间列表间切换焦点配合区间上下文菜单操作。区间详情面板audio-region-details.tsx同样通过normalizedKeyMap读取AUDIO_SET_PLAYBACK_TO_INTERVAL_START、AUDIO_PLAY_INTERVAL_ONCE、AUDIO_SET_PLAYBACK_TO_INTERVAL_END、AUDIO_SWITCH_LOCK、AUDIO_SWITCH_PINNED、AUDIO_SWITCH_HIDDEN保证详情面板与侧边栏的提示一致。作用域与防冲突机制为什么自定义不会乱套音频快捷键全部声明了明确的作用域。ShortcutScope.AUDIO_WORKSPACE_CONTROLS限定的快捷键只有在音频工作区Workspace.AUDIO激活时才会执行——例如 audio-player-navigation.tsx 的处理器开头都会判断workspace Workspace.AUDIO后才调用播放/跳转逻辑避免在图像标注工作区误触。区间列表的快捷键则使用ShortcutScope.OBJECTS_SIDEBAR仅在对象侧边栏可见时生效。用户在快捷键设置中修改序列时conflict-detector 会检查新序列是否与其他已注册快捷键冲突一旦冲突冲突方会被一并更新见UPDATE_SEQUENCE分支中conflictingShortcuts的合并逻辑normalizedKeyMap也随之重新归一化。这套机制保证自定义、冲突检测、Tooltip 展示三者的数据源始终统一这正是本次显示实际快捷键修复能够长期有效的架构基础。总结本次 changelog 修复虽小却触及 CVAT 前端快捷键体系的要害任何面向用户的快捷键提示都必须来自运行时数据normalizedKeyMap而非组件内写死的默认序列。通过 shortcuts-reducer.ts 的归一化、GlobalHotKeys的全局绑定、registerComponentShortcuts的组件注册以及容器组件向CVATTooltip的 props 传递CVAT 音频工作区的每个按钮提示都能准确反映用户当前的自定义配置。对于标注人员这意味着可以放心修改快捷键而不用担心界面提示误导对于二次开发者本文给出的源码路径与快捷键清单则是理解并扩展音频标注交互的可靠起点。【免费下载链接】cvatComputer Vision Annotation Tool (CVAT) is a leading platform for building high-quality visual datasets for vision AI. It offers open-source, cloud, and enterprise products, as well as labeling services, for image, video, and 3D annotation with AI-assisted labeling, quality assurance, team collaboration, analytics, and developer APIs.项目地址: https://gitcode.com/GitHub_Trending/cvat/cvat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
CVAT 音频标注工作区 Tooltip 快捷键修复与快捷键体系深度解析
CVAT 音频标注工作区 Tooltip 快捷键修复与快捷键体系深度解析【免费下载链接】cvatComputer Vision Annotation Tool (CVAT) is a leading platform for building high-quality visual datasets for vision AI. It offers open-source, cloud, and enterprise products, as well as labeling services, for image, video, and 3D annotation with AI-assisted labeling, quality assurance, team collaboration, analytics, and developer APIs.项目地址: https://gitcode.com/GitHub_Trending/cvat/cvat导读本文围绕 CVATComputer Vision Annotation Tool变更记录中的一条修复条目展开音频标注工作区Audio Workspace中各个控件悬浮提示Tooltip此前显示的是写死的快捷键文本与实际生效的快捷键不一致本次修复让 Tooltip 直接读取当前生效的快捷键映射确保提示与真实行为始终同步。文章将从变更记录出发结合 cvat-ui/src/audio 下的组件源码梳理 CVAT 音频工作区的完整快捷键注册、归一化与展示链路并给出全部默认快捷键清单帮助标注人员与二次开发者理解并自定义音频标注快捷键。变更记录解读修了什么为什么重要本次变更记录位于 changelog.d/20260826_124341_aleksey.zinovyev_fix_audio_tooltips_shortcuts.md内容仅一条Fixed— Fixed audio control tooltips to show actual shortcuts.修复音频控件 Tooltip 显示实际快捷键的问题其问题本质是CVAT 允许用户在快捷键设置对话框中自定义任意快捷键包括与音频相关的快捷键。如果控件 Tooltip 中拼接的是源码里写死的默认序列如d、f那么一旦用户把AUDIO_FORWARD从f改成其他按键悬浮提示仍会显示旧的f造成提示与行为不一致的误导。本次修复的要点就是让 Tooltip 的文案来自 Redux 中实时维护的normalizedKeyMap而非硬编码字符串。从仓库源码可以确认该修复的落地方式顶栏容器 audio-top-bar.tsx 在渲染组件时从state.shortcuts.normalizedKeyMap中取出PLAY_PAUSE_AUDIO、AUDIO_BACKWARD、AUDIO_FORWARD、AUDIO_FAST_BACKWARD、AUDIO_FAST_FORWARD、AUDIO_UNDO、AUDIO_REDO等归一化后的快捷键字符串通过 props 传给底层组件底层组件再把这些字符串拼进CVATTooltip的title中。侧边栏组件如 controls-side-bar.tsx也以同样方式把CANCEL_AUDIO、CREATE_AUDIO_REGION、RECORD_AUDIO_REGION、EXTEND_AUDIO_REGION_FROM_LAST、SPLIT_AUDIO_INTERVAL_AT_PLAYBACK_POSITION、TOGGLE_AUDIO_LOOP等归一化快捷键传入各控件。因此无论用户如何自定义快捷键Tooltip 都会显示实际生效的组合。CVAT 快捷键体系从注册到展示的完整链路要理解这次修复需要先掌握 CVAT 前端快捷键从定义到显示的完整数据流。它由三个核心环节组成1. 组件级快捷键注册registerComponentShortcuts每个音频组件在自己文件内定义一个componentShortcuts对象字段结构遵循 mousetrap-react.tsx 中的KeyMapItem接口interface KeyMapItem { name: string; // 快捷键名称用于设置界面展示 description: string; // 功能描述 sequences: string[]; // 绑定的按键序列默认值 displayedSequences?: string[]; // 可选自定义展示序列 scope: ShortcutScope; // 生效作用域 nonActive?: boolean; applicable?: string[]; displayWeight?: number; }随后通过registerComponentShortcuts(componentShortcuts)把定义注入全局快捷键仓库。例如播放导航组件 audio-player-navigation.tsx 注册了五个快捷键PLAY_PAUSE_AUDIOspace、AUDIO_BACKWARDd、AUDIO_FORWARDf、AUDIO_FAST_BACKWARDc、AUDIO_FAST_FORWARDv作用域均为ShortcutScope.AUDIO_WORKSPACE_CONTROLS。2. 全局按键绑定GlobalHotKeys Mousetrap组件内部通过GlobalHotKeys组件将subKeyMap(componentShortcuts, keyMap)与处理函数交给 Mousetrap 绑定。从 mousetrap-react.tsx 的实现可见GlobalHotKeys在useEffect中遍历keyMap对每个sequences调用Mousetrap.bind并在组件卸载时unbind同时把定义写进模块级applicationKeyMap供全局查询用getApplicationKeyMap()可读取。值得注意的细节是Mousetrap.prototype.stopCallback当焦点位于input、select、textarea时快捷键不触发当有 Modal 打开时除SWITCH_SHORTCUTS、SWITCH_SETTINGS外的快捷键都会被屏蔽避免干扰弹窗交互。subKeyMap的作用是继承用户自定义它以组件默认的componentShortcuts为骨架用 Redux 中已注册的keyMap用户可能已修改序列覆盖同名项从而保证绑定的是用户配置后的实际按键。这正是Tooltip 显示实际快捷键与按键实际生效两者一致的前提——它们都源自同一份keyMap。3. 归一化展示normalizedKeyMapRedux 侧由 shortcuts-reducer.ts 维护normalizedKeyMap。每当有快捷键注册REGISTER_SHORTCUTS或用户更新序列UPDATE_SEQUENCE时reducer 都会调用formatShortcuts把原始序列如ctrlshiftz格式化为适合界面展示的字符串如CtrlShiftZfunction formatShortcuts(shortcuts: KeyMapItem): string { const list: string[] shortcuts.displayedSequences || (shortcuts.sequences as string[]); ... return [${list.map((shortcut) { // 拆分 、逐键首字母大写、arrowleft 等特殊键转为 Arrow Left }).join(, )}]; }同时mousetrap-react.tsx 定义了KeyMapItem中的displayedSequences可选字段——当默认序列不便直接展示时可以单独指定展示文本。conflictDetector见 shortcuts-reducer.ts还会在用户修改快捷键时检测冲突保证同一序列不会被多个功能同时占用。修复后的 Tooltip 展示链路为用户自定义序列 → ReduxkeyMap更新 → reducer 重新归一化normalizedKeyMap→ 容器组件读取并下发给控件 →CVATTooltip渲染实际快捷键。修复落地Tooltip 中的快捷键来自哪里下面以几个代表性控件为例说明修复后 Tooltip 的具体取数方式。播放导航按钮audio-player-navigation.tsx 中SeekButton结构体可携带shortcut字段指向 props 中的backwardShortcut、forwardShortcut、fastBackwardShortcut、fastForwardShortcut之一渲染时拼接为CVATTooltip title{${tooltip} ${shortcutValue}}。例如Short step backward的 Tooltip 会显示为Short step backward [D]若用户未修改默认键。这些 props 值来自容器 audio-top-bar.tsx 中读取的normalizedKeyMap.AUDIO_BACKWARD等字段。播放/暂停按钮同一文件 audio-player-navigation.tsx 将playPauseShortcut来自normalizedKeyMap.PLAY_PAUSE_AUDIO拼入Play ${playPauseShortcut}/Pause ${playPauseShortcut}。因此即使播放/暂停被改成其他按键悬浮提示也会同步变化。撤销/重做按钮audio-left-group.tsx 中CVATTooltip overlay{Undo: ${undoAction} ${undoShortcut}} ... CVATTooltip overlay{Redo: ${redoAction} ${redoShortcut}}其中undoShortcut/redoShortcut来自容器中normalizedKeyMap.AUDIO_UNDO ?? normalizedKeyMap.UNDO、normalizedKeyMap.AUDIO_REDO ?? normalizedKeyMap.REDO见 audio-top-bar.tsx——即音频专用快捷键优先回退到通用撤销/重做快捷键。光标与区间工具cursor-control.tsxCVATTooltip title{Cursor ${cursorShortkey}}其中cursorShortkey normalizedKeyMap.CANCEL_AUDIO。interval-region-control.tsxrenderAction统一把描述与快捷键拼接为CVATTooltip title{${description} ${shortcut}}三个动作按钮Draw / Record / Extend分别使用createRegionShortkey、recordRegionShortkey、extendRegionShortkey。loop-control.tsxCVATTooltip title{Loop interval playback${loop ? (on) : } ${loopShortcut}}。正是这些组件此前普遍使用组件内componentShortcuts的默认sequences拼接 Tooltip才会在用户自定义快捷键后出现提示失实修复后统一改为读取归一化映射问题随之消除。音频工作区默认快捷键完整清单以下快捷键默认值均取自当前仓库源码作用域为ShortcutScope.AUDIO_WORKSPACE_CONTROLS音频工作区控件或ShortcutScope.OBJECTS_SIDEBAR对象侧边栏。用户可在 CVAT 的快捷键设置对话框中修改任意一项修改后 Tooltip 与行为同步更新。顶栏播放控制audio-player-navigation.tsx快捷键 ID默认按键功能PLAY_PAUSE_AUDIOspace播放/暂停音频AUDIO_BACKWARDd短步进后退AUDIO_FORWARDf短步进前进AUDIO_FAST_BACKWARDc长步进后退AUDIO_FAST_FORWARDv长步进前进短/长步进的意图定义见同一文件的AUDIO_SEEK_INTENTS常量kind: stepsize: short | long具体步长由播放器实现决定播放器还支持直接跳转到音频起点/终点对应Jump to start / Jump to end按钮无默认快捷键。顶栏撤销/重做与保存audio-left-group.tsx、audio-save-annotations-button.tsx快捷键 ID默认按键功能AUDIO_UNDOctrlz撤销最近一次音频区间操作AUDIO_REDOctrlshiftz、ctrly重做被撤销的操作SAVE_ANNOTATIONSctrls保存音频标注侧边栏工具interval-region-control.tsx、cursor-control.tsx、loop-control.tsx、split-at-playhead-control.tsx快捷键 ID默认按键功能CANCEL_AUDIOesc取消当前激活的音频工具模式回到光标CREATE_AUDIO_REGIONn进入区间创建模式在波形上拖拽生成区间RECORD_AUDIO_REGIONshiftn切换实时录音式区间录制首次按下在当前位置标记起点再次按下或暂停结束EXTEND_AUDIO_REGION_FROM_LASTshifte从最近一个区间末尾无则从音频起点延伸到当前播放位置创建新区间TOGGLE_AUDIO_LOOPr切换活动音频区间的循环播放SPLIT_AUDIO_INTERVAL_AT_PLAYBACK_POSITIONaltm在当前位置拆分音频区间区间列表侧边栏audio-regions-list.tsx快捷键 ID默认按键功能AUDIO_SWITCH_ALL_LOCKt l锁定/解锁侧边栏全部区间AUDIO_SWITCH_LOCKl锁定/解锁当前活动区间AUDIO_SWITCH_ALL_PINNEDt p固定/取消固定全部未锁定区间AUDIO_SWITCH_PINNEDp固定/取消固定当前活动区间AUDIO_SWITCH_ALL_HIDDENt h隐藏/显示全部区间AUDIO_SWITCH_HIDDENh隐藏/显示当前活动区间AUDIO_DELETE_REGIONdel/shiftdel删除活动区间shift强制删除已锁定区间AUDIO_SET_PLAYBACK_TO_INTERVAL_STARTshiftd将播放位置定位到区间起点不改变播放状态AUDIO_SET_PLAYBACK_TO_INTERVAL_ENDshiftf将播放位置定位到区间终点不改变播放状态AUDIO_PLAY_INTERVAL_ONCEshiftspace将活动区间作为播放范围播放一次AUDIO_FIT_INTERVALi将活动区间适配进波形视口区间导航与编辑辅助use-interval-navigation.tstab/shifttab用于在区间列表间切换焦点配合区间上下文菜单操作。区间详情面板audio-region-details.tsx同样通过normalizedKeyMap读取AUDIO_SET_PLAYBACK_TO_INTERVAL_START、AUDIO_PLAY_INTERVAL_ONCE、AUDIO_SET_PLAYBACK_TO_INTERVAL_END、AUDIO_SWITCH_LOCK、AUDIO_SWITCH_PINNED、AUDIO_SWITCH_HIDDEN保证详情面板与侧边栏的提示一致。作用域与防冲突机制为什么自定义不会乱套音频快捷键全部声明了明确的作用域。ShortcutScope.AUDIO_WORKSPACE_CONTROLS限定的快捷键只有在音频工作区Workspace.AUDIO激活时才会执行——例如 audio-player-navigation.tsx 的处理器开头都会判断workspace Workspace.AUDIO后才调用播放/跳转逻辑避免在图像标注工作区误触。区间列表的快捷键则使用ShortcutScope.OBJECTS_SIDEBAR仅在对象侧边栏可见时生效。用户在快捷键设置中修改序列时conflict-detector 会检查新序列是否与其他已注册快捷键冲突一旦冲突冲突方会被一并更新见UPDATE_SEQUENCE分支中conflictingShortcuts的合并逻辑normalizedKeyMap也随之重新归一化。这套机制保证自定义、冲突检测、Tooltip 展示三者的数据源始终统一这正是本次显示实际快捷键修复能够长期有效的架构基础。总结本次 changelog 修复虽小却触及 CVAT 前端快捷键体系的要害任何面向用户的快捷键提示都必须来自运行时数据normalizedKeyMap而非组件内写死的默认序列。通过 shortcuts-reducer.ts 的归一化、GlobalHotKeys的全局绑定、registerComponentShortcuts的组件注册以及容器组件向CVATTooltip的 props 传递CVAT 音频工作区的每个按钮提示都能准确反映用户当前的自定义配置。对于标注人员这意味着可以放心修改快捷键而不用担心界面提示误导对于二次开发者本文给出的源码路径与快捷键清单则是理解并扩展音频标注交互的可靠起点。【免费下载链接】cvatComputer Vision Annotation Tool (CVAT) is a leading platform for building high-quality visual datasets for vision AI. It offers open-source, cloud, and enterprise products, as well as labeling services, for image, video, and 3D annotation with AI-assisted labeling, quality assurance, team collaboration, analytics, and developer APIs.项目地址: https://gitcode.com/GitHub_Trending/cvat/cvat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
