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-studio

Label Studio 提供了一套开箱即用的键盘快捷键（Hotkeys），帮助标注员在标注图像、文本、音频、视频与时间序列数据时减少鼠标操作、提升标注吞吐量。本指南以 docs/source/guide/hotkeys.md 为核心，完整讲解如何在标注界面查看与开关快捷键、在账号页面逐项重映射、通过EDITOR_KEYMAP环境变量以 JSON 方式批量覆盖映射，以及使用<Shortcut>标签为标注员注入预定义文本片段，并深入源码揭示这些配置从前端注册到后端注入的完整链路。

一、在标注编辑器中查看与开关内置快捷键

打开任意项目的标注界面后，点击编辑器右上角的设置（settings）图标，即可查看全部内置快捷键的列表，并可按需启用或禁用某条快捷键映射。

两条跨平台使用须知：

• 如果配置中指定了enter，在 Mac 键盘上应使用return；配置中的backspace对应 Mac 的delete，alt对应 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。以下按功能域分类整理（均以该文件实际内容为准）。

标注提交与导航

图像工具

音频与媒体控制

视频控制

时间序列

短语标注与分页

三、从账号页面自定义全局快捷键

除了在编辑器内逐项开关，你可以在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 覆盖指定动作的快捷键映射。例如将“提交标注”改为shift+s：

EDITOR_KEYMAP='{"annotation:submit":{"key": "shift+s","description": "My Custom Submit Hotkey!"}}'

要点说明：

• 该变量覆盖同 ID 动作的现有映射；JSON 中的key用于非 Mac 平台，如需区分 Mac 可额外提供mac字段。
• 该变量只能覆盖已有动作的快捷键组合，不能用来删除现有快捷键，也不能新增全新的快捷键动作——新增/删除动作需要在前端Hotkey注册层完成。
• 若key与mac同时存在，前端按isMacOS()自动选择mac ?? key（见 web/libs/editor/src/core/Hotkey.ts）。

环境变量的后端注入链路

从源码可以完整还原该变量的生效路径：

1. label_studio/core/settings/base.py 中定义EDITOR_KEYMAP = json.dumps(get_env('EDITOR_KEYMAP'))，即从环境变量读取原始 JSON 字符串并转为 Django 设置项（label_studio/core/settings/label_studio.py 同样引用）。
2. label_studio/core/middleware.py 在请求中间件中将其附加到request.editor_keymap。
3. label_studio/templates/base.html 渲染时执行JSON.parse({{ settings.EDITOR_KEYMAP|safe }})，把映射放进window.APP_SETTINGS.editor_keymap。
4. 前端编辑器启动时读取该映射合并进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>），快捷方式只在控制标签内生效。

参数说明

完整示例

以下配置展示了一个图像描述任务：标注员在图片上方的文本框中写描述时，可通过点击按钮或按Ctrl+1/Ctrl+2快速插入 “CAR” 或 “AIRPLANE”：

<View> <Image name="image" value="$captioning"/> <Header value="Describe the image:"/> <TextArea name="caption" toName="image"> <!-- Inserts “CAR” when clicked or on Ctrl+1 --> <Shortcut alias="Car" value="CAR" hotkey="ctrl+1" background="#333333"/> <!-- Inserts “AIRPLANE” when clicked or on Ctrl+2 --> <Shortcut alias="Airplane" value="AIRPLANE" hotkey="ctrl+2" background="#FFEE00"/> </TextArea> </View>

再比如音频转写场景中，为<TextArea>配置一个把 “SILENCE” 写入文本区的快捷按钮：

<View> <TextArea name="txt-1"> <Shortcut alias="Silence" value="SILENCE" hotkey="ctrl+1" background="#3333333" /> </TextArea> </View>

注意：<Shortcut>的默认背景色为灰色，可通过background参数以文本或十六进制格式修改。

六、三种自定义方式的选型建议

需要强调的能力边界：前三种方式都只能覆盖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