【Herdr简介】
代理复用器 Herdr 是一个二进制程序,而非应用程序。它能让你在任何设备上,甚至通过 SSH,在一个终端中运行所有编码代理。每个代理都在其独立的真实终端中运行,即便合上笔记本电脑,服务器也会让它们保持运行状态。你可以一眼看到代理的阻塞、工作和完成状态,还能从手机重新连接。
【安装方式】
稳定版安装脚本有 Homebrew Nix flake,使用命令 `curl -fsSL https://herdr.dev/install.sh | sh` 复制。Windows 测试版仅预览,使用命令 `irm https://herdr.dev/install.ps1 | iex` 复制。它有稳定的 Linux/macOS 版本和 Windows 预览测试版,且无需 Electron,无需账户,无遥测数据。
【代理状态与问题解决】
herdr、llm - proxy、qmp 等代理有不同的工作状态,如工作中、空闲、阻塞中、已完成等。当代理状态快速切换时,侧边栏会闪烁。问题在于每次 PTY 块更新时,汇总信息都会重新计算,双重状态切换会在帧中间重绘状态点。解决方案是在 src/app/state.rs 按时间间隔缓冲状态事件,在 src/ui/sidebar.rs 每帧重绘一次汇总信息。
【项目操作与运行情况】
herdr 项目有一系列操作,如开始处理并添加回归测试,运行 bun run dev 命令等。运行过程中会有类型生成耗时、内容同步完成等信息,astro v5.18.1 在 668 毫秒内准备就绪,本地地址为 http://localhost:4321/ 。
【数据库迁移】
在 llm - proxy 项目中,准备请求日志迁移并执行,已写入 migrations/0007_request_log.sql,本地检查通过,可应用迁移,使用 Bash 命令 cargo sqlx migrate run 应用待处理的数据库迁移,还需选择是否继续。
【请求日志与测试情况】
查看日志文件可看到请求的相关信息,如请求 id、路由、状态码、耗时等,还会有缓存命中率、上游延迟、重试等情况。codexserver 有已探索、已运行等测试情况,交接套件测试通过,接下来可考虑将浸泡测试集成到夜间 CI 中。
【qmp 项目运行】
qmp 项目使用 python3 -m http.server 8080 命令在 0.0.0.0 端口 8080 上提供 HTTP 服务,会有不同请求的响应情况。
【实际应用情况】
Herdr 受 JetBrains、Docker、Vercel 等众多公司工程师欢迎,不过这些是个人工程师的选择,并非公司背书。
【社区反馈】
来自 Jilles、DevOps Toolbox 和 Better Stack 的独立使用教程,可让你了解 Herdr 作为编码代理、远程会话和日常代理编排的 tmux 式复用器的实际体验。
【为何选择 Herdr】
代理可以在任何有工作的地方运行,如服务器、Mac Mini、沙盒 VM 等,你可以从任何终端连接,甚至是手机。桌面代理管理器只能在有 GUI 的机器上运行,而 Herdr 不受此限制。它有本地、通过 SSH、瘦客户端等多种使用方式。
【响应式 TUI】
Herdr 可以通过 SSH 在手机或平板电脑上正常使用。终端视图保持真实,窄屏幕会提供适合触摸操作的切换菜单。
【独特之处】
大多数代理管理器是应用程序,而 Herdr 是复用器。tmux 和 Zellij 可以管理持久的终端会话,但不了解代理。桌面代理应用程序了解代理,但只能在一台机器上运行。Herdr 将复用器集成到终端中,并使其具备代理感知能力。它不是终端模拟器,不是浏览器仪表盘,比用于代理的 tmux 更强大。通过表格对比了 Herdr 与 tmux / Zellij、代理应用程序、工作树编排器在功能上的差异。
【你将获得】
Herdr 能提供真实的窗格、代理状态和驱动它们的 API。真实的进程在真实的 PTY 中运行,具备可点击的布局、持久的会话,以及代理可以自行使用的控制界面。包括真实的窗格、代理状态、持久化、控制界面等方面。
【集成功能】
Pi、Claude Code、Codex 等任何终端代理都可以直接使用 Herdr,其集成功能可以提供更丰富的状态和会话恢复功能。
【插件市场】
Herdr 的 CLI 和套接字 API 是插件开发的基础,社区插件可以像代理一样驱动它,如通知器、布局预设、链接处理程序、版本检查等。可以浏览他人的作品,或者通过一个 GitHub 主题发布你自己的插件。
【开启代理管理之旅】
安装 Herdr,运行两个代理,断开连接一次,当终端关闭后代理仍能继续运行时,你就能体会到 Herdr 的价值。