MyDeskBot

简体中文

English

简体中文

English

Appearance

故障排除 ​

简介 ​

本指南帮助您诊断和解决使用 MyDeskBot 时遇到的常见问题。

通用问题 ​

连接问题 ​

症状 ​

  • 无法连接到服务器
  • 超时错误
  • 频繁断开连接

解决方案 ​

  1. 检查网络连接

    bash
    # 测试网络连接
ping api.anthropic.com

  2. 检查代理设置

    • 如果使用代理，确保配置正确
    • 尝试禁用代理测试

  3. 检查防火墙

    • 确保防火墙允许相关端口
    • 添加例外规则

  4. 重启应用

    • 完全退出应用
    • 重新启动

性能问题 ​

症状 ​

  • 响应缓慢
  • CPU/内存占用高
  • 卡顿或冻结

解决方案 ​

  1. 检查系统资源

    bash
    # 检查 CPU 和内存使用
top -p $(pgrep MyDeskBot)

  2. 减少上下文

    • 缩小文件选择范围
    • 使用更精确的查询

  3. 调整模型设置

    • 降低 token 限制
    • 使用更快的模型

  4. 清理缓存

    bash
    # 清理应用缓存
rm -rf ~/.mydeskbot/cache

Desktop 特定问题 ​

安装问题 ​

macOS 安装失败 ​

症状: "无法验证开发者" 错误

解决方案:

bash
# 在系统设置中允许应用
# 系统设置 → 隐私与安全性 → 点击"仍要打开"

症状: "损坏" 错误

解决方案:

bash
# 移除隔离属性
xattr -cr /Applications/MyDeskBot.app

Windows 安装失败 ​

症状: SmartScreen 警告

解决方案:

  • 点击"更多信息"
  • 点击"仍要运行"

启动问题 ​

应用无法启动 ​

解决方案:

  1. 检查日志文件

    • macOS: ~/Library/Logs/MyDeskBot/
    • Windows: %APPDATA%\MyDeskBot\logs\
    • Linux: ~/.config/MyDeskBot/logs/

  2. 重置配置

    bash
    # macOS/Linux
rm -rf ~/.mydeskbot/config

# Windows
del %APPDATA%\MyDeskBot\config

  3. 重新安装应用

更新问题 ​

更新失败 ​

解决方案:

  1. 手动下载最新版本
  2. 卸载旧版本
  3. 安装新版本

更新后问题 ​

解决方案:

  1. 清理缓存
  2. 重置配置
  3. 联系支持团队

IDE 扩展问题 ​

VS Code 扩展 ​

扩展无法激活 ​

症状: 扩展显示为"已禁用"

解决方案:

  1. 检查 VS Code 版本兼容性
  2. 重新加载窗口 (Cmd+Shift+P → "Reload Window")
  3. 重新安装扩展

自动补全不工作 ​

解决方案:

  1. 检查 API 密钥配置
  2. 确保选择正确的语言模式
  3. 查看扩展日志 (View → Output → MyDeskBot)

错误消息 "Authentication failed" ​

解决方案:

  1. 验证 API 密钥
  2. 检查网络连接
  3. 重启 VS Code

IntelliJ IDEA 插件 ​

插件无法安装 ​

解决方案:

  1. 检查 IDEA 版本兼容性
  2. 使用手动安装
  3. 检查网络连接

功能不响应 ​

解决方案:

  1. 清理 IDEA 缓存
  2. 重启 IDEA
  3. 禁用冲突插件

Neovim 插件 ​

配置不生效 ​

解决方案:

  1. 检查 init.vim 中的配置
  2. 确保 packer 正确安装插件
  3. 运行 :PackerSync

CLI 问题 ​

命令执行失败 ​

命令未找到 ​

bash
# 检查安装路径
which mydeskbot

# 重新安装
npm install -g @mydeskbot/cli

权限错误 ​

bash
# 使用 sudo 安装（不推荐）
sudo npm install -g @mydeskbot/cli

# 或修复 npm 权限
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

配置问题 ​

配置文件错误 ​

bash
# 验证配置
mydeskbot config validate

# 重置配置
mydeskbot config reset

API 问题 ​

认证错误 ​

Invalid API Key ​

解决方案:

  1. 验证 API 密钥
  2. 检查密钥是否过期
  3. 重新生成密钥

Rate Limit 错误 ​

症状: "Rate limit exceeded"

解决方案:

  1. 等待限制重置
  2. 升级 API 计划
  3. 优化请求频率

Token 限制 ​

症状: "Request too large"

解决方案:

  1. 减少请求内容
  2. 分批处理
  3. 使用更大的上下文窗口模型

性能优化 ​

加快响应时间 ​

  1. 减少上下文

    • 只包含必要的代码
    • 使用文件范围限制

  2. 使用更快的模型

    • Claude Haiku 用于简单任务
    • Claude Sonnet 用于一般任务

  3. 缓存结果

    • 启用本地缓存
    • 重用常见响应

降低资源使用 ​

  1. 调整并发设置

    json
    {
  "maxConcurrentRequests": 3
}

  2. 使用流式响应

    • 更快看到结果
    • 减少内存占用

获取帮助 ​

日志收集 ​

macOS/Linux:

bash
# 收集应用日志
tar -czf logs.tar.gz ~/.mydeskbot/logs

Windows:

powershell
# 收集应用日志
Compress-Archive -Path $env:APPDATA\MyDeskBot\logs\* -DestinationPath logs.zip

报告问题 ​

报告问题时请包含：

  1. 操作系统和版本
  2. MyDeskBot 版本
  3. 问题的详细描述
  4. 重现步骤
  5. 相关日志文件
  6. 错误消息和截图

社区支持 ​

联系支持 ​

← 返回指南

Copyright © 2026 MyDeskBot