变更日志 (Changelog)

本项目的所有重要变更都将记录在此文件中。

格式基于 Keep a Changelog，版本号遵循语义化版本。

未发布

新增 (Added)

待添加的新功能

变更 (Changed)

待变更的现有功能

修复 (Fixed)

待修复的问题

移除 (Removed)

待移除的功能

[1.4.2] - 2025-12-11

新增 (Added)

直线灰度测量工具文本框交互功能 (#line-grayscale-text-interaction)
- 实现文本框拖拽功能,支持自由移动测量结果显示位置
- 实现文本框悬停时显示手型光标,提供清晰的交互提示
- 实现点击文本框选中整个工具,统一选中行为
- 优化文本框检测逻辑,使用默认位置作为备选值
- 调整检测区域 padding 从 50 减小到 10,提高检测精度

核心改进:

修复文本框位置未定义时检测逻辑不执行的问题
实现三级交互优先级:文本框 → 手柄 → 线段
确保所有文本框交互功能正常工作

改动文件:

src/components/measures/LineGrayscaleMeasurementTool.ts

[1.4.1] - 2025-12-11

新增 (Added)

直线灰度测量工具交互功能增强 (#line-grayscale-measurement-interaction)
- 实现整个工具平移功能,点击线段可拖拽移动整个测量工具
- 实现手柄拖拽功能,支持单独调整端点位置
- 实现选中状态管理,选中时手柄半径从6增大到12
- 实现线段和手柄悬停时显示十字准星光标
- 实现悬停高亮效果,提供更好的视觉反馈
- 点击空白区域可取消工具选中状态
- 优化数据更新逻辑,只在必要时重新计算统计数据

核心改进:

使用 handleIndex = -1 标识整个工具的拖拽操作
使用 wholeToolOffset 追踪工具平移的拖拽状态
实现优先级检测:手柄 → 线段
选中状态下保持高亮,提供更好的用户体验

改动文件:

src/components/measures/LineGrayscaleMeasurementTool.ts

[1.4.0] - 2025-12-10

新增 (Added)

矩形区域灰度测量功能 (#rectangle-grayscale-measurement)
- 实现完整的矩形区域灰度测量工具，提供医学影像选区统计分析
- 新增 RectangleGrayscaleMeasurementTool 类，基于Cornerstone3D实现
- 支持在医学图像上绘制矩形选区并自动计算平均、最小、最大灰度值
- 集成完整的测量工具管理系统，支持多视口和状态管理
- 修复矩形手柄拖拽算法，确保角点移动时矩形形状保持正确
- 测量结果实时显示，包括像素平均值、极值和选区面积信息
- 支持工具切换、清除和历史记录管理

核心文件变更：

src/components/measures/RectangleGrayscaleMeasurementTool.ts (新增)
src/utils/measurementToolManager.ts (更新测量工具管理)
src/pages/view/components/viewers/stack.image.viewer.tsx (工具集成)
docs/实现/矩形区域灰度测量的实现方案.md (功能设计文档)

[1.3.5] - 2025-12-10

修复 (Fixed)

工作列表患者照片显示逻辑修复 (#worklist.tsx)
- 修复患者照片查找条件类型比较错误，解决 undefined === '' 导致照片不显示的问题

[1.2.7] - 2025-12-09

修复 (Fixed)

Reset Image 功能反色问题 (#stack.image.viewer.tsx)
- 修复了点击 Reset Image 按钮后，DICOM 图像显示反色的问题
- 从图像缓存中正确获取原始 photometricInterpretation 元数据
- 发现并处理 resetProperties() 后需要反转 invert 值的特殊行为
- 解决了 MONOCHROME1/MONOCHROME2 格式图像的正确显示问题

关键技术发现：

resetProperties() 会重置 VOI LUT 等渲染参数
导致需要与初始加载相反的 invert 值才能正确显示
MONOCHROME1: 初始 invert=true，Reset 后需要 invert=false
MONOCHROME2: 初始 invert=false，Reset 后需要 invert=true

影响范围：

确保无论用户是否使用"反色对比"功能，Reset 都能正确恢复初始显示
所有使用 Cornerstone3D 显示的 DICOM 图像

[1.2.6] - 2025-12-XX

说明

历史版本，具体变更待补充

版本号说明

本项目遵循语义化版本 2.0.0规范：

主版本号 (Major)：当你做了不兼容的 API 修改
次版本号 (Minor)：当你做了向下兼容的功能性新增
修订号 (Patch)：当你做了向下兼容的问题修正

变更类型说明

新增 (Added): 添加的新功能
变更 (Changed): 对现有功能的变更
弃用 (Deprecated): 即将移除的功能
移除 (Removed): 已移除的功能
修复 (Fixed): 任何 bug 修复
安全 (Security): 针对安全漏洞的修复

链接说明

[未发布]: 当前开发中的版本
[1.2.7]: https://github.com/usernamedd/zsis/compare/v1.2.6...v1.2.7
[1.2.6]: https://github.com/usernamedd/zsis/releases/tag/v1.2.6