文章

Herdr 桌面 App 入门:用 space 与标签页管理多个 AI

用 Herdr 桌面 App 把每个 repo 放进 space、每件工作放进标签页,从 agents 侧边栏一眼看出哪个 AI 在等你;本文依 v0.1.15 官方文档,说明安装、四种状态、关窗后的行为与遥测设置。

Herdr 桌面 App 入门:用 space 与标签页管理多个 AI

同时让好几个 AI 在不同项目里写代码,最常卡住的是不知道哪一个停下来在等你回答,只好一个窗口一个窗口切过去看。

Herdr 桌面 App(程序名 herdr-app)处理的就是这件事。按官方 README,它是给终端和 coding agent 用的桌面 App,把工作分进一个个 space,让你看出哪些 agent 需要你。关掉窗口后,终端里的程序还会继续跑。

依官方首页,它是免费的,App、herdr-core 和 Herdr TUI 都以 Apache 2.0 许可证开源。

这篇依 herdr-app v0.1.15 的官方文档整理,文中三张插图是我画的概念图。v0.1.15 在 2026-11-11(台北时间)发布,我在 2026-11-12 确认 releases.herdr.dev 和 Homebrew 上都还是这一版。Herdr App 还没到 1.0,更新很快,操作方式与快捷键以官方 README为准。

先说几个词

  • 终端(terminal):输入命令的文字窗口。macOS 的“终端”App、Windows 的 PowerShell 都是。
  • repo:用 git 管理的项目文件夹。本文说“一个 repo”,可以理解成“一个项目”。
  • agent(coding agent):在终端里跑、会自己读文件、改代码、运行命令的 AI,例如 Anthropic 的 Claude Code、OpenAI 的 Codex。官方说,任何能在终端里运行的程序都能放进 Herdr。
  • space/标签页(tab)/pane:Herdr App 从大到小的三层,步骤 3 有图和说明。
  • OSC 7501:agent 和 Herdr 之间约定好的报告方式,让 agent 告诉 Herdr 自己在忙、做完了,还是在等你。会这样报告的 agent,Herdr 才显示得出它的状态;不会的照样能跑,只是没有状态。
  • SSH:从一台电脑连到另一台电脑、在那台电脑上操作的方式。Herdr 用 SSH 连到你的其他电脑或服务器,手机 App 也是通过 SSH 连接。
  • 遥测(telemetry):App 发回给开发者的使用统计。
  • mod 和 layout:mod 是在 Herdr 里运行的 JavaScript 小程序,例如放在 pane 里的面板。layout 是整个窗口的布局,内置的有 Herdr、Terminals 和 Herdr 98。

先分清楚:App、herdr-core 与 Herdr TUI

herdr.dev 上有两个名字很像的程序,这篇讲的是 Herdr App。依官方 FAQ 和 README,它们的关系如下:

flowchart LR
  W["App 窗口(布局)"] --> C["herdr-core(运行)"]
  C --> A1[终端与 agent]
  T[Herdr TUI] --> S[TUI 自己的 server]
  S --> A2[另一批终端与 agent]
  • Herdr App(herdr-app):新的、独立的程序,有自己的桌面窗口,构建在 herdr-core 上。你看到的窗口只负责把终端排在屏幕上。
  • herdr-core(命令是 hc):随 Herdr App 附带,在后台真正运行每个终端和 agent。README 用一句话讲完两者的分工:“The window arranges terminals. The core runs them.”(窗口负责布局,core 负责运行。)
  • Herdr TUI:最早的 Herdr,整个界面都在终端里,由它自己的后台程序(server)运行 agent。官方说它照常可用,相关资料都在 herdr.dev/tui。

App 和 TUI 不共享 agent:依官方 FAQ,在其中一个里启动的 agent,不会出现在另一个里。手机 App 也只支持 herdr-core,不支持 Herdr TUI。依手机 App 页面,Herdr TUI 和 herdr-core 可以同时装在同一台电脑上。

我建议挑一个当主力。因为 agent 不共享,两边各开几个,又会回到“不知道谁在等你”的老问题。想留在终端里用的,看herdr 入门:在终端同时跑多个 AI,找出卡住的那个;想要一个桌面窗口、或想用手机查看 agent 的,继续往下读。

