完整 Unity MCP 工具白名单 + 两级工具架构文档更新

- deploy.ps1: 自动写入 allowedTools 白名单至 ~/.claude/settings.json
  - 包含 Claude 内置工具 (Bash/Read/Write/Edit/Glob/Grep 等)
  - 包含全部 66 个核心 Unity MCP 工具 (mcp__unity-mcp__ 前缀)
  - 包含 unity_list_advanced_tools + unity_advanced_tool 代理 (200+ 高级工具)
  - 包含 6 个 Unity Hub 工具
  - 包含 multi-instance 和 project context 工具
  - 同步写入 WSL2 ~/.claude/settings.json 和 Windows %USERPROFILE%\.claude\settings.json
- README: 重写工具列表，反映两级架构 (288 工具)，说明高级工具分类与用法

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

claude-dev-stack/README.md

@@ -249,23 +249,52 @@ claude
 
 ### 可用 MCP 工具列表
 
-| 工具 | 功能 |
+AnkleBreaker Unity MCP 采用**两级工具架构**，共 **288 个工具**：
-|------|------|
+
-| `execute_menu_item` | 执行 Unity 菜单项 |
+- **核心工具（~70个）**：直接暴露，无需中转
-| `select_gameobject` | 选中场景中的 GameObject |
+- **高级工具（200+）**：通过 `unity_advanced_tool` 代理访问（避免 MCP 客户端工具过多失效）
-| `update_gameobject` | 更新/创建 GameObject 属性 |
+
-| `update_component` | 更新/添加组件 |
+#### 核心工具（直接可用）
-| `add_package` | 通过 Package Manager 安装包 |
+
-| `run_tests` | 运行 Unity Test Runner 测试 |
+| 分类 | 工具名 | 功能 |
-| `add_asset_to_scene` | 将 Asset 添加到场景 |
+|------|--------|------|
-| `create_prefab` | 创建 Prefab |
+| **编辑器状态** | `unity_editor_ping` / `unity_editor_state` / `unity_project_info` | 检测连接、获取编辑器/项目状态 |
-| `create_scene` / `load_scene` / `delete_scene` | 场景管理 |
+| **场景** | `unity_scene_info/open/save/new/hierarchy/stats` | 场景完整生命周期管理 |
-| `get_gameobject` | 获取 GameObject 详细信息 |
+| **GameObject** | `unity_gameobject_create/delete/info/set_transform/duplicate/set_active/reparent` | 对象增删改查 |
-| `get_console_logs` | 读取 Unity Console 日志 |
+| **组件** | `unity_component_add/remove/get_properties/set_property/set_reference/batch_wire` | 组件与属性操作 |
-| `recompile_scripts` | 重新编译脚本 |
+| **资产** | `unity_asset_list/import/delete/create_prefab/instantiate_prefab` | 资产管理 |
-| `create_material` / `assign_material` | 材质管理 |
+| **脚本** | `unity_script_create/read/update` + `unity_execute_code` | C# 脚本读写与运行时执行 |
-| `move/rotate/scale_gameobject` | Transform 操作 |
+| **材质** | `unity_material_create` / `unity_renderer_set_material` | 材质创建与赋值 |
-| `batch_execute` | 批量执行多个操作 |
+| **构建/运行** | `unity_build` / `unity_play_mode` | 多平台构建、Play Mode 控制 |
+| **控制台** | `unity_console_log/clear` + `unity_get_compilation_errors` | 日志读取与编译错误 |
+| **编辑器操作** | `unity_execute_menu_item` / `unity_undo/redo/undo_history` | 菜单执行、撤销重做 |
+| **选择/搜索** | `unity_selection_*` / `unity_search_by_*` / `unity_search_assets` | 对象查找与选中 |
+| **截图** | `unity_screenshot_game/scene` + `unity_graphics_*_capture` | 场景/游戏视图截图 |
+| **Prefab** | `unity_prefab_info` / `unity_set_object_reference` | Prefab 信息与引用 |
+| **包管理** | `unity_packages_list/add/remove/search/info` | Package Manager 操作 |
+| **Multi-Agent** | `unity_queue_info` / `unity_agents_list` / `unity_agent_log` | 多代理会话管理 |
+| **高级工具代理** | `unity_list_advanced_tools` / `unity_advanced_tool` | 访问 200+ 高级工具 |
+| **Unity Hub** | `unity_hub_list_editors/available_releases/install_editor/install_modules` | Hub 版本管理 |
+| **多实例** | `unity_list_instances` / `unity_select_instance` | 多 Unity 实例切换 |
+| **项目上下文** | `unity_get_project_context` | AI 代理项目文档注入 |
+
+#### 高级工具分类（通过 `unity_advanced_tool` 访问）
+
+动画、Prefab 模式、物理、光照、音频、地形、导航网格、粒子、UI、标签与层、输入系统、Shader Graph、VFX Graph、Amplify Shader Editor、性能分析器、帧调试器、内存分析器、ScriptableObject、约束、LOD、MPPM 多人 PlayMode、UMA Avatar 等 30+ 分类。
+
+```bash
+# 列出所有高级工具
+> 使用 unity_list_advanced_tools 查看所有高级工具
+
+# 按分类过滤
+> unity_list_advanced_tools { "category": "animation" }
+> unity_list_advanced_tools { "category": "terrain" }
+
+# 执行高级工具
+> unity_advanced_tool { "tool": "unity_animation_create_controller", "params": {...} }
+```
+
+`deploy.ps1` 会自动将所有工具写入 `~/.claude/settings.json` 的 `allowedTools` 白名单，**无需每次手动确认**。
 
 ---
 

