Repository navigation
v0.13.4
这一版改了什么
- 10-13 注册能直接填邮箱:自动取 @ 前面那段当用户名,登录时填邮箱也认;注册失败不再算进限流,填错不会被锁
- 10-13 设置 → 安全 新增「沙箱安全」开关:关掉后 AI 能动工作目录外的文件、连本机和内网;多个账号共用时关不了
- 10-13 「本机/内网放行」支持通配符:192.168.1.: 放一整个网段,*.local:8080 放一类主机名
每条对应的代码和判据在 CHANGELOG。
安装
macOS 一句话装好(下载 → 装进「应用程序」→ 摘掉隔离标记 → 打开,不会被 Gatekeeper 拦):
curl -fsSL https://raw.githubusercontent.com/CatCatUncle/openworkbuddy/main/install-mac.sh | bash
手动下包的话:
- macOS(Apple 芯片) →
OpenWorkBuddy-*-mac-arm64.dmg - macOS(Intel) →
OpenWorkBuddy-*-mac-x64.dmg
——⚠️ 下 dmg 的第一次打开一定会弹「未打开“OpenWorkBuddy”· Apple 无法验证…」,只有「完成 / 移到废纸篓」两个按钮。
点**「完成」→ 系统设置 → 隐私与安全性 → 滚到最下面 → 点「仍要打开」**→ 输开机密码。做这一次就够了。
细节和另外两条路见下面「第一次打开会被系统拦一下」。 - Windows(x64 / ARM 同一个包) →
OpenWorkBuddy-*-win-setup.exe← 绝大多数人下这个(双击打开安装向导,能选装在哪个盘,有进度条,装时自动选架构) - Windows 免安装版 →
OpenWorkBuddy-*-win-x64-portable.exe/-win-arm64-portable.exe
—— 只在公司电脑不让装软件时才用。它的原理是自解压:每次启动都要把整个应用解压到%TEMP%,
还要被 Defender 逐个扫一遍,第一次可能要等好几分钟,期间任务管理器里有进程、屏幕上什么都没有。
第一次打开会被系统拦一下
代码签名证书还在申请(苹果一年 99 美元、Windows 一年几千块),所以现在发出去的包是 ad-hoc 签名的。
系统拦的是「这个开发者我没见过」,不是「这个文件有毒」——包里的签名本身完好,
codesign --verify --deep --strict 自己验得出来。证书批下来之后这一步就没有了。
macOS · 三条路,挑一条
- 不想碰终端(推荐):双击 → 弹窗点 「完成」(别点「移到废纸篓」)→ 打开
**「系统设置 → 隐私与安全性」**→ 一直滚到最下面的「安全性」那一段,会看到
「已阻止使用“OpenWorkBuddy”,因为它来自身份不明的开发者」→ 点 「仍要打开」→
输开机密码 → 再弹一次点 「打开」。做这一次就够了,以后双击直接开。
(「仍要打开」这一栏只在你刚刚被拦过之后才出现。设置里翻不到的话,先回去双击一次应用,再进设置。) - 一句命令:先把 .app 从 dmg 拖进「应用程序」(dmg 是只读卷,在里面执行会失败),然后在终端跑:
xattr -dr com.apple.quarantine /Applications/OpenWorkBuddy.app
- 一个弹窗都不想见:用最上面那句 curl。浏览器下载的文件会被打上
com.apple.quarantine标记,
curl 下的不会——整条路径上没有 Gatekeeper。
两条容易走错的岔路:
- 别照着网上「右键 → 打开」的教程点。 那条只在 macOS 14 及更早有效;macOS 15 (Sequoia) 起
苹果取消了这条通道,右键弹窗里已经没有第二个「打开」按钮——照着点会以为「就是打不开」。 - 提示「已损坏,应将它移到废纸篓」和上面不是一回事。 那是签名真的被弄坏了(网盘、同步盘、
某些解压工具都会干这事)。重下一次,或者就地重签:codesign --force --deep --sign - /Applications/OpenWorkBuddy.app
Windows:弹出「Windows 已保护你的电脑」时,点弹窗里的灰色小字 「更多信息」,下面才会出现 「仍要运行」。
装完先去设置里填模型 API Key。你的配置、会话、工作区都在 ~/OpenWorkBuddy,卸载不会删。
双击了没反应?
每次启动都会写一份日志,先看它停在哪儿:
~/OpenWorkBuddy/logs/boot.log # Windows: C:\Users\你\OpenWorkBuddy\logs\boot.log
常见的几种,以及对应的解法:
| 现象 | 解法 |
|---|---|
| 双击安装包没反应,也没弹「Windows 已保护你的电脑」 | 看 360 / 火绒 / 电脑管家的隔离区,把 OpenWorkBuddy 恢复并加进信任 |
| 免安装版双击后一直停在「正在打开」 | 改用 -win-setup.exe 安装版(免安装版每次启动都要解压整包) |
| 窗口不出现,或者出来一整片黑 | 在 ~/OpenWorkBuddy/config.json 的 server 里加 "disable_gpu": true |
| 弹框说「放数据的文件夹建不起来」 | 设环境变量 OPENWORKBUDDY_HOME 指到本机一个能写的文件夹 |
| 弹框说「已经在运行了,但窗口没出来」 | 任务管理器里结束 OpenWorkBuddy 进程再打开 |
| 弹框说端口用不了 | 把 config.json 里的 server.port 换成 3810 之类 |
失败时应该总有一个写着原因的窗口或弹框。如果你什么都没看到,那本身就值得开一个 issue,
带上那份 boot.log。更全的排查表在 安装与启动。
升级
以后有新版,不用卸载重装:下这里的新包覆盖装一次就行,~/OpenWorkBuddy 里的配置、
会话和成果文件都不动。从源码跑的话 git pull && npm install 重启即可。
应用里 设置 → 关于 → 检查更新 会告诉你线上是不是有新版、你这种装法怎么升。
(没有一键自动更新:这些包没有代码签名证书,macOS 的自动更新通道会校验签名,硬做只会是一颗永远报错的按钮。)
Full Changelog: v0.13.3...v0.13.4