From 803a09517ff4cc5a3febabfc29d0c94baf45dea5 Mon Sep 17 00:00:00 2001
From: furao <furao20261@gmail.com>
Date: Sun, 7 Jun 2026 17:58:15 +0800
Subject: [PATCH] =?UTF-8?q?docs(cli):=20=E8=A1=A5=E5=85=85=20QUICK-REF=20?=
 =?UTF-8?q?=E4=B8=AD=20prefab=20op=20=E4=B8=8E=20CLI=20=E5=AD=90=E5=91=BD?=
 =?UTF-8?q?=E4=BB=A4=E7=9A=84=E5=8C=BA=E5=88=AB=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 QUICK-REF.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/QUICK-REF.md b/QUICK-REF.md
index c30a16c..29fdaad 100644
--- a/QUICK-REF.md
+++ b/QUICK-REF.md
@@ -30,6 +30,8 @@ node extensions/cc-3-8-x-mcp/cli/bin/cocos-mcp-cli.js <command>
 | 看 stub 节点已写入的所有 propertyOverrides | `query <prefab> --selector overrides --id 58` |
 | 比较两个 prefab 字段差异 | `diff <a> <b>` |
 
+> ⚠️ **下方「改 prefab」各表列的是 op 名，不是独立子命令**——统一通过 `batch <prefab> ops.json` 执行（单条改动也要包成 `[{"op":"...",...}]`）。直接 `cli set-sprite-frame ...` 会报「未知子命令」。CLI 真正的子命令只有 `query` / `set`（单字段快捷写入 `set <prefab> <node> <field> <value>`）/ `batch` / `anim` / `diff`。写法见下方 §写 ops.json 速记。
+
 ### 改 prefab — 节点字段
 
 | 场景 | op |