创建个性化 AI 中台，WorkBuddy 接入 B.AI 模型详细指南

正文：

在当今迅速发展的开发领域，WorkBuddy 凭借其灵活的工作流管理和强大的系统集成功能，已经成为许多开发者桌面环境中的“生产力核心”。它不仅能够整合多种分散的开发工具，还能作为专属的智能中台，使开发者能够在不切换上下文的沉浸式环境中直接利用顶尖的 AI 能力，从而显著减少日常任务中的执行摩擦，让核心精力集中于高价值的思考与创造。

为了帮助广大开发者更高效地将 B.AI 的高性能模型引入日常开发流程，本文将提供详细的指导，教您如何在 WorkBuddy 桌面端集成 B.AI 自定义模型。在配置之前，请确保您已准备好 WorkBuddy 账号、B.AI API Key，以及当前可用的模型 ID。接下来的步骤仅需遵循本文的简单指引，即可在本地实现高效流畅的 AI 协作体验。

请注意：如果系统阻止安装，请首先确认安装包来源于官方网站，并检查弹窗中的应用名称及发布者信息。切勿通过关闭 Windows 安全防护来绕过安全检查。

当前，官方网站提供适用于 Apple 芯片和 Intel 版的 .dmg 文件，要求 macOS 12.0 或更高版本。

打开 .dmg 文件后，将 WorkBuddy 拖入「应用程序」文件夹，并从应用程序中启动。如果不确定芯片类型，可以在「关于本机」中查看「芯片」或「处理器」信息。

当前 WorkBuddy 桌面端仅支持 Windows 和 macOS，暂不支持 Linux。同时，由于移动端与鸿蒙端的功能差异，本文中的所有操作均以桌面端为准。

首次启动时，请点击「登录」，按照客户端提示完成认证。国际版官方文档提供了 Google 和 GitHub OAuth 的选项。如果您看到微信扫码或其他入口，请根据客户端实际选项进行操作。

请先登录 B.AI，然后在左侧导航栏中选择 API 管理或 API Key 管理页面，点击「创建 API Key」，并为其设置一个易于识别的名称（例如 WorkBuddy）。由于 B.AI 的官方机制限制，完整的 Key 仅在创建成功时显示一次，因此请务必在创建后立即复制并妥善保存。

请注意：切勿在文章、截图、聊天记录或公开仓库中泄露完整 Key。如果怀疑 Key 已泄露，请立即删除旧 Key，创建新 Key，并更新 WorkBuddy 配置。

打开 WorkBuddy，点击左下角的账户头像，选择「设置」。

如果列表中已有其他自定义模型，请确保点击「添加模型」以新增配置，切勿直接覆盖现有模型的参数。如果需要修改现有的 B.AI 模型，只需点击该模型旁的铅笔图标即可。如果希望在修改的同时保留旧版模型，则需要全新添加一条配置。

在「提供商」下拉菜单中选择「自定义」，并在弹出的页面中填写相关信息。

根据 WorkBuddy 官方文档，当「自定义协议」关闭时，客户端会按照标准的 OpenAI Chat Completions 规则，自动在填写的 URL 末尾添加 /chat/completions 路径；当该开关开启时，客户端将直接向您填写的完整 URL 发起请求，不再进行任何路径拼接。请注意避免混用这两种方式，重复拼接成 /v1/chat/completions/chat/completions 时，通常会返回 404 错误。

「高级设置」中的开关仅用于声明模型的能力，勾选后不会使本来不支持的模型自动获得能力。请根据实际情况，遵循以下原则进行配置：

如果无法确认输入、输出的上限，建议保留「使用供应商默认值」。未经文档或实测确认，请勿默认开启所有能力。

检查完 URL、API Key 和模型 ID 后，点击「保存」。新模型应出现在「已保存模型」列表中。

如果未显示，请依次检查保存弹窗是否仍然打开、字段是否报错、模型选择器是否刷新以及客户端版本。必要时，完全退出 WorkBuddy 后重新启动。模型出现在列表中仅说明配置已保存，并不表明 B.AI 调用已成功，仍需进行后续验证。

返回「新建任务」，打开输入框附近的模型选择器，在自定义模型分组中选择刚添加的模型。在测试期间，请勿选择“Auto”模式，因为该模式可能调度其他模型，从而无法确认本次请求确实使用了 B.AI。

如果收到正常的回复，说明 WorkBuddy 已成功读取配置，并且 Key、URL 与模型 ID 至少能够完成一次文本调用。如果调用失败，请按「当前模型 → API Key → URL 和协议开关 → 模型 ID → 额度与权限」的顺序进行检查。请勿通过询问模型“你是谁”来判断路由是否成功，因为模型自报身份不能作为接入的有效证据。

请先新建一个只用于测试的文件夹，放入一两个不含隐私信息的文本文件，在 WorkBuddy 中将该文件夹设置为工作区，并仅授予完成读取任务所需的权限，最后发送以下指令：

请读取当前工作空间中的文本文件，列出文件名并各用一句话总结内容。请勿修改、移动或删除任何文件。

只有当 WorkBuddy 显示文件读取工具调用，并正确返回文件摘要时，才说明工具调用链路可用。如果能够聊天但不能读取文件，请检查工具调用、模型工具调用能力、B.AI 端点支持以及工作空间权限。

如果 B.AI 控制台提供了用量或调用记录，请核对近期的请求时间、模型 ID、请求次数以及 Token 消耗量，以确保数据与刚刚的测试相符。

为了确保整个接入流程完整有效，请逐一核查以下三个阶段的成功状态：

可能是尚未登录、客户端版本较旧，或未打开桌面端模型设置。请先登录，然后进入「设置」→「模型」。如果仍然找不到入口，请选择「检查更新」以更新客户端并重启。若问题依旧，请通过「帮助与反馈」提交版本号和截图。

2. 如果 Windows 或 macOS 无法安装或打开该如何处理？

请先确认「已保存模型」中是否存在该条目，再关闭设置并重新打开模型选择器。如果仍未显示，请完全退出并重启 WorkBuddy，同时检查客户端更新。

4. 出现 401、403、404、429 错误的原因及解决方法是什么？

每次只需修改一项，再用普通对话测试，以便更精准地定位问题。

5. 如果出现“model not found”提示该如何解决？