文档: 强化 AI 刷新性能警示

- 在 manage_editor 描述中加入⚠️警告,强制要求使用 path 避免全量刷新
- AI 安全守则更新为 4 条,包含禁止全局刷新要求
- 注意事项文档同步强化路径要求警示
This commit is contained in:
火焰库拉
2026-02-12 23:36:21 +08:00
parent 5989a388f8
commit 8df6f5a415
3 changed files with 11 additions and 7 deletions

View File

@@ -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 连接和队列位置。