WorkBuddy 使用文档：把算力装进你的客户端

本页说明如何将「埃拉Ai」模型接入 WorkBuddy 桌面端。本账号与积分仅限 WorkBuddy 使用。

1详细使用说明（先读这段）

整体流程只有三步，全程无需懂技术：

  1. 兑换码激活积分：在兑换页或门户「我的额度」里粘贴兑换码（形如 12 位字母数字，如 W2464QRS7E5A，无前缀无连字符），积分立即到账。
  2. 下载配置包：在「我的额度」点击「下载 WorkBuddy 配置」，得到 workbuddy-config.zip（压缩包里已含你的专属网关密钥）。
  3. 导入 WorkBuddy：解压后双击 import.bat（推荐，最简单），或按本文「手动部署」自己放文件。然后打开 WorkBuddy 切到模型设置即可看到模型。

积分是结算单位，WorkBuddy 内只显示「积分余额」与用量，不显示金额。每次调用模型按 token 消耗扣减积分，余额用尽需续费。

2在线一键脚本（免解压，推荐）

除了 zip 离线包，现在多了一条更省事的方式：在线一键脚本。在「我的额度」里和「下载配置」并列提供，按你的系统下载 workbuddy-setup.cmd（Windows）或 workbuddy-setup.sh（macOS）。脚本里已经烘焙好你的专属密钥与模型清单，下载后直接运行即可，无需解压、也无需本机安装 Python。

  1. 登录 WorkBuddy 门户 → 「我的额度」卡片，点击对应的 「Windows 脚本」/「macOS 脚本」按钮下载。
  2. Windows：双击 workbuddy-setup.cmd；macOS：在终端执行 bash workbuddy-setup.sh。
  3. 看到「配置成功」提示后，重启 WorkBuddy，即可看到 埃拉Ai DeepSeek-V4-Pro 等模型。
为什么比 zip 更省心？
脚本会自动对你原有的 models.json 做备份（生成 models.json.backup-时间戳 文件），按模型 id 合并写入（相同 id 覆盖、异 id 追加，不会抹掉你已有的其它自定义模型），密钥仅写入本机配置目录、不外泄。无需解压、无需 Python；个别系统仍可能被 SmartScreen 拦截（点「更多信息 → 仍要运行」即可），一般无需像 zip 包那样临时关闭实时防护。

3获取「一键部署脚本（.bat / zip）」的方法

我们不直接发放 .bat 文件（容易被杀毒软件当作病毒拦截删除），而是把它打包进「配置包」里，由你登录后自行下载：

  1. 打开 WorkBuddy 门户 并登录。
  2. 登录后在「我的额度」卡片里，点击 「下载 WorkBuddy 配置」 按钮。
  3. 浏览器会下载一个 workbuddy-config.zip 压缩包，解压到桌面等你能找到的位置。
  4. 解压后里面就有 import.bat（一键部署脚本）和 使用说明.txt，以及 models.json、merge.py 等配置文件。

如果浏览器提示「下载的文件可能有害」被拦截，请在下载栏选择「保留」或「仍要下载」——这是压缩包 + 脚本的误报，文件本身安全。

前往 WorkBuddy 门户下载配置包

4⚠ 重要：运行 .bat 前请先临时关闭杀毒软件

运行 import.bat 之前，请先临时关闭 Windows 安全中心 / 第三方杀毒软件。
该脚本会向你的 WorkBuddy 配置目录写入 models.json 文件。杀毒软件对「可执行脚本 + 写入系统目录」的行为高度敏感，常会误判并直接拦截或删除脚本，导致导入失败（表现：双击没反应、文件被秒删、客户端看不到模型）。

正确做法：

  1. 暂时退出 / 关闭杀毒软件与 Windows 安全中心（实时防护）。
  2. 双击 import.bat，看到窗口显示「导入成功」再关闭窗口。
  3. 导入完成后、WorkBuddy 已能正常连接模型，再把杀毒软件重新开启。

若双击时被 SmartScreen 拦截，点「更多信息 → 仍要运行」即可。整个过程只是写入本地配置文件，不会联网上传任何东西。

