WorkBuddy 不支持在图形界面中直接输入 API Key，因「添加模型」UI 仅对预置提供商生效，选「自定义」后跳过密钥字段；密钥必须手动写入 ~/.workbuddy/models.json 文件，且修改后需完全退出并重启应用才生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 不支持在图形界面中直接粘贴或输入 API Key —— 所有自定义模型的密钥必须通过修改 models.json 文件手动注入。
为什么不能在「模型」配置界面填 API Key？
WorkBuddy 的 Web UI 中的「添加模型」流程仅对预置提供商（如腾讯云、Kimi）生效；选择「自定义」后，UI 会跳过密钥字段，实际密钥需写入本地配置文件。这是当前 v4.6.4+ 版本的设计限制，不是 bug。
- UI 提交时不会校验或保存
api_key字段，留空即被忽略 - 即使你看到「保存成功」提示，
models.json文件里也不会出现密钥内容 - 密钥明文写入本地 JSON 是唯一可靠方式，WorkBuddy 启动时只读取该文件
正确写入 API Key 的路径和格式
确保配置目录和文件存在，并按标准 JSON 格式填写密钥字段。路径必须是 ~/.workbuddy/models.json，其他位置（如项目根目录、/tmp）无效。
WorkBuddy Visio — Visio 兼容架构图生成器
下载
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
- 先执行
mkdir -p ~/.workbuddy创建目录（注意中间是-p，不是_p） - 用编辑器打开
~/.workbuddy/models.json，不要新建同名文件放在别处 - 每个模型对象必须包含
"api_key"字段，值为字符串，例如："api_key": "sk-xxx123" - 若使用 Ollama 或本地部署模型，
"api_key"可设为空字符串""或直接省略（但 HTTP 模型必须提供）
常见错误：密钥写对了却调用失败
API Key 能被读取，不代表请求能通。以下问题比密钥本身更常导致 401/403 错误：
-
base_url拼写错误，比如写成baseurl或漏掉http://前缀 - 模型名（
model字段）与服务商要求不一致，例如 Kimi 必须用moonshot-v1-8k，写成kimi-8k就拒收 - 没配
max_tokens或temperature等必要参数，部分接口（如月之暗面）会静默拒绝无参请求 - JSON 末尾多了一个逗号（,），导致整个
models.json解析失败，WorkBuddy 启动时不会报错，但模型列表为空
最易被忽略的一点：WorkBuddy 不会热重载 models.json。改完文件后必须完全退出应用（macOS 下右键 Dock 图标 →「退出」），再重新启动才能生效。
