文档目录 WorkBuddy

WorkBuddy 模型接入 HiRoute:通过 Magpie headless 让 Pi 执行

把 WorkBuddy 账号里的模型接入 HiRoute,让快速模型处理常规工作,主力模型负责深度判断,再到 Pi 或 Codex CLI 中使用这条路由。WorkBuddy 提供模型,你可以继续使用喜欢的 Agent 来读文件、改代码和整理资料。

下载 HiRoute · 查看接入总览

1. 扫描或登录,获取模型 · 2. 配置智能路由 · 3. 接入 Agent · 4. 了解任务委派

1. 扫描或登录,获取模型

在 HiRoute 服务所在电脑安装 Magpie CLI。按系统选择启动方式。

  • macOS 或使用 systemd 的 Linux 运行 magpie daemon install --no-web,用 magpie daemon status 确认服务状态。需要启动已安装的服务时,运行 magpie daemon start。
  • Windows 或其他无法安装后台服务的环境,另开终端运行 magpie serve 并保持运行。

已有网关时可直接登录。

运行 magpie plugin add @magpie-community/opencode-workbuddy-auth,再按账号版本登录。

  • 国内版 CodeBuddy 套餐运行 magpie plugin login workbuddy。
  • 国际版运行 magpie plugin login workbuddy-ai。

在浏览器完成授权后查询目录,记下要用的完整模型 ID。Windows PowerShell 中使用 curl.exe。

curl -fsS -H 'Authorization: Bearer magpie' http://127.0.0.1:3425/v1/models

在 HiRoute 打开“模型 → 通用模型 → 添加模型 → 新建 API 接入 → 自定义 API”,按下面填写并检查。

设置 填写内容
连接名称 例如“Magpie WorkBuddy”
API 地址 http://127.0.0.1:3425/v1,网关改过地址时用实际值
协议 Responses,适用于下面的 Pi 或 Codex CLI 示例
API Key 默认本机网关为 magpie,改过 Key 时填自己的值
模型 从返回目录选择,保留完整来源前缀

点击“检查并继续”,选择模型并保存。目录没有显示时,在“高级设置”把模型目录路径设为 /v1/models,也可以手动填写刚查到的完整 ID。如果已经有受支持的 Agent 配置指向这个网关,可先用“扫描本机”发现并复用接入。

在 HiRoute 自定义 API 中填写 Magpie 地址和 Responses 协议
把 WorkBuddy 模型所在的 Magpie API 保存到 HiRoute。

2. 配置智能路由

  1. 打开“智能路由 → 新建智能路由”,命名为“WorkBuddy 资料整理”,选择 “按难度分流”。
  2. 在“常规模型”组点击“添加模型”,选择第一步接入的快速或经济模型,处理读文件、找定义、整理资料等常规工作。
  3. 在“主力模型”组添加适合复杂分析、方案判断或多文件修改的模型。两组可以使用不同订阅、API 或本地模型,按各自账号可用的模型组合。
  4. “判断方式”先选 “启发式规则”,然后点击 “启用”。发布后,这条路由就能在下一步的 Agent 接入设置里选到。
HiRoute 按难度分流配置中的判断方式、常规模型组和主力模型组
常规组负责日常步骤,主力组处理复杂轮次。图中的模型可替换为你第一步接入的模型。

想根据执行表现进一步调整时,可在同一位置选择决策模型,使用阶段评分和低分保护。了解难度路由的判断方式

3. 接入 Agent

在 Pi 中使用 WorkBuddy 模型

打开“Agent → Pi → 模型路由”,勾选刚发布的“WorkBuddy 资料整理”,选择与接入一致的 Responses 协议并保存。

Pi 的模型路由选择界面
在 Pi 的接入设置中,选择你刚创建的 WorkBuddy 路由。

重启 Pi,输入 /model 选择这条路由,试着让它归纳项目 README 的三条要点。模型来自 WorkBuddy 接入,读文件等操作由 Pi 执行。在 HiRoute“会话 → 路由时间线”可查看实际模型。

也可以把同一计划勾选到“Agent → Codex → 模型路由”,用“按需使用 · 仅 CLI”给出的命令启动。图文步骤见 Codex CLI 接入。

4. 了解任务委派

用 Codex CLI 写方案时,可以让轻量的 Pi 先从一组文档整理负责人、截止日期和待确认事项。把第一步接入的 WorkBuddy 经济模型给 Pi,文档阅读用这套模型完成,Codex 主会话只需要处理结构化的简报。

用 WorkBuddy 模型创建“Pi 文档速读”固定模型路由,在“更多设置 → 任务委派”中开启委派并选 Pi,填写用途并启用。然后在主 Agent 的“任务路由”中开启委派。

使用 HiRoute 让“Pi 文档速读”整理这几份文档,返回负责人、截止日期、待确认事项和出处。

让主 Agent 根据简报继续写方案,并到任务记录和会话时间线核对执行方与用量。配置 Pi 轻量委派