Initial public release

openspec/specs/cutout-depth-extension/spec.md

@@ -0,0 +1,53 @@
+# cutout-depth-extension Specification
+
+## Purpose
+TBD - created by archiving change restore-cutout-depth-extension. Update Purpose after archive.
+## Requirements
+### Requirement: Reliable depth sources retain the tested alpha rule
+
+系统 SHALL 按剪裁 Alpha 定义可见域和8连通分量；供体候选 SHALL 位于同一可见分量内，并满足固定 Alpha ≥ 0.95、Validity > 0.5、有限正深度。系统 SHALL 保留内侧2像素保护及旧版回退规则。
+
+#### Scenario: Low clipping threshold retains translucent edges
+- **WHEN** 剪裁 Alpha 为0.1，边缘 Alpha 为0.1且同分量存在可靠核心
+- **THEN** 边缘属于可见域但不能充当供体，其深度使用同分量可靠来源补齐
+
+#### Scenario: Narrow component lacks a core
+- **WHEN** 分量内缩2像素后没有可靠供体
+- **THEN** 使用本分量未内缩的可靠候选；候选也为空时保留该分量原预测
+
+### Requirement: Extension preserves reliable interior and projection
+
+系统 SHALL 沿用旧算法补齐轮廓边缘及可见域外4个深度图像素，使用sigma=0.8、半径3像素的分量内局部平滑。系统 SHALL 保留内部受保护区域及未修补像素，按目标像素射线重建变化像素的XYZ。
+
+#### Scenario: Filtered sampling crosses an outline
+- **WHEN** 采样邻域跨越主体轮廓
+- **THEN** 邻近透明侧4像素范围提供延伸深度，各分量采用自身供体和平滑输入，其他可见分量保持各自处理结果
+
+#### Scenario: Corrected points retain their pixel location
+- **WHEN** 像素继承供体Z
+- **THEN** XYZ仍投影至目标像素，归一化投影误差小于1e-6；原Alpha和validity保持不变
+
+#### Scenario: Opaque input and interior validity holes
+- **WHEN** 输入完全不透明，或透明图内部存在模型validity孔洞
+- **THEN** 完全不透明输入原样返回；内部孔洞只限制供体资格，不扩大轮廓修补区域
+
+### Requirement: Only cutout depth artifacts use corrected frames
+
+系统 SHALL 仅由Cutout深度请求开启延伸，使用同一修复Frame写入深度和Metadata。共享入口默认 SHALL 关闭修复，Normal SHALL 使用原始Frame，EXR A SHALL 保持原Alpha乘原validity。
+
+#### Scenario: Cutout requests depth and normals
+- **WHEN** 同一Cutout请求同时生成深度和Normal
+- **THEN** 只执行一次模型预测，深度及Metadata来自修复Frame，Normal来自原始Frame
+
+#### Scenario: Other artifact requests
+- **WHEN** 普通Depth Plane、全景深度或仅Normal请求运行
+- **THEN** 沿用各自原始预测产物行为
+
+### Requirement: Real image verification uses a fixed prediction
+
+验收 SHALL 在工作区外使用用户蜘蛛和头骨原图、固定同一Alpha与预测，在现有几何节点及相同参数下仅替换原始/延伸深度产物，记录截图、耗时与残余问题。
+
+#### Scenario: Full modifier evaluation
+- **WHEN** 两张图完成深度产物对照
+- **THEN** 全部结果非空、坐标有限、无节点警告，报告一次补边与节点求值的独立耗时，并检查Normal着色
+