Herdr 已更新但运行中的服务器仍是旧版本怎么排查server stop 与重启流程【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdr升级 Herdr 二进制后运行中的会话可能仍然由旧版本服务器驱动更新只替换了客户端可执行文件并不会替换一个已经启动且版本兼容的后台服务器。如果你升级后发现新功能没有生效、或客户端弹出了功能不可用的提示而不是断连就是遇到了这种情况。本文给出排查命令、判断依据以及用herdr server stop重启默认会话或herdr session stop重启命名会话的完整流程并说明重启会丢掉什么、如何验证服务器已经换上新版本。先确认问题客户端和服务器版本各是多少按 Troubleshooting 的建议从版本与会话状态入手herdr -V herdr statusherdr -V打印的是磁盘上已安装的二进制版本CLI reference 中也写作herdr --version。herdr status显示当前会话与服务器状态它还有herdr status server和herdr status client两个变体可以分别查看服务器侧和客户端侧的信息。判断依据来自 Install 的 Update 一节普通herdr update只安装新二进制endpoint-generation-1 的服务器及其 pane 进程会保持运行只影响客户端的改动重新打开 Herdr 后立刻生效新的服务器端功能在旧服务器停止并重启之前保持不可用此时客户端显示一条提示notice而不是断开连接。所以已更新但服务器仍是旧版本的典型现象是herdr -V是新版本但新发行版引入的服务器端功能用不了、客户端提示该动作不可用。socket 协议本身允许客户端与服务器构建不匹配——连接建立时双方协商编解码器服务器声明它支持的 API 方法缺少的方法只禁用对应动作并显示客户端本地提示见 Socket API 的 Protocol stability 一节。判断是否需要重启服务器先分清两类改动这决定你要不要动服务器只需要客户端改动不需要停服务器。重新运行herdr重新连接即可更新后的客户端会接上仍在运行的兼容服务器。需要本次发行版的服务器端改动先herdr status确认当前会话然后停止服务器再启动。另外注意endpoint-generation-1之前的旧服务器在更新时需要一次额外的最终停止见 Install。重启流程herdr server stop 与重新启动停止服务器会结束其所有 pane 进程这一点在操作前必须确认因为正在跑的 shell、测试、服务器进程都会随会话一起退出。默认会话herdr server stop herdrherdr server stop停掉默认会话的后台服务器随后运行herdr会启动新服务器并附上新的客户端 UI。这是 Troubleshooting 给出的标准流程。命名会话命名会话使用herdr session stop name其中name替换为你的会话名例如herdr session stop work如果需要在 CLI 中显式停止默认会话把会话名写成defaultherdr session stop default会话概念默认herdr命令附着到默认会话命名会话是独立的运行时命名空间见 Concepts。重启后哪些状态会回来按 Session state and restore服务器停止后重新启动属于Server restart场景恢复项结果原 pane 进程不会保留原进程已随服务器退出布局workspace、tab、pane、cwd、焦点从快照恢复最近的终端屏幕内容仅当启用 pane screen history默认关闭时恢复Agent 对话仅当该 agent 通过官方集成上报了原生会话引用时可经原生会话恢复也就是说重启后 pane 会以新 shell 的形式回到保存的目录。如果你不希望 pane 进程中断见下一节的 live handoff 可选路径。顺带区分一个容易混淆的操作ctrlb q只是分离客户端服务器和所有进程继续运行之后herdr重新附着即可——这不是重启服务器进程不会丢。可选分支不想停进程时用 live handoff如果必须让 pane 进程在服务器替换过程中继续运行可以使用实验性的 live handoffherdr update --handoff它的适用条件有限仅对由 Herdr 自身安装器管理的安装有效Homebrew、mise、Nix 安装走各自的包管理器更新herdr update在这些安装上被禁用无法执行 handoffhandoff 成功后保留 pane PTY 与进程、agent 身份等会话状态但跨替换边界的瞬态协调进行中的 CLI/API 请求、wait、订阅流、客户端 socket可能被中断客户端需要重连重试它是 opt-in 的实验功能不是常规连接路径见 Session state and restore 的 Live handoff 一节。对于包管理器安装流程是先用包管理器更新如brew install herdr、mise use -g herdr、nix profile upgrade等见 Install再运行herdr重连兼容的旧服务器会继续运行只有当你需要新版发行版的服务器端改动时才用herdr server stop或herdr session stop name重启它。验证服务器已换上新版本重启完成后再次执行herdr status确认状态中服务器已随新二进制启动并且此前不可用的服务器端动作现在可以正常调用——更新前客户端只是显示提示重启后这些动作应恢复可用。排查辅助诊断日志需要更多细节时日志默认位于~/.config/herdr/herdr.log herdr-client.log herdr-server.log设置HERDR_LOGherdrdebug可以提高日志详细度报告问题时附上当前日志及轮转后的同名文件。另外记录操作系统、外层终端名称与版本、会话是本地还是远程、是否涉及 tmux有助于定位问题。相关文档Troubleshooting本场景的原始排查条目Install更新机制、更新渠道与 handoff 适用条件CLI referencestatus、server、session命令清单Session state and restore停止/重启后各类状态的保留矩阵【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考