feat(mcp): 基座换行分帧与 isError 映射；新增 dwg_review 审查 Agent

基座（cad_mcp_frame）: - 新增 RecvOneFrame: 以 '\n' 为消息边界分帧，去掉单次 recv(2048) 限制（上限 8MB）；用 select 短探测兼容不发 '\n' 的旧客户端；clientSocket 设 SO_RCVTIMEO 防卸载卡死 - JSON-RPC id 支持 string/number；无 id 的通知不回包 - isError 映射: 协议级错误保留顶层 error，工具执行错误转 result.isError=true - 响应补 '\n' 作为消息边界 Agent（新增 dwg_review 包）: - mcp_client: 唯一 TCP/JSON-RPC 封装（单飞锁/分帧/重试/兼容 error 与 isError） - cad_tools: 从 tools/list 动态建表，含 15 个只读白名单 - phases: planning -> evidence -> review（受控只读取证子循环）-> report - annotator: 批注回写 AI_REVIEW 层，支持 dry-run 与撤销 - config: 配置全部走环境变量；Windows 下回退读注册表以读到新设的系统变量其它: 新增 verify_mcp_frame.py 验证脚本；.gitignore 补 Python/AutoCAD 锁文件规则； ai.memory 记录架构决策与实测结论
2026-10-13 23:44:11 +08:00
1 parent 3b1cc88262
commit ec5292debe
@@ -0,0 +1,127 @@
+"""验证基座 B 最小集改动（换行分帧 / 大报文 / string id / 通知 / isError）。
+
+前提：CAD 已打开并加载了重新构建的 cad_mcp_frame.arx，8080 端口在监听。
+
+用法：
+    python verify_mcp_frame.py
+"""
+
+import json
+import socket
+import sys
+
+HOST = "127.0.0.1"
+PORT = 8080
+
+
+def raw_send(payload_bytes, *, timeout=10.0):
+    """发送一帧（已含 '\\n'），读回响应原始字节（读不到则为空）。"""
+    sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+    sock.settimeout(timeout)
+    try:
+        sock.connect((HOST, PORT))
+        sock.sendall(payload_bytes)
+        data = b""
+        while True:
+            try:
+                chunk = sock.recv(65536)
+            except socket.timeout:
+                break
+            if not chunk:
+                break
+            data += chunk
+            if b"\n" in data:
+                break
+        return data
+    finally:
+        sock.close()
+
+
+def _call(payload):
+    return raw_send(json.dumps(payload).encode("utf-8") + b"\n")
+
+
+def test_string_id():
+    resp = json.loads(_call({"jsonrpc": "2.0", "id": "abc-123", "method": "tools/list"}).decode())
+    assert resp.get("id") == "abc-123", f"id 未原样回显: {resp.get('id')!r}"
+    count = len(resp.get("result", {}).get("tools", []))
+    print(f"[PASS] string id 原样回显；tools={count}")
+
+
+def test_large_request():
+    """构造 >2KB 的 arguments；旧基座会截断成 -32700，新基座应正常返回 -32601。"""
+    big = {"blob": "x" * 5000}
+    resp = json.loads(
+        _call(
+            {
+                "jsonrpc": "2.0",
+                "id": 7,
+                "method": "tools/call",
+                "params": {"name": "__no_such_tool__", "arguments": big},
+            }
+        ).decode()
+    )
+    code = (resp.get("error") or {}).get("code")
+    assert code == -32601, f"期望 -32601（工具不存在），实际 {resp}"
+    print("[PASS] >2KB 请求未被截断（返回 -32601 而非 -32700）")
+
+
+def test_notification_no_reply():
+    data = raw_send(
+        json.dumps({"jsonrpc": "2.0", "method": "notifications/initialized"}).encode() + b"\n",
+        timeout=2.0,
+    )
+    assert data == b"", f"通知不应回包，却收到 {data[:120]!r}"
+    print("[PASS] 无 id 的通知未回包")
+
+
+def test_tool_error_shape():
+    """用不存在的 handle 触发工具执行错误，应为 result.isError=true。"""
+    resp = json.loads(
+        _call(
+            {
+                "jsonrpc": "2.0",
+                "id": 9,
+                "method": "tools/call",
+                "params": {"name": "get_entity_detail", "arguments": {"handle": "ZZZZZZ"}},
+            }
+        ).decode()
+    )
+    result = resp.get("result")
+    if isinstance(result, dict) and result.get("isError") is True:
+        print("[PASS] 工具执行错误 -> result.isError=true")
+    elif resp.get("error"):
+        print(f"[WARN] 仍是顶层 error（code={resp['error'].get('code')}），isError 映射未生效")
+    else:
+        print(f"[?] 未预期响应: {resp}")
+
+
+def main():
+    # 先探测端口
+    probe = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+    probe.settimeout(1.5)
+    try:
+        probe.connect((HOST, PORT))
+    except OSError as exc:
+        print(f"[X] {HOST}:{PORT} 未监听（{exc}）。请先启动已加载插件的 CAD。")
+        return 1
+    finally:
+        probe.close()
+
+    print(f"=== 验证基座 {HOST}:{PORT} ===")
+    failed = 0
+    for test in (test_string_id, test_large_request, test_notification_no_reply, test_tool_error_shape):
+        try:
+            test()
+        except AssertionError as exc:
+            print(f"[FAIL] {test.__name__}: {exc}")
+            failed += 1
+        except Exception as exc:  # noqa: BLE001
+            print(f"[ERROR] {test.__name__}: {exc}")
+            failed += 1
+    print("=== 全部通过 ===" if failed == 0 else f"=== {failed} 项未通过 ===")
+    return 0 if failed == 0 else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())