diff --git a/src/app/main.cpp b/src/app/main.cpp
index 105c8f2..b305b01 100644
--- a/src/app/main.cpp
+++ b/src/app/main.cpp
@@ -788,6 +788,10 @@ int main(int argc, char* argv[])
     QSurfaceFormat::setDefaultFormat(QVTKOpenGLStereoWidget::defaultFormat());
     QApplication app(argc, argv);
 
+    // 异步 ApiCall::finished 等信号携带 ApiResponse；注册元类型以支持跨 QueuedConnection 传递
+    // （当前详情链路为同线程 DirectConnection，非严格必需，但作防御性注册，见 spec §5.1）。
+    qRegisterMetaType<geopro::net::ApiResponse>();
+
     // 组织/应用名：QSettings 持久化（dock 布局、登录记忆等）按此定位存储位置。
     QCoreApplication::setOrganizationName(QStringLiteral("Geomative"));
     QCoreApplication::setApplicationName(QStringLiteral("Geopro3"));