如果你对「关闭杀软」感到不安，请直接走下方「手动部署」，全程不运行任何脚本，同样能把模型接好。

5手动部署（不运行任何脚本的替代方案）

如果你不想关闭杀软、或脚本方式失败，可以用手动方式导入。WorkBuddy 的配置方式是把一个 models.json 放进配置目录。

  1. 解压 workbuddy-config.zip，找到里面的 models.json。
  2. 打开文件资源管理器，地址栏输入 %USERPROFILE%\.workbuddy 并回车，进入 WorkBuddy 配置目录。
  3. 把 models.json 复制到该目录下（若已存在同名文件，先备份原文件再覆盖）。
  4. 打开 WorkBuddy，左侧菜单切到「模型 / 设置」，刷新或重启客户端，即可看到 埃拉Ai DeepSeek-V4-Pro 等模型。

提示：配置包里的 使用说明.txt 也提供了详细步骤；若仍看不到模型，先确认 models.json 是否到位，再重启 WorkBuddy。

6查询你的积分余额（随时查看用量）

登录 WorkBuddy 门户 后，在「我的额度」里可实时查看积分余额、每次调用的 token 消耗与用量明细。点击下方按钮直接跳转查询（需先登录 WorkBuddy 账号）：

📊 WorkBuddy 积分查询

查看 WorkBuddy 专用积分余额、用量与专属令牌状态。

前往 WorkBuddy 门户

7信任说明与常见问题

🔒 密钥安全吗？为什么敢把 Key 放在脚本 / 配置里？

  • 配置与脚本里的「专属密钥」是只对你这台机器、WorkBuddy 客户端生效的网关令牌，里面不含你的登录密码。
  • 脚本只把配置写入你自己本机的客户端目录（%USERPROFILE%\.workbuddy），不会联网上传、不会外发给任何人。
  • 密钥仅用于 WorkBuddy 向网关请求模型调用，传输走 HTTPS；我们不会在网页或 URL 里展示完整密钥。用完脚本建议即删。

♻️ 配置写错了 / 想还原怎么办？（备份机制）

  • 无论 zip 还是在线脚本，写入前都会自动备份你原有的 models.json → models.json.backup-时间戳。
  • 还原方法：把备份文件重命名回原名（去掉 .backup-… 后缀）即可恢复。
  • 脚本按模型 id 合并，不会覆盖你已有的其它自定义模型；覆盖同名 id 时也会先备份。

😵 WorkBuddy 看不到模型？

  • 先确认脚本提示「配置成功」——若没成功，按下方「工具跑不起来」排查。
  • 成功率最高的办法：完全退出（含后台进程）WorkBuddy，再重新打开，很多客户端需要重启才刷新模型列表。
  • 打开 WorkBuddy 后「设置 → 模型」看一下。
  • 仍看不到：回到「我的额度」再点一次「下载配置 / 脚本」重新生成（每次都用当前生效的密钥），然后重来。

🐢 兑换后积分到账延迟？

  • 兑换码通常即时到账；偶有支付平台延迟，最多等几分钟，可在「我的额度」刷新查看。
  • 若长时间未到账，请凭订单号联系客服核对，不要重复购买。

🛠 工具跑不起来 / 脚本报错？

  • 确认下载的是与系统匹配的文件（Windows 用 workbuddy-setup.cmd，macOS 用 workbuddy-setup.sh）。
  • Windows 被拦截：点「更多信息 → 仍要运行」；或在「设置 → 更新和安全 → Windows 安全中心 → 病毒和威胁防护」临时关闭实时保护后再运行 zip 里的 import.bat。
  • macOS 提示权限：终端里先 chmod +x workbuddy-setup.sh 再运行。

🔑 提示 Key 无效 / 401？

  • 密钥是随配置包/脚本一起下发的，不要手动改动或复制粘贴错行；直接重新下载一次最新配置即可。
  • 同一密钥可在多台机器的同一个 WorkBuddy 使用；若被怀疑泄露，回「我的额度」重新下载配置，旧密钥立即作废、改用新密钥（原密钥会被吊销，无法再调用）。