WorkBuddy + LM Studio 本地模型批量配置指南

WorkBuddy LM Studio 本地模型批量配置指南 概述本文档说明如何将 LM Studio 中的本地模型批量导入到 WorkBuddy使其能够使用 MCPModel Context Protocol工具调用这些模型。LM Studio API Token 获取与权限配置完全指南最新版 Claude Desktop LM Studio 直连配置指南LM Studio 0.4.19 问题背景WorkBuddy 的积分用完了想继续当前的工作但模型列表只有几个手动配置的模型没有 LM Studio 其他模型的选项一项项配置非常耗时。于是可以发指令给 WorkBuddy 让它自己给自己配置并且完善候选模型列表本文记录了批量配置时容易遇到的问题和解决方案。WorkBuddy 有两个相关但独立的数据存储位置MCP 配置(~/.workbuddy/mcp.json) - 用于定义外部 MCP 服务器连接本地模型列表(~/.workbuddy/models.json) - WorkBuddy UI 中显示和选择模型的来源️ 完整配置步骤第一步从 LM Studio 获取模型 IDLM Studio 在localhost:1234上提供 API 端点。使用以下命令获取所有已加载模型的列表curl -s http://localhost:1234/v1/models | jq .data[] | {id, name}示例输出{ id: qwen3.5-9b-claude-4.6-highiq-instruct-heretic-uncensored, name: Qwen3.5 - Claude (HighIQ) }第二步编辑 MCP 服务器配置打开~/.workbuddy/mcp.json添加新的 LM Studio MCP 服务器条目放在最底部{ mcpServers: { // ... 其他现有配置 ... lmstudio-models: { type: model, models: [ {id: qwen3.5-9b-claude-4.6-highiq-instruct-heretic-uncensored}, {id: glm-4.7-flash-uncensored-heretic-neo-code-imatrix-max}, // ... 更多模型 ... ], base_url: http://localhost:1234/v1, default_model: qwen3.5-9b-claude-4.6-highiq-instruct-heretic-uncensored } } }第三步编辑 WorkBuddy 本地模型列表这是关键步骤打开~/.workbuddy/models.json用 LM Studio 模型替换所有现有条目。每个模型需要以下配置项字段说明示例值id唯一标识符必须与 MCP ID 匹配qwen3.5-9b-claude...name用户友好的名称Qwen3.5 - Claude (HighIQ)vendor模型来源LM StudiourlAPI 端点http://localhost:1234/v1apiKeyAPI 密钥sk-lm-XXXX:YYYY第四步验证配置重启 WorkBuddy 后在 UI 中检查✅ 已保存模型列表中应显示所有 LM Studio 模型✅ 默认选中的应该是第一个 Qwen3.5 模型✅ MCP 连接状态应为活跃 完整的模型列表模板[ { id: qwen3.5-9b-claude-4.6-highiq-instruct-heretic-uncensored, name: Qwen3.5 - Claude (HighIQ), vendor: LM Studio, url: http://localhost:1234/v1, apiKey: sk-lm-M05udwxr:Xut1wBZYgLdD1deXCRW8, supportsToolCall: true, supportsImages: true, supportsReasoning: true, useCustomProtocol: false, defaultModel: true }, { id: glm-4.7-flash-uncensored-heretic-neo-code-imatrix-max, name: GLM-4.7 Flash (Uncensored), vendor: LM Studio, url: http://localhost:1234/v1, apiKey: sk-lm-M05udwxr:Xut1wBZYgLdD1deXCRW8, supportsToolCall: true, supportsImages: false, supportsReasoning: false, useCustomProtocol: false }, // ... 更多模型 ... ] 故障排查Q1: MCP 服务器没有出现在列表中确认 MCP 服务器在mcp.json中正确配置检查 LM Studio 是否在运行端口 1234重启 WorkBuddyQ2: 模型列表未更新MCP 配置不是实时同步的必须手动编辑models.json文件确保每个模型的id与 MCP 配置中的 ID 完全匹配Q3: API 密钥无效默认格式sk-lm-XXXX:YYYY可以自定义但前缀应为sk-lm- 关键配置对比配置文件用途自动同步需要重启mcp.jsonMCP 服务器定义✅❌models.jsonUI 模型来源列表❌❌ 最佳实践版本控制将mcp.json和models.json纳入 Git 版本管理定期备份保存这些配置文件以防意外删除命名约定为模型使用清晰、描述性的名称API Key 安全不要将这些密钥提交到公共仓库 修改历史日期作者变更说明2026-07-22WorkBuddy Assistant初始创建添加 LM Studio 配置支持文档版本: 1.0最后更新: 2026-07-22 20:53