Initial public release

openspec/specs/clipboard-image-cache/spec.md

@@ -0,0 +1,43 @@
+# clipboard-image-cache Specification
+
+## Purpose
+TBD - created by archiving change unify-material-color-images. Update Purpose after archive.
+## Requirements
+### Requirement: Clipboard reuse requires an unchanged image
+
+相同剪贴板输入 SHALL 仅复用当前像素、尺寸、颜色空间和 Alpha 模式均匹配缓存基线的有效 Image。缓存验证 SHALL 包括透明区域 RGB，并保持候选图像原有内容与状态。
+
+#### Scenario: Repeated content remains unchanged
+
+- **WHEN** 相同剪贴板内容再次粘贴，缓存图像内容和设置未改变
+- **THEN** 系统 SHALL 复用该 Image
+
+#### Scenario: Mask overwrites the cached image
+
+- **WHEN** Mask 修改了独占的剪贴板 Image，修改结果已打包，再次粘贴原始剪贴板内容
+- **THEN** 系统 SHALL 加载原始剪贴板内容到另一 Image，保留已编辑图像
+
+#### Scenario: Shared edit leaves an intact candidate
+
+- **WHEN** 编辑产生独立结果，另一个用户仍引用未修改的剪贴板原图
+- **THEN** 再次粘贴 SHALL 复用该未修改原图
+
+#### Scenario: Other editing or interpretation changes invalidate a candidate
+
+- **WHEN** 候选图像经过尺寸修改、原生绘制、透明 RGB 修改、颜色空间或 Alpha 模式变更
+- **THEN** 再次粘贴 SHALL 跳过已变更候选，使用原始剪贴板内容及其初始解释设置
+
+#### Scenario: Legacy or unreadable cache entry is found
+
+- **WHEN** 候选缺少内容校验基线或无法读取
+- **THEN** 系统 SHALL 按未命中处理，并保留已有图像
+
+### Requirement: Clipboard material results stay outside the source cache
+
+剪贴板 Plane SHALL 从有效剪贴板原图按整图范围生成独立材质颜色图。参考图、节点和笔刷的后续粘贴 SHALL 按原图缓存有效性选择 Image。
+
+#### Scenario: Painted material is followed by another paste
+
+- **WHEN** 用户粘贴为 Plane 并绘制其材质，随后把相同内容粘贴为参考图、节点或笔刷
+- **THEN** 系统 SHALL 使用原始剪贴板内容，且不复用材质颜色图
+