From f71183b39e06015746b6c1daafab352ce6dfc980 Mon Sep 17 00:00:00 2001
From: InpaintRegionEditor Dev <dev@inpaint-region-editor.local>
Date: Tue, 3 Mar 2026 19:54:02 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=20CHANGELOG=20?=
 =?UTF-8?q?=E5=92=8C=20HANDOFF=EF=BC=8C=E8=AE=B0=E5=BD=95=20v1.3=20?=
 =?UTF-8?q?=E5=AE=8C=E6=88=90=E7=9A=84=E5=8A=9F=E8=83=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CHANGELOG.md    | 22 ++++++++++++++++++++++
 docs/HANDOFF.md |  4 +++-
 2 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b743965..880607b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,28 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.0] - 2026-03-03
+
+### Added
+- **Photopea 蒙版编辑**：双图层模式（参考图像 + 蒙版层），支持羽化效果
+- **UPNG.js 集成**：保存时保留 Alpha=0 的 RGB 数据，解决 Canvas premultiplied alpha 问题
+- **MaskEditor clipspace 支持**：使用 VALIDATE_INPUTS 支持动态文件路径验证
+- **选区坐标同步**：前端拖动后正确传递到后端（region_coords hidden widget）
+
+### Changed
+- 右键菜单分离：「编辑图像（Photopea）」和「编辑蒙版（Photopea）」两个独立操作
+- 图像加载：编辑蒙版时使用 `channel=rgb` 和 `channel=a` 分离加载
+
+### Fixed
+- Photopea 编辑蒙版后原图被"掏窟窿"的问题
+- MaskEditor 保存后文件路径验证失败的问题
+- 节点显示蒙版效果
+
+### Technical Details
+- **前端**：`loadImgForMask()` 分离 RGB/Alpha，`mergeMaskToImage()` 使用 UPNG.js 编码
+- **后端**：`VALIDATE_INPUTS` 方法支持 clipspace 文件验证
+- **羽化逻辑**：蒙版层黑色半透明 → Alpha 中间值（公式：finalAlpha = 255 - maskAlpha）
+
 ## [1.2.0] - 2026-03-03
 
 ### Added
diff --git a/docs/HANDOFF.md b/docs/HANDOFF.md
index bcc9946..34d8d08 100644
--- a/docs/HANDOFF.md
+++ b/docs/HANDOFF.md
@@ -1,6 +1,6 @@
 # InpaintRegionEditor 项目交接文档
 
-> 版本：1.1 | 日期：2026-03-03
+> 版本：1.3 | 日期：2026-03-03
 > 交接对象：开发团队
 > 交接人：项目经理 Agent
 
@@ -526,6 +526,8 @@ doc.selection.copy();
 | 0.1 | 2026-02-27 | 初始版本（简化版，仅 Photopea 集成） |
 | 1.0 | 2026-03-02 | 需求最终确认，编写 handoff 文档 |
 | 1.1 | 2026-03-03 | Photopea 蒙版编辑功能，修复 RGB 被掏窟窿问题 |
+| 1.2 | 2026-03-03 | 选区调整大小、光标变化、Ctrl+V 粘贴、MaskEditor 集成 |
+| 1.3 | 2026-03-03 | MaskEditor clipspace 支持、选区坐标同步、羽化效果 |
 
 ---