@alpsckr/unitycli 0.4.5 → 0.5.0

package/docs/error-codes.md

@@ -73,7 +73,7 @@ alps-unity-cli 使用结构化错误码，包含机器可读的 `code`、`transi
 
 | 错误码 | 含义 | 恢复 |
 |--------|------|------|
-| `E_RUNTIME_NOT_READY` | Runtime 工具需 Play Mode | 先 `tools run editor.play`，transient 可重试 |
+| `E_RUNTIME_NOT_READY` | Runtime 工具需 Play Mode | 先 `tools run editor.play-mode.start`，transient 可重试 |
 | `E_RUNTIME_SESSION_STALE` | 运行时会话过期 | 重新进入 Play Mode |
 | `E_RUNTIME_TIMEOUT` | 运行时操作超时 | 增加 `--timeout-ms` 或重试 |
 
@@ -135,9 +135,9 @@ alps-unity-cli 使用结构化错误码，包含机器可读的 `code`、`transi
 | `E_PROJECT_SETTINGS_NO_FIELDS` | setter没有提供任何批准字段 | 按`tools describe project.*-settings.set`提供至少一个字段 |
 | `E_PROJECT_SETTINGS_INVALID` | 数值边界、分页、axis或Player enum输入非法 | 按错误中的精确字段约束修正输入 |
 | `E_PROJECT_SETTINGS_LIMIT_EXCEEDED` | legacy Input Manager超过4096个axis，无法在公开有界读取内安全扫描 | 减少Input Manager axis数量后重试 |
-| `E_PROJECT_INPUT_AXIS_NOT_FOUND` | 没有完全同名的legacy Input Manager axis | 先分页读取`project.input-settings`并传精确名称 |
+| `E_PROJECT_INPUT_AXIS_NOT_FOUND` | 没有完全同名的legacy Input Manager axis | 先分页读取`project-settings.input-settings`并传精确名称 |
 | `E_PROJECT_SETTINGS_TARGET_CHANGED` | 冻结的Input axis index/name在effect前漂移 | fresh读取Input设置后提交新请求 |
-| `E_PROJECT_SETTINGS_VERIFY_FAILED` | typed readback或ProjectSettings文件SHA未证明持久化终态 | 读取对应`project.*-settings`后再决定是否重试 |
+| `E_PROJECT_SETTINGS_VERIFY_FAILED` | typed readback或ProjectSettings文件SHA未证明持久化终态 | 读取对应`project-settings.*`后再决定是否重试 |
 
 ### Editor Utility 错误
 
@@ -183,7 +183,7 @@ alps-unity-cli 使用结构化错误码，包含机器可读的 `code`、`transi
 
 | 错误码 | 含义 | 恢复 |
 |--------|------|------|
-| `E_METHOD_NOT_FOUND` | 方法名或显式参数签名不存在 | 运行 `reflection.method.find` 并核对 `parameterType` |
+| `E_METHOD_NOT_FOUND` | 方法名或显式参数签名不存在 | 运行 `runtime-reflection.method.find` 并核对 `parameterType` |
 | `E_METHOD_AMBIGUOUS` | 多个 overload 与参数数量匹配 | 将选中签名的 `parameterType` 数组作为 `parameterTypes` 重试 |
 | `E_TYPE_NOT_FOUND` | 目标类型或参数类型不存在 | 使用完整 C# type name |
 
@@ -214,7 +214,7 @@ alps-unity-cli 使用结构化错误码，包含机器可读的 `code`、`transi
 ### nextActions 规则
 
 - Instance 错误的 `nextActions` 必须指向 `instances list`、显式 `--instance`、项目路径或关闭重复 Editor
-- Runtime 错误的 `nextActions` 必须指向 `tools run editor.play` 或 Play Mode 相关操作
+- Runtime 错误的 `nextActions` 必须指向 `tools run editor.play-mode.start` 或 Play Mode 相关操作
 - Discovery 错误的 `nextActions` 必须指向 `tools group`、`tools group list`、`tools search <k1|k2|...>` 或 `tools describe`
 - 弹窗 blocker 的 `nextActions` 必须指向先 `tools run editor.dialogs`，再 `tools run editor.dialog.click`；不得要求人工处理、预定义按钮列表、launch-only 入口或额外确认
 - 诊断错误的 `nextActions` 必须指向顶层 `doctor` 或对应 owner（`instances list`、`editor.state`、`extensions doctor`、Unity Console）

package/docs/extensions.md

@@ -103,7 +103,7 @@ unitycli extensions doctor --project <path>         # 扩展诊断
 
 | 扩展 | 状态 | 说明 |
 |------|------|------|
-| ProBuilder | ✅ 已实现 | 36 个扩展工具（create-shape/extrude-faces/delete-faces 等），只接受 `com.unity.probuilder@5.2.4` |
+| ProBuilder | ✅ 已实现 | 37 个扩展工具（create-shape/extrude-faces/delete-faces 等），只接受 `com.unity.probuilder@5.2.4` |
 | Cinemachine | ✅ 已实现 | Cinemachine camera/target/lens/shot 等工具，需要 `com.unity.cinemachine` |
 | VFX Graph | ✅ 已实现 | VFX Graph、ParticleSystem、LineRenderer、TrailRenderer 相关工具；VFX Graph 子集需要 `com.unity.visualeffectgraph` |
 | URP | ✅ 已实现 | URP renderer feature、volume、settings 等工具，需要 `com.unity.render-pipelines.universal` |
@@ -121,6 +121,6 @@ unitycli extensions doctor --project <path>         # 扩展诊断
 ## 取证与依赖
 
 - 扩展基础设施：`extensions list/install/remove/doctor`、`init --auto-detect`、缺依赖 descriptor 的 `available:false` / `unavailableReason` 与执行错误的 `nextActions`。
-- ProBuilder：源码位于 `extensions/probuilder/`，安装后位于 `Packages/com.alpsckr.unitycli/Extensions/probuilder/`，通过 project-tool bridge 路由提供扩展工具；所有 operation replay 固定于 `com.unity.probuilder@5.2.4`，版本不匹配时在 effect 前拒绝。
+- ProBuilder：源码位于 `extensions/probuilder/`，安装后位于 `Packages/com.alpsckr.unitycli/Extensions/probuilder/`，通过 catalog bridge 路由提供扩展工具；所有 operation replay 固定于 `com.unity.probuilder@5.2.4`，版本不匹配时在 effect 前拒绝。
 - Cinemachine/VFX/URP/HDRP：源码位于对应 `extensions/<id>/` 目录，安装后位于 `Packages/com.alpsckr.unitycli/Extensions/<id>/`，通过 metadata、bridge domain 和 C# command handler 提供 live Bridge 工具。
 - 验证入口：`npm test`、`npm run contracts:validate`、extension availability tests。

package/docs/risk-and-side-effects.md

@@ -21,18 +21,18 @@ Every tool carries risk hints in its descriptor. Public Tool and CLI control-pla
 |---------|-------|----------------------|
 | `tools run asset.delete` | Delete Asset | ✅ |
 | `tools run scene.save` | Save Scene | ✅ |
-| `tools run code.exec` | Execute Live Code | ✅ |
+| `tools run code.execute` | Execute Live Code | ✅ |
 | `tools run scriptable-object.create` | Create ScriptableObject Asset | ✅ |
 | `tools run scriptable-object.modify` | Modify ScriptableObject Asset | ✅ |
 | `tools run texture.modify` | Modify Texture Asset | ✅ |
 | `tools run texture.delete` | Delete Texture Asset | ✅ |
 | `tools run shader.delete` | Delete Shader Asset | ✅ |
