WorkBuddy 自定义模型配置

WorkBuddy 的模型配置痛点

WorkBuddy 默认模型无法覆盖企业内部模型、本地推理服务或特定厂商的 API。手动修改配置文件容易出错，字段拼写、URL 格式或能力标志设置不当会导致模型无法调用工具或解析图像。缺乏统一的校验流程，问题排查成本高。

技能如何工作

该技能通过编辑 ~/.workbuddy/models.json 实现对自定义模型的全流程管理：

• 添加模型：读取现有配置（不存在则初始化为 []），收集模型 ID、显示名称、供应商、API URL、API Key 和能力标志，检查 ID 唯一性后追加到数组。
• 列出模型：解析 JSON 并以可读格式展示 ID、名称、供应商、URL（API Key 做掩码处理）和能力标志。
• 更新与删除：按 ID 定位目标模型，应用变更或移除对象后写回文件。
• 配置校验：运行脚本检查 JSON 语法、必填字段、URL 格式、API Key 非空性、ID 唯一性，可选测试 API 连通性。

WorkBuddy 启动时加载该文件并监听变更，自定义模型以 custom-local: 前缀出现在模型选择器中（如 custom-local:gpt-5.4），保存后即时生效。

适用边界与注意点

• 只支持 OpenAI 兼容 API（/chat/completions 或兼容 base URL）；非兼容协议需将 useCustomProtocol 设为 true。
• API Key 属敏感信息，展示时必须掩码为 sk-xxxx...last4，不要写入日志或提交到版本控制。
• 覆盖或删除现有配置前需与用户确认。
• 模型能力（工具调用、图像、推理）需与实际模型匹配，否则会出现调用失败或功能缺失。
• 企业环境可能限制自定义模型使用，需咨询管理员。