cheatengine 5.8.19 → 5.8.21

package/README_CN.md

@@ -383,47 +383,47 @@ Hook 函数以拦截调用并捕获参数。
 
 ## 推荐工作流
 
-### 指针追踪
-```python
-# 自动 (首选)
-result = ce_find_pointer_path(address="0x255D5E758")
-# 返回: base_address, offsets, ce_pointer_notation
-
-# 手动 (自动失败时)
-# 1. 查找访问该地址的代码
-accesses = ce_find_what_accesses(address="0x255D5E758")
-# 2. 获取寄存器值 (如 rcx = 0x255D5E658)
-# 3. 搜索存储该值的指针
-pointers = ce_value_scan(value="0x255D5E658", type="qword")
-# 4. 重复直到找到 game.exe+offset
-```
-
-### 函数分析
-```python
-# 1. 查找函数边界
-bounds = ce_find_function_boundaries(address="0x14587EDB0")
-
-# 2. 跟踪执行
-trace = ce_break_and_trace(address="0x14587EDB0", max_steps=100)
-
-# 3. 生成特征码用于更新
-sig = ce_generate_signature(address="0x14587EDB0")
-```
-
-### 逆向未知代码
-```python
-# 1. 反汇编
-code = ce_disassemble(address="0x14587EDB0", count=20)
-
-# 2. 符号跟踪理解逻辑
-symbolic = ce_symbolic_trace(address="0x14587EDB0", initial_state={"rcx": "this"})
-
-# 3. 为复杂函数构建 CFG
-cfg = ce_build_cfg(address="0x14587EDB0")
-
-# 4. 检测模式
-patterns = ce_detect_patterns(address="0x14587EDB0")
-```
+### 指针追踪
+```json
+// 自动 (首选)
+{"name": "ce_find_pointer_path", "arguments": {"address": "0x255D5E758", "user_prompted": true}}
+// 返回: base_address, offsets, ce_pointer_notation
+
+// 手动 (自动失败时)
+// 1. 查找访问该地址的代码
+{"name": "ce_find_what_accesses", "arguments": {"address": "0x255D5E758", "user_prompted": true}}
+// 2. 从结果获取寄存器值 (如 RBX=0x255D5E658)
+// 3. 搜索存储该值的指针
+{"name": "ce_value_scan", "arguments": {"value": "0x255D5E658", "type": "qword"}}
+// 4. 重复直到找到 game.exe+offset
+```
+
+### 函数分析
+```json
+// 1. 查找函数边界
+{"name": "ce_find_function_boundaries", "arguments": {"address": "0x14587EDB0"}}
+
+// 2. 跟踪执行
+{"name": "ce_break_and_trace", "arguments": {"address": "0x14587EDB0", "max_steps": 100}}
+
+// 3. 生成特征码用于更新
+{"name": "ce_generate_signature", "arguments": {"address": "0x14587EDB0"}}
+```
+
+### 逆向未知代码
+```json
+// 1. 反汇编
+{"name": "ce_disassemble", "arguments": {"address": "0x14587EDB0", "count": 20}}
+
+// 2. 符号跟踪理解逻辑
+{"name": "ce_symbolic_trace", "arguments": {"address": "0x14587EDB0", "initial_state": {"rcx": "this"}}}
+
+// 3. 为复杂函数构建 CFG
+{"name": "ce_build_cfg", "arguments": {"address": "0x14587EDB0"}}
+
+// 4. 检测模式
+{"name": "ce_detect_patterns", "arguments": {"address": "0x14587EDB0"}}
+```
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cheatengine",
-  "version": "5.8.19",
+  "version": "5.8.21",
   "description": "Cheat Engine MCP Server - AI-assisted reverse engineering bridge",
   "main": "ce_mcp_server.js",
   "bin": {

package/src/pipe-client.js

@@ -86,30 +86,32 @@ class PipeClient extends EventEmitter {
   _handleData(data) {
     this.responseBuffer = Buffer.concat([this.responseBuffer, data]);
     
-    // Try to parse response
-    if (this.pendingResponse && this.responseBuffer.length >= 4) {
-      const respLen = this.responseBuffer.readUInt32LE(0);
-      
-      if (respLen === 0 || respLen > Config.MAX_RESPONSE_SIZE) {
-        this.pendingResponse.reject(new Error(`Invalid response size: ${respLen}`));
-        this.pendingResponse = null;
-        this.responseBuffer = Buffer.alloc(0);
-        return;
-      }
+    // Try to parse response only if we have a pending request
+    if (!this.pendingResponse || this.responseBuffer.length < 4) {
+      return;
+    }
+    
+    const respLen = this.responseBuffer.readUInt32LE(0);
+    
+    if (respLen === 0 || respLen > Config.MAX_RESPONSE_SIZE) {
+      this.pendingResponse.reject(new Error(`Invalid response size: ${respLen}`));
+      this.pendingResponse = null;
+      this.responseBuffer = Buffer.alloc(0);
+      return;
+    }
 
-      if (this.responseBuffer.length >= 4 + respLen) {
-        const respData = this.responseBuffer.slice(4, 4 + respLen);
-        this.responseBuffer = this.responseBuffer.slice(4 + respLen);
-        
-        try {
-          const decoded = this._decodeResponse(respData);
-          const result = JSON.parse(decoded);
-          this.pendingResponse.resolve(result);
-        } catch (err) {
-          this.pendingResponse.reject(err);
-        }
-        this.pendingResponse = null;
+    if (this.responseBuffer.length >= 4 + respLen) {
+      const respData = this.responseBuffer.slice(4, 4 + respLen);
+      this.responseBuffer = this.responseBuffer.slice(4 + respLen);
+      
+      try {
+        const decoded = this._decodeResponse(respData);
+        const result = JSON.parse(decoded);
+        this.pendingResponse.resolve(result);
+      } catch (err) {
+        this.pendingResponse.reject(err);
       }
+      this.pendingResponse = null;
     }
   }
 
@@ -258,7 +260,27 @@ class PipeClient extends EventEmitter {
   _waitForResponse() {
     return new Promise((resolve, reject) => {
       this.pendingResponse = { resolve, reject };
-      this.responseBuffer = Buffer.alloc(0);
+      
+      // Check if we already have data in buffer (race condition fix)
+      if (this.responseBuffer.length >= 4) {
+        const respLen = this.responseBuffer.readUInt32LE(0);
+        if (respLen > 0 && respLen <= Config.MAX_RESPONSE_SIZE && this.responseBuffer.length >= 4 + respLen) {
+          const respData = this.responseBuffer.slice(4, 4 + respLen);
+          this.responseBuffer = this.responseBuffer.slice(4 + respLen);
+          
+          try {
+            const decoded = this._decodeResponse(respData);
+            const result = JSON.parse(decoded);
+            this.pendingResponse = null;
+            resolve(result);
+            return;
+          } catch (err) {
+            this.pendingResponse = null;
+            reject(err);
+            return;
+          }
+        }
+      }
     });
   }