文章

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 是哪一種,就點左上角蘋果選單 >「關於這台 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
command palettecmd-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 按鈕或 command palette 打開。
  • 從原始碼自己建置的版本不會自動更新。

更新的驗證:只比對 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 授權