支持
大部分问题出在「两端版本不一致」和「网络不通」这两件事上。下面的自查顺序照着走一遍,再决定要不要写信。
先看常见问题,没解决就写信。邮件请附上应用版本(设置 → 关于本应用)与 macOS 版本,能加一段复现步骤或截图最好。
先做这四步自查
- 确认两端都是最新版本——补发文件这类修复只在双方都升级后才生效。
- 在「系统设置 → 隐私与安全性 → 本地网络」里确认 Hai 已勾选。没这个权限,局域网里发现不了对方。
- 用对接口令建立连接,不要手动抄 IP 与端口;口令里带公钥,能确保连到的是对的人。
- 打开「设置 → 网络与连接」,看链路状态:是直连、经中继,还是根本没建立连接。
开始使用
需要注册账号吗?
不需要。没有账号体系,也不需要手机号或邮箱。首次启动时,应用在本机生成一对 Ed25519 密钥作为你的身份,私钥保存在应用数据目录里,不对外发送。
换电脑时身份不会自动跟着走;需要的话,把数据目录整体迁移过去(见下面「数据与备份」)。
怎么和对方建立连接?
在「网络与连接」里生成对接口令,发给对方(微信、邮件都可以),对方粘贴后即可直连。口令里包含地址与公钥,不含任何私钥——转发口令不会泄露你的身份。
同一局域网内,应用也会通过 Bonjour 自动发现同网段的设备,通常不必手抄口令。
支持哪些系统与语言?
需要 macOS 14.0 或更新版本;Intel 与 Apple 芯片均可(通用二进制)。
界面提供九种语言:中文、English、日本語、Deutsch、Français、Español、Русский、العربية、עברית(后两种为从右到左排版)。
连接问题
对方一直显示「离线」
「离线」表示此刻没有可用的连接,不是对方删了你。按顺序排查:
- 对方是否正在运行应用(关闭窗口不等于退出)。
- 双方是否都有「本地网络」权限。
- 同网段时能否自动发现;跨网时是否具备 IPv6 直连,或是否配置了中继。
- 公司网络与酒店网络常禁止设备互访,这类环境下只能用中继。
同一局域网里却互相发现不到
先确认两台机器在同一个网段(不是「同一个 Wi-Fi 名称」就算)。路由器的「AP 隔离」「访客网络」会阻断设备互访;企业网络还常禁用 Bonjour 所需的组播。
这种情况用对接口令手动连,或走中继,比继续排查网络更快。
跨网连不上,也没配中继
跨网需要两条路之一:IPv6 直连,或经中继转发。IPv4 下的自动端口映射依赖路由器配合,部分路由器上不生效(本版启用了 App 沙盒,UPnP 类映射受限),所以「在家里能用、到公司就不行」是正常现象。
长期跨网协作,建议在「网络与连接」里配置一台中继。中转的是密文,中继看不到内容。
文件传输
对方发的文件我没收到,界面上写「文件不在本机」
这句话的意思是:消息到了,文件字节没到。通常是发送时对方不在线,或传输中途断了。
当前版本会在发送方暂存文件,等对方上线后自动补发;但升级之前发出的那条不会自动补。让对方重新发一次即可。
我这边一直显示「文件待发」
说明文件还在你的机器上排队,等对方上线。连接一建立就会自动重发,标记随之消失。
待发记录保留 7 天;超过期限或附件副本被清理后,就不再补发。期间不要删除应用数据目录里的附件。
对方收到两份同样的文件?
正常情况下不会:接收侧发现本地已有完整副本时,会忽略整条重发。如果你确实看到两份,请把两边的版本号与时间告诉我们——这是缺陷,不是预期行为。
数据与备份
数据存在哪里?怎么备份?
全部在应用沙盒容器内,一个目录就是全部:
~/Library/Containers/com.workbuddy.bizcollab/Data/Library/Application Support/Hai
把它整体拷走就是完整备份(数据库、附件、身份密钥都在里面)。恢复时放回同一路径即可。
卸载应用会删掉数据吗?
不会。把应用拖进废纸篓只删程序本身,数据仍在容器里。要彻底清除,需要另外删除上面那个目录——删除后不可恢复,我们这边没有副本可还原。
换新 Mac 怎么迁移?
把旧机器上的容器目录复制到新机器的同一路径,再打开应用。身份密钥跟着走,对方看到的仍是你,不需要重新交换口令。
如果从「未启用沙盒」的早期版本升级过来,旧数据在 ~/Library/Application Support/Hai,新版看不到它——数据没丢,只是沙盒收窄了可见范围。
AI 归纳与演示
AI 归纳点了没反应 / 报错
归纳不内置模型,需要你自己填一个模型服务的地址、模型名与密钥。没配置时,应用的其他功能完全可用。
归纳结果不会自动写入台账,必须逐条确认后才入库——这是刻意的,避免把模型猜出来的东西当成事实。
只有一台电脑,能用吗?
能。设置里有「体验单机演示」:在本机建一个演示对端,把发消息、发文件这条链走一遍。演示会话不出网,消息不经过任何服务器,用来熟悉界面足够。
如果你的版本较新,还可以从菜单栏的「Hai → 新建独立实例」(⌘⇧N)开一个独立工作区,把它当作第二端:两份实例各有自己的身份与数据,互相发现后就能走真实的收发流程。
它不能替代两台真实设备——跨网、防火墙、路由器这些差异只有真机能验。
报告问题时请附上
- 应用版本设置 → 关于本应用,形如
1.0.0.14.5.22。 - 系统版本苹果菜单 → 关于本机,例如 macOS 14.6。
- 现象与时间哪一步不对、屏幕上写了什么;截图比描述省一轮往返。
- 已经试过什么重启、重发口令、换网络——写清能避免我们让你重做一遍。
涉及数据处理的疑问,先看隐私政策:那里逐条写了哪些数据在本机、什么时候会离开设备、中继能看到什么。