Label Studio Enterprise 2.15.0 版本发布说明Reviewer 工作流升级、Django 4.2 迁移与性能评分体系详解【免费下载链接】label-studioLabel Studio is a multi-type data labeling and annotation tool with standardized output format项目地址: https://gitcode.com/GitHub_Trending/la/label-studio本文基于开源仓库中的官方发布说明docs/source/guide/release_notes/onprem/2.15.0.md整理。Label Studio Enterprise 2.15.02024 年 9 月 3 日发布对应 Helm Chart 版本 1.6.3是一次以审核Review体验为核心的迭代Reviewer 工作流被重构为更直观的操作路径Data Manager 支持标签页拖拽排序性能评分体系新增 Performance Score 列同时底层框架升级到 Django 4.2 并移除对 PostgreSQL 11 的支持。本文将逐项拆解这些增强、破坏性变更与修复并对照当前仓库源码说明其实现位置与影响范围帮助管理员、标注团队负责人和开发者评估升级影响、规划升级路径。一、本次版本概览1.1 版本信息发布版本Label Studio Enterprise 2.15.0发布日期2024 年 9 月 3 日Sep 03, 2024配套 Helm Chart 版本1.6.3版本主题Reviewer 工作流更新、Data Manager 标签页拖拽排序、Show region labels显示区域标签选项的可用性增强以及升级至 Django 4.21.2 版本类型定位本次发布属于增强型Enhancements为主的迭代版本同时包含 1 项明确的 Breaking ChangeDjango 升级导致的数据库版本要求变更、1 项安全修复NLTK 升级以及 3 个 Feature flag 的移除和一批 Bug 修复。对于正在规划从旧版本升级的团队本版本的数据库版本要求变更是需要优先评估的破坏性因素。二、核心增强Reviewer 工作流重构2.15.0 对审核工作流进行了大幅重构核心目标是让审核操作更贴近任务本身、更符合直觉。2.1 角色化操作入口Accept / Reject / FixAccept变更前任何进入任务页面的用户包括 Reviewer、Manager、Admin、Owner看到的是Update操作。变更后当 Reviewer、Manager、Admin 或 Owner 在 Data Manager 中点击某个任务时看到的是审核操作Accept接受、Reject拒绝、FixAccept修复并接受而不再是 Update。Update操作从此仅对创建该标注的标注员本人可见这保证了标注责任与编辑权限的边界清晰只有标注作者才能修改自己的标注审核者只能通过 Accept/Reject/FixAccept 表达审核结论。源码层面的印证Label Studio 的标注与任务生命周期由label_studio/fsm有限状态机模块管理。在 label_studio/fsm/state_choices.py 中AnnotationStateChoices定义了标注的 CREATED 状态任务状态则包含 CREATED / IN_PROGRESS / COMPLETED 三种label_studio/fsm/state_choices.py。审核操作本质上是基于这些状态的状态迁移在 label_studio/fsm/annotation_transitions.py 中标注创建annotation_created通过post_transition_hook将任务状态推进到 COMPLETEDlabel_studio/fsm/annotation_transitions.py而标注更新annotation_updated则保留 CREATED 状态并记录审计轨迹label_studio/fsm/annotation_transitions.py。从该结构可以推断Accept / Reject / FixAccept 对应的审核结论会在后续的状态与评分聚合中被消费从而影响成员页面上的评分指标。2.2 Explore All Reviews 被移除变更前存在独立的Explore All Reviews浏览全部审核入口。变更后该选项不再提供。因为其核心能力已由在 Data Manager 中直接选择任务这一更自然的交互方式覆盖——审核者只需在 Data Manager 中挑选任务即可看到审核操作与审核历史无需再进入单独的浏览视图。2.3 Review All Tasks 默认排序方向反转变更前点击Review All Tasks审核全部任务时任务按完成时间的倒序展示最新完成的排在最前面。变更后默认按标注员完成任务的原始顺序展示先完成的在前。这一调整更符合审核者顺着标注员的作业顺序逐条审核的实际工作流减少了跳转与上下文切换成本。三、Data Manager 标签页支持拖拽排序3.1 功能描述Data Manager 中的多个视图标签页Tab现在可以通过**拖拽drag and drop**的方式重新排序无需再通过菜单调整视图顺序。3.2 前端实现位置该功能由 Data Manager 前端模块实现关键代码位于 web/libs/datamanager/src/components/DataManager/DataManager.jsx每个标签页通过Draggable组件包裹DataManager.jsx提供draggableProps与dragHandleProps支持拖拽onDragEnd回调在拖拽结束时调用views.updateViewOrder(result.source.index, result.destination.index)DataManager.jsx将标签页从源索引移动到目标索引标签页的样式类定义在 web/libs/datamanager/src/components/Common/Tabs/Tabs.prefix.css 与 web/libs/datamanager/src/components/Common/Table/TableHead/TableHead.jsx 等位置draggable修饰类统一了拖拽中的视觉反馈。从源码结构看标签页的排序状态通过views.updateViewOrder持久化到视图配置中因此拖拽结果在刷新后依然保留属于面向日常使用的常规操作增强。四、Show region labels 增强标签索引与区域列表对齐4.1 变更内容在标注区域启用Show region labels显示区域标签后画布上每个区域角标显示的内容发生变化变更前区域标签不携带索引编号无法与区域列表快速对应变更后区域标签中包含与区域列表Regions List中一致的索引标识index identifier视觉上可以直接将画布上的标注与列表中的条目一一对应。4.2 价值在多区域标注场景如目标检测、多边形标注、关键点标注中当单个任务包含几十甚至上百个区域时画布角标 ↔ 区域列表的索引对齐能显著减少标注员与审核者的比对成本也是修复文本/超文本、图像标注中区域管理可用性问题的基础体验提升。五、标注配置未保存离开时的警告提示5.1 功能描述当用户修改了项目的标注配置Labeling Configuration但尚未保存、尝试离开当前页面时界面会弹出警告消息提示先保存更改。5.2 适用场景该提示主要作用于项目设置页面的标注配置编辑器。它降低了误操作离开导致配置丢失的风险属于典型的表单脏状态dirty state防护检测到未保存的改动后拦截导航并给出明确提示。六、Annotator Performance Reports 支持按日期聚合6.1 变更内容在查看Annotator Performance Reports标注员绩效报告时现在可以选择聚合维度Creation Date创建日期按标注/审核记录的创建时间聚合数据Updated Date更新日期按记录的更新时间聚合数据。6.2 意义当标注员在工作流中被多次 Reject 后再 Accept即标注经历多轮修改时创建日期与更新日期会产生显著差异。选择不同的聚合日期维度可以帮助管理者从标注产出节奏或最终确认节奏两个视角观察绩效走势。七、新增 Performance Score 列绩效评分的统一度量这是本版本在质量管理维度最重要的功能增强。7.1 位置与作用项目Members成员页面新增Performance Score绩效评分列用于反映标注员的整体绩效。该评分把所有审核动作都纳入考量——包括最初被拒绝、后来被接受的标注——从而比只反映当前状态的 Review Score 更全面地刻画标注员的工作质量。7.2 计算方法评分规则如下每一次标注审核动作Accept、Reject、FixAccept都为一个评分事件计入总分Performance Score 所有审核动作得分之和 ÷ 审核动作总次数不同审核动作的得分取值Accept 得 1 分Reject 得 0 分FixAccept 按实际修复质量得分0~1 之间的百分数如 42% 记为 0.42。7.3 计算示例官方文档给出了两个典型示例示例一某标注先后被 Reject 两次、最终 Accept 一次Performance Score (0 0 1) / 3 33%示例二某标注被 Reject 一次随后被 FixAccept修复得分为 42%Performance Score (0 0.42) / 2 21%7.4 与 Review Score 的区别Review Score只反映标注的当前状态当前是 accepted 还是 rejectedPerformance Score综合全部历史审核动作按动作次数平均。正因如此Performance Score 对标注员经历了多次返工但最终达标的情况更为敏感适合作为长期绩效追踪的量化指标。7.5 相关 Bug 修复的关联本次版本同时修复了Reviewer 先 Reject、后 Accept 时成员页面上的 Annotator 一致性评分agreement scores计算不准确的问题见下文 Bug 修复列表这与 Performance Score 的上线形成配套审核状态的多轮变化现在会被正确计入评分体系而不会出现只认最终状态、忽略中间过程的失真。八、支持门户入口版本菜单中新增了指向HumanSignal 支持门户的链接其中包含常见问题FAQ与故障排查troubleshooting资料并提供开启支持工单support ticket的入口。该入口面向使用 Enterprise 版本的运维与管理员用于快速获取官方支持资源。九、Breaking changesDjango 4.2 升级与 PostgreSQL 版本要求9.1 变更内容本版本将后端框架升级至Django 4.2随之而来的一项破坏性变更PostgreSQL 11 不再受支持。升级前必须迁移到 PostgreSQL 12 或更高版本。9.2 影响与升级步骤评估当前数据库版本执行SELECT version();确认 PostgreSQL 大版本若为 PostgreSQL 11规划数据库迁移建议通过 pg_dump/恢复或就地升级方式迁移至 12务必在升级 Label Studio Enterprise 之前完成完成迁移后再执行 Label Studio Enterprise 的升级流程并验证数据完整性。9.3 仓库配置佐证当前仓库的数据库配置位于 label_studio/core/settings/base.py。默认数据库引擎为 PostgreSQL其连接参数POSTGRE_USER/POSTGRE_PASSWORD/POSTGRE_NAME/POSTGRE_HOST/POSTGRE_PORT均通过环境变量注入默认主机localhost、端口5432base.py同时支持 MySQL 与 SQLite 作为备选引擎base.py并可通过DJANGO_DB环境变量切换base.py。此外设置项ALLOW_SCHEDULED_MIGRATIONSbase.py控制异步 SQL 迁移是否可以进入 SCHEDULED 状态说明升级过程中的数据库迁移可以由平台统一调度执行。需要说明的是当前开源主干的依赖声明为Django (5.2.16,5.3.0)见 pyproject.toml而 2.15.0 发布说明记录的升级目标是 Django 4.2两者反映了不同发布分支的依赖锁定策略本小节内容以发布说明记载的 2.15.0 行为为准。无论哪个分支升级后都必须保证 PostgreSQL 满足 Django 支持的最低版本要求。十、安全更新NLTK 升级修复 CVE-2024-3970510.1 变更内容组件NLTK自然语言处理工具包升级目标版本3.9.1修复漏洞CVE-2024-3970510.2 漏洞背景基于公开漏洞信息归纳CVE-2024-39705 属于 NLTK 在语料库下载/解压环节相关的安全问题攻击者可能利用恶意构造的语料库文件触发风险。Label Studio 在部分 NLP 类标注流程中会用到 NLTK 相关能力因此通过升级到 3.9.1 封堵该漏洞。建议部署了该版本的团队在升级后重新构建镜像并做一次安全回归验证。十一、Feature flag 清理以下 3 个 Feature flag 在本版本中被移除被移除的 Feature flag推测用途fflag_feat_front_prod_e_111_annotator_workflow_control_short标注员工作流控制annotator workflow control相关的前端特性开关fflag_fix_front_lsdv_4673_rect3point_relative_310523_short前端矩形三点相对定位rect3point relative修复开关ff_back_1614_rejected_queue_17022022_short后端被拒绝队列rejected queue修复开关在仓库中检索这三个 flag 名称目前仅在 docs/source/guide/release_notes/onprem/2.15.0.md 的发布说明中出现说明它们已在代码中彻底移除、不再作为运行时开关存在。Feature flag 清理的典型含义相关功能已经默认启用并稳定不再需要灰度开关例如ff_back_1614_rejected_queue_17022022_short涉及的被拒绝队列逻辑从本次 Reviewer 工作流重构来看已被新的审核交互所取代升级后若发现自定义部署中曾显式配置过这些 flag需要将其从环境变量/配置中移除避免遗留无效配置。十二、Bug 修复清单本版本共修复 17 项问题按功能域归类如下12.1 标注与审核修复了Text标签值为空时View all annotations查看全部标注操作不工作的问题修复了在项目级别被分配Reviewer角色的标注员看不到评论comments的问题修复了成员页面中 Annotator一致性评分agreement scores计算不准确的问题——该问题出现在 Reviewer 先 Reject、后 Accept 某条标注时修复了按Command或 Ctrl多选多个边界框时反而新建了一个边界框的问题。12.2 Data Manager 与界面显示修复了 Data Manager 中大整数显示异常的问题修复了为区域regions添加标注时包含 emoji 的 Text/HyperText 内容被破坏的问题修复了 tooltip 导致过渡动画报错的问题修复了成员用户列表变大后Members 表格的可用性问题。12.3 仪表盘与项目修复了在项目标注配置**不包含标签labels**时加载仪表盘出现运行时错误的问题修复了Project 仪表盘返回错误的问题修复了复制项目时未包含项目摘要project summary的问题。12.4 API 与基础设施修复了通过 API 删除**仍包含项目的工作区workspace**的问题——现在此类删除应被阻止修复了未先选择用户时访问Annotator Performance Report页面报错的问题——现在会先重定向离开该页面直到用户被选中修复了tracing 破坏预签名 URLpresigned URL请求的问题修复了图片加载后因原始尺寸设置不当而被错误缩放的问题。十三、升级建议与注意事项汇总结合本版本的全部变更给出以下升级行动清单数据库前置检查最高优先级确认 PostgreSQL 版本 ≥ 12若仍为 11先完成数据库迁移再升级 Label Studio Enterprise 2.15.0验证审核工作流升级后确认 Reviewer/Manager/Admin/Owner 角色在任务页看到的是 Accept / Reject / FixAccept且 Update 仅对标注作者可见Review All Tasks 的排序方向已变为完成顺序清理 Feature flag 配置从部署配置中移除已删除的三个 flag回归重点场景多选边界框Command/Ctrl、含 emoji 的文本标注、含大量整数数值的 Data Manager 表格、仪表盘在无标签配置项目下的加载、图片缩放行为安全更新确认 NLTK 已升级到 3.9.1对应 CVE-2024-39705 修复理解新指标向团队成员说明 Performance Score 与 Review Score 的计算差异避免对成员页面评分的误读。结语Label Studio Enterprise 2.15.0 是一次审核体验 质量度量 平台现代化的综合迭代Reviewer 工作流从编辑视角转向审核视角拖拽排序让 Data Manager 的视图组织更加自由Performance Score 为团队质量管理提供了全量历史动作的量化口径而 Django 4.2 升级则明确了数据库的版本底线。对于正在评估升级的团队本文的变更清单、计算示例与升级注意事项可直接作为版本评估与升级计划的核对底稿。更多参考版本发布说明原文docs/source/guide/release_notes/onprem/2.15.0.md任务/标注/项目状态机实现label_studio/fsm/state_choices.py、label_studio/fsm/annotation_transitions.pyData Manager 标签页拖拽实现web/libs/datamanager/src/components/DataManager/DataManager.jsx数据库配置label_studio/core/settings/base.py依赖声明pyproject.toml【免费下载链接】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），仅供参考