QoderWake Waker页面打不开需依次排查Web Bridge启用状态、8080端口占用、HTTPS混合内容拦截及沙盒前端资源损坏；执行qoderwake status确认【WebBridge started】，用lsof或netstat检查端口，配置chrome://flags绕过不安全脚本限制，并通过--rebuild-sandbox恢复renderer目录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QoderWake创建Waker页面打不开，说明客户端已启动但Web UI服务未成功暴露或前端资源加载中断，常见于端口冲突、Web Bridge未启用、HTTPS混合内容拦截或本地沙盒初始化失败等情况。
确认Web Bridge模块是否已启用
QoderWake默认不启动Web服务，必须显式开启Web Bridge才能提供Waker页面（通常为http://localhost:8080），否则直接访问会显示“无法连接”或空白页。
执行 qoderwake status 查看输出中是否包含 【WebBridge started on :8080】 字样；若无此行，说明模块未激活。
立即运行：qoderwake restart --enable-web-bridge --web-port=8080 强制启用并绑定端口。
注意：该命令会覆盖当前配置，重启后需重新检查status输出——若仍无WebBridge日志，说明config.yaml中server.web_bridge.enabled被硬编码为false，需手动编辑修正。
检查8080端口是否被其他进程占用
Waker页面默认监听8080，若被VS Code Live Server、Docker容器或旧版QoderWake残留进程占用，会导致服务静默失败。
方法一（推荐）：在终端执行 lsof -i :8080（macOS/Linux）或 netstat -ano | findstr :8080（Windows），确认PID是否存在。
方法二：直接尝试访问 http://localhost:8081（假设你已按上一步将端口改为8081），若能打开页面，则100%是8080被占。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
若发现占用进程非系统关键服务（如PID对应node或python），立即终止：kill -9 [PID] 或 taskkill /f /pid [PID]。
绕过HTTPS混合内容限制强制加载
当Waker页面部分资源（如JS/CSS）通过HTTP加载而主页面为HTTPS时，现代浏览器会主动屏蔽这些“不安全脚本”，导致UI白屏或功能按钮不可点击。
第一步：在浏览器地址栏输入 chrome://flags/#unsafely-treat-insecure-origin-as-secure（Chrome/Edge）或 about:config 搜索 security.mixed_content.block_active_content（Firefox）。
第二步：将 http://localhost:8080 添加到允许列表，并重启浏览器。
【关键操作】此设置仅限本地开发环境，切勿对公网域名启用。
第三步：清除浏览器缓存（Ctrl+Shift+Del → 勾选“缓存的图像和文件”）后重试访问。
重建沙盒工作区并重置UI状态
Waker页面依赖沙盒内预编译的前端包（如renderer.js、index.html），若该目录损坏或权限异常，即使Web服务正常，也会返回404或空响应。
- 关闭所有QoderWake进程，确保无残留qoderwake.exe或qoderwake守护进程。
- 定位沙盒前端目录：
Windows：%USERPROFILE%\.qoderwake\sandbox\renderer
macOS/Linux：~/.qoderwake/sandbox/renderer - 将整个
renderer文件夹重命名为renderer.bak。 - 执行
qoderwake --rebuild-sandbox触发前端资源自动重拉与解压。 - 等待终端输出 【Renderer bundle rebuilt successfully】 后，重新访问 http://localhost:8080。
