项目地址:Github
最简单使用方法
把下面这段提示词直接丢给WorkBuddy,让它自己完成。
请帮我安装 OC Ferry,并把它提供的可用免费模型导入本机 WorkBuddy。
项目:https://github.com/HRuiCcc/RuiC-oc-ferry
请先阅读最新 README 和 Releases,检查我的系统与芯片架构。
优先下载安装匹配的官方 Release 成品包,并核对公布的校验值。
安装前备份 WorkBuddy 模型配置,保留已有模型和设置。
启动 OC Ferry,等待它准备 OpenCode、检测免费模型并完成导入。
告诉我哪些模型检测可用,哪些仅支持对话。
若检测失败,请报告具体原因,不要把安装完成说成模型可用。
遇到需要我点击的系统提示,告诉我具体操作。
若需重启 WorkBuddy,先提醒我保存当前工作,由我手动重启。
最后指导我切换到一个可用模型,完成一次对话和一次文件操作验证。

把 OpenCode 的免费模型摆渡给 WorkBuddy
跨平台托盘应用 · 无需登录注册、无需 API Key · 隔离运行时 · 并发检测 · 判定缓存 · 一键导入 · 本机 OpenAI 兼容转发口
许可证 平台 Node 测试
WorkBuddy 支持在它的 models.json 里填自定义模型。OpenCode 的免费模型池是现成的免费额度,但它不是一个能直接填进去的 OpenAI 端点:目录里带 free 的模型不一定免费,能聊天不等于能按 WorkBuddy 的方式产生工具调用,而且免费池随时上下线。
OC Ferry 就是中间这一层:在数据目录里放一份隔离的 OpenCode,按价格筛出免费模型,逐个探测它们能不能按 WorkBuddy 的工具协议干活,把通过的写进你的 models.json,再起一个只监听本机的转发口供 WorkBuddy 调用。
工作流程
五条核心链路
发现:只看价格字段(输入/输出/缓存读写全为 0)才算免费,名字里带 free 不算数;已声明 deprecated 的直接排除。
体检:给 5 个工具、自由选择,让它读一个带随机 token 的文件。只回文本不算失败——按「可用 · 仅对话」发布并关掉工具;动作不符重试一次;超时与格式失败不重试。
提速:检测 3 路并发(一轮约 60 秒);判定按模型缓存,成功保留 6 小时、当时的负载只保留 10 分钟——重启基本是秒开,不会每次都全量重测。
导入:只增删自己标记过的条目,你手写的一条都不动;写前备份、加锁、原子替换,内容没变就不写;退出时把自己的条目摘干净。
转发:模型只能回一个 JSON 信封表达动作,执行权始终在 WorkBuddy 手里——任何本机动作一律被拒绝或转交成外部工具调用,模型永远不会自己动手。
用法
先安装 WorkBuddy。不需要另外装 Node.js(打包后的应用用 Electron 自带的 Node 跑后台服务)。
macOS(Apple 芯片):下载 OC-Ferry-<版本>-mac-arm64.dmg(仓库右侧 Releases 里),双击打开,把 OC Ferry 拖进「应用程序」,再双击打开。未做 Apple 公证,首次打开可能要右键 →「打开」;若提示「已损坏」,先核对 Release 说明里的 sha256,再移除下载隔离标记:xattr -dr com.apple.quarantine "/Applications/OC Ferry.app"。也可以下载 zip,解压后把 OC Ferry.app 拖进「应用程序」。
Windows:运行 OC-Ferry-Setup-<版本>-win-x64.exe,装完桌面就有了图标,双击即开。 安装包会同时做两件事:把开机自启写进当前用户的 Run 项(启动参数 --hidden,开机后只常驻托盘、不弹窗)、并保证卸载时把这一条摘干净。 因此装完就等于「一直连着」——不用每次先开一次应用,WorkBuddy 里的免费模型才在。 (只想要绿色版的话用 npm run build:win:portable;portable 包必须完整解压,不要只复制 exe。)
首次启动会自动准备 OpenCode、扫描免费模型并逐个检测,检测完自动导入一次。之后重新检测或读取不会自动改 WorkBuddy,需要点「导入 WorkBuddy」。
几个日常操作:
关窗口 ≠ 退出:关掉窗口它继续在托盘跑;从托盘退出时会把自己导入的条目摘掉(保留你手写的),所以这些模型可用期间请让它常驻。
想重新验证:点「检测全部」强制重测一轮;只想重测某一个,在它的详情里点「只重测这一个」。
主题:工具栏右上角可在系统 / 浅色 / 深色之间切换,选择会记住。

评论4