文档更新: 补充性能优化与防御性增强的说明

- UPDATE_LOG.md: 新增 2026-03-04 性能优化章节(JSON压缩、队列限制、子节点上限)

- 注意事项.md: 补充队列长度限制(100/429)和子节点上限(50/childrenTruncated)说明

- README.md: 更新并发安全特性描述和 get_scene_hierarchy 参数说明
This commit is contained in:
火焰库拉
2026-03-04 09:35:03 +08:00
parent f7b39b2f58
commit fb4025e50b
3 changed files with 25 additions and 2 deletions

View File

@@ -28,7 +28,7 @@
- **全局搜索**: 在项目中搜索文本内容
- **撤销/重做**: 管理编辑器的撤销栈
- **特效管理**: 创建和修改粒子系统
- **并发安全**: 指令队列串行化执行,防止编辑器卡死
- **并发安全**: 指令队列串行化执行,队列上限 100 条(超限返回 HTTP 429防止编辑器卡死
- **超时保护**: IPC 通信和指令队列均有超时兜底机制
- **属性保护**: 组件核心属性黑名单机制,防止 AI 篡改 `node`/`uuid` 等引用导致崩溃
- **AI 容错**: 参数别名映射(`operation``action``save``update`/`write`),兼容大模型幻觉
@@ -113,7 +113,7 @@ Args: [你的项目所在盘符]:/[项目路径]/packages/mcp-bridge/src/mcp-pro
- **描述**: 获取当前场景的完整节点树结构(支持分页避免长数据截断)。如果要查询具体组件属性请配合 manage_components。
- **参数**:
- `nodeId`: 指定的根节点 UUID。如果不传则获取整个场景的根 (可选)。
- `depth`: 遍历的深度限制,默认为 2。用来防止过大场景导致返回数据超长 (可选)。
- `depth`: 遍历的深度限制,默认为 2。用来防止过大场景导致返回数据超长 (可选)。每层最多返回 50 个子节点,超出部分通过 `childrenTruncated` 字段标注。
- `includeDetails`: 是否包含坐标、缩放等杂项详情,默认为 false (可选)。
### 5. update_node_transform