Wealth for macOS 安装教程

macOS 13.0 Ventura 及以上 · Apple 芯片与 Intel 芯片通用 · 全程图解

系统要求
下载
校验文件完整性
安装（配图）
突破 Gatekeeper 拦截（关键一步，配图）
首次启动与登录
音视频通话权限
常见问题
卸载

1. 系统要求

项目	要求
macOS 版本	13.0 Ventura 或更高（硬性下限，低于此版本无法运行）
CPU 架构	Apple 芯片（M1/M2/M3/M4）或 Intel 芯片 — 同一个包通用
磁盘空间	安装后约 735 MB，下载包另需 319 MB
网络	需能访问 `lingoflow.top`

为什么下限是 macOS 13.0？这个限制来自 Electron 44 运行时和两个原生模块（fs-xattr、mute-state-change）的编译目标，不是可以绕过的设置项。macOS 12 及更早的系统跑不起来。

2. 下载

下载完成后会得到 wealth-desktop-mac-universal-8.33.0-alpha.9.zip（约 319 MB）。

文件	大小	说明
`wealth-desktop-mac-universal-8.33.0-alpha.9.zip`	334,097,187 字节	主安装包
`.zip.sha256`	114 字节	校验文件

3. 校验文件完整性（建议做）

打开「终端」（Launchpad 搜索 终端 或 Terminal），执行：

cd ~/Downloads
shasum -a 256 wealth-desktop-mac-universal-8.33.0-alpha.9.zip

输出应当与下面的值完全一致：

b45aa0f47a931ca22c86797f2c69cb16bf4ea4bab28d3d3ee4ca7d67e35f74eb

一致说明文件完整未被篡改。若不一致，说明下载中断或文件损坏，请重新下载。

4. 安装

方式一：拖拽安装（最直观）

1解压文件
双击 zip，系统自动解压出蓝色的 Wealth.app。

Finder 下载文件夹中显示解压后的 Wealth.app — **第 1 步图解** — 在「下载」文件夹里双击 zip，图标变成蓝色 W 的 **Wealth.app** 即解压成功。zip 原文件可以留着或删掉。

2拖进「应用程序」
把 Wealth.app 拖到左侧边栏的「应用程序」文件夹（也可以 ⌘C 复制，进「应用程序」后 ⌘V 粘贴）。

把 Wealth.app 拖进应用程序文件夹 — **第 2 步图解** — 拖动到「应用程序」文件夹，松手即完成拷贝。**不要直接在下载文件夹里运行**，那样系统会把它放进临时沙盒，后续权限会反复询问。

3第一次打开必须用右键
在「应用程序」里找到 Wealth，按住 Control 键点它（或触控板双指点按），选「打开」，弹窗里再点一次「打开」。
详见第 5 节。

方式二：一条命令解决（熟悉终端的用户）

xattr -dr com.apple.quarantine /Applications/Wealth.app

如果已经把 Wealth.app 放进「应用程序」，执行这条命令后双击就能正常打开。

方式三：自动安装脚本

如果分发包里带了 install-mac.command，把它和 Wealth.app 放同一文件夹：

cd ~/Downloads
bash install-mac.command

脚本会自动完成：解除隔离 → 校验签名 → 拷贝到 /Applications。

5. 突破 Gatekeeper 拦截（关键一步）

第一次打开时很可能看到下面这类提示：

提示文字	真实含义
「无法打开 Wealth，因为 Apple 无法检查其是否包含恶意软件」	Gatekeeper 未识别签名证书
「Wealth 已损坏，无法打开。您应该将它移到废纸篓」	不是真的损坏，是系统对未公证应用的统一话术
「无法验证开发者」	同上

这三种提示都不代表文件有问题。本安装包已用代码签名证书签名并开启了硬化运行时（Hardened Runtime），相机、麦克风、音频权限都已正确声明。Apple 的 Gatekeeper 只认 Apple 自己签发的 Developer ID 证书，自建证书签的包一律需要手动放行一次。

放行方法 A：Control + 点击打开（图形界面，推荐）

1打开「应用程序」文件夹，找到 Wealth

2按住 Control 键点击图标（或触控板双指点按），菜单里选「打开」

Control 点击 Wealth 图标弹出的右键菜单，其中「打开」被高亮 — **第 3 步图解** — 按住 `Control` 点击图标后，菜单里会出现「打开」。
注意：直接双击时这个「打开」通常**不存在**，只有「移到废纸篓」，这也是很多人卡住的原因。

3系统弹出确认框，点「打开」

