docs: 更新 README 和 UPDATE_LOG 文档,新增日志持久化与面板修复记录

This commit is contained in:
火焰库拉
2026-02-27 23:04:25 +08:00
parent 9268340af3
commit 002f081290
7 changed files with 4191 additions and 4304 deletions

View File

@@ -15,7 +15,7 @@
- **脚本管理**: 创建、删除、读取、写入脚本文件
- **批处理执行**: 批量执行多个 MCP 工具操作,提高效率
- **资产管理**: 创建、删除、移动、获取资源信息
- **实时日志**: 提供详细的操作日志记录和展示
- **实时日志**: 提供详细的操作日志记录和展示,支持持久化写入项目内日志文件
- **自动启动**: 支持编辑器启动时自动开启服务
- **编辑器管理**: 获取和设置选中对象,刷新编辑器
- **游戏对象查找**: 根据条件查找场景中的节点
@@ -28,6 +28,8 @@
- **全局搜索**: 在项目中搜索文本内容
- **撤销/重做**: 管理编辑器的撤销栈
- **特效管理**: 创建和修改粒子系统
- **并发安全**: 指令队列串行化执行,防止编辑器卡死
- **超时保护**: IPC 通信和指令队列均有超时兜底机制
- **工具说明**: 测试面板提供详细的工具描述和参数说明
## 安装与使用
@@ -71,12 +73,12 @@ Args: [你的项目所在盘符]:/[项目路径]/packages/mcp-bridge/mcp-proxy.j
```json
{
"mcpServers": {
"cocos-creator": {
"command": "node",
"args": ["[Cocos Creator 项目的绝对路径]/packages/mcp-bridge/mcp-proxy.js"]
}
}
"mcpServers": {
"cocos-creator": {
"command": "node",
"args": ["[Cocos Creator 项目的绝对路径]/packages/mcp-bridge/mcp-proxy.js"]
}
}
}
```
@@ -406,13 +408,14 @@ Args: [你的项目所在盘符]:/[项目路径]/packages/mcp-bridge/mcp-proxy.j
### 日志管理
插件会通过内置的测试面板MCP Bridge/Open Panel实时记录所有操作的日志包括
插件会通过内置的测试面板MCP Bridge/Open Panel实时记录所有操作的日志并同步持久化写入项目目录 `settings/mcp-bridge.log` 文件,编辑器重启后仍可查阅历史日志。日志记录包括:
- 服务启动/停止状态
- MCP 客户端请求接收(完整包含工具的 `arguments` 参数,超长自动截断)
- 场景节点树遍历与耗时信息
- 工具调用的执行成功/失败状态返回
- IPC 消息和核心底层报错堆栈
- 内存保护:日志缓冲区上限 2000 条,超出自动截断旧日志
## 注意事项