Herdr 中文教程：先验证脱离重连，再接入远程机器
Herdr 是多代理终端工作区。它在后台服务中管理终端窗格，让客户端关闭或 SSH 断线后仍能继续现有任务，并把代理标成 working、blocked 或 idle。当前官方仓库已经迁移到 herdrdev/herdr，本页不再使用旧仓库作为事实来源。
1. 选一种安装方式
Linux 或 macOS 的官方安装器命令如下。先在浏览器中打开脚本地址检查内容和下载位置，再决定是否通过管道执行：
curl -fsSL https://herdr.dev/install.sh | sh
herdr已有 Homebrew 或 mise 时，使用各自渠道更容易管理更新：
brew install herdr
# 或
mise use -g herdrWindows 官方提供 PowerShell 安装器；若终端安全软件阻止无文件执行，安装文档还给出下载 install.cmd 后运行的路径。手动下载时，Linux 和 macOS 有 x86_64/aarch64 资产，Windows 稳定资产表当前列出 x86_64 压缩包。
2. 用两个临时窗格验证脱离和重连
启动 Herdr 后，先开两个无敏感内容的 shell，一个持续输出时间，另一个保持空闲。按 Ctrl+B，再按 Q 脱离；随后重新运行 herdr。检查窗格、输出和进程是否仍在。这个测试验证的是客户端脱离，不能证明机器重启后的原进程还在。
官方说得很清楚：服务器或机器重启后可恢复保存的布局，并能恢复部分受支持代理的会话，但原来的操作系统进程不会存活。长任务仍应自己保存状态和中间产物。
3. 再核对代理状态
分别让一个代理持续工作、一个代理停在需要回答的问题、一个窗格回到 shell 提示符，再观察 working、blocked、idle 是否与实际一致。状态识别只能辅助定位，不能替代查看代理输出。不同代理的会话恢复支持也不同，应逐个做中断和恢复测试。
4. 最后加入 SSH 机器
先选一台非关键主机，验证首次认证、短暂断网、手动重连和远端 Herdr 版本。v0.9.1 支持用 herdr --machine <label-or-id> 把 CLI 操作转发到已保存机器；官方 release notes 要求本地与远端都更新到支持该能力的版本，失败的远程命令不会退回本地执行。
升级渠道也要保持一致。官方安装器管理的版本可用 herdr update，并可在 stable 和 preview 之间切换；Homebrew、mise、Nix 安装则应通过原包管理器更新。官方明确提醒 preview 可能回归。
5. 和 tmux 怎么选
相比 tmux，Herdr 同样有窗格、脱离和重新连接，但额外提供代理状态、受支持代理的会话恢复、多机器合并视图、CLI/socket API 和插件。tmux 是通用终端复用器，适合稳定地管理普通终端进程；Herdr 更贴近多个编码代理同时工作的场景。已有成熟 tmux 流程、又不需要代理状态时，没有必要只为界面差异迁移。
6. 验证状态与验证边界
验证边界：启动界面、后台服务、detach/reattach、代理状态识别、远程重连、Windows 行为和重启后的会话恢复均未本机实测。上面的步骤是用于复测的清单，不能当成已经验证成功的结果。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
近期变化与关注原因
同时运行多个编码代理时，真正难管的是终端、断线、机器切换和哪个代理在等输入。Herdr 把这些状态放进同一界面，并允许 CLI 和 socket API 驱动窗格。这些数据说明搜索关注持续存在，不代表独立用户数。
适合谁用
适合同时开多个 Claude Code、Codex、Cursor、OpenCode 或其他终端代理，需要看出谁在运行、谁在等输入，并在本地和 SSH 主机之间切换的人。只需要普通 shell 会话复用、团队已经熟悉 tmux，或不需要代理状态识别时，迁移收益要单独评估。
采用建议
Herdr 的价值在于同时看管多代理和多机器，而不是单纯替代 shell。先用两个临时窗格验证 detach/reattach 和状态识别，再测试一台非关键 SSH 主机；确认会话恢复边界后，才适合承载长任务。已经熟练使用 tmux 且不需要代理状态的人，不必为了界面差异迁移。
原教程未展开的系统信息
核心功能
本地与远程机器统一视图
本地工作区和已保存的 SSH 机器可以放在一个窗口中，代理列表合并显示，各远程连接可独立重连。
单个 Rust 二进制文件
Herdr 在现有终端中运行，不依赖 Electron；官方提供 Linux、macOS 和 Windows 稳定版二进制文件。
架构与数据流
Herdr 由终端客户端和后台服务协作：服务持有工作区、标签页、窗格与代理状态，客户端负责显示和输入；关闭客户端不会等同于停止服务。远程机器通过已保存的 SSH 连接加入同一视图，CLI 或 socket API 可以操作窗格。重启后的恢复分两层：布局可从状态重建，受支持代理可恢复会话，原来的操作系统进程不会跨重启保留。
技术栈和运行条件
语言
Rust
框架
终端界面、后台服务、CLI 与 socket API
关键依赖
- 系统终端/PTY
- SSH 远程机器连接
- 各编码代理自己的 CLI
运行环境
官方稳定二进制覆盖 Linux x86_64/aarch64、macOS Intel/Apple silicon 和 Windows x86_64；Windows ARM64 需依赖兼容运行方式
常见问题
Herdr 关闭窗口后，编码代理还会继续运行吗？
如果只是脱离客户端或 SSH 断线，官方说明后台服务会继续管理终端。若整台机器重启，原进程不会存活；Herdr 只能恢复保存的布局，并尝试恢复受支持代理的会话。
Herdr 现在支持 Windows 吗？
支持。官方安装页提供 PowerShell 和 install.cmd 两条路径，稳定资产表列出 Windows x86_64 压缩包。Windows ARM64 当前没有单列原生资产，使用前要核对官方平台限制。
Herdr 和 tmux 的主要区别是什么？
tmux 是通用终端复用器；Herdr 在窗格和脱离/重连之外，增加代理状态识别、受支持代理的会话恢复、多机器视图和代理可调用的 CLI/socket API。
Herdr 应该怎样更新才不会混用渠道？
只有官方安装器管理的版本使用 herdr update 和 stable/preview 通道。Homebrew、mise 或 Nix 安装应继续通过各自的包管理器更新；官方说明 preview 可能出现回归。