用 git 安装 TalkTrack（推荐）

如果你的 Mac 是 macOS 15 (Sequoia) 或更新的版本，强烈建议走这条路。

直接把 dmg 装到 Mac 上、又是从邮件 / 微信 / 网盘下载来的话，新版 macOS 会把它打上一个「来源不明」的标记 — 你双击会被拦死，还得自己进系统设置去解锁。

用 git clone 拉过来的文件没有这个标记，安装完直接双击就能开，省一大段折腾。

---

准备：装 git（如果还没装）

打开 Mac 自带的「终端」（Terminal），输入：

git --version

• 显示 git version x.x.x → 已经有 git，跳到下一步
• 显示「需要安装命令行开发者工具」的弹窗 → 点 安装，等 5 分钟装完再回来

不会找终端？

按 Cmd + 空格 打开聚焦搜索 → 输入 终端 → 回车

---

第一步：拿到你的安装链接

邀请邮件里我们给了你一个专属 git 链接，长这样：

https://github.com/talktrack-app/release-XXXXXXXX.git

末尾的 XXXXXXXX 是你的邀请码 — 这个仓库只对持有该链接的人开放。

别把链接发给别人

这个链接绑定你的邀请，被滥用后我们可能撤销。要分享 TalkTrack 给同事？让他 自己申请内测。

---

第二步：在终端里跑两行命令

复制下面两行，把 <你的链接> 换成邀请邮件里的那个 URL，粘到终端里回车：

cd ~/Downloads
git clone <你的链接> talktrack

跑完之后 ~/Downloads/talktrack/ 文件夹里会出现一个 .dmg 文件，文件名类似：

TalkTrack_0.4.0-beta.10_aarch64.dmg

---

第三步：装上 TalkTrack

1. 打开「访达」（Finder）→ 进入 下载 文件夹 → talktrack → 双击那个 .dmg 文件
2. 弹出来的窗口里，把 TalkTrack 图标拖到 Applications 文件夹
3. 关掉窗口，到「应用程序」（Applications）里双击 TalkTrack — 应该直接就开了

第一次打开仍弹「无法打开」？

极少数情况下还是会被拦。这时候：

• 在「应用程序」里 右键 TalkTrack → 选 打开
• 弹窗如果再说一次「无法验证开发者」，再点 打开 就行

之后双击就直接开了，不用再这么操作。

---

第四步：开通 4 项权限

第一次启动时 TalkTrack 会引导你开通这些权限。4 项都要开，少一项就影响录音：

权限	干什么用
麦克风	录你自己说的话
屏幕录制	录会议软件里对方说的话（不截屏，只取声音）
辅助功能	监听全局快捷键，比如按一下就停录
自动化（Apple Events）	自动检测你正在开哪个会议软件

详细开通步骤参考 安装与第一次打开。

---

接下来：跑你的第一场会议

→ 录你的第一场会议

---

升级到新版本

我们发布新版本时，会发邮件告诉你。升级方式很简单：

cd ~/Downloads/talktrack
git pull

然后双击新出现的 .dmg 文件，重新拖到 Applications 替换旧版本即可。

需要重新开权限吗？

内测期间每次更新可能都需要重新开一下屏幕录制权限。这是 Apple 还在审核我们正式签名期间的临时现象。 具体在 常见问题 → 录完发现录音是空的 里写了一键修复办法。

---

卸载

不用了想清理：

# 删 git 仓库
rm -rf ~/Downloads/talktrack

# 删 app 本身
rm -rf /Applications/TalkTrack.app

# （可选）删本地数据：会议录音、转写、报告
rm -rf ~/Library/Application\ Support/TalkTrack

---

为什么这种装法不会被 macOS 拦

简单解释：

• 从浏览器、邮件、微信下载的文件，macOS 会偷偷给它打一个**「来源不明」标记**（叫 com.apple.quarantine）
• macOS 15 (Sequoia) 起，被打过这个标记的、又没被苹果官方签名的应用，会被完全拦死 — 必须进系统设置手动解锁
• git clone 拉下来的文件不会被打这个标记，于是绕过了所有 Gatekeeper 的拦截

我们暂时还在等苹果官方开发者证书审核（这是分发 macOS app 的标准流程，要一两个月）。一旦拿到证书，所有用户都可以直接下载、双击、开 — 这条 git 路就不需要了。

---

还是装不上？

最常见的几种情况：

问题 1：git clone 提示「fatal: repository not found」或「authentication failed」

可能是：

• 邀请码已过期（每次申请都给一个新的，超过 30 天就失效了）
• 链接复制时少了字符
• 你的网络被防火墙拦了 GitHub

→ 发邮件到 hello@talktrack.cn，附上你申请时填的邮箱，我们重新给你一个。

问题 2：跑 git clone 后下载特别慢甚至超时

国内访问 GitHub 偶尔会慢。可以试：

# 用 https 代理（如果你已经会用 clash/v2ray）
git config --global https.proxy http://127.0.0.1:7890

或者直接发邮件给我们 — 我们可以从国内镜像给你重发链接。

问题 3：装上之后开不了 / 报错 / 录不到声音

→ 看 常见问题。

问题 4：还是不行

→ 发邮件 hello@talktrack.cn，告诉我们：

1. 你的 macOS 版本（点苹果图标 → 关于本机）
2. 你跑 git clone 的输出截图
3. 双击 dmg 之后的截图

工作日 24 小时内回你。