herdrm 项目面板:一屏掌控 Docker、热重载服务与本地虚拟机的新体验

原创2026-10-28 14:30:53393 阅读

herdrm 项目面板:一屏掌控 Docker、热重载服务与本地虚拟机的新体验

herdrm 是 herdr 的 macOS 原生控制台,而它的新特性「项目面板(Project Panel)」正是本文主角:把一个项目相关的 Docker 容器、热重载开发服务、本地虚拟机(VM)全部聚合到一屏里,告别反复敲 docker ps 和 lsof 查状态的碎片化操作。

herdrm 项目面板所在的应用主界面:左侧设备与 Space 侧边栏,右侧实时终端

3 步打开 herdrm 项目面板

项目面板是 0.6.19 版本加入的(见 CHANGELOG.md),每个 Space 都有一张,打开方式很简单:

  1. 在任意 Agent / Terminal / Space 行的右键菜单里点 「Project…」;
  2. 或点击终端窗口标题栏上的 Project 切换按钮;
  3. 面板出现在右侧区域,自动探测该 Space 所在设备的运行状态。

面板会先显示「Inspecting project…」,几秒后即渲染出一整套卡片。注意它需要一个 shell 环境——tailcat 设备和 Windows 设备暂不支持项目详情。

架构总览:一张图看懂 Mac、主机与关联节点

面板顶部是 Architecture(架构) 卡片:本地 Space 直接展示主机节点;远程 Space 则画出「Mac → 远程主机 → 关联主机」的拓扑,并标注 Hot reload、Docker、VM 三条工作负载通道(lane)。点击通道可滚动到对应卡片。相关视图实现见 ProjectOverviewCard.swift。

热重载卡片:开发服务的端口、日志与 URL 一屏掌握

Hot reload 卡片列出项目里所有正在运行的开发服务器,每行两行信息:

第一行 框架名(Next、uvicorn…)· 角色(Frontend / Backend / Tooling)· 绑定地址:端口 · public 或 loopback only 标签 · ⚡ hot reload 标签
第二行 systemd unit 名 · 日志文件名 · 可点击/可复制的 URL 芯片
  • 点击行尾的 ⋯ 菜单可打开或复制 URL,甚至 Set URL… 覆盖为实际使用的公网地址;
  • 不想要的监听器可 Hide,收进底部 Hidden 卡片,随时 Unhide;
  • 已失效的 URL 覆盖会单独提示,避免你点一个早就没有服务的链接。

分类逻辑(前端/后端/工具链角色、热重载识别)在 ProjectClassifier.swift,界面在 ProjectHotReloadCard.swift。

Docker 卡片:容器健康度与端口映射的瓦片网格

Docker 卡片把容器组织成小瓦片(tile)网格:

  • Compose 项目按组展示,组头显示 3/4 这样的 running/total 计数,匹配方式(path / name / attached)以徽章标出;
  • 每个瓦片显示容器名 + 状态点:🟢 运行中、🔴 unhealthy、灰色停止,第二行是端口映射(如 8080→80)或健康标签;
  • 点击瓦片展开详情条:镜像名(可一键复制)、完整端口列表、容器 URL,还能 Attach / Detach / Dismiss;
  • 面板会自动建议可能属于该项目的容器,你确认后点 Attach,它们就固定到卡片里;
  • 其他 Compose 项目折叠在「Other Compose projects」中,可手动 Attach。

健康度映射(healthy / unhealthy / starting)见 ProjectDockerCard.swift。Docker 不可达时会直接给出 "Docker is not reachable" 警示,而不是空白卡片。

Hosts & VMs:负载、内存与 Parallels / Lima 虚拟机管理

Hosts & VMs 卡片回答「这台机器现在忙不忙、还养得活这个项目吗」:

  • 主机行展示 hostname、Docker 版本、Load(1 分钟负载/核数)与 Memory 两个胶囊计量条,超过 75% 变黄、90% 变红;
  • 项目相关的 VM 逐行列出:名称、厂商标签(Parallels / VMPal / Lima)、运行状态、IP(右键可复制),建议的 VM 可一键 Attach,已挂载的可 Detach;
  • 还可通过 Link host… 把其他 SSH 主机关联到该项目,形成多主机开发视图。

实现见 ProjectHostsCard.swift。

herdrm 浅色主题下的项目与终端工作界面:侧边栏 Space 列表与完整 PTY 终端

自动刷新机制:每 15 秒更新一次项目状态

面板可见期间,状态每 15 秒自动探测一次;若设备反复探测失败,间隔会按 2 倍递增(最长 60 秒)退避,恢复后自动重置,逻辑见 ProjectInspectorModel.swift。同一项目的多个 Space 共享一份快照缓存,多个终端只探测一次。

几个值得注意的边界行为:

  • 当前版本面板是只读的——查看、覆盖 URL、Attach/Detach 都支持,但启动/停止容器与服务端日志将在后续版本到来;
  • 你做的所有微调(URL 覆盖、隐藏项、已挂载的容器/VM、关联主机、自定义项目根目录)按项目持久化保存在 herdrm 本地存储中;
  • 顶部菜单可 Change root… 手动固定项目根目录,Reset overrides 一键清空该项目的全部覆盖设置。

数据从哪来:一条 shell 探测脚本,隐私友好

面板背后是一次跑在目标设备上的 POSIX sh 探测(本地直接执行,远程走单条 ssh 命令),输出监听套接字、Docker Compose 项目与容器、systemd unit、项目文件和本地 VM 等结构化帧,协议定义见 ProjectProbeScript.swift。隐私上做了克制:.env 文件只读取变量名,值永不离开设备。

写在最后

herdrm 项目面板把「我的项目现在到底跑着什么」这个问题的答案压缩成一屏:热重载服务、Docker 容器、虚拟机与主机负载各有卡片,15 秒自动刷新,且所有偏好按项目记忆。如果你同时维护多个开发服务、容器和 VM,它就是 herdrm 侧边栏之外最值得关注的新面板。

核心源码入口:ProjectView.swift(面板总装配)、ProjectInspectorModel.swift(探测与缓存)、ProjectSnapshot.swift(数据模型)。

登录后查看全文
herdrm