无法验证开发者的确认对话框，右侧「打开」按钮被高亮 — **第 4 步图解** — 弹窗里点右边的「打开」，**不要点「移到废纸篓」**（那会直接删掉 App）。点完可能要输入开机密码。

成功一次之后，以后双击就能直接打开，不会再问。

放行方法 B：系统设置里放行（已经被拦过之后）

1先尝试双击一次，让它被拦住

2打开「系统设置」→「隐私与安全性」

3向下滚动到「安全性」区域，点「仍要打开」

4回到「应用程序」再双击，弹窗里点「打开」

系统设置隐私与安全性页面，安全性区域显示仍要打开按钮 — **方法 B 图解** — 「隐私与安全性」页面下方的「安全性」区域会出现一行「已阻止使用「Wealth」，因为来自身份不明的开发者」，点右侧「**仍要打开**」。

放行方法 C：命令行（最彻底）

1打开「终端」

2粘贴下面的命令并回车

xattr -dr com.apple.quarantine /Applications/Wealth.app

3用第二条命令确认标记已清除

xattr -p com.apple.quarantine /Applications/Wealth.app
# 输出 "No such xattr" 就表示已清除

终端窗口执行 xattr 命令并确认隔离标记已清除 — **方法 C 图解** — 第一条命令删除隔离标记（无输出即成功）；第二条确认，出现「**No such xattr**」就是清理干净了；第三条 `codesign --verify` 无输出代表签名校验通过。

4如果系统设置里找不到「仍要打开」按钮，用这条兜底重签

xattr -cr /Applications/Wealth.app
codesign --force --deep --sign - /Applications/Wealth.app

6. 首次启动与登录

1打开 Wealth，首次启动有几秒初始化，属正常

2注册新账号：访问 lingoflow.top/registration

3已有账号：在登录页填入账号密码

Wealth 客户端登录窗口 — **登录界面** — 填入账号与密码后点「登录」。首次登录会自动同步联系人与历史消息，会话数量多时需要等一会儿。

7. 音视频通话权限

第一次发起或接听通话时，macOS 会依次询问：

权限	必须允许，否则
麦克风	对方听不到你的声音
摄像头	视频通话是黑屏

麦克风与摄像头权限请求弹窗 — **权限图解** — 两个弹窗都要点「好」。误点了「不允许」的话，去「系统设置 → 隐私与安全性 → 麦克风 / 摄像头」把 Wealth 打开即可，不用重装。

本应用已在签名中声明了 com.apple.security.device.audio-input、com.apple.security.device.camera、com.apple.security.device.microphone 三项硬件权限，并开启了 JIT 与库验证豁免（原生加密模块需要）。这些都是通话功能的必要条件。

8. 常见问题

问：打开后窗口闪一下就没了？

先确认 macOS 版本 ≥ 13.0（「关于本机」里看）。版本够的话，打开「控制台」App 搜索 Wealth 查看报错，或把 ~/Library/Application Support/Wealth-selfhost-*/logs/main.log 最后几行发给我们。

问：提示「无法验证开发者」，但右键菜单里没有「打开」？

某些 macOS 版本在右键菜单里不显示「打开」。改用方法 B（系统设置 → 隐私与安全性 → 仍要打开）或方法 C（命令行）。

问：Intel Mac 能用吗？

能。这个包是 universal 版本，同时内含 arm64 和 x86_64 两套指令，Intel 机器自动用 x86_64 那套（通过 Rosetta 2 运行）。第一次启动会慢几秒，之后正常。

问：会不会被自动更新覆盖成别的版本？

不会。这个客户端关闭了自动更新（updatesEnabled: false），不会被远程替换。

问：文件校验值在哪看？

下载页和本页第 3 节都有。也可以用 shasum -a 256 自己算一遍比对。

问：为什么每次新版本都要重新放行？

因为每个新版本的签名都不同，macOS 会重新做一次来源检查。放行一次即可，同版本内不用重复。

9. 卸载

只删程序（保留聊天记录）：

rm -rf /Applications/Wealth.app

彻底清除（含聊天记录与配置）：

rm -rf /Applications/Wealth.app
rm -rf ~/Library/Application\ Support/Wealth-selfhost-*
rm -rf ~/Library/Caches/com.lingoflow.wealth.desktop

第二条命令会删除本地数据库，聊天记录不可恢复。确认不再需要再执行。

版本 8.33.0-alpha.9 · universal (arm64 + x86_64) · 已签名（自建 CA）· 未公证
返回下载页 · 注册 · 登录