故障排除

问题过长 / 提示词过长

• 全书库问题：使用 AI 搜索（不选书），或在选中 50+ 本书时接受切换到 AI 搜索
• 多本书比较：最多 30 本使用详细元数据；更大选择会自动切换为紧凑格式
• 非常大的书库可能在提示词限制处截断索引——如有需要，在通用设置中启用 自定义提示词长度限制（建议值：524288）
• 阅读错误消息——它会显示当前长度、限制值和建议操作

详见 自定义提示词长度。

请求失败

• 检查网络连接
• 验证 API 密钥是否正确
• 尝试其他 AI 提供商

API 密钥无效

• 复制完整密钥，不要有空格
• 检查密钥是否过期
• 对于 Grok: 使用 console.x.ai 的密钥，不是 x.com

Ollama 不工作

1. 确保 Ollama 已安装并运行
2. 拉取模型: ollama pull llama3.2
3. 检查模型: ollama list
4. 确认服务运行: ollama serve

常见问题

插件不显示在工具栏

1. 安装后重启 calibre
2. 检查 首选项 -> 工具栏与菜单
3. 确保插件已启用

响应很慢

• 尝试其他 AI 提供商
• 检查你的网络连接
• 考虑使用更小/更快的模型

模型列表不加载

• 验证你的 API 密钥是否正确
• 检查 Base URL 是否正确
• 尝试再次点击 "加载模型列表"