docs(r2): 契约核对补充 + design-data-contract 增加 width/height 语义注记

- diy-fix-workflow：新增两份契约逐项核对总表 - design-data-contract-v1：stickers[].width/height/x/y 语义 = 画布显示像素（实现注记，非版本升级），历史数据读端按 mask 归一化兼容 Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-12 18:53:07 +08:00
parent c47071c9d8
commit 395fa4116c
2 changed files with 24 additions and 0 deletions
@@ -82,6 +82,12 @@ interface DesignDataV1 {
 - `imageSrc/imagePos` 保留为兼容旧版字段；新写入统一走 `background.src/pos`，
  WCD 打包器同时兜底读旧字段。

+> **实现注记（2026-09-12，DIY 修正，非版本升级）**：`stickers[].width/height` 的语义为
+> **画布显示像素**（坐标空间 = `category.mask` 的宽高），`x/y` 同为画布内坐标。
+> 渲染、碰撞检测、WCD 打包三方按同一语义消费，打包时不再做像素换算。
+> 历史数据中按「图片原始像素」写入的值（width > mask 宽高）由读取端按 mask 等比归一化兼容，
+> 不做存量迁移。`addSticker` 时即归一化到画布空间（建议初始占 mask 短边 60%）。
+
 ## 3. 冻结约束（R2 需落地）

 | # | 约束 | 说明 |