常见问题及排查方法包括:
- API连接失败:检查密钥有效性、网络连接,确认
CUSTOM_LLM_ENDPOINT
设置正确 - 多模态处理异常:确认模型是否支持该功能(如 DeepSeek-R1 不支持图片分析)
- 输出截断:调整
CUSTOM_LLM_MAX_TOKENS
环境变量(默认8192) - 性能问题:切换更轻量模型或检查本地资源占用
排查工具:
1. 运行 elc logs
查看详细错误日志
2. 查阅项目的 troubleshooting 文档
3. 在GitHub提交issue附上报错信息和复现步骤
推荐首次使用时先执行简单文本生成测试验证基础功能,再逐步尝试复杂场景。
本答案来源于文章《easy-llm-cli:让Gemini CLI 支持调用多种大语言模型》