create-dwy 0.17.1 → 0.18.1

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-ios-app-store-release/references/screenshot-specs.yaml

@@ -0,0 +1,98 @@
+# App Store 预览图规格。P 图与上传只读本文件，不要把尺寸抄到其它文件。
+# 数字来自 Apple App Store Connect Screenshot Specifications（2026-08）。
+# 上传被拒时先打开官方页核对，再改本文件。
+schema_version: 1
+source: https://developer.apple.com/help/app-store-connect/reference/screenshot-specifications/
+processing:
+  color_space: sRGB
+  alpha: false
+  formats: [png, jpeg, jpg]
+  min_count: 1
+  max_count: 10
+  # 后续自动 P 图默认只出 canonical；其它尺寸交给 Apple 缩放。
+  canonical:
+    ios: ios_iphone_master
+    ipados: ipad_13_master
+    macos: macos_master
+displays:
+  ios_iphone_master:
+    family: iphone
+    display: 6.9
+    required: iphone
+    note: iPhone Air / 17 Pro Max / 16 Pro Max / 16 Plus / 15 Pro Max / 15 Plus / 14 Pro Max
+    portrait:
+      - { width: 1320, height: 2868 }
+      - { width: 1290, height: 2796 }
+      - { width: 1260, height: 2736 }
+    landscape:
+      - { width: 2868, height: 1320 }
+      - { width: 2796, height: 1290 }
+      - { width: 2736, height: 1260 }
+    preferred: { width: 1320, height: 2868 }
+  iphone_65:
+    family: iphone
+    display: 6.5
+    required: iphone_without_69
+    note: 仅当未提供 6.9" 时必填。提供 6.9" 后由 Apple 缩放。
+    portrait:
+      - { width: 1284, height: 2778 }
+      - { width: 1242, height: 2688 }
+    landscape:
+      - { width: 2778, height: 1284 }
+      - { width: 2688, height: 1242 }
+    preferred: { width: 1242, height: 2688 }
+  iphone_63:
+    family: iphone
+    display: 6.3
+    required: optional
+    portrait:
+      - { width: 1206, height: 2622 }
+      - { width: 1179, height: 2556 }
+    landscape:
+      - { width: 2622, height: 1206 }
+      - { width: 2556, height: 1179 }
+  ipad_13_master:
+    family: ipad
+    display: 13
+    required: ipad
+    note: iPad Pro M5/M4 与 13" 机型。应用支持 iPad 时必填。
+    portrait:
+      - { width: 2064, height: 2752 }
+      - { width: 2048, height: 2732 }
+    landscape:
+      - { width: 2752, height: 2064 }
+      - { width: 2732, height: 2048 }
+    preferred: { width: 2064, height: 2752 }
+  ipad_11:
+    family: ipad
+    display: 11
+    required: optional
+    portrait:
+      - { width: 1668, height: 2420 }
+      - { width: 1668, height: 2388 }
+      - { width: 1640, height: 2360 }
+      - { width: 1488, height: 2266 }
+    landscape:
+      - { width: 2420, height: 1668 }
+      - { width: 2388, height: 1668 }
+      - { width: 2360, height: 1640 }
+      - { width: 2266, height: 1488 }
+  macos_master:
+    family: mac
+    display: mac
+    required: mac
+    aspect_ratio: "16:10"
+    accepted:
+      - { width: 1280, height: 800 }
+      - { width: 1440, height: 900 }
+      - { width: 2560, height: 1600 }
+      - { width: 2880, height: 1800 }
+    preferred: { width: 2880, height: 1800 }
+  macos_iap_review:
+    family: mac
+    display: iap_review
+    required: each_iap
+    note: 内购审核截图，不是产品页预览图。
+    accepted:
+      - { width: 1280, height: 800 }
+    preferred: { width: 1280, height: 800 }

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-ios-app-store-release/references/screenshot-workflow.md

@@ -1,16 +1,72 @@
 # iOS/macOS 截图工作流
 
+尺寸、格式、张数与 canonical 画布只以 [screenshot-specs.yaml](screenshot-specs.yaml) 为准。后续自动 P 图也读那份文件。
+
+## 是否更新
+
+- `source=first`：必须采集并上传，`screenshots.update=true`
+- 后续版本默认 `screenshots.update=false`：把现网各 `displayType` 截图拷到本版本，不问
+- 仅当本版功能变化很大（新主界面、新核心能力、旧截图已不能代表产品、What's New 写了的能力在现网截图里看不到）时，才确认是否改为 `true`
+- `true`：按规格处理后再传，旧图不留在本版本对应语言/尺寸槽
+
 ## 采集
 
