免费大模型一键接入

痛点：积分不够用与配置门槛

在 WorkBuddy 里调用大模型通常需要消耗积分，但重度用户经常会遇到 6004 错误（积分耗尽或限流）。虽然市面上有 DeepSeek、GLM、Qwen 等提供免费额度的大模型，但把它们接入 WorkBuddy 往往意味着手动修改配置文件、处理复杂的路径映射，甚至面临模型 ID 不匹配导致的 403/404 错误。

核心工作流：脚本化一键接入

这个技能的核心逻辑是用一条命令完成原本繁琐的配置工作，核心脚本为 scripts/setup_free_llm.py。

• 三路线选型：脚本内置了国内直连友好的「硅基流动」、境外模型池「OpenRouter」以及「Gemini 官方」三条路线，并会展示各自的免费额度与网络要求。
• 自动化探测与写入：选定路线并粘贴 sk- 开头的 API Key 后，脚本会自动抓取平台实时模型清单，逐个实测连通性。
• 安全备份与持久化：实测通过的模型会被合并写入 ~/.codebuddy/models.json 与 ~/.workbuddy/models.json，写入前会自动备份原文件为 .bak-时间戳，确保不覆盖用户的已有配置。

适用边界与排错

• 仅限免费层对话：通过此方式接入的模型作为「自定义模型」使用，不消耗 WorkBuddy 积分；一旦切回内置模型则恢复扣费。
• 关于 429 限流：免费模型使用全球共享算力池，高峰期遇到 429 错误是常态，并非故障，建议切换到列表中的其他模型或稍后重试。
• 网络要求：OpenRouter 的 API 通常可直连，但 Gemini 必须保持海外网络环境且账号需合规。