Label Studio Enterprise 2.28.0 发布解析Bitmask 像素级分割、自定义全局热键与标注工作流增强【免费下载链接】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 Enterprise 2.28.0 的正式发布内容展开系统梳理该版本在图像分割Bitmask 像素级标注、用户自定义热键、任务级标注摘要、项目页面与 Workspace 管理、时间序列与音视频标注配置等方向的核心更新。读者阅读后将能完整掌握 2.28.0 的新特性用法、涉及的标注配置参数、API 变更与破坏性变更影响并能够结合当前开源仓库的源码与文档在自己的标注项目中落地这些能力。版本信息Label Studio Enterprise 2.28.0发布于 2025 年 8 月 28 日对应 Helm Chart 版本 1.11.1。版本主题Bitmasks位掩码、custom hotkeys自定义热键、annotation summaries标注摘要、project page improvements项目页改进等。一、新特性详解1. Bitmask 像素级图像标注2.28.0 引入了全新的BitMask 标签用于基于画笔Brush与橡皮擦Eraser的像素级图像分割。相比传统的框选或多边形标注Bitmask 允许标注者以“刷子”方式自由绘制掩码区域光标会实时反映画笔大小最小可精确到单像素从而完成高细节的分割任务同时该版本的性能得到优化可以更从容地处理更多标注区域。在开源仓库中该能力由 BitmaskLabels.jsx 注册为bitmasklabels标签其实现要点如下输出格式操作基于像素级结果输出为“黑色像素 透明背景”的 Base64 编码 PNG 数据 URL导出格式为data-url:image/png;[base64-encoded-string]使用前提必须在Image标签上设置smoothingfalse才能对单个像素进行精确操作标签参数支持name、toName、choicesingle/multiple默认single、maxUsages单个标签在每个任务中的最大使用次数、showInline默认true标签同行显示。一个基础的分割标注配置如下取自 bitmasklabels 标签文档View BitmaskLabels namelabels toNameimage Label valuePerson / Label valueAnimal / /BitmaskLabels Image nameimage value$image smoothingfalse / /View从 Bitmask.jsx 的画笔工具实现可以看到画笔宽度strokeWidth默认 15、取值范围 150工具栏中提供竖向滑杆调节并可通过快捷键tool:decrease-tool/tool:increase-tool以 5 为步长增减绘制过程通过mousedownEv开始路径beginPath、mousemoveEv连续落点、mouseupEv结束路径并提交标注区域commitDrawingRegion提交时会将当前画布数据以imageDataURL形式写入标注结果。此外Mac 用户现在可以在所有标注任务中用双指捏合缩放pinch zoom与平移pan图片进一步提升触控板使用体验。2. 自定义全局热键Custom global hotkeys此前热键主要在标注编辑器内查看与启停2.28.0 起每个用户账户都可以自定义全局热键入口位于Account Settings账户与设置页面。结合 hotkeys 指南 可以梳理出自定义热键的三种途径标注编辑器内点击设置图标查看所有内置热键详情并可启用/禁用账户页面在Account Settings Hotkeys中按用户账户级定制环境变量部署级在.env或启动命令中设置EDITOR_KEYMAP环境变量值为 JSON例如将“提交标注”改为shiftsEDITOR_KEYMAP{annotation:submit:{key: shifts,description: My Custom Submit Hotkey!}}需要注意环境变量方式只能覆盖已有热键映射不能删除或新增热键完整的可定制热键清单可参见 keymap.json。3. 按任务的标注摘要Annotation summary by task当用户处于Reviewer审核员及以上角色在使用View All操作时可以查看某个任务的全部标注摘要。摘要包含元数据metadata任务与标注的基本信息一致性agreements不同标注之间的一致性指标标签并排对比side-by-side comparisons逐标签对比多个标注结果。该摘要的价值在于审核者无需逐个打开标注即可快速理解共识与分歧尤其适合在多名标注者协同标注的任务中做高效的对比审核是质量把控环节的重要增强。二、增强项详解1. SDK 2.0.0含破坏性变更官方发布了Label Studio SDK 2.0.0带来多项功能与文档改进。重要提醒该版本包含破坏性变更breaking changes如果当前自动化流水线中使用了 SDK 包强烈建议将 SDK 版本固定pin在 2.0.0待迁移验证后再升级。2. TimelineLabels 配置设置当标注配置中包含TimelineLabels用于视频帧分类时界面上会出现设置图标可配置视频播放速度Playback speed是否循环播放时间线区域Loop timeline regions。TimelineLabels的典型用法是先选择标签单击标注单帧、拖拽标注多帧区间并配合Video标签使用其源码位于 TimelineLabels.js。3. 标注者Annotator角色的批量标注操作此前批量标注操作 仅对Reviewer、Manager、Admin、Owner角色开放。2.28.0 起Annotator 角色也可以使用这些批量操作。使用前提有两点项目必须使用Manual手动分配方式标注者必须拥有Data Manager的访问权限。注意插件启用的批量标注能力plugin-enabled bulk labeling对 Annotator 的开放情况需另行参照插件文档bulk_labeling 插件确认此处改动仅针对 Data Manager 内建的批量标注动作。4. 项目页面改进Projects项目页面新增列表视图list format可替代默认的卡片网格视图。列表视图以更紧凑的形式呈现项目信息单页展示更多项目同时减少每项展示的指标数量。管理员与标注者视图各自独立优化。配套能力排序两种视图下均可对项目进行排序搜索增强除了项目名称现在还可以按项目描述description与项目 ID 搜索。5. Workspace 改进Workspace 列表有若干体验提升列表现在按字母顺序排序编辑项目设置并选择目标 Workspace 时下拉列表支持搜索项目面包屑breadcrumbs中的 Workspace 链接可直接点击跳转回对应 Workspace。6. Prompts 支持 GPT-5 模型使用 OpenAI API Key 时Prompt 功能的模型选项中新增以下模型gpt-5gpt-5-minigpt-5-nano7. 组织级邮件通知控制Organization Usage License页面新增了组织级开关可以为组织内所有成员统一禁用指定的邮件通知。一旦组织级禁用该通知对所有用户生效且不可见同时也会从用户的Account Settings页面对应选项中隐藏。8. Members 页面导出数据Members成员页面新增将 Annotation Summary 数据导出为 CSV的选项便于将成员维度/标注汇总数据带到外部做进一步分析。9. 高频时间序列数据支持现在可以标注亚秒级小数精度的时间序列数据。前提是时间格式必须包含.%f才能解析小数例如TimeSeries ... timeFormat%Y-%m-%d %H:%M:%S.%f ... /该格式在TimeSeries标签的timeFormat参数中配置适用于采样频率很高的时间序列数据。10. 矩形框吸附到像素Snap bounding boxes to pixelsRectangle与RectangleLabels标签新增snap参数可将矩形框吸附到像素边界避免出现小数像素坐标RectangleLabels namelabels toNameimage snappixel Label valuePerson / /RectangleLabels从源码看Rectangle.jssnap取值支持pixel与none默认none。提示如需在放大图片时看到像素网格必须关闭像素平滑pixel smoothing既可以在Image标签上设置参数对应 Image.js 中的smoothing属性也可以从用户设置中关闭。11. 定义内容区默认折叠状态Collapse标签新增open参数用于指定内容区默认是展开还是折叠。源码Collapse.jsx中该参数为布尔类型Collapse 级别的open设定所有面板的默认状态而 Panel 级别的open可以覆盖全局设置Collapse openfalse Panel value高级设置 ViewHeader value默认折叠的高级设置区域 //View /Panel /Collapse在 accordion手风琴模式下仅第一个激活面板生效该标签同时支持accordion默认true与bordered默认false参数。12. 标注配置中控制频谱图显示Audio标签新增spectrogram参数可在加载音频时默认显示频谱图。源码Audio/model.js中该参数为布尔类型、默认false当配置开启时视图层Audio/view.tsx会将频谱图图层的可见性置为开启。Audio nameaudio value$audio spectrogramtrue /13. 项目列表 API 新增include与filter参数List all projectsAPI 更新新增两个参数include逗号分隔的计数类字段列表用于按需返回字段以优化性能。可用字段包括task_number、finished_task_number、total_predictions_number、total_annotations_number、num_tasks_with_annotations、useful_annotation_number、ground_truth_number、skipped_annotations_number不指定时返回全部计数字段filter按置顶状态过滤项目取值pinned_only仅置顶、exclude_pinned排除置顶、all全部默认。以上参数的定义与校验逻辑可在 label_studio/projects/serializers.py 中查看include会在校验时按逗号拆分filter仅接受上述三个合法值。此外该项目列表接口还支持search按标题与描述搜索。14. 组织成员列表 API 新增查询参数列出组织成员时新增两个查询参数用于排除特定项目或 Workspace 的成员exclude_project_idexclude_workspace_id当需要获取“仅属于组织、不属于某项目/某 Workspace”的成员集合时可直接在调用成员列表接口时携带这两个参数。15. 其他可用性与性能改进Audio 默认缩放调整移除了音频默认的缩放级别计算默认渲染完整波形Add Source Storage 弹窗清晰度优化标注界面信息面板 UX 改进Ask AI 默认开启所有新账户默认启用邮件通知改为 opt-in既有用户账户的邮件通知默认不订阅需主动开启保存标注与审核reviews时的错误处理与数据持久化改进数据导入失败时的错误提示改进项目复制duplication过程中的状态可见性改进。三、破坏性变更Breaking changes升级到 2.28.0 前需要关注以下接口变化/api/projects/{project_id}/export已弃用deprecated依赖该接口的脚本应尽快迁移到替代的数据导出方案/api/projects的分页大小限制为 100一次最多返回 100 个项目超出部分需通过分页参数获取大批量拉取项目的既有集成需要适配。四、安全更新Security修复了一个与重定向函数相关的Koa.js XSS 漏洞增强密码校验improved password validation。五、Bug 修复清单2.28.0 修复了大量问题按主题归纳如下方便对照排查自身环境是否受影响。标注与审核Annotation Review修复使用 Choices 时不可见标注被错误提交的问题修复FixAccept在审核者做出修改后不显示的问题修复审核数据在目标存储无法写入标注时未持久化到数据库的问题修复任务得分计算异常报错的问题修复任务一致性阈值配置时数值未正确发送的问题修复基于标注者评估的用户暂停动作在统计缺失时仍可能触发的问题修复Propagate Annotations实验性操作后得分未重新计算的问题修复任务历史导航label stream时加载到错误草稿的问题修复批量标注未触发部分 webhook 事件的问题修复橡皮擦工具无法在单像素级别工作的问题。时间序列与音频/视频修复TimeSeries与MultiChannel标签组合时初始显示异常的问题修复大数据集、特定缩放级别下 TimeSeries 图表垂直位移超出可视区域的问题修复TimeSeriesVisualizer组件渲染大量数据时的问题修复分通道split channel模式下音频区域无法全界面可视化的问题修复页面级缩小后音频无法渲染完整波形的问题修复分通道音频渲染高度不正确的问题修复手动输入音频区域结束时间的问题修复标签界面区域缩放时视频播放器不同步缩放的问题修复“允许在视频边界外绘制”设置失效的问题修复视频设置弹窗点击外部无法关闭的问题。数据管理Data Manager修复修改过滤器/列后过滤器消失且无法编辑的问题修复 Data Manager 刷新页面后新建标签页被移到最前的问题修复按评论文本排序时任务重复的问题修复任务分配标注者超过 10 人时无法查看标注者人数的问题修复 Data Manager 中偶尔无显示名的用户渲染问题修复将过滤器固定pin到侧边栏时的布局错误修复固定过滤器后排序不生效的问题修复头像溢出 Data Manager 表格单元格的问题。界面与体验UI/UX修复暗色模式dark mode下的多项问题修复白标whitelabeled环境下的多项问题修复按钮与工具提示tooltip的多项 UI 问题修复按钮文字大小不正确的问题修复日期时间选择中 AM/PM 选项未居中的视觉问题修复导入弹窗中 UI 元素意外换行的视觉问题修复 RichText 标签在 Firefox 上因跨浏览器兼容性导致的渲染问题修复登出状态下访问部分页面出现空白屏而非跳转登录页的问题修复文档链接在同一窗口打开而非新标签页的问题修复用户信息弹窗popover在部分场景无法打开的问题修复项目设置保存时出现“Duplicating”徽标的问题修复创建项目时错误指示器不可见的问题修复设置切换过快时设置界面跳动的问题。用户、角色与组织修复组织内被提升为 manager/admin 的用户项目角色受影响的问题修复Manage Member弹窗忽略活动搜索过滤器、选中全部项目成员的问题修复已删除用户的头像仍显示在 Members 页面的问题修复 LDAP 用户在近期 Enterprise 版本中注册失效的问题修复邮件通知偏好复选框显示错误的问题。项目与存储修复复制过程中用户修改设置导致项目复制失败的问题修复直接上传图片的复制项目中出现的 CORS 错误问题修复 GCS WIF 云存储中任务搜索与性能优化缺失的问题修复导入 CSV 后数据导入页面显示异常的问题修复从All Projects跳转时page参数未重置为 1 的问题。性能与稳定性修复/api/tasks在标注数量巨大时超时的问题修复 Prompts 成本估算导致的**内存溢出OOM**问题修复 Prompt 推理运行时内存消耗未优化的问题修复成员相关 API 调用导致的性能下降问题修复邮件通知中意外出现任务数据的问题修复 Activity Log 页面偶尔无法加载的问题。六、升级建议与注意事项综合本版本的破坏性变更与安全修复建议升级前完成以下检查SDK 兼容性如自动化流水线依赖label-studio-sdk先固定版本2.0.0并评估 2.0.0 的 API 差异后再迁移API 依赖检查检索代码中对/api/projects/{project_id}/export的调用并替换确认分页逻辑能承受/api/projects单页 100 条的上限安全补丁Koa.js XSS 修复与密码校验增强属于安全项建议尽快升级功能权限变化Annotator 角色的批量标注权限、Ask AI 默认开启、邮件通知 opt-in 等行为变化会影响既有工作流与用户体验升级后需在组织设置中复核标签配置增量snap、open、spectrogram、timeFormat%Y-%m-%d %H:%M:%S.%f等均为增量参数不影响既有配置兼容性可按需开启新能力。相关参考文档索引BitmaskLabels 标签、RectangleLabels 标签、Collapse 标签、TimelineLabels 标签、热键指南、批量标注指南、项目列表 API 序列化实现、Bitmask 画笔工具实现。【免费下载链接】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），仅供参考