CodePass 出故障怎么办？自助诊断怎么用
本文说明 CodePass 常见故障类型、自助诊断工具的使用步骤，以及诊断后仍无法解决时的求助渠道。
常见故障类型
使用 CodePass 时遇到的问题通常可以归为几类：网络连通性异常（请求超时或无法到达）、插件补丁配置问题（版本不匹配或授权失效）、账号用量问题（余额不足或凭证过期）。先大致判断属于哪一类，能帮助更快缩小排查范围。
自助诊断工具使用步骤
打开 Cursor 里的 CodePass 插件面板，找到故障检测入口并点击开始检测，官网说明这项功能覆盖网络、插件补丁、账号用量等共 16 项[1]，检测过程不需要额外配置，几秒到几十秒内就能看到结果，而且诊断过程本身也不会采集你的代码内容。
诊断结果怎么看
检测报告会按维度分别标注正常和异常的项目。如果异常集中在网络类，优先检查本地网络环境；如果异常在插件补丁类，检查插件版本是否是最新、授权是否还有效；如果异常在账号用量类，直接去后台确认余额和凭证状态。
仍无法解决时怎么求助
按诊断报告提示排查一遍之后问题依旧存在，建议保留好诊断结果（可以截图），通过官网提供的支持渠道联系客服，说明具体的报错信息和诊断结果，方便对方更快定位问题。
常见问题
故障检测要花多长时间？
整个流程比较轻量，一般几秒到几十秒就能出结果，具体耗时以实际使用体验为准。
检测全部显示正常，但实际调用还是有问题怎么办？
说明问题可能不在这 16 项覆盖的范围内，这种情况建议直接联系客服并提供具体的错误信息，方便进一步排查。
多久应该主动跑一次故障检测？
没有固定要求，遇到调用异常时随时可以跑一次，日常使用顺畅的情况下不需要频繁主动检测。