HRuiCcc GitHub avatar

RuiC-oc-ferry

JavaScript
大模型本地转发工具HRuiCcc最近推送 2026年11月1日
模型推理与部署MIT54010313 issues7 天 +37

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日

把 OpenCode 免费模型筛选、检测后写入 WorkBuddy 或 DSH 的托盘工具。

这是一个跨平台托盘应用,在本地放一份隔离的 OpenCode 运行时,按价格字段筛出免费模型,逐个检测能否按客户端工具协议产生动作,再把通过的模型写入 WorkBuddy 的 models.json 或 DSH 的 cordis.patch.yml,并起一个只监听本机的 OpenAI 兼容转发口供客户端调用。它解决的是 OpenCode 免费模型池不能直接当 OpenAI 端点填进客户端的问题。

推荐指数

4.0

思路清晰、边界交代诚实,适合想白嫖免费模型又不想手动折腾配置的桌面用户。

近 7 天

+37

新增 Star

总 Star 排名

#3631

雷达追踪的 3,958 个 AI 仓库中

创建于

2026

2026年10月10日

核心亮点

  • 1按价格筛免费

    只看输入输出缓存价格全为 0,名字带 free 不算数。

  • 2协议级体检

    给工具让它读随机 token 文件,验证能否真正产生工具调用。

  • 3判定缓存

    成功判定保留 6 小时,重启基本秒开,不必全量重测。

  • 4安全写入

    只增删自己标记的条目,写前备份、原子替换,退出时清理。

  • 5本机转发口

    127.0.0.1:41980 提供 OpenAI 兼容接口,带鉴权与来源围栏。

适用场景

  • 在 WorkBuddy 里用免费模型

    例如:首次启动自动检测后一键导入,WorkBuddy 的模型列表出现 OC 分组。

  • 给 DSH 各 profile 配模型

    例如:切换写入目标为 DSH,写入所有已检测 profile 的 cordis.patch.yml。

  • 自建本机 OpenAI 端点

    例如:其他工具通过 /v1/chat/completions 调用已判定可用的模型。

它是怎么工作的

  1. 第 1 步

    发现

    读取隔离 OpenCode 的模型目录,按价格字段筛出免费且未弃用的模型。

  2. 第 2 步

    体检

    并发 3 路探测模型能否按协议产生工具动作,只回文本则降级为仅对话。

  3. 第 3 步

    缓存

    判定结果按模型缓存,成功 6 小时、负载 10 分钟,过期自动重测。

  4. 第 4 步

    写入

    把通过的模型合并进 WorkBuddy 或 DSH 配置,写前备份并原子替换。

  5. 第 5 步

    转发

    客户端请求打到本机端口,经适配器转给 OpenCode,动作交还客户端执行。

快速上手

  1. 1

    下载安装

    从 Releases 下载 macOS dmg 或 Windows 安装包,装完双击打开。

  2. 2

    等待自动检测

    首次启动自动准备 OpenCode、扫描并检测免费模型,完成后自动写入一次。

  3. 3

    按需切换目标

    控制面板右上角在 WorkBuddy 与 DSH 之间切换写入目标。

  4. 4

    本地开发

    克隆后安装依赖并跑测试或起 Electron。

    npm ci && npm test && npm run desktop

适合谁

  • 使用 WorkBuddy 或 DSH 的桌面用户
  • 想用 OpenCode 免费额度但不想手动配端点的人
  • macOS 或 Windows 普通开发者

不太适合

  • 需要稳定商用模型供给的团队
  • Linux 生产环境用户(仅实验性支持)
  • 不愿常驻托盘进程的人

成熟度

  • 活跃度创建不到一个月已有 520 star,最近一次推送在 2026-11-01。
  • 文档README 含流程图、数据目录表、接口列表和设计说明文档。
  • 社区98 fork、13 个开放 issue,社区规模尚小。
  • 上手难度提供安装包,无需另装 Node,首次启动自动完成检测与写入。

使用前注意

  • · 免费模型与额度由上游决定,随时可能变化或下线。
  • · 检测请求会消耗少量免费额度,且只验证单次协议动作。
  • · macOS 未做公证,首次打开可能需右键打开或移除隔离标记。
  • · 系统代理仅支持手动 HTTP/HTTPS,不支持 PAC/SOCKS。

主题标签

electronfree-modelsllmmacosopenai-compatibleopencodetray-appwindowsworkbuddy