qoderwake网络诊断需在活跃登录态下通过设置→运维工具→网络诊断启动，5秒内触发失败任务以捕获真实connector状态，重点排查mcp握手、dns一致性、tls证书链三大阻断点。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在使用QoderWake时遇到任务卡在“连接中”、工具调用超时、或提示“无法访问目标服务”，但本地网络看似正常，就需要立即启动内置网络诊断模块定位真实阻断点——它不依赖ping或traceroute，而是模拟Agent真实请求链路，逐跳验证MCP协议握手、Connector池连通性、DNS解析一致性及TLS证书有效性。
启动网络诊断会话
诊断必须在当前运行的QoderWake实例上下文中触发，不能通过独立CLI命令调用，否则无法捕获沙盒内真实的Connector状态。
1、确保QoderWake桌面端已启动且处于活跃登录态（右上角显示绿色✅）。
2、点击主界面左下角「⚙️ 设置」→「运维工具」→「网络诊断」。
3、在弹出窗口中选择「快速诊断」模式，系统将自动注入探针并捕获当前所有活跃Connector的底层Socket状态与TLS握手日志。
4、点击「开始检测」后，【必须在5秒内手动触发一次待诊断的失败任务】（例如重试一个报错的GitHub PR分析），否则诊断仅覆盖空闲连接，无法复现真实问题。
解读MCP协议握手异常
MCP（Multi-Connector Protocol）是QoderWake与外部服务通信的统一协议层，握手失败意味着身份认证或路由策略被拦截，而非单纯网络不通。
方法一：查看握手失败标记
在诊断报告中定位「MCP Handshake」区块，若某Connector行显示红色❌且状态为“Auth rejected by gateway”，说明QoderWake签发的临时凭证未被目标网关接受。
方法二：比对时间戳偏差
检查报告顶部「System Time Drift」数值，若>300ms，【立即校准系统时间】——QoderWake所有MCP签名含纳秒级时间戳，偏差超阈值将直接被网关拒绝，且不提示具体原因。
方法三：验证协议版本兼容性
在Connector详情页点击「Show MCP Header」，确认version字段为v2.4+；若为v1.x，需执行qoder connector upgrade --force强制更新该Connector插件，旧版不支持2026年Qoder平台启用的零信任路由策略。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
定位DNS解析不一致问题
QoderWake在沙盒内维护独立DNS缓存，与系统DNS可能不同步，导致同一域名在浏览器能打开、但在Agent中解析失败。
第一步：导出沙盒DNS快照
在诊断报告页点击「Export DNS Cache」，保存为dns-sandbox-20260730.json。
第二步：对比系统DNS结果
在终端执行nslookup api.qoder.com → 记录返回的IP；再打开导出的JSON文件，搜索api.qoder.com → 比对IP是否一致。若不一致，说明沙盒缓存了过期记录或被中间代理污染。
第三步：强制刷新沙盒DNS
执行qoder dns flush --hard，该操作将清空全部缓存并重新发起权威DNS查询，无需重启QoderWake。
检查TLS证书链完整性
当诊断报告显示“TLS handshake timeout”或“CERT_UNTRUSTED”，并非证书过期，而是QoderWake沙盒信任库缺失中间CA证书。
1、在诊断报告中点击「View TLS Chain」，展开失败连接的证书路径。
2、确认根证书是否为DigiCert Global Root G3（Qoder平台2026年强制要求），若显示为自签名或Let's Encrypt R3，则需手动导入可信根。
3、下载Qoder官方根证书包：curl -fL https://qoder.com/certs/qoder-trust-bundle-2026.crt -o ~/.qoder/certs/qoder-root.crt。
4、执行qoder tls trust --import ~/.qoder/certs/qoder-root.crt，系统将自动校验并注入沙盒信任链。
