文档: 强化 AI 刷新性能警示
- 在 manage_editor 描述中加入⚠️警告,强制要求使用 path 避免全量刷新
- AI 安全守则更新为 4 条,包含禁止全局刷新要求
- 注意事项文档同步强化路径要求警示
This commit is contained in:
6
注意事项.md
6
注意事项.md
@@ -119,7 +119,11 @@
|
||||
2. `batchExecute` 内部也已从并行 `forEach` 改为串行链式执行。
|
||||
3. 队列长度会在日志中显示(`REQ -> [toolName] (队列长度: N)`),可用于排查积压问题。
|
||||
|
||||
### 9.2 IPC 超时保护 (callSceneScriptWithTimeout)
|
||||
### 9.2 `refresh_editor` 路径要求
|
||||
|
||||
- **⚠️ 必须带路径**:在调用 `manage_editor` 的 `refresh_editor` 时,务必通过 `properties.path` 指定精确的文件或目录(如 `db://assets/scripts/Test.ts`)。严禁空参数进行全局刷新,在生产项目中会导致数分钟的编辑器卡死。
|
||||
|
||||
### 9.3 IPC 超时保护 (callSceneScriptWithTimeout)
|
||||
|
||||
- **背景**:`Editor.Scene.callSceneScript` 的回调依赖 Scene 面板响应 IPC 消息。如果主线程阻塞,Scene 面板无法处理消息,导致 callback 永远不返回,HTTP 连接堆积。
|
||||
- **解决方案**:所有 `callSceneScript` 调用均通过 `callSceneScriptWithTimeout` 包装,默认 15 秒超时。超时后自动返回错误,释放 HTTP 连接和队列位置。
|
||||
|
||||
Reference in New Issue
Block a user