真实故障 · 可验证步骤
从具体报错开始，不靠反复重装碰运气。
这里整理 Windows 上 AI 编程工具最常见、也最容易被误判的故障。每篇都先划清风险，再给排查顺序和成功标志。
插件明明安装了，为什么列表里不显示？
区分文件存在、市场清单登记、技能启用和实际工具调用。
查看排查步骤 → MCP 连接MCP 一直 failed 或 pending 怎么办？
把进程、传输、授权和资源权限拆开验证。
查看排查步骤 → NOTIONNotion 能搜索但不能读取正文
为什么 self 成功不代表文档可读，以及正确的 search → fetch 验证。
查看排查步骤 → WINDOWS / LINUX远程 bash 提示文件不存在，但文件明明在
检查 CRLF、^M、shebang 和跨 Shell 路径污染。
查看排查步骤 → 网络WebSocket 超时，但 HTTPS fallback 可用
判断这是可降级警告，还是会影响工作的真实断网。
查看排查步骤 →