用 git 安装 TalkTrack(高级路径)
大多数人不需要这条路径
装 TalkTrack 最简单的方式是 从下载页直接下载 dmg——双击就能装。
这条 git clone 路径是为高级用户准备的,如果你想要:
git pull升级:每次发新版一行命令拿到,不用每次重新点邮件链接- 加密校验完整性:仓库带
SHA256SUMS,确认 dmg 没被中途篡改 - 不依赖浏览器 / 邀请码下载页:直接走终端流程
才需要看下面的步骤。否则回去走下载页就行。
从 v0.4.0-beta.10 起,TalkTrack 已通过 Apple Developer ID 签名 + 公证(notarization)。两条路径拿到的是同一个签名 dmg,安装后体验完全一致——双击就能开。
准备:装 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
- 打开「访达」(Finder)→ 进入
下载文件夹 →talktrack→ 双击那个.dmg文件 - 弹出来的窗口里,把 TalkTrack 图标拖到 Applications 文件夹
- 关掉窗口,到「应用程序」(Applications)里双击 TalkTrack — 直接就开了
关于 macOS 安全提示
TalkTrack 已经过 Apple Developer ID 签名 + 公证,双击就能开。第一次打开时 macOS 可能会弹一个「TalkTrack 是从互联网下载的应用,确定要打开吗?」的标准提示,点 打开 即可(不是「无法验证开发者」那种红框警告)。
第四步:开通 4 项权限
第一次启动时 TalkTrack 会引导你开通这些权限。4 项都要开,少一项就影响录音:
| 权限 | 干什么用 |
|---|---|
| 麦克风 | 录你自己说的话 |
| 屏幕录制 | 录会议软件里对方说的话(不截屏,只取声音) |
| 辅助功能 | 监听全局快捷键,比如按一下就停录 |
| 自动化(Apple Events) | 自动检测你正在开哪个会议软件 |
详细开通步骤参考 安装与第一次打开。
接下来:跑你的第一场会议
→ 录你的第一场会议
升级到新版本
我们发布新版本时,会发邮件告诉你。升级方式很简单:
cd ~/Downloads/talktrack
git pull然后双击新出现的 .dmg 文件,重新拖到 Applications 替换旧版本即可。
卸载
不用了想清理:
# 删 git 仓库
rm -rf ~/Downloads/talktrack
# 删 app 本身
rm -rf /Applications/TalkTrack.app
# (可选)删本地数据:会议录音、转写、报告
rm -rf ~/Library/Application\ Support/TalkTrack关于代码签名
TalkTrack 已通过 Apple Developer ID 签名 + 公证(notarization):
签名团队:Kerwin Su (K5TH7T9DL5)
公证状态:Apple 已审核通过,ticket 已 staple 到 dmg
校验方式:装完后在终端跑
bashcodesign -dv --verbose=2 /Applications/TalkTrack.app应能看到
Authority=Developer ID Application: Kerwin Su (K5TH7T9DL5)那一行。
这意味着:
- ✅ 双击直接打开,无需「右键 → 打开」绕开 Gatekeeper
- ✅ 跨版本升级权限保留(macOS 通过证书 + identifier 识别同一个 app)
- ✅ 离线时 macOS 仍能验证(公证 ticket 已嵌入 dmg)
还是装不上?
最常见的几种情况:
问题 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,告诉我们:
- 你的 macOS 版本(点苹果图标 → 关于本机)
- 你跑
git clone的输出截图 - 双击 dmg 之后的截图
工作日 24 小时内回你。