-| `tools run object.modify` | Modify Object (deep patch) | ✅ |
-| `tools run reflection.method.call` | Call Method via Reflection | ✅ |
-| `tools run graphics.bake-clear` | Clear Baked Lighting | ❌ |
-| `tools run graphics.bake-start` | Start Light Bake | ❌ |
-| `tools run graphics.bake-reflection-probe` | Bake Reflection Probe | ❌ |
-| `tools run controller.remove-layer` | Remove Animator Controller Layer | ❌ |
+| `tools run serialized-object.patch` | Modify Object (deep patch) | ✅ |
+| `tools run runtime-reflection.method.invoke` | Call Method via Reflection | ✅ |
+| `tools run lighting.bake.clear` | Clear Baked Lighting | ❌ |
+| `tools run lighting.bake.start` | Start Light Bake | ❌ |
+| `tools run lighting.bake.reflection-probe` | Bake Reflection Probe | ❌ |
+| `tools run animator-controller.remove-layer` | Remove Animator Controller Layer | ❌ |
 | `tools run editor.menu` | Execute Editor Menu | ❌ |
 | `tools run package.embed` | Embed Package | ✅ |
 | `tools run package.install` | Package Install | ❌ |
@@ -41,9 +41,9 @@ Every tool carries risk hints in its descriptor. Public Tool and CLI control-pla
 | `tools run package.restore` | Package Restore | ✅ |
 | `tools run package.bridge-remove` | Package Bridge Remove | ✅ |
 
-`code.exec` keeps unrestricted synchronous C# execution. It does not reject infinite loops, long sleeps, blocking waits, lock contention, synchronous I/O, or long-running Unity API calls. Before submitting such code, the caller must decide whether it is necessary for the requested result and consider a bounded implementation or an existing Tool; necessary code may still be executed unchanged. After `Run` starts on the Unity Editor main thread, `--timeout-ms` can stop the CLI from waiting but cannot stop the C# code. The Editor can remain unresponsive, the mutation owner can remain active, Unity state can be partial or unknown, and recovery can require terminating the Editor process. A timeout is not proof that the code stopped, so inspect business state before retrying. Dry-run only previews the source hash and planned effect; it does not compile, execute, or prove termination.
+`code.execute` keeps unrestricted synchronous C# execution. It does not reject infinite loops, long sleeps, blocking waits, lock contention, synchronous I/O, or long-running Unity API calls. Before submitting such code, the caller must decide whether it is necessary for the requested result and consider a bounded implementation or an existing Tool; necessary code may still be executed unchanged. After `Run` starts on the Unity Editor main thread, `--timeout-ms` can stop the CLI from waiting but cannot stop the C# code. The Editor can remain unresponsive, the mutation owner can remain active, Unity state can be partial or unknown, and recovery can require terminating the Editor process. A timeout is not proof that the code stopped, so inspect business state before retrying. Dry-run only previews the source hash and planned effect; it does not compile, execute, or prove termination.
 
-The `reflection.method.call` tool performs no scope restriction on the invoked method (public/private/static/instance, any namespace/assembly, Editor/Runtime). Its risk metadata describes that effect; invoking the public Tool authorizes execution. When a method name has overloads, pass the selected signature's `parameterType` values as `parameterTypes`.
+The `runtime-reflection.method.invoke` tool performs no scope restriction on the invoked method (public/private/static/instance, any namespace/assembly, Editor/Runtime). Its risk metadata describes that effect; invoking the public Tool authorizes execution. When a method name has overloads, pass the selected signature's `parameterType` values as `parameterTypes`.
 
 ### Optional Preview
 
@@ -88,7 +88,7 @@ Each Unity domain validates the complete Tool table before publishing its single
 ## Cross-Reference
 
 - Runtime and execution errors: [error-codes](./error-codes.md)
-- Tool descriptor field coverage: [tool-discovery](./tool-discovery.md) §Descriptor field coverage
+- Tool descriptor field coverage: [tool-discovery](./tool-discovery.md) §tools describe
 - Tool metadata schema: [../schemas/tool-metadata.schema.json](../schemas/tool-metadata.schema.json)
-- Security policy source: `src/security-policy.ts` and `src/security.ts`
-- AI skill (compact version): [/skills/unitycli/SKILL.md](../skills/unitycli/SKILL.md)
+- Destructive metadata source: TS tool metadata and bridge specs (`src/tools/**`, `src/bridge/domains/*.ts`) plus C# `ToolDescriptor.DestructiveHint`, cross-checked by `src/contracts/command-contract.ts`
+- AI skill entry: [skills/unitycli/SKILL.md](../skills/unitycli/SKILL.md)

package/docs/safety-boundaries.md

@@ -32,25 +32,25 @@ alps-unity-cli的安全模型围绕三个核心原则：Tool副作用必须准
 | `tools run texture.modify` | 修改 Texture 资产 |
 | `tools run texture.delete` | 删除 Texture 资产 |
 | `tools run shader.delete` | 删除 Shader 资产 |
-| `tools run object.modify` | 修改场景对象或持久资产数据 |
+| `tools run serialized-object.patch` | 修改场景对象或持久资产数据 |
 | `tools run component.modify` | 修改场景组件或持久 Prefab/资产组件 |
 | `tools run texture.import-settings` | 持久化 TextureImporter 设置 |
 | `tools run texture.sprite` | 持久化 Sprite importer 与切片设置 |
-| `tools run graphics.quality` | 持久化 QualitySettings |
-| `tools run graphics.pipeline-settings` | 持久化默认 RenderPipelineAsset 并触发资产导入 |
-| `tools run graphics.bake-settings` | 持久化 LightingSettings 与场景绑定 |
+| `tools run rendering.quality` | 持久化 QualitySettings |
+| `tools run rendering.pipeline.settings` | 持久化默认 RenderPipelineAsset 并触发资产导入 |
+| `tools run lighting.bake.settings` | 持久化 LightingSettings 与场景绑定 |
 | `tools run build.platform.set` | 持久切换 active BuildTarget |
 | `tools run build.profile.switch` | 持久切换 active Build Profile |
 | `tools run editor.menu` | 执行编辑器菜单项 |
-| `tools run reflection.method.call` | 调用精确同步 C# overload，并要求独立 completion proof |
+| `tools run runtime-reflection.method.invoke` | 调用精确同步 C# overload，并要求独立 completion proof |
 | `tools run package.install` | 安装包 |
 | `tools run package.remove` | 移除包 |
 | `tools run package.deploy` | 复制本地 package 源到项目 Packages 目录 |
 | `tools run package.restore` | 从 package.deploy 备份恢复或移除部署目录 |
 | `tools run package.bridge-remove` | 移除 init 复制的 Bridge 包 |
-| `tools run code.exec` | 在已打开的 Unity Editor 中执行代码 |
+| `tools run code.execute` | 在已打开的 Unity Editor 中执行代码 |
 
-`code.exec`保留完整的同步C#执行能力，不按代码内容拒绝死循环、长时间sleep、阻塞等待、锁等待、同步I/O或长期占用Unity API。调用方在提交这类代码前必须先判断它对当前结果是否确有必要，并考虑有界写法或现有Tool能否达到同一结果；确有必要时仍可原样执行。代码一旦在Unity Editor主线程开始，`--timeout-ms`和取消只能停止CLI等待，不能强制中止正在运行的C#。Unity可能无响应，mutation owner可能无法收尾，业务状态可能部分改变或无法证明，恢复可能需要结束Editor进程。此时timeout不表示代码已经停止，不能据此直接重试。`--dry-run`只返回source hash和planned effect，不编译、不执行，也不验证代码能够结束。
+`code.execute`保留完整的同步C#执行能力，不按代码内容拒绝死循环、长时间sleep、阻塞等待、锁等待、同步I/O或长期占用Unity API。调用方在提交这类代码前必须先判断它对当前结果是否确有必要，并考虑有界写法或现有Tool能否达到同一结果；确有必要时仍可原样执行。代码一旦在Unity Editor主线程开始，`--timeout-ms`和取消只能停止CLI等待，不能强制中止正在运行的C#。Unity可能无响应，mutation owner可能无法收尾，业务状态可能部分改变或无法证明，恢复可能需要结束Editor进程。此时timeout不表示代码已经停止，不能据此直接重试。`--dry-run`只返回source hash和planned effect，不编译、不执行，也不验证代码能够结束。
 
 ### 可选预览
 