claude-dev-stack/deploy.ps1

@@ -447,11 +447,75 @@ true
     Write-OK "Claude Code 安装完成"
 }
 
-# 写入 Claude 配置（WSL2 侧）
+# 写入 Claude 配置（WSL2 侧）— 含 allowedTools 完整白名单（自动信任，无需每次确认）
+$mcpAllowedTools = @(
+    # Claude 内置工具
+    "Bash","Read","Write","Edit","MultiEdit","Glob","Grep","LS","WebFetch","TodoRead","TodoWrite",
+    # Editor State
+    "mcp__unity-mcp__unity_editor_ping","mcp__unity-mcp__unity_editor_state","mcp__unity-mcp__unity_project_info",
+    # Scene
+    "mcp__unity-mcp__unity_scene_info","mcp__unity-mcp__unity_scene_open","mcp__unity-mcp__unity_scene_save",
+    "mcp__unity-mcp__unity_scene_new","mcp__unity-mcp__unity_scene_hierarchy","mcp__unity-mcp__unity_scene_stats",
+    # GameObject
+    "mcp__unity-mcp__unity_gameobject_create","mcp__unity-mcp__unity_gameobject_delete",
+    "mcp__unity-mcp__unity_gameobject_info","mcp__unity-mcp__unity_gameobject_set_transform",
+    "mcp__unity-mcp__unity_gameobject_duplicate","mcp__unity-mcp__unity_gameobject_set_active",
+    "mcp__unity-mcp__unity_gameobject_reparent",
+    # Component
+    "mcp__unity-mcp__unity_component_add","mcp__unity-mcp__unity_component_remove",
+    "mcp__unity-mcp__unity_component_get_properties","mcp__unity-mcp__unity_component_set_property",
+    "mcp__unity-mcp__unity_component_set_reference","mcp__unity-mcp__unity_component_batch_wire",
+    "mcp__unity-mcp__unity_component_get_referenceable",
+    # Asset
+    "mcp__unity-mcp__unity_asset_list","mcp__unity-mcp__unity_asset_import",
+    "mcp__unity-mcp__unity_asset_delete","mcp__unity-mcp__unity_asset_create_prefab",
+    "mcp__unity-mcp__unity_asset_instantiate_prefab",
+    # Script & Code
+    "mcp__unity-mcp__unity_script_create","mcp__unity-mcp__unity_script_read",
+    "mcp__unity-mcp__unity_script_update","mcp__unity-mcp__unity_execute_code",
+    # Material
+    "mcp__unity-mcp__unity_material_create","mcp__unity-mcp__unity_renderer_set_material",
+    # Build & Play Mode
+    "mcp__unity-mcp__unity_build","mcp__unity-mcp__unity_play_mode",
+    # Console & Compilation
+    "mcp__unity-mcp__unity_console_log","mcp__unity-mcp__unity_console_clear",
+    "mcp__unity-mcp__unity_get_compilation_errors",
+    # Editor Actions
+    "mcp__unity-mcp__unity_execute_menu_item","mcp__unity-mcp__unity_undo",
+    "mcp__unity-mcp__unity_redo","mcp__unity-mcp__unity_undo_history",
+    # Selection & Search
+    "mcp__unity-mcp__unity_selection_get","mcp__unity-mcp__unity_selection_set",
+    "mcp__unity-mcp__unity_selection_focus_scene_view","mcp__unity-mcp__unity_selection_find_by_type",
+    "mcp__unity-mcp__unity_search_by_component","mcp__unity-mcp__unity_search_by_tag",
+    "mcp__unity-mcp__unity_search_by_layer","mcp__unity-mcp__unity_search_by_name",
+    "mcp__unity-mcp__unity_search_assets","mcp__unity-mcp__unity_search_missing_references",
+    # Screenshots & Graphics
+    "mcp__unity-mcp__unity_screenshot_game","mcp__unity-mcp__unity_screenshot_scene",
+    "mcp__unity-mcp__unity_graphics_scene_capture","mcp__unity-mcp__unity_graphics_game_capture",
+    # Prefab
+    "mcp__unity-mcp__unity_prefab_info","mcp__unity-mcp__unity_set_object_reference",
+    # Packages
+    "mcp__unity-mcp__unity_packages_list","mcp__unity-mcp__unity_packages_add",
+    "mcp__unity-mcp__unity_packages_remove","mcp__unity-mcp__unity_packages_search",
+    "mcp__unity-mcp__unity_packages_info",
+    # Queue & Multi-Agent
+    "mcp__unity-mcp__unity_queue_info","mcp__unity-mcp__unity_agents_list","mcp__unity-mcp__unity_agent_log",
+    # Advanced Tools proxy（200+ 工具通过此代理访问）
+    "mcp__unity-mcp__unity_list_advanced_tools","mcp__unity-mcp__unity_advanced_tool",
+    # Unity Hub
+    "mcp__unity-mcp__unity_hub_list_editors","mcp__unity-mcp__unity_hub_available_releases",
+    "mcp__unity-mcp__unity_hub_install_editor","mcp__unity-mcp__unity_hub_install_modules",
+    "mcp__unity-mcp__unity_hub_get_install_path","mcp__unity-mcp__unity_hub_set_install_path",
+    # Multi-Instance & Project Context
+    "mcp__unity-mcp__unity_list_instances","mcp__unity-mcp__unity_select_instance",
+    "mcp__unity-mcp__unity_get_project_context"
+)
+$claudeSettingsJson = [ordered]@{ model = $CLAUDE_MODEL; allowedTools = $mcpAllowedTools } |
+    ConvertTo-Json -Depth 3
 $writeClaudeSettingsCmd = @"
 mkdir -p ~/.claude
 cat > ~/.claude/settings.json << 'SETTINGS'
-{"model": "$CLAUDE_MODEL"}
+$claudeSettingsJson
 SETTINGS
 true
 "@
@@ -472,7 +536,7 @@ Invoke-WSL $addEnvCmd -IgnoreError | Out-Null
 # Windows 侧 Claude 配置
 $claudeDir = "$env:USERPROFILE\.claude"
 if (-not (Test-Path $claudeDir)) { New-Item -ItemType Directory -Path $claudeDir | Out-Null }
-@{ model = $CLAUDE_MODEL } | ConvertTo-Json | Set-Content "$claudeDir\settings.json" -Encoding UTF8
+$claudeSettingsJson | Set-Content "$claudeDir\settings.json" -Encoding UTF8
 if ($ANTHROPIC_API_KEY) {
     [System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY",  $ANTHROPIC_API_KEY,  "User")
     [System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $ANTHROPIC_BASE_URL, "User")