Skip to content

用 git 安装 TalkTrack(高级路径)

大多数人不需要这条路径

装 TalkTrack 最简单的方式是 从下载页直接下载 dmg——双击就能装。

这条 git clone 路径是为高级用户准备的,如果你想要:

  • git pull 升级:每次发新版一行命令拿到,不用每次重新点邮件链接
  • 加密校验完整性:仓库带 SHA256SUMS,确认 dmg 没被中途篡改
  • 不依赖浏览器 / 邀请码下载页:直接走终端流程

才需要看下面的步骤。否则回去走下载页就行

从 v0.4.0-beta.10 起,TalkTrack 已通过 Apple Developer ID 签名 + 公证(notarization)。两条路径拿到的是同一个签名 dmg,安装后体验完全一致——双击就能开。


准备:装 git(如果还没装)

打开 Mac 自带的「终端」(Terminal),输入:

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

不会找终端?

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


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

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

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

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

别把链接发给别人

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


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

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

bash
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 — 直接就开了

关于 macOS 安全提示

TalkTrack 已经过 Apple Developer ID 签名 + 公证,双击就能开。第一次打开时 macOS 可能会弹一个「TalkTrack 是从互联网下载的应用,确定要打开吗?」的标准提示,点 打开 即可(不是「无法验证开发者」那种红框警告)。


第四步:开通 4 项权限

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

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

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


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

录你的第一场会议


升级到新版本

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

bash
cd ~/Downloads/talktrack
git pull

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

需要重新开权限吗?

v0.4.0-beta.10 起,正式签名后跨版本权限会保留——不再需要每次升级都重开屏幕录制。

如果升级后录音变空白(极少数情况),看 常见问题 → 录完发现录音是空的


卸载

不用了想清理:

bash
# 删 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

  • 校验方式:装完后在终端跑

    bash
    codesign -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 偶尔会慢。可以试:

bash
# 用 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 小时内回你。