用途：在安装、更新、配置或排查 Herdr 时使用，包括命令缺失、PATH 错误、版本差异以及 Pi 集成设置。核心原则是以已安装的二进制为事实来源，不假设其他版本存在的命令或参数。
主要能力与用法：先检查现状，运行 command -v herdr、herdr --version、herdr --help、herdr integration status。若 herdr 不存在，说明其支持 Linux 和 macOS；Windows 有原生预览安装器，仅在原生预览不适用时使用 WSL。运行上游安装器前需询问用户：irm https://herdr.dev/install.ps1 | iex 或 curl -fsSL https://herdr.dev/install.sh | sh。安装后若 PATH 未刷新，启动新 shell 再运行 herdr --version。
Pi 集成：改动前先查看 herdr integration status，仅在用户要求时安装或更新：herdr integration install pi。用 herdr integration status --outdated-only 识别过期集成，未经确认不要移除集成。
更新与配置：仅在用户要求更新时使用 herdr update。编辑配置前用 herdr --default-config 查看默认值。HERDR_CONFIG_PATH、HERDR_SESSION、HERDR_SOCKET_PATH 视为显式覆盖，排查异常目标或会话前先报告其值。
命令或版本不匹配：遇到未知命令或未知参数错误后停止猜测，运行 herdr --help，再对已知命令组运行 <known-group> --help 查看已安装命令树；阅读上游文档回退，尽量选择已安装版本对应的文档。若已安装帮助与对应版本文档不一致，以已安装帮助为准并报告差异。
安全：herdr server stop、session stop、session delete 以及 workspace/tab/pane close 会影响正在运行的工作，先列出或检查状态，运行前请求确认。