Store Media

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install metarun-store-media
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 metarun-store-media。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Store Media 引导 AI 编码代理通过 MetaRun 和 Apple 的 App Asset Library 管理 iOS App Store 媒体。只需上传一次素材，即可将同一个媒体库文件放置到可编辑的 App 版本、自定义产品页面、App 内活动或产品页面测试方案中。
此工作流程涵盖目录与放置位置发现、文件验证、上传、排序、替换、清理和验证。Openclaw Skills 用户可以使用注重安全的流程，检查 Apple 的要求，并在应用前预览每项写入操作。

应用场景

将截图或 App 预览视频上传到 App Store 商品页面。
添加产品页面页眉、搜索结果图片或 App 内活动卡片等创意素材。
将现有媒体库素材放置到多个受支持的界面。
替换特定截图，同时保留其在放置顺序中的位置。
重新排列截图或移除放置项，而不删除底层媒体库文件。
检查素材处理状态，并按界面和本地化语言报告最终放置情况。

工作原理

使用 apple_list_apps 查找 App，然后查询 apple_get_asset_catalog，以了解受支持的放置类型、设备组、尺寸、格式、限制和视频规则。
检查 apple_list_asset_surfaces，找到目标版本、自定义产品页面、活动或测试方案，并确认其父项可编辑。
对于本地图片或视频，使用 studio_create_media_upload 创建上传 URL，使用返回的 curl 命令 PUT 文件字节，然后完成上传。文件必须可通过 HTTPS 源 URL 访问。
使用 apple_preview_upload_library_asset 预览媒体库上传内容，选择正确的固定类别，并在向用户展示预览后使用 apple_apply_upload_library_asset 应用。
对于视频，使用 apple_get_library_asset 检查处理情况；等待其状态变为 PREPARE_FOR_SUBMISSION 后再放置。查看 Apple 返回的任何 FAILED 原因。
使用素材 ID、放置类型、运行时放置组 ID，以及界面本地化 ID 或语言区域，预览并应用放置操作。必要时使用预览/应用重新排序或替换工具。
对每个受影响的界面和语言，使用 apple_list_asset_placements 验证更改，并使用 apple_get_asset_library 报告媒体库素材及其放置数量。

配置指南

能够运行 npx 的 Node.js 工具。
通过 MCP 服务器或 MetaRun CLI 访问 MetaRun。
使用 MetaRun 个人访问令牌进行身份验证，除非已使用 npx metarun login 登录。
npx metarun login
或者，将 METARUN_TOKEN 作为环境变量提供。登录凭据会存储在 ~/.metarun/config.json 中。
在当前会话中尚不清楚工具架构时，使用该工具前先获取其架构；不要猜测参数：
npx metarun tools apple_get_asset_catalog --json
通过 MetaRun MCP 服务器或 CLI 运行工具：
npx metarun run ''
对于本地媒体，使用上传流程返回的 curl 命令，将字节 PUT 到存储空间，然后完成上传。图片和视频最大可达 500 MB。每项写入都必须使用对应的预览/应用流程：展示预览结果，并在应用更改前获得用户确认。

数据架构

素材组织
数据 作用
App Asset Library 素材 上传的文件，由应用上传后返回的 createdId 标识。
类别 上传时固定：截图和 App 预览使用 APP_SCREENSHOTS_AND_PREVIEWS，页眉、搜索结果和活动图片使用 CREATIVE_ASSETS。
放置项 将媒体库素材放入某个界面一个槽位的引用；同一素材可以有多个放置项。
放置组 apple_get_asset_catalog 返回的运行时 ID；应查找该 ID，而不要猜测设备系列 ID。
界面和本地化 可编辑的 App 版本、自定义产品页面、App 内活动或产品页面测试方案，使用相关本地化 ID 或语言区域标识。
处理状态 视频就绪情况和故障由 apple_get_library_asset 报告；PREPARE_FOR_SUBMISSION 表示已就绪，FAILED 会包含 Apple 提供的原因。
媒体库会将文件与放置项分开存储。移除放置项会保留媒体库中的文件；只要素材仍有放置项，就会阻止删除媒体库素材，除非用户明确同意移除其放置项。放置顺序按槽位维护，App 内活动槽位只包含一个素材，而不是有序列表。

高级特性

从 Apple 实时素材目录中发现准确的设备组 ID、像素尺寸、支持的格式、视频限制和放置上限。
通过媒体库工作流程支持截图、App 预览视频、创意素材、自定义产品页面、App 内活动和产品页面测试方案。
对上传、放置、排序、替换、移除、删除和更新使用预览/应用流程；应用写入前必须展示预览。
通过 Apple 的移除并重建操作替换单个放置项，同时恢复其原有位置。
将可重复使用的媒体库文件与界面放置项分开管理，使一个素材可用于多个位置。
检查视频处理状态，并支持使用
previewFrameTimeCode
更新视频静止帧。
支持已批准素材的重命名或归档操作，并提供考虑放置状态的删除保护。
更改后按界面和语言列出放置项进行验证，包括顺序和状态；放置项会随其父项一起经过 App Review。
普通截图仍可使用经典截图集工具；App 预览视频、创意素材和 iPhone Duo 则必须使用媒体库。

name: store-media description: >- Put screenshots, app preview videos, and creative assets (product page
headers, search results art, in-app event cards) on an iOS app's App Store
pages through Apple's App Asset Library, via MetaRun: upload each file
once, place it on the listing, custom product pages, in-app events, or
product page tests, order it, verify it. Trigger phrases: "upload these
screenshots", "add an app preview", "iPhone Duo screenshots", "product page
header", "event card image", "asset library", "swap screenshot 3", "put
the new screenshots on the store".