在使用 QoderWake 时同时启用两个扩展，经常会导致进程崩溃、界面闪退或主窗口直接关闭，这确实令人困扰。通常情况下，这类问题的根源在于两个插件对共享资源（如 Connector 通道注册表、全局事件总线监听器、模型加载器单例句柄）产生了不可重入的竞态访问，进而触发 Qt 元对象系统的断言失败或内存越界写入。下面是一套经过实战检验的深度排查与修复方案，请按步骤操作。
一、执行双插件隔离启动验证
此方法的核心思路是：强制禁用除目标插件外的所有扩展，构建一个最小冲突环境。这样便能确认崩溃是否确实由这两个插件组合引发，同时排除第三方插件干扰或核心环境异常的影响。
1、首先关闭所有 QoderWake 进程，包括后台服务与 GUI 主窗口，确保环境干净无残留。
2、在终端中执行洁净启动命令，仅加载待测的两个插件：qoderwake --disable-extensions --load-extension=/path/to/plugin-A,/path/to/plugin-B。
3、观察启动后 5 秒内是否再次崩溃。如果未崩溃，再逐一触发各自的核心功能，例如 Plugin-A 调用 OCR 接口，Plugin-B 发起 WebSocket 连接。
4、如果某个功能触发即崩溃，立刻记录崩溃前最后输出的日志行，重点关注 QObject::connect、QMetaObject::activate 或 QPluginLoader::instance 这几类错误信息。
二、启用插件加载时序捕获与依赖图谱分析
QoderWake 2.5 及以上版本内置了插件加载追踪机制，可在动态链接阶段捕获每个插件的符号解析顺序、Qt 元对象注册路径以及跨插件的信号槽绑定关系。该方法对识别循环依赖或重复注册点特别有效。
1、启动 QoderWake 前，先设置环境变量：QODER_DEBUG_PLUGIN_LOAD=1。
2、执行命令：qoderwake --log-level=debug > /tmp/plugin-load-trace.log 2>&1。
3、在日志文件中搜索关键词 Registering QObject subclass、Connecting signal to slot across plugins 以及 Duplicate connector ID。
4、定位到首次出现 conflict on connector://notion/v1 或 duplicate QMetaMethod for onTaskComplete 的行，即可确认冲突具体发生在哪两个插件之间。
三、检查插件间 Connector 通道命名空间隔离状态
QoderWake 要求每个插件声明唯一的 Connector ID 用于下游服务路由。如果两个插件使用了相同的 ID（例如都注册为 connector://llm/router），底层的 Channel Manager 会拒绝二次注册，直接触发 abort()。
1、进入各插件安装目录，打开 manifest.json 文件，查看 connector.id 字段的值。
2、对 Plugin-A 执行：grep -r '"connector\.id"' plugin-A/ | head -1；对 Plugin-B 执行相同命令。
3、如果输出值完全一致（例如都是 "connector.id": "connector://llm/router"），则必须修改其中一个。例如将 Plugin-B 的 ID 改为 "connector://llm/router-v2"。
4、修改后重新打包插件（zip 压缩并保留签名），在 QoderWake 中先卸载原插件，再重新安装。
四、验证插件 Qt 插件路径与平台插件兼容性
部分插件会自带 Qt 平台插件（例如 platforms/libqwebgl.so）。如果两个插件分别携带了不同版本的同名平台库，QoderWake 在初始化 QApplication 时就会因 QFactoryLoader::instance 冲突而罢工。
1、在 Plugin-A 根目录执行：find . -name "libqwebgl*" -o -name "libqoffscreen*"。
2、在 Plugin-B 根目录执行相同命令，对比输出路径及文件 MD5 值。
3、如果发现两者都包含 platforms/libqwebgl.so 且 MD5 不一致，请保留 QoderWake 运行时默认的平台插件（位于 runtime/qt/plugins/platforms/），并删除两个插件内嵌的同名文件。
4、重启 QoderWake 并启用插件，观察是否还会崩溃。如果恢复稳定，说明问题确实出在平台插件版本冲突上。
五、注入插件级内存屏障与信号槽序列化锁
当两个插件通过同一事件总线广播消息且未加锁时，在多线程环境下极易触发 Qt 容器迭代器失效或 QVariantMap 并发写入崩溃。本方法通过强制序列化关键路径，验证问题是否属于竞态本质。
1、编辑 QoderWake 配置文件 config.yaml，在 plugin 节点下添加：serialize_event_bus: true。
2、保存后执行 qoderwake restart 重载配置。
3、再次启用两个插件，执行高频率交互任务（例如每秒触发一次 Plugin-A 生成文本、Plugin-B 解析该文本）。
4、如果崩溃消失但响应延迟明显上升（超过 800ms/次），则可确定原因为事件总线无序并发，需要联系插件作者修复其 emit() 调用位置。