# 变更日志 (Changelog)

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

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

## [未发布] (Unreleased)

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

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

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

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

---

## [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