| name | capcut-theme-video |
| description | CapCut (剪映) one-tap video creation on Android. Always clear A_latest first (copy_images_to_album clear-only), then retrieve by time (list_gallery_images) or content (image-memories). Copy to A_latest (clear_album_first), CapCut 照片视频 → A_latest → 全部, multi_tap, N=K. |
| metadata | {"xomniclaw":{"always":false,"emoji":"🎬"}} |
剪映（CapCut）一键成片与相册选图
本 Skill 指导你如何获取目标照片、统一存入 A_latest 相册，并在剪映中完成「一键成片」。
何时使用
用户要：打开剪映、一键成片、从相册选多张图（按时间或按主题）、去成片 / 导出视频 等多步 UI 操作时加载本 Skill。
包名：com.lemon.lv
相册名 A_latest（硬规则）
- 本流程使用的相册名有且只有一个：
A_latest（与 Pictures/A_latest/ 及剪映「照片视频」下拉显示一致）。
- 禁止变体：
A_latest_风景、主题_A_latest、latest、带空格等；主题/时间只体现在检索，不要写进相册名。
- 入库前必须先清相册：最终写入时
copy_images_to_album 须 clear_album_first: true。
- 任意检索前也须先清空
A_latest（路径 A、路径 B 相同）：见下「步骤 0」。避免旧副本混入按时间的 list_gallery_images 结果，也避免按内容选图时相册里仍残留上一轮素材、与本次拷贝混淆。
核心策略：如何获取照片与目标张数 K
在进入剪映前，必须先确定要选哪些照片以及目标张数 K。不论是按时间还是按主题，所有选出的照片都必须先复制到 A_latest 相册中，然后在剪映里统一从 A_latest 相册中选取。
步骤 0：先清空 A_latest（路径 A 与路径 B 必做，先于一切检索）
在任何 list_gallery_images（路径 A）或 memory_search / memory_get（路径 B）之前，先调用 copy_images_to_album：
album_name: "A_latest"clear_album_first: true- 不要传
content_uris / media_ids → 工具只清空该相册（空相册则删除 0 条）。
原因简述：
- 路径 A：
A_latest 里旧副本仍在 MediaStore 时，date_preset 等未按相册排除的检索会把它们和真实目标照片混在一起。
- 路径 B：先清空可保证后续写入
A_latest 时相册状态干净，不与上一轮成片残留混淆。
可选探针（与直接先清空等价）：先 list_gallery_images，album_filter: "A_latest"，limit: 1；仅当 count ≥ 1 时再执行上述仅清空调用。
步骤 1：获取目标照片的 content_uris
完成步骤 0 后，按用户需求二选一：
路径 A：基于时间或相册名（非主题语义）
适用场景：用户明确要求「今天拍的照片」「昨天的照片」「最近 24 小时」，或者指定了具体的系统相册名。
操作步骤：
- 调用
list_gallery_images，使用 date_preset (today | yesterday | last_24h) 或 album_filter（必要时提高 limit，最大 100）。
- 从返回的图片列表中提取所有的
content_uri。
路径 B：基于特定主题、事件或图像内容
适用场景：用户要求按内容找图，如「风景」「海边」「猫」「去北京旅行」。
操作步骤：
- 提取主题词：从用户话里抽出检索用词。
- 检索 image-memories（按内容找图时不要用
list_gallery_images 的 name_filter 当主题检索：文件名多为 IMG…，不含「风景」「猫」等语义，易得到 0 条）：
- 调用
memory_search，query 填主题词；可适当增大 maxResults（建议 ≥ 10）、略降 minScore（建议 ≤ 0.4）以多召回。
- 遍历返回的
citations 列表，逐条 memory_get，提取 content_uri 或 media_id；不要只读一段就停，避免漏图。
步骤 2：写入固定相册 A_latest（硬规则）
无论走的是路径 A 还是路径 B，拿到 content_uris 或 media_ids 后：
- 调用
copy_images_to_album：album_name: "A_latest"，传入收集到的 content_uris 或 media_ids，clear_album_first: true（再次清空后拷贝；与步骤 0 衔接，避免遗漏或并发下残留）。
- 拷贝后调用
list_gallery_images，album_filter: "A_latest"，记下返回的 count，这就是目标张数 K。
- 在剪映中，必须先点「照片视频」下拉选择
A_latest 相册，再进行选图。
剪映操作执行步骤
1. Deep Link 直达一键成片相关页（优先）
无需在剪映首页再点「一键成片」时，用 device action=open 传 uri + package_name：
device(action="open", package_name="com.lemon.lv", uri="videocut://template/smart_recommend?enter_from=intelligent_edit&tab_name=edit")
随后 device(action="snapshot") 确认是否已进入选素材界面。若出现「是否允许打开剪映」等系统权限弹窗（如 com.oplus.securitypermission），先点允许再 snapshot。若 Deep Link 失败，请在首页用 ref 点击 text '一键成片'。
2. 选素材页：相册与分类切换
snapshot vs screenshot 硬规则（违反必失败）
全程只能用 device(action="snapshot") 返回带 refs 的无障碍树并用 tap ref 点击。禁止用 screenshot 盲猜坐标。
- 先点相册下拉（硬规则）：在树里找到
link '照片视频' 这一行，tap 这一行的 ref（带上 snapshot_id）。禁止用同区域附近的无文案 button 代替。
- 选择
A_latest 相册：展开列表后再 snapshot，在列表里找 text 'A_latest'（名称精确为 A_latest，无后缀）。
- 正确：
tap 紧挨在 text 'A_latest' 的「上一节点」那个 button 的 ref。
- 错误：误点后面的
button（那是下一行相册）。
- 切换到「全部」Tab（重要）：
- 选中
A_latest 后，剪映默认可能停留在「照片」或「视频」Tab。
- 必须在顶部 Tab 栏找到
text '全部'（或 button '全部'），点击其对应的 ref。
- 目的：确保能看到
A_latest 相册下的所有素材（无论图片还是视频）。
snapshot 确认 全部 已被选中（selected）。
3. 勾选素材（点「圈」不点「大图」）（批量点击）
- 勾选注意事项
在相册网格中，每个格子常出现一对相邻节点（先大块
button 再小 link 圈）：
- 只点勾选小圈：多为
link（未选中时无文案，选中后常带序号如 link '1' (selected)）。
- 禁止点大块无文案
button：那是整张缩略图区域，点击会进入大图预览。
- 使用
multi_tap 勾选全部：
- 在当前 Tab 网格中，只列各格勾选小圈的 ref（多为
link），勿混入同格大块无文案缩略图 button。
multi_tap 单次最多 15 个 ref（与单屏可见格数一致）；超出则：multi_tap 一批 → snapshot → 滚动 → 再 multi_tap 下一批。重复 ref 会去重（保序）。- 每次
act（含 multi_tap）须带当前最近一次 snapshot 返回的 snapshot_id（严格模式下 ref 会过期）。
- 校验：
- 核对张数：每次点击或
multi_tap 后必须 snapshot，核对底部 下一步 (N) 的 N 是否达到目标张数 K。
- 易错：界面常出现「选择3个以上素材，成片效果更佳」，这只是推荐，绝不表示选 3 张就可以点下一步。必须选到 N = K。
4. 等待与下一步
简要检查清单
- 步骤 0（两路径相同）：
copy_images_to_album（A_latest + clear_album_first: true，无 URIs）仅清空。
- 检索：路径 A →
list_gallery_images；路径 B → memory_search / memory_get → 得到 content_uri 列表。
- 统一入库：
copy_images_to_album（A_latest + clear_album_first: true + 本次 URIs）→ list_gallery_images album_filter: "A_latest" 得 K。
- 进入剪映：优先 Deep Link，失败则首页 ref 点击。
- 选相册集：下拉选择
A_latest。
- 切全部 Tab：必须点击「全部」Tab，确保素材可见。
- 选图：只点勾选小圈（
link）；multi_tap（≤15/次）配合 snapshot。
- 核对与等待：
下一步 (N) 直到 N = K；act + wait 再 snapshot。