什么时候值得用

  • 同时让两个以上的 agent 在不同 repo 或不同工作上跑,想在一个窗口里看出哪个在等你:适合。
  • 想关掉窗口、让 agent 继续干活:适合。依官方文档,关掉窗口不会停掉终端(步骤 5)。工作放在 SSH 机器上的话,笔记本电脑睡眠时也会继续(步骤 6)。
  • 只跑一个 agent,而且目前的做法已经顺手:不一定要换(我的看法)。

开始前要准备

依官方 FAQ,受支持的电脑如下:

系统架构其他条件
macOSApple Silicon(M1 之后的 Mac)Intel Mac 见步骤 1 的说明
Linuxx86_64、arm64要在有图形桌面的环境里运行(desktop session,只有命令行界面的服务器不行),也要有可用的 Vulkan 驱动(显卡驱动程序提供的绘图功能)
Windowsx86_64Windows 10 1803 以上,以及 curl 和 tar 这两个下载、解压工具;1803 之后的 Windows 已经内置

你要用的 agent 也要先装好,例如 Claude Code 或 Codex:在普通终端里输入 claude 或 codex,能正常启动。

依 CHANGELOG 0.1.14,从 + 菜单打开的每个 Codex 会各自独立,关掉其中一个不会连带结束其他的。这需要 Codex 0.156 或更新的版本。

步骤 1:安装

macOS(Apple Silicon):dmg 或 Homebrew

两种选一种即可。没用过 Homebrew 的话,选 dmg 就好。

用 dmg。 下载 Herdr.dmg,双击打开,把 Herdr 拖到“应用程序”(Applications)文件夹。

用 Homebrew。 Homebrew 是在 Mac 上用一行命令安装软件的工具。在终端运行:

1
brew install --cask herdr-app

依 Homebrew 的 cask 信息,App 会装到 /Applications/Herdr.app,同时多一个 herdr-app 命令。cask 信息里也标明 App 会自己更新(auto_updates: true),更新方式见后面“自动更新”一节。

Intel Mac 没有安装包。 README 写明 macOS 版只提供 Apple Silicon,Intel Mac 要自己从源代码构建;官方安装脚本遇到 Intel Mac 也会直接停下。

不确定自己的 Mac 是哪一种,就点左上角苹果菜单 >“关于本机”。“芯片”写 Apple M 开头的是 Apple Silicon,写“处理器”和 Intel 的是 Intel Mac。

Linux 与 Windows:先下载脚本、读过再运行

Linux 和 Windows 官方只提供安装脚本,另一条路是从源代码构建。安装脚本是一份写好的命令清单,运行后会自动下载并安装 App。README 自己就提醒,这两个安装脚本会下载并运行代码,想先读过可以先读。

Linux。 官方 README 的写法是 curl -fsSL https://releases.herdr.dev/app/install.sh | sh。中间的 | 会把下载到的内容直接交给 sh 运行,等于下载完立刻运行,你没有机会先看。我建议拆成两步,先下载成文件:

1
curl -fsSL https://releases.herdr.dev/app/install.sh -o herdr-app-install.sh

用文本编辑器打开读过,确认看得懂、没问题,再运行:

1
sh herdr-app-install.sh

看不懂脚本在做什么,就先别运行。我读了脚本开头的注释和内容,它在 Linux 上会:

  • 把 App 装到 ~/.local/share/herdr-app,把 herdr-app 命令放到 ~/.local/bin,并加上启动器和图标。
  • 只有在机器上还没有 herdr-core 时,才把它装到 ~/.local/bin/herdr-core(连同 hc);之后由 App 让它保持最新。
  • 下载发布清单(latest.json),比对下载文件的 SHA-256(由文件内容算出的一串指纹,文件只要差一点,指纹就不同),不一致就停下来。

~ 代表你的用户文件夹(主目录)。PATH 是终端找命令时会去查看的文件夹列表。安装程序要求的话,把 ~/.local/bin 加进 PATH,之后在终端输入 herdr-app 才找得到。

之后再运行一次脚本,就是更新 App。这个脚本也支持 macOS(App 会放在 ~/Applications/Herdr.app),不过用 Mac 的话,我建议用上面的 dmg 或 Homebrew。

Windows。 官方写法是在 PowerShell 运行 irm https://releases.herdr.dev/app/install.ps1 | iex,下载页写成 powershell -c "irm https://releases.herdr.dev/app/install.ps1 | iex"。

