# 变更日志 (Changelog)

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

格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。

## [未发布] (Unreleased)

### 新增 (Added)
- 待添加的新功能

### 变更 (Changed)
- 待变更的现有功能

### 修复 (Fixed)
- 待修复的问题

### 移除 (Removed)
- 待移除的功能

---

## [1.4.1] - 2025-12-11

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

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

**改动文件:**
- src/components/measures/LineGrayscaleMeasurementTool.ts

---

## [1.4.0] - 2025-12-10

### 新增 (Added)
- **矩形区域灰度测量功能** ([#rectangle-grayscale-measurement](docs/实现/矩形区域灰度测量的实现方案.md))
  - 实现完整的矩形区域灰度测量工具，提供医学影像选区统计分析
  - 新增 `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](src/pages/patient/worklist.tsx))
  - 修复患者照片查找条件类型比较错误，解决 undefined === '' 导致照片不显示的问题

## [1.2.7] - 2025-12-09

### 修复 (Fixed)
- **Reset Image 功能反色问题** ([#stack.image.viewer.tsx](src/pages/view/components/viewers/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](https://semver.org/lang/zh-CN/)规范：

- **主版本号 (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