WorkBuddy可通过配置火山云Ark API调用免费大模型实现零积分办公创作：先获取API密钥与端点，再修改providers.json添加模型配置，重启后选择对应模型即可处理文档、会议纪要等任务，费用按token从火山云账户扣除。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy怎么用免费模型进行办公创作？你需要绕过默认积分消耗机制，直接调用第三方大模型API——比如火山云Ark提供的12个免费模型，它们不走WorkBuddy积分池，而是按实际token计费，新注册用户通常有数百元额度，足够支撑日常文档处理、会议纪要生成、PPT大纲撰写等高频办公任务。
获取火山云Ark API密钥和端点
打开火山云控制台（https://www.volcengine.com/），登录后进入「Ark大模型服务」→「API管理」→「创建API Key」。系统会自动生成一串32位密钥，【务必立即复制并保存到本地文本文件，页面刷新后无法再次查看】。
在同一个页面找到「服务端点」区域，确认Base URL为https://ark.cn-beijing.volces.com/api/coding/v3。注意：这个地址带/coding/v3后缀，不是/v1或/v2，填错会导致后续全部配置失败。
记下你打算主用的模型ID，例如deepseek-v4-pro（通用强推理）或glm-4.7（中文理解更稳），这两个模型在办公场景中响应准确率最高。
修改WorkBuddy配置目录定位
WorkBuddy默认把配置文件存在~/.workbuddy路径下，但Windows用户常因权限问题导致写入失败。先确认环境变量：echo $CODEBUDDY_CONFIG_DIR（macOS/Linux）或echo %CODEBUDDY_CONFIG_DIR%（Windows）。
如果返回为空，说明没设环境变量。此时必须手动创建配置目录：在资源管理器中直接输入%USERPROFILE%\.workbuddy（Windows）或~/Library/Application Support/workbuddy（macOS），新建一个空文件夹。
这一步不做，后续JSON配置文件将被写入错误位置，WorkBuddy启动时根本读不到你的自定义模型。
写入自定义模型配置文件
用VS Code或Notepad++打开providers.json文件（路径：你的配置目录/providers.json）。如果文件不存在，就新建一个。
在文件末尾的]前插入以下JSON块（注意逗号分隔）：
{
"id": "volc-deepseek-pro",
"name": "火山·DeepSeek-V4-Pro",
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
"provider": "openai",
"base_url": "https://ark.cn-beijing.volces.com/api/coding/v3",
"api_key": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"model": "deepseek-v4-pro"
}
【api_key字段值必须替换成你刚才复制的真实密钥，且不能有多余空格或换行】。模型名必须与火山云文档中列出的ID完全一致，大小写都不能错。
保存文件后，重启WorkBuddy客户端——只有重启才能触发配置重载，热刷新无效。
在任务中调用免费模型
第一步：点击左下角「选用模型」→下滑到底部→选择「火山·DeepSeek-V4-Pro」。
第二步：回到对话区，直接输入办公需求，例如：“把上周会议录音文字稿整理成带时间戳的纪要，重点标出三个待办事项和负责人”。
第三步：WorkBuddy会自动识别该请求需调用本地文件，弹出文件选择框→选中你的txt或docx文件→点击「确认」。
第四步：等待生成结果。首次调用可能稍慢（约8～12秒），因为要建立HTTPS连接并验证API密钥；后续同一会话内响应会快很多。
第五步：生成的纪要可直接导出为Word或Markdown，无需二次编辑。所有处理过程不扣除WorkBuddy积分，只从火山云账户扣token费用。