-从真实 iOS 模拟器和 macOS 应用构建采集截图。先向用户确认截图剧本：启动方式、测试账号引用、页面路径、测试数据、脱敏规则和中英文文案。禁止以与实际应用不一致的生成图替代功能展示。
+从真实 iOS 模拟器和 macOS 应用构建采集。先向用户确认截图剧本：启动方式、测试账号引用、页面路径、测试数据、脱敏规则和中英文文案。禁止以与实际应用不一致的生成图替代功能展示。
+
+- 模拟器外观跟系统，与 App 主题无关。深色产品先 `xcrun simctl ui <udid> appearance dark` 再 launch。
+- 画布必须落在目标 display 的 accepted 像素。真机分辨率不等于商店槽（如 6.1" 机 1170×2532，6.5" 槽要 1242×2688）。用该槽原生机型模拟器，或缩放且无 1 像素误差。
+- 状态栏可用 `xcrun simctl status_bar override` 固定时间与电量。
+- 中英各截一套。禁止同一张图只改文案冒充另一语言。
+- 真机无线调试通常没有截图 CLI；锁屏无法 launch。截不到改模拟器。
+- 禁止把尚未上架版本的界面写进仍在售版本的截图槽（Guideline 2.3.3）。
 
 ## 分平台输出
 
-- iOS 和 macOS 必须分别采集、设计、校验和上传，不能将同一图片简单缩放复用。
-- 每种平台、设备尺寸和语言输出 1 到 10 张 JPEG/JPG/PNG；不得包含 Alpha 通道。
-- macOS 使用 16:10：`1280x800`、`1440x900`、`2560x1600` 或 `2880x1800`。
-- iOS 根据目标 iPhone 展示尺寸选择 Apple 当前接受的规格；执行时先读取 Apple 官方截图规格，避免使用过期机型尺寸。
+- iOS 与 macOS 必须分别采集、设计和上传，不能把同一张图缩放后两用
+- iPhone 默认只出 `processing.canonical.ios` 指向的 display，画布用该 display 的 `preferred`
+- 应用支持 iPad：另出 `processing.canonical.ipados`
+- macOS 默认 `processing.canonical.macos`。内购审核图走 `macos_iap_review`
+- 张数、格式、Alpha、色彩空间用 `processing` 字段，不要另写一套
+
+## P 图契约
+
+后续自动 P 图必须：
+
+1. 读 `screenshot-specs.yaml` 的 `processing` 与对应 `preferred`
+2. 画布精确等于 `preferred` 宽高，不留 1 像素误差
+3. 去 Alpha、转 sRGB、导出 png 或 jpeg
+4. 中英文各一套；iOS 与 macOS 分套
+5. 先出本地预览清单，用户确认后再上传
 
 ## 上传前检查
 
-检查尺寸、方向、格式、无透明通道、语言目录、页面顺序、隐私脱敏和平台归属。先生成本地预览和上传清单，用户确认后才上传。
+检查尺寸是否落在该 display 的 accepted 列表、方向、格式、无透明通道、语言目录、页面顺序、隐私脱敏和平台归属。先生成本地预览和上传清单，用户确认后才上传。
+
+## 只补现网已有槽
+
+现网各 locale 的 `appScreenshotSets.screenshotDisplayType` 是槽位真相源。只向已有 displayType 补图或替换。不要因为 yaml `processing.canonical` 指向更大尺寸，就新建现网没有的 set。现网只有 6.5" 就出 6.5"；有 6.9" 才出 6.9"。
+
+## 送审后锁死
+
+`WAITING_FOR_REVIEW` / `IN_REVIEW` 不能增删改截图。API 409：`Can't Delete Screenshot After Submit for review` 或 `Can't Create Screenshot while Waiting For Review`。
+
+同一版本里：截图、更新说明、描述、关键词已送审即锁；`promotionalText` 仍可 PATCH。
+
+用户明确要求改已送审截图 → 先说明必须撤审、队列重排、定时发布日期可保留，再执行：
+
+1. `PATCH /v1/reviewSubmissions/{id}` `{canceled: true}`
+2. 等 submission `COMPLETE`、版本 `DEVELOPER_REJECTED`（不是 `PREPARE_FOR_SUBMISSION`）
+3. 换图（见下「替换一张」）
+4. **新建** `reviewSubmissions`（旧 id 作废）→ 挂同一 `appStoreVersion` → `submitted: true`
+5. 核对 `releaseType` 与 `earliestReleaseDate` 仍在
+
+## 替换一张（保留顺序）
+
+`DELETE` 后再 `POST`，新图会排到该 set **末尾**。先记下原 index，等 `assetDeliveryState.state=COMPLETE` 后：
+
+```
+PATCH /v1/appScreenshotSets/{setId}/relationships/appScreenshots
+{"data":[{"type":"appScreenshots","id":"<按原顺序的 id>"}]}
+```
+
+中英 set 分开替换，locale 不要混。

package/templates/ai-tools/skills//345/237/272/347/241/200/345/272/223/dwy-eui/references/eui-design-guide.md

@@ -154,8 +154,9 @@ neutral（默认）| blue | green | rose | orange | violet | slate
     v-model="page"
     :total="total"
     v-model:pageSize="pageSize"
-    showSizeChanger
-    showTotal
+    :page-sizes="[10, 20, 50, 100]"
+    show-size-changer
+    show-total
   />
 </div>
 ```