package/docs/tool-discovery.md

@@ -60,7 +60,7 @@ unitycli tools search 'project-summary|scene' --page-size 20 --cursor <nextCurso
 执行前读取单个 Tool 的完整 descriptor：
 
 ```powershell
-unitycli tools describe camera.screenshot
+unitycli tools describe screenshot.from-camera
 ```
 
 公开字段：

package/docs/tool-execution.md

@@ -9,10 +9,10 @@
 unitycli tools run camera.list --input '{}'
 
 # 通过 --input-file 传参（JSON 文件）
-unitycli tools run camera.screenshot --input-file params.json
+unitycli tools run screenshot.from-camera --input-file params.json
 
 # 通过 --stdin 传参
-echo '{"target":"Main Camera"}' | unitycli tools run camera.screenshot --stdin
+echo '{"target":"Main Camera"}' | unitycli tools run screenshot.from-camera --stdin
 ```
 
 ## 执行路由
@@ -33,10 +33,10 @@ echo '{"target":"Main Camera"}' | unitycli tools run camera.screenshot --stdin
 
 ```powershell
 # 正确：提供 inputSchema 要求的字段
-unitycli tools run camera.screenshot --input '{"target":"Main Camera","output":"shot.png"}'
+unitycli tools run screenshot.from-camera --input '{"target":"Main Camera","output":"shot.png"}'
 
 # 错误：缺少必需字段
-unitycli tools run camera.screenshot --input '{}'
+unitycli tools run screenshot.from-camera --input '{}'
 # → E_SCHEMA_INVALID, nextActions 指向 tools describe
 ```
 
@@ -66,10 +66,10 @@ Bridge-backed Tool由Unity Editor主线程执行。业务请求发送前，sessi
 
 ### `editor.compile`
 
-`editor.compile` 是唯一公开编译 Tool。一次调用在同一 root request 下等待 pre-existing import/compile、触发 owned compilation cycle、跨 domain reload 恢复、收集本次 `CompilationPipeline` diagnostics，并等待 Editor 与 listener 重新稳定。公开成功要求 `compile.completed=true`、`errorCount=0`、`editorState.status=ready`；warning 可作为 diagnostics 返回。compiler error 返回 `E_UNITY_COMPILE_FAILED`，不会用旧 Console 历史判断本次结果。
+`editor.compile` 是唯一公开编译 Tool。一次调用在同一 root request 下等待 pre-existing import/compile、刷新 Asset Database，并由 Unity 判断导入的脚本变化是否需要编译。Tool 只观察刷新后出现的新 `CompilationPipeline` cycle，不额外调用 `RequestScriptCompilation()`；有编译时跨 domain reload 恢复并收集本次 diagnostics，没有编译时返回 `compile.status="unchanged"`、`compilationTriggered=false` 和 `noOpReason="no-script-changes"`。公开成功要求 `compile.completed=true`、`errorCount=0`、`editorState.status=ready`；warning 可作为 diagnostics 返回。compiler error 返回 `E_UNITY_COMPILE_FAILED`，不会用旧 Console 历史判断本次结果。
 
 ```powershell
-unitycli tools run editor.compile --input '{"refresh":true,"includeWarnings":true}' --timeout-ms 120000
+unitycli tools run editor.compile --input '{"includeWarnings":true}' --timeout-ms 120000
 ```
 
 accepted、queued、phase、run ID 和 listener 字段仅属于内部 coordinator，不会成为公开成功。稳定 Play Mode 调用返回 `E_UNITY_COMPILE_REQUIRES_EDIT_MODE`；dry-run 只返回 planned effects，不触发 refresh 或 compile。
@@ -107,8 +107,8 @@ unitycli tools run asset.delete --input '{"path":"Assets/Temp.mat"}'
 通用规则：
 
 - discovery 的 `tools group list`、`tools search` 和省略name的`command`列表默认每页20项、最大100项；继续读取时将`pageInfo.nextCursor`原值传回CLI `--cursor`。
-- `console.get`、`scene.hierarchy`、`go.find`、`profiler.hierarchy`、`profiler.frame-debugger.events`、`profiler.memory-snapshot.list`、`type.schema` 和 `reflection.method.find` 使用 opaque string `nextCursor`。游标绑定原始位置、selector 与 Unity/assembly generation；Frame Debugger 游标还绑定 Editor listener、CLI enable/disable generation、事件数与捕获首尾签名。游标必须原样传回，改变 selector、generation 或捕获后返回 `E_CONTINUATION_STALE`。`truncated=true` 表示还有原始位置；不能把当前页数量当作总数。
-- 深度序列化工具（`object.get-data`、`asset.get-data`、`component.get`）优先传 `paths` 或 `viewQuery`。`maxDepth` 为 `0..16`，`maxArrayItems` 为 `1..1000`，`paths` 最多128条并保持输入顺序；cycle/depth 在展开前裁决，所有路径共享同一预算，非 `IList` enumerable 不会预 materialize。`truncated` 与 `nextPath` 表示被截断子树。
+- `console.read`、`scene.hierarchy`、`game-object.find`、`profiler.hierarchy`、`profiler.frame-debugger.events`、`profiler.memory-snapshot.list`、`runtime-reflection.type.schema` 和 `runtime-reflection.method.find` 使用 opaque string `nextCursor`。游标绑定原始位置、selector 与 Unity/assembly generation；Frame Debugger 游标还绑定 Editor listener、CLI enable/disable generation、事件数与捕获首尾签名。游标必须原样传回，改变 selector、generation 或捕获后返回 `E_CONTINUATION_STALE`。`truncated=true` 表示还有原始位置；不能把当前页数量当作总数。
+- 深度序列化工具（`serialized-object.read`、`asset.get-data`、`component.get`）优先传 `paths` 或 `viewQuery`。`maxDepth` 为 `0..16`，`maxArrayItems` 为 `1..1000`，`paths` 最多128条并保持输入顺序；cycle/depth 在展开前裁决，所有路径共享同一预算，非 `IList` enumerable 不会预 materialize。`truncated` 与 `nextPath` 表示被截断子树。
 - 上述 Unity 主线程读取默认共用 `10000` scanned records、`4096` nodes、`2048` getters、`4096` reflection calls、`250ms` monotonic main-thread work 和 `1 MiB` serialized UTF-8。`budget` 可收紧或提高到公开上限 `100000`、`20000`、`10000`、`20000`、`2000ms`、`8 MiB`；零、负数或超限值在读取/effect前返回 `E_SCHEMA_INVALID` 或 `E_REQUEST_BUDGET_INVALID`。
 - 文本源码工具（如 `shader.read`）使用 `offset` 和 `maxBytes` 分段读取。输出 `truncated=true` 时，下一次把 `nextOffset` 作为新的 `offset`。
 - 截图/相机捕获的单图边长最多8192且最多16777216像素，capture count最多36。完整计划必须在首个effect前满足默认33554432 total pixels、128 MiB peak temporary memory、64 MiB artifact bytes；公开上限为67108864、256 MiB、256 MiB。`orbit`逐图释放，`surround`逐图写入contact sheet后释放，不同时保留所有tile。内联图片仍限512 KiB。
@@ -142,7 +142,7 @@ unitycli tools run shader.read --input '{"path":"Assets/Shaders/Probe.shader","m
 | 错误码 | 原因 | 恢复方式 |
 |--------|------|---------|
 | `E_TOOL_NOT_FOUND_FOR_TARGET` | 名称不属于当前实例完整 Tool 目录 | 运行 `tools search <k1|k2|...>` 发现相关 Tool，再用 `tools describe` 检查 requiresPackages 和 available |
-| `E_RUNTIME_NOT_READY` | Runtime 工具但非 Play Mode | 先执行 `tools run editor.play`，transient 可重试 |
+| `E_RUNTIME_NOT_READY` | Runtime 工具但非 Play Mode | 先执行 `tools run editor.play-mode.start`，transient 可重试 |
 | `E_SCHEMA_INVALID` | 输入缺少 inputSchema.required 字段 | 查看 `tools describe` 的 inputSchema |
 | `E_DRY_RUN_UNSUPPORTED` | 工具不支持 dry-run | 去除可选 `--dry-run` 后直接调用 |
 | `E_INSTANCE_CONFLICT` | 至少两个verified live process claim属于同一canonical project | 关闭重复Editor，只保留目标session |
@@ -157,24 +157,24 @@ unitycli tools run shader.read --input '{"path":"Assets/Shaders/Probe.shader","m
 
 ## Object 与 Component 修改
 
-`object.modify` 和 `component.modify` 只接受非空 `pathPatches`。每一项必须是可由 Unity `SerializedObject.FindProperty` 定位并 fresh readback 的 direct `replace`；不提供 merge、add、remove、reflection member path 或 diff 旁路。支持的值类型以当前 `inputSchema` 和错误 `nextActions` 为准。
+`serialized-object.patch` 和 `component.modify` 只接受非空 `pathPatches`。每一项必须是可由 Unity `SerializedObject.FindProperty` 定位并 fresh readback 的 direct `replace`；不提供 merge、add、remove、reflection member path 或 diff 旁路。支持的值类型以当前 `inputSchema` 和错误 `nextActions` 为准。
 
-`path` 使用 Unity serialized property path，例如 `m_Name`、`m_LocalPosition.x` 或数组的 `Array.data[0]`。它不是 `/` 分隔的 C# member path。`asset.modify` 是独立的文本资产覆写 Tool，不使用 ObjectPatch。
+`path` 使用 Unity serialized property path，例如 `m_Name`、`m_LocalPosition.x` 或数组的 `Array.data[0]`。它不是 `/` 分隔的 C# member path。`asset.write-text` 是独立的文本资产覆写 Tool，不使用 ObjectPatch。
 
 ```powershell
 # 先读后改
 unitycli tools run component.get --input '{"path":"Player","component":"Rigidbody"}'
 unitycli tools run component.modify --input '{"path":"Player","component":"Rigidbody","pathPatches":[{"path":"m_Mass","op":"replace","value":10}]}'
 
