Label Studio 快捷键完全指南查看、自定义与Shortcut标签实战【免费下载链接】label-studioLabel Studio is a multi-type data labeling and annotation tool with standardized output format项目地址: https://gitcode.com/GitHub_Trending/la/label-studioLabel Studio 提供了一套开箱即用的键盘快捷键Hotkeys帮助标注员在标注图像、文本、音频、视频与时间序列数据时减少鼠标操作、提升标注吞吐量。本指南以 docs/source/guide/hotkeys.md 为核心完整讲解如何在标注界面查看与开关快捷键、在账号页面逐项重映射、通过EDITOR_KEYMAP环境变量以 JSON 方式批量覆盖映射以及使用Shortcut标签为标注员注入预定义文本片段并深入源码揭示这些配置从前端注册到后端注入的完整链路。一、在标注编辑器中查看与开关内置快捷键打开任意项目的标注界面后点击编辑器右上角的设置settings图标即可查看全部内置快捷键的列表并可按需启用或禁用某条快捷键映射。两条跨平台使用须知如果配置中指定了enter在 Mac 键盘上应使用return配置中的backspace对应 Mac 的deletealt对应 Mac 的option。该查看/开关能力由前端快捷键注册机制支撑所有具名快捷键在运行时通过 web/libs/editor/src/core/Hotkey.ts 注册与查询并在当前操作系统下自动选择mac字段或key字段作为实际生效组合键。二、内置快捷键全量清单内置快捷键的“事实来源”是编辑器源码中的 web/libs/editor/src/core/settings/keymap.json其中每条映射形如action:id: { key: ..., mac: ..., description: ... }mac字段缺省时表示 Mac 与 Windows/Linux 共用key。以下按功能域分类整理均以该文件实际内容为准。标注提交与导航快捷键 ID按键非 Mac / Mac动作annotation:submitctrlenter/commandenter提交标注annotation:skipctrlspace/altenter跳过任务annotation:undoctrlz/commandz撤销annotation:redoctrlshiftz/commandshiftz重做region:delete-allctrlbackspace/commandbackspace删除全部区域region:unselectu取消选择区域region:exitescape退出关系模式并取消选择区域region:cyclealt.循环切换区域region:duplicatectrld/commandd复制选中区域region:deletebackspace删除选中区域segment:deletedelete删除选中区域region:focusenter聚焦第一个可聚焦区域region:relationaltr在区域间创建关系region:visibilityalth切换选中区域可见性region:visibility-allctrlh/commandh切换所有区域可见性region:lockaltl锁定选中区域region:metaaltm编辑选中区域的元数据图像工具快捷键 ID按键动作tool:moveV选择移动工具tool:rectR选择矩形标注工具tool:rect-3pointshiftR三点法绘制旋转矩形tool:ellipseO选择椭圆工具tool:polygonP选择多边形工具tool:vectorP选择矢量工具tool:key-pointK选择关键点工具tool:brushB选择笔刷工具tool:eraserE选择橡皮擦工具tool:magic-wandW智能选区魔棒tool:auto-detectM自动检测并建议区域tool:pan-imageH平移图像tool:zoom-inctrlplus/commandplus放大tool:zoom-outctrlminus/commandminus缩小tool:zoom-to-fitshift1缩放至适配整个图像tool:zoom-to-actualshift2缩放至 100% 实际尺寸tool:rotate-leftaltleft图像左旋 90°tool:rotate-rightaltright图像右旋 90°tool:increase-tool]增大工具尺寸tool:decrease-tool[减小工具尺寸image:prev/image:nextctrlleft/ctrlrightMac 用command上一张 / 下一张图片音频与媒体控制快捷键 ID按键非 Mac / Mac动作audio:playpausectrlp/commandp播放 / 暂停audio:backctrlb/commandb后退一秒audio:step-backward/audio:step-forwardalta/altd后退 / 前进一步media:playpausectrlaltspace/commandaltspace播放 / 暂停media:step-backward/media:step-forwardaltleft/altright后退 / 前进一步视频控制快捷键 ID按键非 Mac / Mac动作video:keyframe-backward/video:keyframe-forwardctrlaltleft/ctrlaltrightMac 用command上一关键帧 / 下一关键帧video:backwardaltleft后退video:forwardshiftaltright前进video:rewindshiftctrlaltleftMac 用shiftcommandaltleft跳到第一帧video:fastforwardshiftctrlaltrightMac 用shiftcommandaltright跳到最后一帧video:hop-backward/video:hop-forwardshiftaltleft/shiftaltright快速跳回 / 快进时间序列快捷键 ID按键动作ts:grow-left/ts:grow-rightleft/right向左 / 向右扩大区域ts:shrink-left/ts:shrink-rightaltleft/altright向左 / 向右缩小区域ts:grow-left-large/ts:grow-right-largeshiftleft/shiftright大步向左 / 向右扩大区域ts:shrink-left-large/ts:shrink-right-largeshiftaltleft/shiftaltright大步向左 / 向右缩小区域ts:pan-left/ts:pan-rightleft/right平移视图ts:pan-left-large/ts:pan-right-largeshiftleft/shiftright大步平移视图短语标注与分页快捷键 ID按键非 Mac / Mac动作phrases:next-phrase/phrases:previous-phrasectrldown/ctrlupMac 用command下一短语 / 上一短语phrases:next-region/phrases:previous-regionctrlleft/ctrlrightMac 用command当前短语内选择下一 / 上一区域phrases:select_all_annotatectrlshifta/commandshifta全选并标注当前短语repeater:next-page/repeater:previous-pagealtright/altleft下一页 / 上一页annotation:toggle-auto-annotationshiftalta切换自动标注三、从账号页面自定义全局快捷键除了在编辑器内逐项开关你可以在Account Settings Hotkeys页面对应文档 docs/source/guide/user_account.md 的 Hotkeys 小节为当前账号定制全局快捷键Export Hotkeys将当前自定义快捷键映射导出为 JSON 文件便于分享给其他 Label Studio 用户。Import Hotkeys粘贴 JSON 格式的自定义快捷键映射完成导入。Reset to Defaults一键将所有快捷键恢复为默认值。设置方式点击每个动作旁列出的默认快捷键在弹出提示后按下你希望使用的新组合键即可。每个快捷键可以是单个字符键数字、字母、符号也可以是字符键与多个控制键如Shift、Control、Option等的组合。从源码看账号级自定义映射以user.custom_hotkeys的形式随页面注入前端label_studio/templates/base.html 中通过var __customHotkeys {{ user.custom_hotkeys|... }}将其序列化到window.APP_SETTINGS.user.customHotkeys并与产品默认映射在运行时由前端合并生效custom_hotkeys字段定义于 label_studio/users/models.py。四、用EDITOR_KEYMAP环境变量批量覆盖映射管理员或自托管用户可以在.env文件或启动 Label Studio 时设置EDITOR_KEYMAP环境变量用一段合法的 JSON 覆盖指定动作的快捷键映射。例如将“提交标注”改为shiftsEDITOR_KEYMAP{annotation:submit:{key: shifts,description: My Custom Submit Hotkey!}}要点说明该变量覆盖同 ID 动作的现有映射JSON 中的key用于非 Mac 平台如需区分 Mac 可额外提供mac字段。该变量只能覆盖已有动作的快捷键组合不能用来删除现有快捷键也不能新增全新的快捷键动作——新增/删除动作需要在前端Hotkey注册层完成。若key与mac同时存在前端按isMacOS()自动选择mac ?? key见 web/libs/editor/src/core/Hotkey.ts。环境变量的后端注入链路从源码可以完整还原该变量的生效路径label_studio/core/settings/base.py 中定义EDITOR_KEYMAP json.dumps(get_env(EDITOR_KEYMAP))即从环境变量读取原始 JSON 字符串并转为 Django 设置项label_studio/core/settings/label_studio.py 同样引用。label_studio/core/middleware.py 在请求中间件中将其附加到request.editor_keymap。label_studio/templates/base.html 渲染时执行JSON.parse({{ settings.EDITOR_KEYMAP|safe }})把映射放进window.APP_SETTINGS.editor_keymap。前端编辑器启动时读取该映射合并进Hotkey.keymap覆盖同名动作的默认组合键。对应的前端测试 web/libs/editor/src/core/Hotkey.setKeymap.test.ts 验证了setKeymap的覆盖语义传入部分映射后annotation:submit的key变为自定义值而未被覆盖的其它动作如audio:playpause保持默认值不变。五、使用Shortcut标签为标注员注入预定义内容Shortcut是标签配置Labeling Config中的专用标签用于为标注员定义一个“快捷片段”标注员既可以直接点击快捷按钮也可以按下对应热键把预定义文本插入当前标注内容。官方文档见 docs/source/tags/shortcut.md。适用数据类型Audio、Image、HTML、Paragraphs、Text、Time series、Video。工作原理Shortcut必须嵌套在控制类标签内部如TextArea、Labels快捷方式只在控制标签内生效。参数说明参数类型默认值说明valuestring—必填快捷键插入的具体值aliasstring—快捷按钮上显示的别名hotkeystring—触发该快捷键的组合键backgroundstring#333333按钮背景色十六进制完整示例以下配置展示了一个图像描述任务标注员在图片上方的文本框中写描述时可通过点击按钮或按Ctrl1/Ctrl2快速插入 “CAR” 或 “AIRPLANE”View Image nameimage value$captioning/ Header valueDescribe the image:/ TextArea namecaption toNameimage !-- Inserts “CAR” when clicked or on Ctrl1 -- Shortcut aliasCar valueCAR hotkeyctrl1 background#333333/ !-- Inserts “AIRPLANE” when clicked or on Ctrl2 -- Shortcut aliasAirplane valueAIRPLANE hotkeyctrl2 background#FFEE00/ /TextArea /View再比如音频转写场景中为TextArea配置一个把 “SILENCE” 写入文本区的快捷按钮View TextArea nametxt-1 Shortcut aliasSilence valueSILENCE hotkeyctrl1 background#3333333 / /TextArea /View注意Shortcut的默认背景色为灰色可通过background参数以文本或十六进制格式修改。六、三种自定义方式的选型建议方式生效范围适用场景编辑器设置图标当前用户在编辑器内快速查看/开关默认快捷键Account Settings Hotkeys当前账号跨项目个人习惯定制支持导出/导入/重置EDITOR_KEYMAP环境变量服务端全局所有用户团队统一规范、部署时批量覆盖默认映射Shortcut标签单个项目的标注配置为特定任务注入预定义文本片段需要强调的能力边界前三种方式都只能覆盖keymap.json中已存在的动作无法删除或新增动作若需要全新的快捷键动作必须在前端 web/libs/editor/src/core/Hotkey.ts 的注册层扩展。而Shortcut标签提供的“插入预定义内容”能力则独立于全局快捷键系统属于标注配置层面的快捷输入两者互补使用可获得最佳的标注提速效果。【免费下载链接】label-studioLabel Studio is a multi-type data labeling and annotation tool with standardized output format项目地址: https://gitcode.com/GitHub_Trending/la/label-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Label Studio 快捷键完全指南：查看、自定义与 `＜Shortcut＞` 标签实战
Label Studio 快捷键完全指南查看、自定义与Shortcut标签实战【免费下载链接】label-studioLabel Studio is a multi-type data labeling and annotation tool with standardized output format项目地址: https://gitcode.com/GitHub_Trending/la/label-studioLabel Studio 提供了一套开箱即用的键盘快捷键Hotkeys帮助标注员在标注图像、文本、音频、视频与时间序列数据时减少鼠标操作、提升标注吞吐量。本指南以 docs/source/guide/hotkeys.md 为核心完整讲解如何在标注界面查看与开关快捷键、在账号页面逐项重映射、通过EDITOR_KEYMAP环境变量以 JSON 方式批量覆盖映射以及使用Shortcut标签为标注员注入预定义文本片段并深入源码揭示这些配置从前端注册到后端注入的完整链路。一、在标注编辑器中查看与开关内置快捷键打开任意项目的标注界面后点击编辑器右上角的设置settings图标即可查看全部内置快捷键的列表并可按需启用或禁用某条快捷键映射。两条跨平台使用须知如果配置中指定了enter在 Mac 键盘上应使用return配置中的backspace对应 Mac 的deletealt对应 Mac 的option。该查看/开关能力由前端快捷键注册机制支撑所有具名快捷键在运行时通过 web/libs/editor/src/core/Hotkey.ts 注册与查询并在当前操作系统下自动选择mac字段或key字段作为实际生效组合键。二、内置快捷键全量清单内置快捷键的“事实来源”是编辑器源码中的 web/libs/editor/src/core/settings/keymap.json其中每条映射形如action:id: { key: ..., mac: ..., description: ... }mac字段缺省时表示 Mac 与 Windows/Linux 共用key。以下按功能域分类整理均以该文件实际内容为准。标注提交与导航快捷键 ID按键非 Mac / Mac动作annotation:submitctrlenter/commandenter提交标注annotation:skipctrlspace/altenter跳过任务annotation:undoctrlz/commandz撤销annotation:redoctrlshiftz/commandshiftz重做region:delete-allctrlbackspace/commandbackspace删除全部区域region:unselectu取消选择区域region:exitescape退出关系模式并取消选择区域region:cyclealt.循环切换区域region:duplicatectrld/commandd复制选中区域region:deletebackspace删除选中区域segment:deletedelete删除选中区域region:focusenter聚焦第一个可聚焦区域region:relationaltr在区域间创建关系region:visibilityalth切换选中区域可见性region:visibility-allctrlh/commandh切换所有区域可见性region:lockaltl锁定选中区域region:metaaltm编辑选中区域的元数据图像工具快捷键 ID按键动作tool:moveV选择移动工具tool:rectR选择矩形标注工具tool:rect-3pointshiftR三点法绘制旋转矩形tool:ellipseO选择椭圆工具tool:polygonP选择多边形工具tool:vectorP选择矢量工具tool:key-pointK选择关键点工具tool:brushB选择笔刷工具tool:eraserE选择橡皮擦工具tool:magic-wandW智能选区魔棒tool:auto-detectM自动检测并建议区域tool:pan-imageH平移图像tool:zoom-inctrlplus/commandplus放大tool:zoom-outctrlminus/commandminus缩小tool:zoom-to-fitshift1缩放至适配整个图像tool:zoom-to-actualshift2缩放至 100% 实际尺寸tool:rotate-leftaltleft图像左旋 90°tool:rotate-rightaltright图像右旋 90°tool:increase-tool]增大工具尺寸tool:decrease-tool[减小工具尺寸image:prev/image:nextctrlleft/ctrlrightMac 用command上一张 / 下一张图片音频与媒体控制快捷键 ID按键非 Mac / Mac动作audio:playpausectrlp/commandp播放 / 暂停audio:backctrlb/commandb后退一秒audio:step-backward/audio:step-forwardalta/altd后退 / 前进一步media:playpausectrlaltspace/commandaltspace播放 / 暂停media:step-backward/media:step-forwardaltleft/altright后退 / 前进一步视频控制快捷键 ID按键非 Mac / Mac动作video:keyframe-backward/video:keyframe-forwardctrlaltleft/ctrlaltrightMac 用command上一关键帧 / 下一关键帧video:backwardaltleft后退video:forwardshiftaltright前进video:rewindshiftctrlaltleftMac 用shiftcommandaltleft跳到第一帧video:fastforwardshiftctrlaltrightMac 用shiftcommandaltright跳到最后一帧video:hop-backward/video:hop-forwardshiftaltleft/shiftaltright快速跳回 / 快进时间序列快捷键 ID按键动作ts:grow-left/ts:grow-rightleft/right向左 / 向右扩大区域ts:shrink-left/ts:shrink-rightaltleft/altright向左 / 向右缩小区域ts:grow-left-large/ts:grow-right-largeshiftleft/shiftright大步向左 / 向右扩大区域ts:shrink-left-large/ts:shrink-right-largeshiftaltleft/shiftaltright大步向左 / 向右缩小区域ts:pan-left/ts:pan-rightleft/right平移视图ts:pan-left-large/ts:pan-right-largeshiftleft/shiftright大步平移视图短语标注与分页快捷键 ID按键非 Mac / Mac动作phrases:next-phrase/phrases:previous-phrasectrldown/ctrlupMac 用command下一短语 / 上一短语phrases:next-region/phrases:previous-regionctrlleft/ctrlrightMac 用command当前短语内选择下一 / 上一区域phrases:select_all_annotatectrlshifta/commandshifta全选并标注当前短语repeater:next-page/repeater:previous-pagealtright/altleft下一页 / 上一页annotation:toggle-auto-annotationshiftalta切换自动标注三、从账号页面自定义全局快捷键除了在编辑器内逐项开关你可以在Account Settings Hotkeys页面对应文档 docs/source/guide/user_account.md 的 Hotkeys 小节为当前账号定制全局快捷键Export Hotkeys将当前自定义快捷键映射导出为 JSON 文件便于分享给其他 Label Studio 用户。Import Hotkeys粘贴 JSON 格式的自定义快捷键映射完成导入。Reset to Defaults一键将所有快捷键恢复为默认值。设置方式点击每个动作旁列出的默认快捷键在弹出提示后按下你希望使用的新组合键即可。每个快捷键可以是单个字符键数字、字母、符号也可以是字符键与多个控制键如Shift、Control、Option等的组合。从源码看账号级自定义映射以user.custom_hotkeys的形式随页面注入前端label_studio/templates/base.html 中通过var __customHotkeys {{ user.custom_hotkeys|... }}将其序列化到window.APP_SETTINGS.user.customHotkeys并与产品默认映射在运行时由前端合并生效custom_hotkeys字段定义于 label_studio/users/models.py。四、用EDITOR_KEYMAP环境变量批量覆盖映射管理员或自托管用户可以在.env文件或启动 Label Studio 时设置EDITOR_KEYMAP环境变量用一段合法的 JSON 覆盖指定动作的快捷键映射。例如将“提交标注”改为shiftsEDITOR_KEYMAP{annotation:submit:{key: shifts,description: My Custom Submit Hotkey!}}要点说明该变量覆盖同 ID 动作的现有映射JSON 中的key用于非 Mac 平台如需区分 Mac 可额外提供mac字段。该变量只能覆盖已有动作的快捷键组合不能用来删除现有快捷键也不能新增全新的快捷键动作——新增/删除动作需要在前端Hotkey注册层完成。若key与mac同时存在前端按isMacOS()自动选择mac ?? key见 web/libs/editor/src/core/Hotkey.ts。环境变量的后端注入链路从源码可以完整还原该变量的生效路径label_studio/core/settings/base.py 中定义EDITOR_KEYMAP json.dumps(get_env(EDITOR_KEYMAP))即从环境变量读取原始 JSON 字符串并转为 Django 设置项label_studio/core/settings/label_studio.py 同样引用。label_studio/core/middleware.py 在请求中间件中将其附加到request.editor_keymap。label_studio/templates/base.html 渲染时执行JSON.parse({{ settings.EDITOR_KEYMAP|safe }})把映射放进window.APP_SETTINGS.editor_keymap。前端编辑器启动时读取该映射合并进Hotkey.keymap覆盖同名动作的默认组合键。对应的前端测试 web/libs/editor/src/core/Hotkey.setKeymap.test.ts 验证了setKeymap的覆盖语义传入部分映射后annotation:submit的key变为自定义值而未被覆盖的其它动作如audio:playpause保持默认值不变。五、使用Shortcut标签为标注员注入预定义内容Shortcut是标签配置Labeling Config中的专用标签用于为标注员定义一个“快捷片段”标注员既可以直接点击快捷按钮也可以按下对应热键把预定义文本插入当前标注内容。官方文档见 docs/source/tags/shortcut.md。适用数据类型Audio、Image、HTML、Paragraphs、Text、Time series、Video。工作原理Shortcut必须嵌套在控制类标签内部如TextArea、Labels快捷方式只在控制标签内生效。参数说明参数类型默认值说明valuestring—必填快捷键插入的具体值aliasstring—快捷按钮上显示的别名hotkeystring—触发该快捷键的组合键backgroundstring#333333按钮背景色十六进制完整示例以下配置展示了一个图像描述任务标注员在图片上方的文本框中写描述时可通过点击按钮或按Ctrl1/Ctrl2快速插入 “CAR” 或 “AIRPLANE”View Image nameimage value$captioning/ Header valueDescribe the image:/ TextArea namecaption toNameimage !-- Inserts “CAR” when clicked or on Ctrl1 -- Shortcut aliasCar valueCAR hotkeyctrl1 background#333333/ !-- Inserts “AIRPLANE” when clicked or on Ctrl2 -- Shortcut aliasAirplane valueAIRPLANE hotkeyctrl2 background#FFEE00/ /TextArea /View再比如音频转写场景中为TextArea配置一个把 “SILENCE” 写入文本区的快捷按钮View TextArea nametxt-1 Shortcut aliasSilence valueSILENCE hotkeyctrl1 background#3333333 / /TextArea /View注意Shortcut的默认背景色为灰色可通过background参数以文本或十六进制格式修改。六、三种自定义方式的选型建议方式生效范围适用场景编辑器设置图标当前用户在编辑器内快速查看/开关默认快捷键Account Settings Hotkeys当前账号跨项目个人习惯定制支持导出/导入/重置EDITOR_KEYMAP环境变量服务端全局所有用户团队统一规范、部署时批量覆盖默认映射Shortcut标签单个项目的标注配置为特定任务注入预定义文本片段需要强调的能力边界前三种方式都只能覆盖keymap.json中已存在的动作无法删除或新增动作若需要全新的快捷键动作必须在前端 web/libs/editor/src/core/Hotkey.ts 的注册层扩展。而Shortcut标签提供的“插入预定义内容”能力则独立于全局快捷键系统属于标注配置层面的快捷输入两者互补使用可获得最佳的标注提速效果。【免费下载链接】label-studioLabel Studio is a multi-type data labeling and annotation tool with standardized output format项目地址: https://gitcode.com/GitHub_Trending/la/label-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考