文档更新: 补充性能优化与防御性增强的说明
- UPDATE_LOG.md: 新增 2026-03-04 性能优化章节(JSON压缩、队列限制、子节点上限) - 注意事项.md: 补充队列长度限制(100/429)和子节点上限(50/childrenTruncated)说明 - README.md: 更新并发安全特性描述和 get_scene_hierarchy 参数说明
This commit is contained in:
@@ -132,6 +132,7 @@
|
||||
1. 队列在 `processNextCommand` 的 `catch` 块中有防死锁保护,即使某个指令抛出异常也不会永久阻塞后续指令。
|
||||
2. `batchExecute` 内部也已从并行 `forEach` 改为串行链式执行。
|
||||
3. 队列长度会在日志中显示(`REQ -> [toolName] (队列长度: N)`),可用于排查积压问题。
|
||||
4. **队列长度限制**:队列上限为 100 条。超限时新请求会被直接拒绝并返回 HTTP 429 状态码,防止极端情况下内存无限增长。
|
||||
|
||||
### 9.2 `refresh_editor` 路径要求
|
||||
|
||||
@@ -153,6 +154,7 @@
|
||||
- **最佳实践**:
|
||||
- **默认使用 `depth: 2`** (默认限制) 来逐步探查。
|
||||
- **结合 `nodeId` 参数**:找到关键模块(例如 `Canvas/LoginPanel`)的 UUID 后,再单独向该 `nodeId` 请求下一层的结构,而非每次从根部拉取。
|
||||
- **子节点数量上限**:每层最多返回 50 个子节点。如果某节点的子节点数超过 50,返回数据中会包含 `childrenTruncated` 字段标注被截断的数量。此时可通过 `nodeId` 参数指定该节点单独获取完整子节点列表。
|
||||
|
||||
### 10.2 大对象与长数组截断
|
||||
|
||||
|
||||
Reference in New Issue
Block a user