解决QoderWake插件冲突避免多个扩展同时运行崩溃

遇到QoderWake启动卡死、界面白屏，或者命令面板无法打开，控制台频繁报错“Extension host terminated unexpectedly”？先别急着重装系统或怀疑硬件问题，这通常是多个扩展插件之间发生冲突导致的。与VSCode的插件冲突不同，QoderWake的扩展冲突根源更深层，往往是Connector扩展、沙盒注入模块和运行时策略加载器这三方，在争夺主进程控制权时引发的连锁崩溃。遵循以下系统性的排查与解决方案，可以高效定位并彻底解决QoderWake插件冲突问题。

一、强制禁用全部扩展，验证冲突根源

第一步，必须确认问题是否由插件引起，以避免在错误的排查方向上耗费时间。由于QoderWake缺乏图形化的插件管理界面，我们需要通过命令行启动一个“纯净”的运行环境来进行验证。

1. 首先，请彻底关闭所有QoderWake客户端及后台进程，确保没有任何残留的Agent实例在运行。

2. 在终端中执行核心命令：qoderwake --disable-extensions，随后等待服务端返回“沙盒初始化完成”的提示信息。

3. 使用浏览器访问 http://localhost:8080，检查UI界面能否正常加载，身份选择页面是否可交互。同时，确认记忆模块的状态应显示为“未启用”，而非任何错误提示。

4. 如果此时所有功能恢复正常，即可100%确定是扩展冲突所致。若问题依旧存在，则需转向检查系统级依赖，例如glibc版本、OpenSSL兼容性，或是服务端的策略快照文件是否已损坏。

二、按加载时序分组隔离，定位高危扩展

QoderWake的插件根据其生命周期可分为三类：启动期即注入的（如Chrome Browser Use Agent）、策略同步期激活的（如Qoder Connector for GitHub）、以及事件响应期才加载的（如Qoder Slack Bridge）。冲突通常发生在前两类，因为它们会直接修改主进程的启动参数或修补核心模块。

1. 执行命令：qoderwake --list-extensions，获取已安装扩展的完整列表及其加载顺序编号。

2. 优先禁用编号为1到3的启动期扩展：运行命令 qoderwake --disable-extension qoder.chrome-browser-use-agent，然后重启QoderWake服务。

3. 若问题未解决，继续禁用编号4到6的策略同步型扩展：执行命令 qoderwake --disable-extension qoder.github-connector --disable-extension qoder.notion-sync。

4. 每次禁用操作后，需等待约90秒以确保策略同步完成，随后通过 qoderwake status 命令确认状态显示为“Extension Host: Running”，且没有出现“Activation failed”的错误标记。

三、彻底清除残留初始化逻辑与沙盒缓存

部分旧版QoderWake扩展（例如v1.0.2之前的Qoder Slack Bridge）即使被禁用，仍可能在 ~/.qoderwake/cache/sandbox/ 目录下残留hook.js文件，并在每次启动时强制加载。此文件会劫持console.error的调用链，导致扩展宿主进程静默退出，引发白屏或卡死。

1. 定位缓存目录：执行命令 ls -la ~/.qoderwake/cache/sandbox/ | grep hook.js。

2. 如果存在匹配的残留文件，立即将其删除：rm -f ~/.qoderwake/cache/sandbox/hook.js。

3. 同步清理策略缓存：执行命令 rm -rf ~/.qoderwake/cache/policy/*，以防止旧的策略包中仍包含已被移除扩展的依赖声明。

4. 在重启QoderWake之前，手动验证目录是否已清空：执行命令 ls -A ~/.qoderwake/cache/sandbox/，此时应无任何输出。

四、替换冲突扩展为轻量级替代方案

如果最终确认某个特定扩展（如Qoder Chrome Browser Use Agent）是唯一的冲突源头，但其功能又不可或缺，该怎么办？解决方案是切换到该扩展最新版本提供的“无侵入模式”。此模式放弃了传统的DOM劫持方式，转而采用独立的Chromium实例配合IPC进程间通信，从而彻底避免对QoderWake主进程的污染。

1. 进入QoderWake的设置页面，导航至「高级选项 > 浏览器自动化」，将运行模式从默认的“内嵌注入”切换为“沙盒进程”。

2. 将对应版本的 qoder-chrome-sandbox 二进制文件下载至 /usr/local/bin/ 目录，并赋予其可执行权限：chmod +x /usr/local/bin/qoder-chrome-sandbox。

3. 在配置文件 ~/.qoderwake/config.yaml 中新增两个关键字段：browser_mode: "sandbox" 和 sandbox_binary: "/usr/local/bin/qoder-chrome-sandbox"。

4. 保存配置文件后，执行命令 qoderwake reload config，观察系统日志中是否出现“Launched sandbox process with PID XXXX”的成功提示字样。