故障排除指南
常见问题
连接与授权问题
无法登录或认证失败
症状：
- 登录页面持续加载但不完成
- 显示"认证失败"或"令牌无效"错误
- 登录后立即被登出
解决方法：
-
检查网络
- 确认设备能访问互联网
- 检查防火墙设置
- 验证代理配置
-
清除缓存
- VS Code: 执行命令
开发人员: 重载窗口 - JetBrains: 文件 > 失效缓存并重启
- VS Code: 执行命令
-
更新凭证
- 完全注销并重新登录
- 验证账户状态
- 对于SSO登录，确认组织账户状态
-
检查服务状态
- 访问服务状态页面
- 查看系统维护通知
模型服务不可用
症状：
- "无法连接到模型服务"错误
- 响应持续超时
- 模型选择器显示"服务不可用"
解决方法：
-
验证API密钥
- 检查API密钥有效性
- 确认权限和配额充足
-
检查网络连接
- 确认能访问API端点
- 检查网络是否限制AI服务
-
切换模型
- 尝试使用其他模型提供商
性能与响应问题
响应缓慢
症状：
- 生成回复需要异常长时间
- 界面卡顿或冻结
- 进度指示器停滞
解决方法：
-
检查资源使用
- 关闭其他资源密集型应用
- 监控IDE内存使用
- 检查CPU使用率
-
调整模型配置
- 使用轻量级模型
- 减小上下文窗口
-
限制项目范围
- 减少扫描文件数量
- 排除大型生成文件
- 精简上下文信息
-
清理缓存
- VS Code: 清理扩展数据文件夹
- JetBrains: 使用缓存清理功能
功能特定问题
智能提示失效
症状：
- 输入时无代码提示
- 提示与上下文不相关
- 提示质量下降
解决方法：
-
检查功能状态
- 验证智能提示已启用
- 检查项目设置
-
重建索引
- 触发项目索引重建
- 确认语言服务器运行
- 检查文件排除设置
-
检查语言支持
- 确认当前语言受支持
- 安装必要语言扩展
- 验证语言服务器状态
代码改进应用失败
症状：
- 应用按钮无响应
- 显示"应用失败"错误
- 差异显示不正确
解决方法：
-
检查文件权限
- 确认文件非只读
- 验证文件系统权限
- 检查文件锁定状态
-
解决格式问题
- 检查代码语法有效性
- 确认行尾和缩进格式
- 处理字符编码问题
-
处理复杂差异
- 对大型差异分段应用
- 手动应用部分更改
- 使用差异编辑器合并
智能助理工具调用失败
症状：
- 工具调用返回错误
- 无法访问文件或运行命令
- 显示"权限被拒绝"
解决方法：
-
检查权限
- 确认工具访问权限
- 检查权限策略设置
- 验证工作区信任设置
-
验证工具配置
- 确认工具路径正确
- 检查依赖工具可用性
- 验证环境变量设置
-
独立测试
- 在终端中直接执行命令
- 验证文件访问路径
- 确认命令行工具可用
日志与诊断
日志文件位置
- Windows:
%USERPROFILE%\.dhcoder\logs - macOS/Linux:
~/.dhcoder/logs
自助修复步骤
基本修复
-
重载窗口
- VS Code:
开发人员: 重载窗口 - JetBrains: 文件 > 失效缓存并重启
- VS Code:
-
重置插件状态
- 关闭IDE
- 重命名插件状态目录
- 重启IDE，重建状态
-
更新扩展
- 安装待更新版本
- 重启IDE
- 查看更新日志
完全重置
如问题持续存在：
-
重新安装
- 完全卸载DHcoder
- 删除配置与缓存
- 安装最新版本
-
清理数据
- 移除用户目录中的扩展数据
- 重置IDE集成设置
- 清除自定义配置
获取支持
支持渠道
- 官方支持
- 使用
问题反馈功能 - 提交诊断报告
- 详述重现步骤
- 提供环境信息
- 企业邮箱：operation@dhcoder.net
- 使用