-unitycli tools run object.modify --input '{"path":"Player","pathPatches":[{"path":"m_Name","op":"replace","value":"PlayerModified"}]}'
+unitycli tools run serialized-object.patch --input '{"path":"Player","pathPatches":[{"path":"m_Name","op":"replace","value":"PlayerModified"}]}'
 ```
 
-## reflection.method.call
+## runtime-reflection.method.invoke
 
-`reflection.method.call` 不做调用范围限制（public/private/static/instance、任意 namespace/assembly、Editor/Runtime），且 `destructiveHint: true`。先用 `reflection.method.find` 获取签名；存在同名 overload 时，将选中签名的 `parameterType` 数组作为 `parameterTypes`。公开调用即授权：
+`runtime-reflection.method.invoke` 不做调用范围限制（public/private/static/instance、任意 namespace/assembly、Editor/Runtime），且 `destructiveHint: true`。先用 `runtime-reflection.method.find` 获取签名；存在同名 overload 时，将选中签名的 `parameterType` 数组作为 `parameterTypes`。公开调用即授权：
 
 ```powershell
-unitycli tools run reflection.method.call --input '{
+unitycli tools run runtime-reflection.method.invoke --input '{
   "typeName":"UnityEngine.Transform",
   "methodName":"Translate",
   "parameterTypes":["UnityEngine.Vector3","UnityEngine.Space"],
@@ -187,4 +187,4 @@ unitycli tools run reflection.method.call --input '{
 
 ## asset.get-data 复用 serializer
 
-`asset.get-data` 是 asset-friendly wrapper，底层复用 `object.get-data` 的 `ObjectSerializer`，不重复实现序列化。`object.get-data` 是任意 `UnityEngine.Object` 深序列化主入口，`asset.get-data` 提供按 assetPath 解析的便捷入口。
+`asset.get-data` 是 asset-friendly wrapper，底层复用 `serialized-object.read` 的 `ObjectSerializer`，不重复实现序列化。`serialized-object.read` 是任意 `UnityEngine.Object` 深序列化主入口，`asset.get-data` 提供按 assetPath 解析的便捷入口。

package/extensions/cinemachine/bridge/domains/cinemachine.ts

