配置使用教程
从拿到兑换码到用上 AI 大模型，最快 5 分钟。照着下面的步骤一步步做即可。
准备工作：安装客户端
还没装客户端的先下载（装好的跳过）
下载 WorkBuddy 桌面客户端（Windows / Mac 都支持）
安装并登录后，先随便打开一个对话窗口，确认客户端能正常使用
你的兑换码在下方随时可用，不需要在客户端里注册任何账号
备选方式：手动逐个添加（所有版本通用）
如果上方「一键导入」在你的客户端上没生效，用这个兜底方式：在客户端里手动逐个添加，所有版本通用、亲测有效。先加 Auto 和 DeepSeek V4 Flash 两个就够用，其他随时补。
在客户端里：设置 → 模型 → 添加模型
供应商选「自定义」
接口地址填：https://heraldbuddy.chuanxunzhe.cn/v1
API Key 填你的兑换码（bc- 开头）
模型名称照抄下表里的名字（区分大小写、带空格），每加一个模型重复一次本流程
高级配置保持默认即可，点「保存」
| 模型名称（照抄，区分大小写） | 适合场景 | 消耗速度 |
|---|---|---|
| Auto | 日常首选，自动选最优模型 | 最省 ≈80 积分/轮 |
| DeepSeek V4 Flash | 快速问答、写作 | 最省 ≈80 积分/轮 |
| Kimi K3 | 长文档、写作 | ≈95 积分/轮 |
| Kimi K2.5 | 长文本、日常 | ≈95 积分/轮 |
| MiniMax M3 | 长文档、分析 | ≈95 积分/轮 |
| Qwen3.7-MAX | 中文创作 | ≈105 积分/轮 |
| GLM-5.2 | 中文创作 | ≈105 积分/轮 |
| DeepSeek V4 Pro | 复杂推理（思考久） | 较费 ≈160 积分/轮 |
第二步：验证配置成功
怎么判断配置成功了
完全退出客户端：Windows 右下角托盘图标右键退出；Mac 按 ⌘+Q（注意不是点窗口关闭按钮）
重新打开客户端，进入对话窗口
点击底部模型选择框，如果看到 Auto、DeepSeek V4 Flash 等刚添加的模型 → 配置成功 ✅
随便发一句「你好」测试，能正常回复就大功告成
- 检查接口地址是否精确为
https://heraldbuddy.chuanxunzhe.cn/v1（结尾有 /v1） - 检查 API Key 是否填的兑换码（bc- 开头，复制时不要带空格）
- 检查模型名称是否一字不差（区分大小写、带空格）
- 报 401/403：兑换码积分已用尽或有旧配置残留，删除旧模型后重新添加
第三步：开始使用
日常使用说明
在模型下拉框选择任意 HeraldBuddy 模型即可开始对话，积分按 token 用量自动扣除
推荐日常用 Auto（自动选最优模型），写代码选 Kimi K2.7 Code，长文档选 1M 上下文的模型（GLM-5.2 / MiniMax M3 / Kimi K3）
想开启深度思考：点击模型旁边的「编辑」图标，打开「推理/Reasoning」开关
首次对话因建立缓存消耗略多，之后同会话享受约 5 折
换电脑、换客户端不用重新购买：用同一个兑换码在新设备上重新添加一遍模型即可，积分全局通用
增值服务：AI 画图 & AI 视频
积分查询、续费与购买
第一步：一键导入全部模型（推荐方式）
只需配置 一次 API，就能把平台全部 11 个模型一次性导入到客户端， 之后在模型下拉框里任意切换，积分从同一个兑换码里自动扣除。比手动一个个加快得多。
操作步骤
打开配置页面：点击顶部导航栏「生成配置」，或直接访问 /config
输入你的兑换码（bc- 开头），首选模型推荐选 Auto
点击「生成配置文件」
下载「Windows 全自动脚本」或「Mac 全自动脚本」，脚本会自动下载 models.json 并放到正确位置
双击运行脚本，完成后完全退出客户端再重新打开
Windows 用户
- 在 /config 页面下载「Windows 全自动脚本」
- 把 .bat 文件放到桌面，双击运行
- 脚本会自动把 models.json 写入
C:\Users\你的用户名\.workbuddy\ - 看到「完成」提示后，按任意键关闭窗口
C:\Users\你的用户名\.workbuddy\，替换原有文件。Mac 用户
- 在 /config 页面下载「Mac 全自动脚本」
- 把 .command 文件放到桌面，双击运行
- 脚本会自动把 models.json 写入
~/.workbuddy/ - 看到「完成」提示后，按回车退出
~/.workbuddy/，替换原有文件。常见问题
📢 关于底层大模型的透明披露
依据《生成式人工智能服务管理暂行办法》，我们如实告知：HeraldBuddy 平台的 AI 能力底层由 DeepSeek 等第三方开源大模型驱动（通过正规云平台付费调用），HeraldBuddy 提供的是接入、计费与服务支持。平台助手在对话中自称「HeraldBuddy 平台提供的 AI 助手」，指服务提供方；如您追问底层模型，助手会如实告知。我们不会冒充任何其他厂商的模型。
Q：你们用的是什么大模型？是自己训练的吗？
A：底层由 DeepSeek 等第三方开源大模型驱动，我们通过正规云平台付费调用，不是自研模型。HeraldBuddy 做的是稳定接入、积分计费和客户服务。模型开源协议（MIT）允许合法商用，请放心使用。
Q：为什么助手自称 HeraldBuddy 而不报模型名？
A：「HeraldBuddy 平台提供的 AI 助手」指的是服务提供方。当您进一步追问底层模型时，助手会如实告知当前使用的是 DeepSeek 具体版本。如果您发现助手自称其他厂商（如 Claude、GPT），那是个别客户端注入的历史配置残留，属于显示问题，实际调用的始终是我们公开列表里的模型。
Q：一键导入 models.json 后模型没出现
A：极少数旧版客户端对配置文件格式支持不同，可能导入后不生效。请退回「备选：手动逐个添加」在客户端里手动添加，3 分钟搞定，所有版本通用；也可以完全退出客户端重开一次再试。
Q：报错 400 / 3000
A：网络问题，多数是开了代理/VPN。关闭代理后重试即可。
Q：报错 502 / 503
A：高峰期偶发拥堵，不用改配置，稍等片刻继续请求即可。
Q：报错 401 / 403
A：① 检查 API Key 是否填的兑换码（bc- 开头）；② 如果之前导入过旧配置，删除旧模型后重新添加；③ 积分用尽请通过闲鱼联系客服续费。
Q：回复速度慢
A：模型正在深度思考，属于正常现象，耐心等待即可。追速度可选 DeepSeek V4 Flash。
Q：如何开启深度思考
A：点击模型名称旁的「编辑」图标，打开「推理 / Reasoning」开关后保存。
Q：一个兑换码可以多台电脑用吗
A：可以。兑换码 = 账户 = API Key，积分跨设备、跨客户端通用。新电脑上重新添加一遍模型即可。
准备好了？3 分钟添加你的第一个模型
照着「第一步：一键导入全部模型」做即可，接口地址和模型名称都能直接复制