这同样是下载完直接运行,所以我建议同样拆成两步。先在 PowerShell 把脚本下载成文件:

1
irm https://releases.herdr.dev/app/install.ps1 -OutFile herdr-app-install.ps1

用记事本打开读过,确认没问题,再运行你刚读过的这一份:

1
Get-Content .\herdr-app-install.ps1 -Raw | iex

这一行和官方写法一样交给 iex 运行,区别在于运行的是你读过的那份文件,不是重新下载的另一份。不要读完再跑官方那一行,因为那会重新下载,跑的不一定是你读过的内容。看不懂就先别装。

依脚本开头的说明,安装不需要管理员权限,装好后 Herdr 会出现在开始菜单。安装程序会把 %LOCALAPPDATA%\Programs\herdr-app 加进用户的 PATH,要打开一个新的终端窗口才会生效。之后再运行一次脚本,就是更新 App。

装好之后:herdr-core 从哪里来

大多数人不用另外处理 herdr-core。依官方文档:

  • 用脚本安装:机器上还没有 herdr-core 的话,脚本会一起装;已经有就不重装。
  • 用 dmg 或 Homebrew 安装:App 会在你还没有 herdr-core 时帮你设置好;找到的 core 用不了时,也会协助你安装或更新。
  • App 会在 PATH、~/.local/bin、Homebrew、mise、Nix、cargo 这些地方找 core。后面四个都是安装开发工具的渠道,没用过可以略过。
  • 连不上正在运行的 core 时,App 会说明原因和修复方法(CHANGELOG 0.1.14)。

步骤 2:打开 App,从标签栏的 + 开一个 agent

依下载页,打开 Herdr 之后,从标签栏(tab bar)的 + 开一个 agent,例如 Claude Code 或 Codex。+ 菜单也能开普通的终端。

你也可以在 pane 里输入 claude 这类命令直接启动 agent,跟在普通终端里一样。习惯用 tmux 的人要注意,官方 FAQ 提醒要直接在 Herdr 的 pane 里跑 agent,不要包在 tmux 里,理由见步骤 4。

依 README,新标签页会从当前选中的终端(光标所在的那个)正在用的文件夹开始。所以要让 agent 在某个 repo 里工作,先在当前的终端切到那个 repo 的文件夹,例如:

1
cd ~/projects/web-app

再开新标签页。其他要知道的事:

  • macOS 第一次使用时,系统可能会问 herdr-core(或 Herdr Core)能不能访问“文稿”这类文件夹、局域网或麦克风。依 CHANGELOG 0.1.12 和 0.1.13,那就是 Herdr 的一部分,点“允许”即可。
  • agent 退出后,它所在的终端不会跟着关掉,会留下来等你输入下一个命令。
  • agent 一启动就失败时,依内置指南,Herdr 会弹出错误通知,附上错误代码和最后几行输出,方便你查原因。
  • 没有命名的 space 会跟着它第一个终端的文件夹走。想要一个固定不变的标签,就给 space 或标签页命名,默认快捷键是标签页 f2、space shift-f2。
  • 如果你在 macOS 上用的是比 0.1.15 旧的版本,刚登录或重启后,+ 菜单可能把每个 agent 都标成“not installed”;0.1.15 已修复。

步骤 3:认识 space、标签页、pane

一台机器里有多个 space,每个 space 有多个标签页,每个标签页分成几个 pane,各跑一个 agent 概念图:一台机器 → space(通常是一个 repo)→ 标签页(一件工作)→ pane(一个终端,可以各跑 Claude Code 或 Codex)。

依官方 README,三层的分工是:

  • space:一台电脑上的一份工作,通常是一个 repo。
  • 标签页(tab):space 里的一件工作,包含它的终端,以及这些终端怎么左右、上下分割。关掉 space 里最后一个标签页,space 也会跟着关掉;依内置指南,这时 Herdr 会先问你是否确定。
  • pane:标签页里的一格画面,放一个终端,或放在终端旁边的 mod 面板。

官方首页建议每个 repo 一个 space、每件工作一个标签页。例如同一个 repo 里,一个标签页让 Claude Code 做登录页,另一个标签页让 Codex 修测试。需要一边看 agent、一边自己跑测试时,再把标签页分割成两个 pane,快捷键见下表。

默认快捷键

