louchi1984-coder / ow-bridge

# OW Bridge
跨平台托盘应用，通过隔离的 OpenCode 为 WorkBuddy 提供免费模型。使用 Electron 共用界面和现有 Node.js 代理核心。
> **Windows x64 免安装版已在 Windows 实机验证，推荐下载 v0.2.13 portable 包。macOS（Apple Silicon）版也有实际使用验证。Windows ARM64、Linux 仍未正式测试，不能沿用 x64 的验证结论。**
## 界面预览
截图来自 macOS 实际运行界面；模型名单、免费额度和检测结果会随上游变化。
## 下载
下载最新版本
| 系统 | 验证状态 | 下载 |
|---|---|---|
| **Windows x64** | **已验证 · 推荐免安装版** | v0.2.13 Portable ZIP |
| macOS 13+，Apple Silicon（M 系列） | 已实际使用验证，ZIP 签名完整性检查通过 | v0.2.13 Mac ARM64 ZIP |
| Windows ARM64 | 未正式测试，旧版 | v0.2.2 ARM64 安装程序 |
| Linux x64 | 实验性，未正式测试，旧版 | v0.2.2 AppImage |
请先安装 WorkBuddy。无需另装 Node.js 或 npm，应用按需下载 OpenCode（官方 npm 优先，失败尝试 npmmirror）。Mac 使用临时签名，未做 Apple 公证；Windows 未做发布者签名，系统可能提示未知开发者。Windows x64 提供免安装 ZIP；NSIS 安装器未更新。免费模型及额度由上游决定。
## 使用
- macOS：解压 `OW-Bridge-0.2.13-mac-arm64.zip`，双击 OW Bridge.app。
- **Windows x64：完整解压 `OW-Bridge-0.2.13-win-x64-portable.zip`，双击文件夹里的 `OW Bridge.exe`。无需安装；不要只复制 exe，必须保留旁边的 `resources`、DLL 等文件。**
- 首次启动自动准备 OpenCode、扫描免费模型；启动不发送模型探测，只恢复并导入 8 小时内、模型声明未变化的成功缓存。首次使用点击“检测全部”，完成后导入。
- macOS 保持使用 `~/.workbuddy/models.json`。Windows 自动识别默认配置、已保存位置和 WorkBuddy 配置目录环境变量。常规路径找不到时，点击导入后用已检测可用的模型，通过独立 OpenCode 只读会话搜索 `models.json`；有效候选自动记住并导入；找到多个时，选择查找校验前最后访问时间最新的一份，不再弹窗选择。也可从 Windows 托盘“自动查找 WorkBuddy 配置…”重新查找，或“选择 WorkBuddy 配置…”手动指定；首次使用请先在 WorkBuddy 保存一个自定义模型。Windows 托盘菜单“选择 WorkBuddy 配置…”可更换位置，切换时清理旧文件中的本应用条目。不会在猜测的位置新建模型配置。
- 后续重新扫描或检测不会改 WorkBuddy；点击“导入 WorkBuddy”更新，界面会反馈结果。
- 关闭窗口继续在托盘运行；从托盘退出时删除本应用导入的模型，保留用户手动配置。
- 图片输入、推理声明和档位、输入输出上限读取 OpenCode 目录；工具转换能力通过模拟工具请求检测。
- 系统代理开关支持 Mac 和 Windows 的手动 HTTP/HTTPS 代理。
使用问题在抖音/视频号 @娄老师说的对
## Mac 首次打开提示
v0.2.4 已修复旧包签名不完整的问题，使用 **ad-hoc 临时签名**，未做 Apple Developer ID 签名或公证，仍可能被 macOS 拦截。请下载新版 ZIP，解压后将 `OW Bridge.app` 拖入“应用程序”。
先尝试打开，再到“系统设置 → 隐私与安全性”点击“仍要打开”。如果仍提示“已损坏”，请确认文件来自本仓库 Release，且 ZIP 的 SHA-256 与该版本 `SHA256SUMS` 一致；确认信任此应用后，可在终端仅移除此应用的下载隔离标记：
 [code] 
之后重新打开。此操作不会关闭系统整体的 Gatekeeper；它跳过此应用的下载隔离检查，不是 Apple 公证。请勿对来源不明或哈希不符的应用执行。目前 Mac 包仅支持 Apple Silicon（M 系列），要求 macOS 13 或更新版本。
## 开发与打包
 [code] 
运行核心服务：`npm start`。开发依赖 Node.js 22+；打包后的应用不要求用户另装 Node。
Windows ARM64：`npm run build:win:arm64`。Linux 的 `npm run build:linux` 为实验性入口，系统代理和 WorkBuddy 集成尚未验证。平台路径、架构、退出清理与实机验收见 跨平台说明。
## 代理行为和限制
Windows 首次启动默认读取系统 HTTP/HTTPS 代理，没有可用配置时自动直连；已保存的代理开关优先。版本查询和运行时下载都使用该设置，官方 npm 失败后尝试 npmmirror 国内镜像，仍校验 SHA-512 与下载后的版本。镜像是第三方来源；若官方元数据获取失败，校验值也来自镜像。代理连接异常时，运行时下载会回退直连；首次启动自动选择的代理失效时，隔离模型服务也改为直连，已明确保存的模型代理开关保持不变。仅 PAC/SOCKS 暂不支持。
启动时优先复用本机已有的可用 OpenCode，不联网检查新版本，也不主动升级。控制面板的“更新 OpenCode”按钮可手动检查、下载安装并切换新版；更新失败保留当前服务，结果会在面板显示，成功后只读取模型目录，不发检测请求；检测和导入 WorkBuddy 由用户手动触发。只有找不到可用运行时时，才从 npm 官方源（失败尝试国内镜像）读取最新版本并安装。状态记录实际运行版本。使用隔离配置，不批准原生执行工具。WorkBuddy 负责执行外部工具；代理校验模型返回的调用名称、参数和格式。工具检测仅反映单次请求的结果，复杂流程可能仍失败。
启动、读取免费模型、切换代理、更新 OpenCode 都只读取目录和恢复有效缓存，不自动发送模型推理请求。新增、声明变化或成功缓存过期的模型显示待检测；点击检测才发送请求。模型之间间隔 4–5 秒，退出可中断等待。任一检测（含普通对话降级）返回 401/403/429，立即停止整轮，剩余模型标为“待检测”，不写失败记录；30 分钟冷却写入状态文件，重启仍生效。冷却期间手动检测需二次确认，确认后可重测。这是减少请求的保护机制，不能证明或解除上游封禁。
所有可用模型在本地 API 中公开。只通过普通对话检测的模型关闭工具调用；不可用模型仍显示在列表，但不会提供给 WorkBuddy。检测提供多个外部工具且不强制调用：只回复文本