前置条件
- 1Windows 10 20H2+ 或 macOS 12+
- 2已注册 Gemini（Google AI Studio）开放平台账号
- 3电脑能联网（国内访问 Gemini 需梯子）
常见问题
Q我连配置文件是什么都不懂，能用吗？
能用。选方式 A，全程在 WorkBuddy 桌面端的设置界面里点选、粘贴 API Key，不用手写任何配置代码。
Q方式 A 的设置入口在哪？
打开 WorkBuddy 桌面端，点击右上角的齿轮（设置）图标，进入「模型配置」/「供应商」标签，点击「添加自定义供应商」或「+ 新增」即可开始配置。
QAPI Key 填了但还是报 401 错误？
请检查 Key 是否有多余空格或换行符。建议方式 B 用环境变量 apiKeyEnv 而非直接填写 apiKey。确认 Key 未过期且 Google AI Studio 项目计费已启用。
Q调用时出现 404 Not Found？
baseURL 必须包含 /v1beta/openai 路径，正确格式为 https://generativelanguage.googleapis.com/v1beta/openai/，遗漏 /openai 是最常见的新手错误。
Q响应很慢或者超时怎么办？
国内访问 Google 必须开全局梯子，否则会连接超时；先将 maxTokens 降到 1024 测试连通性；超过 200K tokens 的长上下文请求会触发更高计费档位且更慢。