@@ -2,20 +2,20 @@ import { boolFlag, compactArgs, floatFlag, numberFlag, stringFlag, targetArgs }
 import type { BridgeCommandSpec } from "../types.js";
 
 export const cinemachineBridgeSpecs: BridgeCommandSpec[] = markToolsOnly([
-  { group: "cinemachine", command: "ping", bridgeCommand: "project-tool.run", toolName: "cinemachine.ping", buildArgs: cinemachinePingArgs },
-  { group: "cinemachine", command: "create", bridgeCommand: "project-tool.run", toolName: "cinemachine.create", buildArgs: cinemachineCreateArgs },
-  { group: "cinemachine", command: "target", bridgeCommand: "project-tool.run", toolName: "cinemachine.target", buildArgs: cinemachineTargetArgs },
-  { group: "cinemachine", command: "lens", bridgeCommand: "project-tool.run", toolName: "cinemachine.lens", buildArgs: cinemachineLensArgs },
-  { group: "cinemachine", command: "priority", bridgeCommand: "project-tool.run", toolName: "cinemachine.priority", buildArgs: cinemachinePriorityArgs },
-  { group: "cinemachine", command: "blend", bridgeCommand: "project-tool.run", toolName: "cinemachine.blend", buildArgs: cinemachineBlendArgs },
-  { group: "cinemachine", command: "body", bridgeCommand: "project-tool.run", toolName: "cinemachine.body", buildArgs: cinemachineBodyArgs },
-  { group: "cinemachine", command: "aim", bridgeCommand: "project-tool.run", toolName: "cinemachine.aim", buildArgs: cinemachineAimArgs },
-  { group: "cinemachine", command: "noise", bridgeCommand: "project-tool.run", toolName: "cinemachine.noise", buildArgs: cinemachineNoiseArgs },
-  { group: "cinemachine", command: "brain.ensure", bridgeCommand: "project-tool.run", toolName: "cinemachine.brain.ensure", buildArgs: cinemachineTargetOnlyArgs },
-  { group: "cinemachine", command: "brain.status", bridgeCommand: "project-tool.run", toolName: "cinemachine.brain.status", buildArgs: cinemachineTargetOnlyArgs },
-  { group: "cinemachine", command: "extension.list", bridgeCommand: "project-tool.run", toolName: "cinemachine.extension.list", buildArgs: cinemachineTargetOnlyArgs },
-  { group: "cinemachine", command: "extension.add", bridgeCommand: "project-tool.run", toolName: "cinemachine.extension.add", buildArgs: cinemachineExtensionTypeArgs },
-  { group: "cinemachine", command: "extension.remove", bridgeCommand: "project-tool.run", toolName: "cinemachine.extension.remove", buildArgs: cinemachineExtensionTypeArgs }
+  { group: "cinemachine", command: "ping", bridgeCommand: "catalog.editor.run", toolName: "cinemachine.ping", buildArgs: cinemachinePingArgs },
+  { group: "cinemachine", command: "create", bridgeCommand: "catalog.editor.run", toolName: "cinemachine.create", buildArgs: cinemachineCreateArgs },
+  { group: "cinemachine", command: "target", bridgeCommand: "catalog.editor.run", toolName: "cinemachine.target", buildArgs: cinemachineTargetArgs },
+  { group: "cinemachine", command: "lens", bridgeCommand: "catalog.editor.run", toolName: "cinemachine.lens", buildArgs: cinemachineLensArgs },
+  { group: "cinemachine", command: "priority", bridgeCommand: "catalog.editor.run", toolName: "cinemachine.priority", buildArgs: cinemachinePriorityArgs },
+  { group: "cinemachine", command: "blend", bridgeCommand: "catalog.editor.run", toolName: "cinemachine.blend", buildArgs: cinemachineBlendArgs },
+  { group: "cinemachine", command: "body", bridgeCommand: "catalog.editor.run", toolName: "cinemachine.body", buildArgs: cinemachineBodyArgs },
+  { group: "cinemachine", command: "aim", bridgeCommand: "catalog.editor.run", toolName: "cinemachine.aim", buildArgs: cinemachineAimArgs },
+  { group: "cinemachine", command: "noise", bridgeCommand: "catalog.editor.run", toolName: "cinemachine.noise", buildArgs: cinemachineNoiseArgs },
+  { group: "cinemachine", command: "brain.ensure", bridgeCommand: "catalog.editor.run", toolName: "cinemachine.brain.ensure", buildArgs: cinemachineTargetOnlyArgs },
+  { group: "cinemachine", command: "brain.status", bridgeCommand: "catalog.editor.run", toolName: "cinemachine.brain.status", buildArgs: cinemachineTargetOnlyArgs },
+  { group: "cinemachine", command: "extension.list", bridgeCommand: "catalog.editor.run", toolName: "cinemachine.extension.list", buildArgs: cinemachineTargetOnlyArgs },
+  { group: "cinemachine", command: "extension.add", bridgeCommand: "catalog.editor.run", toolName: "cinemachine.extension.add", buildArgs: cinemachineExtensionTypeArgs },
+  { group: "cinemachine", command: "extension.remove", bridgeCommand: "catalog.editor.run", toolName: "cinemachine.extension.remove", buildArgs: cinemachineExtensionTypeArgs }
 ]);
 
 function markToolsOnly(specs: BridgeCommandSpec[]): BridgeCommandSpec[] {

package/extensions/hdrp/bridge/domains/hdrp.ts

@@ -2,13 +2,13 @@ import { boolFlag, compactArgs, floatFlag, stringFlag } from "../args.js";
 import type { BridgeCommandSpec } from "../types.js";
 
 export const hdrpBridgeSpecs: BridgeCommandSpec[] = markToolsOnly([
-  { group: "hdrp", command: "volume-list", bridgeCommand: "project-tool.run", toolName: "hdrp.volume.list", buildArgs: emptyArgs },
-  { group: "hdrp", command: "volume-create", bridgeCommand: "project-tool.run", toolName: "hdrp.volume.create", buildArgs: volumeCreateArgs },
-  { group: "hdrp", command: "volume-info", bridgeCommand: "project-tool.run", toolName: "hdrp.volume.info", buildArgs: volumeTargetArgs },
-  { group: "hdrp", command: "volume-add-effect", bridgeCommand: "project-tool.run", toolName: "hdrp.volume.add-effect", buildArgs: volumeEffectArgs },
-  { group: "hdrp", command: "volume-set", bridgeCommand: "project-tool.run", toolName: "hdrp.volume.set", buildArgs: volumeSetArgs },
-  { group: "hdrp", command: "settings-get", bridgeCommand: "project-tool.run", toolName: "hdrp.settings.get", buildArgs: emptyArgs },
-  { group: "hdrp", command: "settings-set", bridgeCommand: "project-tool.run", toolName: "hdrp.settings.set", buildArgs: hdrpSettingsArgs, destructiveHint: true, supportsDryRun: true }
+  { group: "hdrp", command: "volume.list", bridgeCommand: "catalog.editor.run", toolName: "hdrp.volume.list", buildArgs: emptyArgs },
+  { group: "hdrp", command: "volume.create", bridgeCommand: "catalog.editor.run", toolName: "hdrp.volume.create", buildArgs: volumeCreateArgs },
+  { group: "hdrp", command: "volume.info", bridgeCommand: "catalog.editor.run", toolName: "hdrp.volume.info", buildArgs: volumeTargetArgs },
+  { group: "hdrp", command: "volume.add-effect", bridgeCommand: "catalog.editor.run", toolName: "hdrp.volume.add-effect", buildArgs: volumeEffectArgs },
+  { group: "hdrp", command: "volume.set", bridgeCommand: "catalog.editor.run", toolName: "hdrp.volume.set", buildArgs: volumeSetArgs },
+  { group: "hdrp", command: "settings.get", bridgeCommand: "catalog.editor.run", toolName: "hdrp.settings.get", buildArgs: emptyArgs },
+  { group: "hdrp", command: "settings.set", bridgeCommand: "catalog.editor.run", toolName: "hdrp.settings.set", buildArgs: hdrpSettingsArgs, destructiveHint: true, supportsDryRun: true }
 ]);
 
 function markToolsOnly(specs: BridgeCommandSpec[]): BridgeCommandSpec[] {

package/extensions/hdrp/unitypkg/Editor/Hdrp/HdrpToolSupport.cs

@@ -415,7 +415,7 @@ namespace UnityCli
             var profile = HdrpToolSupport.GetProfileForPlanning(volume.GetComponent(HdrpToolSupport.VolumeType)) as VolumeProfile;
             var addMethod = HdrpToolSupport.VolumeProfileType.GetMethod("Add", new[] { typeof(Type), typeof(bool) });
             if (profile == null || addMethod == null) throw new UnityCliBridge.BridgeCommandException(errorPrefix + "_VOLUME_PROFILE_NOT_FOUND", "The target Volume has no writable Add API.", "Create a Volume or assign a profile before adding an effect.");
-            if (profile.components.Any(component => component != null && effectType.IsInstanceOfType(component))) throw new UnityCliBridge.BridgeCommandException(errorPrefix + "_VOLUME_EFFECT_EXISTS", "The requested effect is already present: " + effectTypeName, "Use volume.set to modify the existing effect.");
+            if (profile.components.Any(component => component != null && effectType.IsInstanceOfType(component))) throw new UnityCliBridge.BridgeCommandException(errorPrefix + "_VOLUME_EFFECT_EXISTS", "The requested effect is already present: " + effectTypeName, "Use hdrp.volume.set to modify the existing effect.");
         }
 
         internal sealed class VolumeSetMutationPlan { internal int GameObjectId { get; set; } internal int PlanningProfileId { get; set; } internal int SharedProfileId { get; set; } internal Type EffectType { get; set; } internal string PropertyPath { get; set; } internal SerializedPropertyType PropertyType { get; set; } internal object ExpectedValue { get; set; } internal string ExpectedReadback { get; set; } }
@@ -488,7 +488,7 @@ namespace UnityCli
             var addMethod = HdrpToolSupport.VolumeProfileType.GetMethod("Add", new[] { typeof(Type), typeof(bool) });
             if (profile == null || addMethod == null) throw new UnityCliBridge.BridgeCommandException(errorPrefix + "_VOLUME_PROFILE_NOT_FOUND", "The target Volume has no writable in-memory profile.", "Create a Volume with hdrp.volume.create or assign a profile before adding an effect.");
             var countBefore = profile.components.Count(component => component != null && effectType.IsInstanceOfType(component));
-            if (countBefore != 0) throw new UnityCliBridge.BridgeCommandException(errorPrefix + "_VOLUME_EFFECT_EXISTS", "The requested effect is already present: " + effectTypeName, "Use volume.set to modify the existing effect.");
+            if (countBefore != 0) throw new UnityCliBridge.BridgeCommandException(errorPrefix + "_VOLUME_EFFECT_EXISTS", "The requested effect is already present: " + effectTypeName, "Use hdrp.volume.set to modify the existing effect.");
             addMethod.Invoke(profile, new object[] { effectType, true });
             var observedObject = ResolveVolume(gameObject.GetInstanceID().ToString(CultureInfo.InvariantCulture), errorPrefix);
             var observedProfile = HdrpToolSupport.GetVolumeProfile(observedObject.GetComponent(HdrpToolSupport.VolumeType)) as VolumeProfile;

package/extensions/probuilder/bridge/domains/probuilder.ts

@@ -4,10 +4,10 @@ import type { BridgeCommandSpec, BridgeFlags } from "../types.js";
 /**
  * ProBuilder extension bridge specs — 37 single-action tools.
  *
- * Each CLI command is routed through the project-tool.run bridge command
+ * Each CLI command is routed through the catalog.editor.run bridge command
  * to reach ProBuilder IUnityCliTool handlers in the Unity package. The
- * bridgeCommand field is always "project-tool.run";
- * the toolName field carries the underlying project-tool name (e.g.
+ * bridgeCommand field is always "catalog.editor.run";
+ * the toolName field carries the underlying catalog tool name (e.g.
  * "probuilder.ping"). The buildArgs output is wrapped into { name, input }
  * so the C# ProjectToolRun handler receives both the tool name and its
  * JSON input payload.
@@ -15,63 +15,63 @@ import type { BridgeCommandSpec, BridgeFlags } from "../types.js";
 
 export const probuilderBridgeSpecs: BridgeCommandSpec[] = markToolsOnly([
   // ─── Utility ───────────────────────────────────────────
-  { group: "probuilder", command: "ping", bridgeCommand: "project-tool.run", toolName: "probuilder.ping", buildArgs: probuilderPingArgs },
-  { group: "probuilder", command: "scene", bridgeCommand: "project-tool.run", toolName: "probuilder.scene", buildArgs: probuilderSceneArgs },
+  { group: "probuilder", command: "ping", bridgeCommand: "catalog.editor.run", toolName: "probuilder.ping", buildArgs: probuilderPingArgs },
+  { group: "probuilder", command: "scene", bridgeCommand: "catalog.editor.run", toolName: "probuilder.scene", buildArgs: probuilderSceneArgs },
 
   // ─── Shape Creation ────────────────────────────────────
-  { group: "probuilder", command: "create-shape", bridgeCommand: "project-tool.run", toolName: "probuilder.create-shape", buildArgs: probuilderCreateShapeArgs },
-  { group: "probuilder", command: "create-poly-shape", bridgeCommand: "project-tool.run", toolName: "probuilder.create-poly-shape", buildArgs: probuilderCreatePolyShapeArgs },
+  { group: "probuilder", command: "create-shape", bridgeCommand: "catalog.editor.run", toolName: "probuilder.create-shape", buildArgs: probuilderCreateShapeArgs },
+  { group: "probuilder", command: "create-poly-shape", bridgeCommand: "catalog.editor.run", toolName: "probuilder.create-poly-shape", buildArgs: probuilderCreatePolyShapeArgs },
 
   // ─── Face Operations ──────────────────────────────────
-  { group: "probuilder", command: "extrude-faces", bridgeCommand: "project-tool.run", toolName: "probuilder.extrude-faces", buildArgs: probuilderTargetWithIndicesArgs },
-  { group: "probuilder", command: "delete-faces", bridgeCommand: "project-tool.run", toolName: "probuilder.delete-faces", buildArgs: probuilderTargetWithIndicesArgs },
-  { group: "probuilder", command: "detach-faces", bridgeCommand: "project-tool.run", toolName: "probuilder.detach-faces", buildArgs: probuilderDetachFacesArgs },
-  { group: "probuilder", command: "merge-faces", bridgeCommand: "project-tool.run", toolName: "probuilder.merge-faces", buildArgs: probuilderTargetWithIndicesArgs },
-  { group: "probuilder", command: "subdivide", bridgeCommand: "project-tool.run", toolName: "probuilder.subdivide", buildArgs: probuilderTargetWithOptionalIndicesArgs },
-  { group: "probuilder", command: "flip-normals", bridgeCommand: "project-tool.run", toolName: "probuilder.flip-normals", buildArgs: probuilderTargetWithOptionalIndicesArgs },
-  { group: "probuilder", command: "select-faces", bridgeCommand: "project-tool.run", toolName: "probuilder.select-faces", buildArgs: probuilderSelectFacesArgs },
-  { group: "probuilder", command: "set-face-material", bridgeCommand: "project-tool.run", toolName: "probuilder.set-face-material", buildArgs: probuilderSetFaceMaterialArgs },
-  { group: "probuilder", command: "set-face-color", bridgeCommand: "project-tool.run", toolName: "probuilder.set-face-color", buildArgs: probuilderSetFaceColorArgs },
-  { group: "probuilder", command: "set-face-uvs", bridgeCommand: "project-tool.run", toolName: "probuilder.set-face-uvs", buildArgs: probuilderSetFaceUvsArgs },
+  { group: "probuilder", command: "extrude-faces", bridgeCommand: "catalog.editor.run", toolName: "probuilder.extrude-faces", buildArgs: probuilderTargetWithIndicesArgs },
+  { group: "probuilder", command: "delete-faces", bridgeCommand: "catalog.editor.run", toolName: "probuilder.delete-faces", buildArgs: probuilderTargetWithIndicesArgs },
+  { group: "probuilder", command: "detach-faces", bridgeCommand: "catalog.editor.run", toolName: "probuilder.detach-faces", buildArgs: probuilderDetachFacesArgs },
+  { group: "probuilder", command: "merge-faces", bridgeCommand: "catalog.editor.run", toolName: "probuilder.merge-faces", buildArgs: probuilderTargetWithIndicesArgs },
+  { group: "probuilder", command: "subdivide", bridgeCommand: "catalog.editor.run", toolName: "probuilder.subdivide", buildArgs: probuilderTargetWithOptionalIndicesArgs },
+  { group: "probuilder", command: "flip-normals", bridgeCommand: "catalog.editor.run", toolName: "probuilder.flip-normals", buildArgs: probuilderTargetWithOptionalIndicesArgs },
+  { group: "probuilder", command: "select-faces", bridgeCommand: "catalog.editor.run", toolName: "probuilder.select-faces", buildArgs: probuilderSelectFacesArgs },
+  { group: "probuilder", command: "set-face-material", bridgeCommand: "catalog.editor.run", toolName: "probuilder.set-face-material", buildArgs: probuilderSetFaceMaterialArgs },
+  { group: "probuilder", command: "set-face-color", bridgeCommand: "catalog.editor.run", toolName: "probuilder.set-face-color", buildArgs: probuilderSetFaceColorArgs },
+  { group: "probuilder", command: "set-face-uvs", bridgeCommand: "catalog.editor.run", toolName: "probuilder.set-face-uvs", buildArgs: probuilderSetFaceUvsArgs },
 
   // ─── Edge Operations ──────────────────────────────────
-  { group: "probuilder", command: "extrude-edges", bridgeCommand: "project-tool.run", toolName: "probuilder.extrude-edges", buildArgs: probuilderEdgeArgs },
-  { group: "probuilder", command: "bevel-edges", bridgeCommand: "project-tool.run", toolName: "probuilder.bevel-edges", buildArgs: probuilderBevelArgs },
-  { group: "probuilder", command: "bridge-edges", bridgeCommand: "project-tool.run", toolName: "probuilder.bridge-edges", buildArgs: probuilderBridgeEdgesArgs },
-  { group: "probuilder", command: "connect-elements", bridgeCommand: "project-tool.run", toolName: "probuilder.connect-elements", buildArgs: probuilderConnectArgs },
+  { group: "probuilder", command: "extrude-edges", bridgeCommand: "catalog.editor.run", toolName: "probuilder.extrude-edges", buildArgs: probuilderEdgeArgs },
+  { group: "probuilder", command: "bevel-edges", bridgeCommand: "catalog.editor.run", toolName: "probuilder.bevel-edges", buildArgs: probuilderBevelArgs },
+  { group: "probuilder", command: "bridge-edges", bridgeCommand: "catalog.editor.run", toolName: "probuilder.bridge-edges", buildArgs: probuilderBridgeEdgesArgs },
+  { group: "probuilder", command: "connect-elements", bridgeCommand: "catalog.editor.run", toolName: "probuilder.connect-elements", buildArgs: probuilderConnectArgs },
 
   // ─── Mesh Combine / Merge ─────────────────────────────
-  { group: "probuilder", command: "combine-meshes", bridgeCommand: "project-tool.run", toolName: "probuilder.combine-meshes", buildArgs: probuilderMultiTargetArgs },
-  { group: "probuilder", command: "merge-objects", bridgeCommand: "project-tool.run", toolName: "probuilder.merge-objects", buildArgs: probuilderMergeObjectsArgs },
-  { group: "probuilder", command: "duplicate-and-flip", bridgeCommand: "project-tool.run", toolName: "probuilder.duplicate-and-flip", buildArgs: probuilderTargetWithOptionalIndicesArgs },
-  { group: "probuilder", command: "create-polygon", bridgeCommand: "project-tool.run", toolName: "probuilder.create-polygon", buildArgs: probuilderCreatePolygonArgs },
+  { group: "probuilder", command: "combine-meshes", bridgeCommand: "catalog.editor.run", toolName: "probuilder.combine-meshes", buildArgs: probuilderMultiTargetArgs },
+  { group: "probuilder", command: "merge-objects", bridgeCommand: "catalog.editor.run", toolName: "probuilder.merge-objects", buildArgs: probuilderMergeObjectsArgs },
+  { group: "probuilder", command: "duplicate-and-flip", bridgeCommand: "catalog.editor.run", toolName: "probuilder.duplicate-and-flip", buildArgs: probuilderTargetWithOptionalIndicesArgs },
+  { group: "probuilder", command: "create-polygon", bridgeCommand: "catalog.editor.run", toolName: "probuilder.create-polygon", buildArgs: probuilderCreatePolygonArgs },
 
   // ─── Vertex Operations ────────────────────────────────
-  { group: "probuilder", command: "merge-vertices", bridgeCommand: "project-tool.run", toolName: "probuilder.merge-vertices", buildArgs: probuilderVertexIndicesArgs },
-  { group: "probuilder", command: "weld-vertices", bridgeCommand: "project-tool.run", toolName: "probuilder.weld-vertices", buildArgs: probuilderWeldArgs },
-  { group: "probuilder", command: "split-vertices", bridgeCommand: "project-tool.run", toolName: "probuilder.split-vertices", buildArgs: probuilderVertexIndicesArgs },
-  { group: "probuilder", command: "move-vertices", bridgeCommand: "project-tool.run", toolName: "probuilder.move-vertices", buildArgs: probuilderMoveVerticesArgs },
-  { group: "probuilder", command: "insert-vertex", bridgeCommand: "project-tool.run", toolName: "probuilder.insert-vertex", buildArgs: probuilderInsertVertexArgs },
-  { group: "probuilder", command: "append-vertices-to-edge", bridgeCommand: "project-tool.run", toolName: "probuilder.append-vertices-to-edge", buildArgs: probuilderAppendVerticesArgs },
+  { group: "probuilder", command: "merge-vertices", bridgeCommand: "catalog.editor.run", toolName: "probuilder.merge-vertices", buildArgs: probuilderVertexIndicesArgs },
+  { group: "probuilder", command: "weld-vertices", bridgeCommand: "catalog.editor.run", toolName: "probuilder.weld-vertices", buildArgs: probuilderWeldArgs },
+  { group: "probuilder", command: "split-vertices", bridgeCommand: "catalog.editor.run", toolName: "probuilder.split-vertices", buildArgs: probuilderVertexIndicesArgs },
+  { group: "probuilder", command: "move-vertices", bridgeCommand: "catalog.editor.run", toolName: "probuilder.move-vertices", buildArgs: probuilderMoveVerticesArgs },
+  { group: "probuilder", command: "insert-vertex", bridgeCommand: "catalog.editor.run", toolName: "probuilder.insert-vertex", buildArgs: probuilderInsertVertexArgs },
+  { group: "probuilder", command: "append-vertices-to-edge", bridgeCommand: "catalog.editor.run", toolName: "probuilder.append-vertices-to-edge", buildArgs: probuilderAppendVerticesArgs },
 
   // ─── Info / Inspection ────────────────────────────────
-  { group: "probuilder", command: "mesh-info", bridgeCommand: "project-tool.run", toolName: "probuilder.mesh-info", buildArgs: probuilderMeshInfoArgs },
-  { group: "probuilder", command: "validate-mesh", bridgeCommand: "project-tool.run", toolName: "probuilder.validate-mesh", buildArgs: probuilderTargetOnlyArgs },
+  { group: "probuilder", command: "mesh-info", bridgeCommand: "catalog.editor.run", toolName: "probuilder.mesh-info", buildArgs: probuilderMeshInfoArgs },
+  { group: "probuilder", command: "validate-mesh", bridgeCommand: "catalog.editor.run", toolName: "probuilder.validate-mesh", buildArgs: probuilderTargetOnlyArgs },
 
   // ─── Conversion ───────────────────────────────────────
-  { group: "probuilder", command: "convert-to-probuilder", bridgeCommand: "project-tool.run", toolName: "probuilder.convert-to-probuilder", buildArgs: probuilderTargetOnlyArgs },
+  { group: "probuilder", command: "convert-to-probuilder", bridgeCommand: "catalog.editor.run", toolName: "probuilder.convert-to-probuilder", buildArgs: probuilderTargetOnlyArgs },
 
   // ─── Smoothing ────────────────────────────────────────
-  { group: "probuilder", command: "set-smoothing", bridgeCommand: "project-tool.run", toolName: "probuilder.set-smoothing", buildArgs: probuilderSetSmoothingArgs },
-  { group: "probuilder", command: "auto-smooth", bridgeCommand: "project-tool.run", toolName: "probuilder.auto-smooth", buildArgs: probuilderAutoSmoothArgs },
+  { group: "probuilder", command: "set-smoothing", bridgeCommand: "catalog.editor.run", toolName: "probuilder.set-smoothing", buildArgs: probuilderSetSmoothingArgs },
+  { group: "probuilder", command: "auto-smooth", bridgeCommand: "catalog.editor.run", toolName: "probuilder.auto-smooth", buildArgs: probuilderAutoSmoothArgs },
 
   // ─── Pivot / Transform ────────────────────────────────
-  { group: "probuilder", command: "center-pivot", bridgeCommand: "project-tool.run", toolName: "probuilder.center-pivot", buildArgs: probuilderTargetOnlyArgs },
-  { group: "probuilder", command: "freeze-transform", bridgeCommand: "project-tool.run", toolName: "probuilder.freeze-transform", buildArgs: probuilderTargetOnlyArgs },
-  { group: "probuilder", command: "set-pivot", bridgeCommand: "project-tool.run", toolName: "probuilder.set-pivot", buildArgs: probuilderSetPivotArgs },
+  { group: "probuilder", command: "center-pivot", bridgeCommand: "catalog.editor.run", toolName: "probuilder.center-pivot", buildArgs: probuilderTargetOnlyArgs },
+  { group: "probuilder", command: "freeze-transform", bridgeCommand: "catalog.editor.run", toolName: "probuilder.freeze-transform", buildArgs: probuilderTargetOnlyArgs },
+  { group: "probuilder", command: "set-pivot", bridgeCommand: "catalog.editor.run", toolName: "probuilder.set-pivot", buildArgs: probuilderSetPivotArgs },
 
   // ─── Repair ───────────────────────────────────────────
-  { group: "probuilder", command: "repair-mesh", bridgeCommand: "project-tool.run", toolName: "probuilder.repair-mesh", buildArgs: probuilderTargetOnlyArgs }
+  { group: "probuilder", command: "repair-mesh", bridgeCommand: "catalog.editor.run", toolName: "probuilder.repair-mesh", buildArgs: probuilderTargetOnlyArgs }
 ]);
 
 function markToolsOnly(specs: BridgeCommandSpec[]): BridgeCommandSpec[] {

package/extensions/probuilder/unitypkg/Editor/ProBuilder/ProBuilderErrors.cs

@@ -5,7 +5,7 @@ namespace UnityCli.ProBuilder
     /// <summary>
     /// ProBuilder 工具 handler 的结构化错误工厂。
     /// 统一返回 <see cref="UnityCliBridge.BridgeCommandException"/>，由调用处 throw 出去，
-    /// 经 project-tool.run / runtime-tool.run 的 catch 块转成标准错误 envelope。
+    /// 经 catalog.editor.run / catalog.player.run 的 catch 块转成标准错误 envelope。
     /// 错误码统一使用当前 extension dependency、target、schema、operation 与 outcome unknown 契约，
     /// details 与多个 nextActions 通过 exception 字段透传。
     /// </summary>

package/extensions/urp/bridge/domains/urp.ts

@@ -2,18 +2,18 @@ import { boolFlag, compactArgs, floatFlag, numberFlag, stringFlag } from "../arg
 import type { BridgeCommandSpec } from "../types.js";
 
 export const urpBridgeSpecs: BridgeCommandSpec[] = markToolsOnly([
-  { group: "urp", command: "feature-list", bridgeCommand: "project-tool.run", toolName: "urp.feature.list", buildArgs: emptyArgs },
-  { group: "urp", command: "feature-add", bridgeCommand: "project-tool.run", toolName: "urp.feature.add", buildArgs: urpFeatureAddArgs, destructiveHint: true, supportsDryRun: true },
-  { group: "urp", command: "feature-toggle", bridgeCommand: "project-tool.run", toolName: "urp.feature.toggle", buildArgs: urpFeatureToggleArgs, destructiveHint: true, supportsDryRun: true },
-  { group: "urp", command: "feature-configure", bridgeCommand: "project-tool.run", toolName: "urp.feature.configure", buildArgs: urpFeatureConfigureArgs, destructiveHint: true, supportsDryRun: true },
-  { group: "urp", command: "feature-remove", bridgeCommand: "project-tool.run", toolName: "urp.feature.remove", buildArgs: urpFeatureIndexArgs, destructiveHint: true, supportsDryRun: true },
-  { group: "urp", command: "volume-list", bridgeCommand: "project-tool.run", toolName: "urp.volume.list", buildArgs: emptyArgs },
-  { group: "urp", command: "volume-create", bridgeCommand: "project-tool.run", toolName: "urp.volume.create", buildArgs: volumeCreateArgs },
-  { group: "urp", command: "volume-info", bridgeCommand: "project-tool.run", toolName: "urp.volume.info", buildArgs: volumeTargetArgs },
-  { group: "urp", command: "volume-add-effect", bridgeCommand: "project-tool.run", toolName: "urp.volume.add-effect", buildArgs: volumeEffectArgs },
-  { group: "urp", command: "volume-set", bridgeCommand: "project-tool.run", toolName: "urp.volume.set", buildArgs: volumeSetArgs },
-  { group: "urp", command: "settings-get", bridgeCommand: "project-tool.run", toolName: "urp.settings.get", buildArgs: emptyArgs },
-  { group: "urp", command: "settings-set", bridgeCommand: "project-tool.run", toolName: "urp.settings.set", buildArgs: urpSettingsArgs, destructiveHint: true, supportsDryRun: true }
+  { group: "urp", command: "feature.list", bridgeCommand: "catalog.editor.run", toolName: "urp.feature.list", buildArgs: emptyArgs },
+  { group: "urp", command: "feature.add", bridgeCommand: "catalog.editor.run", toolName: "urp.feature.add", buildArgs: urpFeatureAddArgs, destructiveHint: true, supportsDryRun: true },
+  { group: "urp", command: "feature.toggle", bridgeCommand: "catalog.editor.run", toolName: "urp.feature.toggle", buildArgs: urpFeatureToggleArgs, destructiveHint: true, supportsDryRun: true },
+  { group: "urp", command: "feature.configure", bridgeCommand: "catalog.editor.run", toolName: "urp.feature.configure", buildArgs: urpFeatureConfigureArgs, destructiveHint: true, supportsDryRun: true },
+  { group: "urp", command: "feature.remove", bridgeCommand: "catalog.editor.run", toolName: "urp.feature.remove", buildArgs: urpFeatureIndexArgs, destructiveHint: true, supportsDryRun: true },
+  { group: "urp", command: "volume.list", bridgeCommand: "catalog.editor.run", toolName: "urp.volume.list", buildArgs: emptyArgs },
+  { group: "urp", command: "volume.create", bridgeCommand: "catalog.editor.run", toolName: "urp.volume.create", buildArgs: volumeCreateArgs },
+  { group: "urp", command: "volume.info", bridgeCommand: "catalog.editor.run", toolName: "urp.volume.info", buildArgs: volumeTargetArgs },
+  { group: "urp", command: "volume.add-effect", bridgeCommand: "catalog.editor.run", toolName: "urp.volume.add-effect", buildArgs: volumeEffectArgs },
+  { group: "urp", command: "volume.set", bridgeCommand: "catalog.editor.run", toolName: "urp.volume.set", buildArgs: volumeSetArgs },
+  { group: "urp", command: "settings.get", bridgeCommand: "catalog.editor.run", toolName: "urp.settings.get", buildArgs: emptyArgs },
+  { group: "urp", command: "settings.set", bridgeCommand: "catalog.editor.run", toolName: "urp.settings.set", buildArgs: urpSettingsArgs, destructiveHint: true, supportsDryRun: true }
 ]);
 
 function markToolsOnly(specs: BridgeCommandSpec[]): BridgeCommandSpec[] {

package/extensions/urp/unitypkg/Editor/Urp/UrpToolSupport.cs

@@ -592,7 +592,7 @@ namespace UnityCli
             var addMethod = UrpToolSupport.VolumeProfileType.GetMethod("Add", new[] { typeof(Type), typeof(bool) });
             if (profile == null || addMethod == null) throw new UnityCliBridge.BridgeCommandException(errorPrefix + "_VOLUME_PROFILE_NOT_FOUND", "The target Volume has no writable in-memory profile.", "Create a Volume with urp.volume.create or assign a profile before adding an effect.");
             var countBefore = profile.components.Count(component => component != null && effectType.IsInstanceOfType(component));
-            if (countBefore != 0) throw new UnityCliBridge.BridgeCommandException(errorPrefix + "_VOLUME_EFFECT_EXISTS", "The requested effect is already present: " + effectTypeName, "Use volume.set to modify the existing effect.");
+            if (countBefore != 0) throw new UnityCliBridge.BridgeCommandException(errorPrefix + "_VOLUME_EFFECT_EXISTS", "The requested effect is already present: " + effectTypeName, "Use urp.volume.set to modify the existing effect.");
             addMethod.Invoke(profile, new object[] { effectType, true });
             var observedObject = ResolveVolume(gameObject.GetInstanceID().ToString(CultureInfo.InvariantCulture), errorPrefix);
             var observedProfile = UrpToolSupport.GetVolumeProfile(observedObject.GetComponent(UrpToolSupport.VolumeType)) as VolumeProfile;
@@ -613,7 +613,7 @@ namespace UnityCli
             var profile = UrpToolSupport.GetProfileForPlanning(ResolveVolume(target, errorPrefix).GetComponent(UrpToolSupport.VolumeType)) as VolumeProfile;
             var addMethod = UrpToolSupport.VolumeProfileType.GetMethod("Add", new[] { typeof(Type), typeof(bool) });
             if (profile == null || addMethod == null) throw new UnityCliBridge.BridgeCommandException(errorPrefix + "_VOLUME_PROFILE_NOT_FOUND", "The target Volume has no writable Add API.", "Create a Volume with urp.volume.create or assign a profile before adding an effect.");
-            if (profile.components.Any(component => component != null && effectType.IsInstanceOfType(component))) throw new UnityCliBridge.BridgeCommandException(errorPrefix + "_VOLUME_EFFECT_EXISTS", "The requested effect is already present: " + effectTypeName, "Use volume.set to modify the existing effect.");
+            if (profile.components.Any(component => component != null && effectType.IsInstanceOfType(component))) throw new UnityCliBridge.BridgeCommandException(errorPrefix + "_VOLUME_EFFECT_EXISTS", "The requested effect is already present: " + effectTypeName, "Use urp.volume.set to modify the existing effect.");
         }
 
         internal sealed class VolumeSetMutationPlan