网页端唤醒QoderWake失败的根本原因是Web Bridge未启用或CORS配置缺失：需执行qoderwake restart --enable-web-bridge --web-port=8081启用服务，编辑config.yaml添加allow_origin、allow_credentials等CORS字段，前端调用时必须设置credentials: "include"，最后通过Network面板验证响应头是否包含Access-Control-Allow-Origin等完整跨域头。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Qoder全栈开发中，网页端唤醒本地QoderWake客户端失败，常因跨域请求被浏览器拦截导致“未检测到本地服务”或连接超时；根本原因在于Web Bridge服务返回的响应头缺失Access-Control-Allow-Origin等关键CORS字段，或前端请求域名未被显式列入白名单。
确认QoderWake Web Bridge已启用并监听正确端口
打开终端执行 qoderwake status，检查输出中是否包含 “WebBridge started on :8081” 字样。若无此提示，说明Web Bridge模块未激活。
执行 qoderwake restart --enable-web-bridge --web-port=8081 强制启用并指定端口；该命令会覆盖配置文件中旧设置，确保服务以最新参数启动。
⚠️ 注意：若此前已在config.yaml中手动配置过web_bridge节点，此处强制重启会临时忽略该文件内容，需在重启成功后重新编辑配置文件固化设置。
修改config.yaml添加完整CORS响应头规则
用文本编辑器打开QoderWake安装目录下的 config.yaml 文件，在 server: 节点下插入以下配置块：
web_bridge: enabled: true port: 8081 allow_origin: ["http://localhost:3000", "https://qoder.com", "https://your-dev-site.com"] allow_credentials: true allowed_headers: ["Content-Type", "Authorization", "X-Qoder-Token"]
其中 allow_origin 必须精确列出所有合法前端域名，不可使用 "*" 配合 allow_credentials: true，否则浏览器将拒绝携带 Cookie 或认证头的请求。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
保存文件后再次运行 qoderwake restart，观察日志末尾是否出现 “CORS headers enabled for origins [...]” 提示。
前端调用时显式声明withCredentials
在网页端JavaScript中发起唤醒请求时，必须启用凭证传递：
方法一（Fetch API）：
fetch("http://localhost:8081/wake", {<br>
method: "POST",<br>
credentials: "include",<br>
headers: { "Content-Type": "application/json" },<br>
body: JSON.stringify({ task: "open-editor" })<br>
});
方法二（XMLHttpRequest）：
const xhr = new XMLHttpRequest();<br>
xhr.open("POST", "http://localhost:8081/wake");<br>
xhr.withCredentials = true;<br>
xhr.setRequestHeader("Content-Type", "application/json");<br>
xhr.send(JSON.stringify({ task: "open-editor" }));
这一步漏掉 credentials: "include" 或 xhr.withCredentials = true，会导致浏览器不发送Cookie与认证信息，QoderWake服务端无法识别用户身份，唤醒逻辑直接跳过。
验证跨域链路是否通达
第一步：在Chrome中打开开发者工具→Network标签页，过滤出 wake 请求；
第二步：点击网页上的唤醒按钮，观察该请求的Response Headers中是否包含：Access-Control-Allow-Origin: https://qoder.comAccess-Control-Allow-Credentials: trueAccess-Control-Allow-Methods: POST, OPTIONSAccess-Control-Allow-Headers: Content-Type, Authorization, X-Qoder-Token；
第三步：若存在OPTIONS预检请求，确认其响应状态码为200且上述头字段齐全；若OPTIONS返回404或缺失Access-Control-Allow-Methods，说明Web Bridge未正确处理预检请求；
第四步：当所有响应头校验通过，且后续POST请求返回200 + {"status":"success"}，即表示跨域唤醒链路已完全打通。
