OHIF Viewer中多阶段HP切换时DICOM研究变更导致的问题分析

问题背景

在医学影像查看器OHIF Viewer中，Hanging Protocol(HP)功能用于定义影像的显示布局和设置。多阶段HP允许用户在不同显示阶段间切换，以适应不同的诊断需求。然而，当用户在当前HP阶段切换显示的DICOM研究(如加载先前的扫描)时，HP阶段切换功能会出现异常。

问题现象

当用户执行以下操作序列时：

1. 打开一个支持多阶段HP的DICOM研究
2. 在HP阶段运行期间，通过图像系列选择器加载另一个DICOM研究
3. 尝试使用快捷键切换HP阶段

系统会显示"Hanging Protocol could not be applied"错误消息，并伴随控制台错误："Reused viewport details ctDisplaySet with ds [ID] not valid"，表明HP阶段切换功能失效。

技术分析

该问题的核心在于HP服务对显示集(display set)状态的管理机制。当切换DICOM研究时，系统会创建新的显示集实例，但HP服务仍保持着对旧显示集的引用。这种状态不一致导致在尝试切换HP阶段时，系统无法正确验证和重用viewport配置。

错误堆栈显示问题发生在HangingProtocolService.ts的setProtocol方法中，当系统尝试重用viewport细节时，由于显示集ID不匹配而抛出验证错误。

解决方案

经过开发团队排查，该问题已在相关PR中得到修复。修复方案主要涉及以下几个方面：

1. 增强HP服务对显示集变更的感知能力
2. 改进viewport细节的验证逻辑
3. 优化显示集重用机制，确保在DICOM研究变更时能正确处理HP阶段切换

最佳实践建议

对于开发者在使用OHIF Viewer的HP功能时，建议注意以下几点：

1. 当实现自定义HP逻辑时，应充分考虑DICOM研究动态变更的场景
2. 对显示集的生命周期管理要保持一致性
3. 在HP阶段切换前，应验证所有相关显示集的有效性

该问题的修复显著提升了OHIF Viewer在多研究场景下的HP功能稳定性，为放射科医生提供了更流畅的工作流程体验。