下表是我依官方默认按键文件(macOS、Linux/Windows)整理的。记不住也没关系,按 cmd-shift-p(Linux/Windows 是 ctrl-shift-p)打开命令面板(command palette)。它可以按名字找到每个操作,还会列出它的快捷键。

cmd-shift-p 的意思是同时按 Command、Shift 和 P。Mac 上的 cmd 是 ⌘ Command 键,ctrl 是 control 键,两个不一样。

操作macOSLinux/Windows
新建 spacecmd-nctrl-shift-n
新建标签页cmd-tctrl-shift-t
关闭标签页cmd-wctrl-shift-w
向右分割 panecmd-dctrl-shift-o
向下分割 panecmd-shift-dctrl-shift-e
关闭 panecmd-shift-wctrl-shift-x
放大当前 panecmd-shift-enterctrl-shift-z
下一个/上一个 agentcmd-]/cmd-[alt-down/alt-up
显示/隐藏侧边栏cmd-bctrl-shift-b
切到第 1–9 个标签页cmd-1…cmd-9ctrl-1…ctrl-9
切到第 1–9 个 spacectrl-1…ctrl-9alt-1…alt-9
重命名标签页/spacef2/shift-f2f2/shift-f2
命令面板cmd-shift-pctrl-shift-p
设置(Settings)cmd-,ctrl-,
帮助cmd-/ctrl-shift-/

搭配 git worktree

我建议每个 worktree 开一个 space,或至少给它一个自己的 pane,这样每个 agent 只在自己的那份目录里改文件。worktree 是给每个 agent 开的一份独立工作目录,做法见git worktree 教程:让两个 AI 在同一个 repo 分开工作。

App 本身也能管理 worktree。依内置指南:

  • space 菜单和 + 菜单里有 New worktree(新建)、Open worktree(打开已有的)和 Remove worktree(删除)。
  • 新建的 worktree 会放在那台机器的 ~/.herdr/worktrees/<repo 名称>/<分支名称>。
  • Spaces 侧边栏会把这些 worktree 的 space 收在原来 repo 的 space 下面。

步骤 4:看 agents 侧边栏,找出在等你的那个

agents 侧边栏的四种状态 Working、Blocked、Done、Idle,各代表什么、你该做什么 概念图:四种状态的意思,以及本站建议的处理方式;没有 pane 的 worker,点一下会以 peek 打开在当前的标签页上。图上的颜色是本站配图用的,不是 App 界面的配色。

依 README,agents 侧边栏会把各个 space 里的 agent 集中成一张列表,也包括由另一个 agent 启动的程序(官方称为 worker)。会报告状态的 agent,状态有下面四种。最右列是我的建议,简单说就是先处理 Blocked,再看 Done。

状态官方定义(通俗版)本站建议你该做什么
Working还在忙不用管,让它做
Blocked在等你先处理:点进去看清楚它要什么,再回答
Done在你看别处时做完了去看结果,检查它改了什么
Idle没在工作,或已经做完而且你看过了可以交代下一件事
  • space 和标签页本身也会显示状态,取它里面最急的那个 agent,顺序是 blocked > done > working > idle。所以看到某个 space 是 blocked,就说明里面至少有一个 agent 在等你。
  • Done 在你看过之后,会变成 Idle。
  • 点一下 agent 就能跳过去看它。没有 pane 的 worker 会以 peek 的方式打开,像一个临时的预览窗口,盖在你当前的标签页上面。想让它一直放在其他工作旁边,可以把它留成一个标签页。
  • 也可以用快捷键跳到下一个或上一个 agent,快捷键见步骤 3 的表。
  • Herdr 会给每个终端一个地址(代号),例如 t7 是同一台电脑上的终端,vps/t7 是名为 vps 的另一台电脑上的。终端的文字里出现正在运行的终端地址时,按住 Ctrl 点一下(macOS 是 Cmd)就能 peek。

依内置指南,agent 需要你、或在你没看的时候做完,Herdr 会播放声音;你没在看时,还会弹出可以点击的通知(toast)。声音在 settings.json 的 sounds 里设置,也可以在 Settings > Alerts 试听。

状态没出现时

我会依官方 FAQ 依次检查下面三件事:

flowchart TD
  A[agent 没有状态] --> B{"会用 OSC 7501 报告?"}
  B -->|不会| B0[照样能跑,只是没状态]
  B -->|可能是旧版| B1[先更新 agent]
  B -->|会| C{跑在 tmux 里?}
  C -->|是| C1[改在 pane 里直接跑]
  C -->|否| D{"在 Herdr TUI 启动?"}
  D -->|是| D1[不会出现在 App]
  • 报告方式:依 herdr-core 页面,herdr-core 不读屏幕上的文字,也没有内置的 agent 列表,不会靠猜。旧版的 agent 可能还不会报告,所以先把 agent 更新到新版。
  • tmux:agent 跑在 Herdr 里再开的 tmux 里,状态就报告不到 Herdr。没用过 tmux 的话,这项可以跳过。
  • Herdr TUI:在 TUI 里启动的 agent 活在 TUI 自己的 server 里。

步骤 5:关掉窗口不会停掉 agent

依 README 与官方 FAQ:

你做了什么终端和 agent 会怎样
关掉 App 窗口继续在 herdr-core 里跑
退出 App(macOS 按 cmd-q)或更新 App继续跑,什么都不变
关掉 pane 或标签页里面的终端结束
重启、注销,或 herdr-core 停止、崩溃里面的程序也会停

重启或 core 停掉之后,保留下来的 pane 会回来,终端地址也不变。每个 pane 会在原来的文件夹开一个新的 shell(终端里等你输入命令的程序)。

但原来运行的命令不会再跑,Herdr 也不会帮你重新启动 agent 或接着做到一半的工作。官方 FAQ 的说法是,自己把 agent 再开起来,接着做就好。

另外,自己退出或被强制结束的终端会被关闭,不会自动重开。

刚从旧版升级上来的 Mac 用户:依 CHANGELOG 0.1.15,在 herdr-core 0.1.20 之前打开的终端,仍可能在 Herdr 退出时跟着结束。core 更新到 0.1.20 以上之后(Settings > Updates 里看得到版本),把那些终端关掉重开,或重启一次。

步骤 6(可选):加入 SSH 机器、用手机查看

flowchart LR
  L[笔记本上的 App] --> C1[本机 herdr-core]
  L -->|SSH| C2[远程 herdr-core]
  M[手机 App] -->|SSH| C1
  M -->|SSH| C2
  C2 --> R[远程的终端与 agent]

依官方首页与手机 App 页,电脑和手机都通过 SSH 直接连到每台机器上的 herdr-core,也可以搭配 Tailscale(把自己的几台设备连成一个私有网络的服务)。不需要 Herdr 账号,中间没有官方的服务器,终端内容也不经过官方。

加入另一台机器

这一步适合有另一台电脑或云服务器、而且已经能用 SSH 连上去的人;没有的话可以跳过。

依 README,从 Settings → Machines,或侧边栏的 Add machine 加入 SSH 机器。你可以从 SSH 配置里挑一台主机,或直接输入 SSH 要怎么连到它。之后,那台机器上的 space,终端都在那台机器上跑,不是在你的电脑上。

  • 那台机器也要有 herdr-core。依 CHANGELOG 0.1.14,连接需要密码、要接受新的 host key(SSH 用来确认主机身份的密钥),或那台机器还没装 herdr-core 时,Settings > Add machine 会告诉你要运行什么。
  • 只要远程机器和它的 core 还在跑,本机窗口关掉、笔记本电脑睡眠,远程的工作都会继续。

用手机查看

官方有手机 App,支持 iPhone、iPad 和 Android,可从 App Store 和 Google Play 下载。依手机 App 页:

  • Inbox 按紧急程度排序:需要你、做完、在忙、空闲。
  • 打开一个 agent,就是真正的终端,可以直接打字。也可以用 compose(输入消息的区域)粘贴文字、截图、照片,或用语音输入。
  • 不在家时,可以通过 Tailscale 或任何 VPN 连回你的机器;官方说用 Tailscale SSH 不用另外设置密钥。
  • 只装了 herdr-core 的机器,手机上也看得到终端和 agent;那台机器也运行着 Herdr App 时,才看得到 space。
  • 想先看看长什么样,打开手机 App 时点 Try the demo。
  • 官方说手机 App 没有登录、没有广告、没有追踪,也没有分析。

步骤 7(可选):自定义

Settings 改偏好设置。 按 cmd-,(Linux/Windows 是 ctrl-,),可以改字体、颜色、声音等偏好设置。

配置都在 ~/.config/herdr-app。 App 的设置、快捷键、layout、mod 和自动生成的 agent 指南,都放在你用户文件夹下的这个文件夹,macOS 和 Windows 也一样。

文件夹名以 . 开头的 .config 默认是隐藏的,macOS 的访达(Finder)可以按 cmd-shift-. 显示隐藏文件。(进阶:设置了 XDG_CONFIG_HOME 或 HERDR_APP_HOME 环境变量的话,位置会跟着改。)

依安全文档,space、标签页和分割方式存在每台机器的 core 里,不在这个文件夹,所以删掉这个文件夹不会停掉 core,也不会清掉它的数据。

反过来,用 Homebrew 卸载 App 时如果加上 --zap(brew uninstall --zap herdr-app),依 cask 信息,这个文件夹会一起移到废纸篓。你的设置和 mod 也会跟着不见。

改快捷键:keys.json。 任何快捷键都能在 keys.json 里改,格式例如:

1
{"global": {"ctrl-shift-t": "tab.new"}}

这一行的意思是:在任何地方按 ctrl-shift-t,都执行“新建标签页”(tab.new)。保存后窗口会重新加载;改坏了会保留上一个能用的版本,并把错误写到 keys.error。要注意两件事:

  • 没动过的按键文件,升级时会自动换成新版的默认设置。只要你改过(哪怕只改了空白),整个文件就算你的,之后新增的默认快捷键要自己手动加。
  • 单纯的 ctrl 加字母(例如 ctrl+c、ctrl+d)默认会交给终端里的程序,不要拿来绑定 Herdr 的操作。

内置的 layout 和 mod 要先复制再改。 要改结构或代码时,改你复制的那份。你的副本不会被动到;内置的那份,Herdr 每次启动都会更新成最新版。

让 agent 帮你改:AGENTS.md。 依官方首页,Herdr 把 layout、侧边栏、标签页、快捷键和主题都存成 ~/.config/herdr-app 里的普通文件。里面的 AGENTS.md 会向你的 agent 解释这些文件。

下载页的建议是:让 agent 先读这份指南,然后用平常说话的方式说出你想要什么,例如一个看板、每个标签页一个计时器,或换一种外观。

不要自己改 AGENTS.md。 它每次启动都会由 App 重新写入,你的修改会被覆盖。

herdr-app --skill 普通用户用不到。 它打印给 agent 看的窗口操作指南。

官方的分工是:运行和协调程序用 herdr-core,改变你看到的界面用 App。herdr-core 自己的手册则是 hc --skill。

救急键 ctrl-alt-shift-escape。 layout 或快捷键改坏、界面乱掉时,同时按 Ctrl、Alt(Mac 键盘上是 Option)、Shift 和 Esc。

依内置指南,这组键始终有效、不能被改掉。它会把当前的 layout 和 keys.json 移到一边(改名成 *.reset-<时间>),回到默认的 main layout。

隐私、更新与 mod 安全

隐私与更新:在 Settings → Privacy 或 settings.json 关掉遥测,在 Settings → Updates 看更新,mod 拥有完整权限 概念图:在 Settings → Privacy,或在 settings.json 加上 "telemetry": false 关掉遥测;在 Settings → Updates 查看更新;mod 拥有完整权限,装之前先读过。

遥测默认开启,三种关法

依官方 Security and privacy 文档,使用遥测默认开启。正式版每天发送一份小报告到 https://telemetry.herdr.dev/v1/report,附带一个随机的安装 ID。

  • 会发送的:App 和 core 的版本、操作系统与架构、使用时长和次数落在哪个区间(不是精确数字)、已知 agent 的名称、内置 layout 的名称、mod 数量、App 命令名称、固定事件的计数。自定义 layout 的名称一律发送成 custom,自定义 mod 的名称不发送。
  • 不发送的:终端文字、prompt、文件内容、文件夹路径,以及你自己输入的名称。
  • 依隐私页,使用报告保留 3 个月,不存 IP,不出售也不分享。

三种关法:

  1. 在 Settings → Privacy 关掉。同一页也能查看报告的内容。
  2. 在 ~/.config/herdr-app 里现有的 settings.json 加上 "telemetry": false 这个字段。官方示例写成 {"telemetry": false};文件里已经有其他设置的话,把这个字段加进最外层的大括号里,用逗号和其他字段隔开,不要把整个文件换掉。
  3. 只关这一次:从终端启动 App 时,设置环境变量 DO_NOT_TRACK=1 或 HERDR_TELEMETRY=0,例如下面这行。
1
DO_NOT_TRACK=1 herdr-app

在 CI(自动构建、测试代码的服务器环境)里,也会自动停止收集。关掉之前要知道两件事:

  • 关掉遥测会删掉本机的安装 ID 和还没发出的报告,但已经发出的收不回来。
  • 关掉遥测不会停止更新检查、mod 发出的网络请求,以及你自己选择发送的反馈。反馈会先拟好给你看,由你决定发送,不会悄悄发出。

自动更新:后台下载,重开才换新版

依 README 和内置指南:

  • 安装版会在后台检查更新,把新版下载到正在运行的 App 旁边。等你退出再打开 App,或选择更新操作时,新版才会接手。终端继续在 core 里跑。
  • App 更新后第一次启动,也会把 herdr-core 更新到同一代的最新版,终端照样跑。
  • 如果 App 崩溃或被强制结束时,已经有一个验证过的新版在等,下次启动会先装好它,再打开窗口。
  • Settings → Updates 显示有哪些更新,App 和 core 的更新操作都放在这里。
  • 依内置指南,只有少数重点版本会在更新后自动打开 What’s New(更新说明),其他版本只在这次启动时显示一个小小的 Updated 标记。想看更新内容,可以从 Settings → Updates 的 What’s new 按钮或命令面板打开。
  • 从源代码自己构建的版本不会自动更新。

更新的验证:只比对 SHA-256

依官方安全文档,App 在解压更新文件之前,会比对它的 SHA-256 指纹和发布清单上写的是否一致。但指纹和清单来自同一个服务:

flowchart LR
  S[同一个发布服务] --> M[发布清单]
  M -->|写着| H[SHA-256 指纹]
  F[下载的更新文件] --> C[比对指纹]
  H --> C
  C -->|一致| U[解压更新文件]
  X[有人同时换掉两者] -.-> F
  X -.-> M

所以这个比对只能发现下载过程中的文件损坏,不是发布清单上的独立签名。App 也不会另外验证更新清单的数字签名,如果有人能同时换掉更新文件和清单,这道检查拦不住。

安全文档也写明,发布流程没有配置签名证书时,安装包可能没有签名,或只有 ad hoc 签名(没有绑定开发者身份的签名)。Apple 公证(notarization,Apple 替 App 做的安全检查)是另外测试的,不是发布的必要条件。

官方的原话是:“Do not assume every download is notarized or signed.”也就是不要假设每个下载都经过公证或签名。

mod 和别人做的 layout:先读再装

依官方安全文档,mod 是在 Herdr 里运行、被信任的 JavaScript。它没有沙箱(sandbox,把程序隔离起来、限制它能碰哪些东西的机制),权限完整。它能以你的身份运行程序、访问任何网址、读你的文件,也能在你连接的其他机器上运行程序。

官方明说 mod 不是安全边界(is not a security boundary),也就是 Herdr 不会替你拦下 mod 做的事,也不会为每个程序或网络请求弹出权限提示。

安装别人的 mod 前先读过,把它当成你要亲手运行的 shell 脚本。layout 也能加载 mod,所以装别人的 layout 时,它引用的 mod 也要检查。

想从 gallery 找别人做的 layout 或 mod 时,内置指南要求 agent 先读过 recipe 和每个文件。recipe 是每个作品附带的 RECIPE.md,说明它是怎么做出来的。加入之前,agent 要告诉你这个 mod 会不会:

  • 联网。
  • 运行程序(exec、hc)。
  • 读取它自己文件夹以外的文件。

还有两点和配置文件夹有关:

  • mod 可能把敏感数据存在 ~/.config/herdr-app,Herdr 不会加密这个文件夹。
  • App 在这个文件夹里开了一个本机控制 socket(本机程序之间通信用的连接点),让 agent 能查看和操作窗口。官方提醒:能访问这个文件夹,就等于能操作窗口和它的命令。

下一步

延伸阅读:README、Security and privacy、内置指南 AGENTS.md、macOS 默认快捷键、Linux/Windows 默认快捷键、CHANGELOG、安装脚本、herdr.dev、下载页、手机 App、herdr-core、隐私、Herdr TUI、Homebrew cask。

本文由作者按照 CC BY 4.0 进行授权