若qoderwake出现启动卡死、白屏等异常，极可能是connector扩展、沙盒注入模块与策略加载器争抢主进程控制权所致；应依次执行禁用扩展验证、按加载时序隔离高危插件、清除hook.js残留缓存、切换至沙盒进程模式解决。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用QoderWake过程中出现启动卡死、界面白屏、命令面板无法打开或控制台反复报“Extension host terminated unexpectedly”，则极可能是多个插件在初始化阶段发生资源抢占或API劫持冲突。QoderWake插件冲突不同于VSCode，其本质是Connector扩展、沙盒注入模块与运行时策略加载器三者在权限上下文切换时争抢主进程控制权。以下是可行的解决路径：
一、强制禁用全部扩展验证冲突源
该步骤用于快速确认问题是否由插件引发，避免在错误方向上耗费时间。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）。冲突多发生在前两类，因其直接修改主进程argv或patch核心模块。
1、执行qoderwake --list-extensions，获取已安装扩展列表及加载顺序编号。
2、优先禁用编号为1–3的启动期扩展：运行qoderwake --disable-extension qoder.chrome-browser-use-agent并重启。
3、若问题未解，继续禁用编号4–6的策略同步型扩展：执行qoderwake --disable-extension qoder.github-connector --disable-extension qoder.notion-sync。
4、每次禁用后均需等待90秒策略同步完成，再通过qoderwake status命令确认“Extension Host: Running”且无“Activation failed”标记。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
三、清除残留初始化逻辑与沙盒缓存
部分旧版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通信，彻底规避主进程污染。
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”字样。
