cursor-doctor — Cursor IDE 故障诊断工具
Diagnose and fix Cursor IDE errors, crashes, and configuration issues with one command. Built from real pain signals mined from Chinese developer communities.
痛点来源 (Pain Signal Origins)
在 2026 年 4-5 月的中文开发者社区扫描中,Cursor IDE 报错/崩溃是 Top 3 最热话题:
- V2EX
cursor节点:15+ 讨论帖(Cursor 陨落、CLI 反代、模型限制) - CSDN 技术博客:30+ 篇 Cursor 故障文章
- 来源覆盖:V2EX · CSDN · 掘金
Quick Start
pip install cursor-doctor
# Full diagnosis
cursor-doctor diagnose
# Auto-fix common issues
cursor-doctor fix
# Match error text to known signatures
cursor-doctor match --text "MCP Client Closed"
# List all known error signatures
cursor-doctor signatures
Error Categories (16 signatures)
| Category | Count | Examples |
|---|---|---|
| MCP/Agent Connection | 3 | MCP Client Closed, Shell Parse Failure, Auth Expired |
| Crash/Freeze | 3 | Startup White Screen, Plugin Crash, Memory Overflow |
| AI/Agent Malfunction | 3 | Request Timeout, Completion Quality Drop, Agent Loop |
| Proxy/Network | 2 | Proxy Conflict, GFW Blocked |
| Config/Environment | 3 | Config Corruption, Python Not Found, Node.js Error |
| File/Sync | 2 | Sync Conflict, File Watcher Error |
Related Tools
- claude-intel-monitor — 检测 Claude/GPT/DeepSeek 是否降智
- HermesMade — 自动化开发者痛点扫描平台
