故障排除#

要调试 MiMo Code 的问题，请先检查其存储在磁盘上的日志和本地数据。

#日志

日志文件写入位置：

• macOS/Linux: ~/.local/share/mimocode/log/
• Windows: 按 WIN+R 并粘贴 %USERPROFILE%\.local\share\mimocode\log

日志文件以时间戳命名（例如 2025-01-09T123456.log），并保留最近的 10 个日志文件。

你可以通过 --log-level 命令行选项设置日志级别以获取更详细的调试信息。例如：mimo --log-level DEBUG。

#存储

MiMo Code 将会话数据和其他应用数据存储在磁盘上：

• macOS/Linux: ~/.local/share/mimocode/
• Windows: 按 WIN+R 并粘贴 %USERPROFILE%\.local\share\mimocode

该目录包含：

• auth.json - 身份验证数据，如 API 密钥、OAuth Token
• log/ - 应用日志
• project/ - 项目特定数据，如会话和消息数据
  • 如果项目位于 Git 仓库中，则存储在 ./<project-slug>/storage/
  • 如果不是 Git 仓库，则存储在 ./global/storage/

#获取帮助

如果你遇到 MiMo Code 的问题：

1. 在 GitHub 上报告问题

   报告 Bug 或请求功能的最佳方式是通过我们的 GitHub 仓库：

   github.com/mimocode/mimocode/issues

   在创建新 Issue 之前，请先搜索已有的 Issue，看看你的问题是否已被报告。

#常见问题

以下是一些常见问题及其解决方法。

#MiMo Code 无法启动

1. 检查日志中的错误消息
2. 尝试使用 --print-logs 运行以在终端中查看输出
3. 使用 mimo upgrade 确保你使用的是最新版本

#身份验证问题

1. 尝试在 TUI 中使用 /connect 命令重新进行身份验证
2. 检查你的 API 密钥是否有效
3. 确保你的网络允许连接到提供商的 API

#模型不可用

1. 检查你是否已通过提供商的身份验证
2. 验证配置中的模型名称是否正确
3. 某些模型可能需要特定的访问权限或订阅

如果你遇到 ProviderModelNotFoundError，很可能是在某处错误地引用了模型。 模型应按如下方式引用：<providerId>/<modelId>

示例：

• openai/gpt-4.1
• openrouter/google/gemini-2.5-flash
• mimocode/kimi-k2

要查看你有权访问哪些模型，请运行 mimo models

#ProviderInitError

如果你遇到 ProviderInitError，很可能是配置无效或已损坏。

要解决此问题：

1. 首先，按照提供商指南验证你的提供商是否已正确设置

2. 如果问题仍然存在，请尝试清除已存储的配置：

   rm -rf ~/.local/share/mimocode

   在 Windows 上，按 WIN+R 并删除：%USERPROFILE%\.local\share\mimocode

3. 在 TUI 中使用 /connect 命令重新与提供商进行身份验证。

#AI_APICallError 和提供商包问题

如果你遇到 API 调用错误，可能是由于提供商包过期导致的。MiMo Code 会根据需要动态安装提供商包（OpenAI、Anthropic、Google 等）并将它们缓存到本地。

要解决提供商包问题：

1. 清除提供商包缓存：

   rm -rf ~/.cache/mimocode

   在 Windows 上，按 WIN+R 并删除：%USERPROFILE%\.cache\mimocode

2. 重新启动 MiMo Code 以重新安装最新的提供商包

这将强制 MiMo Code 下载最新版本的提供商包，通常可以解决模型参数和 API 变更带来的兼容性问题。

#在 Linux 上复制/粘贴不可用

Linux 用户需要安装以下剪贴板工具之一，复制/粘贴功能才能正常工作：

对于 X11 系统：

apt install -y xclip
# or
apt install -y xsel

对于 Wayland 系统：

apt install -y wl-clipboard

对于无头环境：

apt install -y xvfb
# and run:
Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
export DISPLAY=:99.0

MiMo Code 会检测你是否正在使用 Wayland 并优先使用 wl-clipboard，否则将按以下顺序尝试查找剪贴板工具：xclip 和 xsel。