Herdr 远程 manifest 热更新不重启升级代理检测规则的完整指南【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdrHerdr是一个让编码代理coding agents并行常驻的终端运行时。它的代理检测规则以 TOML 格式的检测 manifest 交付并支持远程 manifest 热更新规则文件更新后正在运行的 Herdr 服务器会自动拉取、校验并热重载进内存缓存全程无需重启进程也不会打断任何一个正在工作的代理窗格。什么是检测 manifest三层来源与优先级检测 manifest 是一组按代理codex、claude、cursor 等组织的 TOML 规则文件例如 codex.toml 通过正则与关键词匹配来判断该代理当前处于idle、working还是blocked。Herdr 对每个代理按固定优先级选取一份生效 manifest本地覆盖最高优先级~/.config/herdr/agent-detection/agent.toml远程 manifest缓存在状态目录只有其版本不低于内置版本时才生效内置 manifest编译进二进制文件的兜底规则见 manifest.rs 中打包的 20 份清单这种优先级设计意味着远程热更新永远不会覆盖你的本地定制远程清单只负责修补 Herdr 已认识的代理的检测规则新增全新代理仍需要更新 Herdr 本身。后台自动热更新30 分钟轮询 原子提交运行中的服务器在启动时会把生效的 manifest 载入内存。之后Herdr 每隔30 分钟自动向远程目录默认目录清单为herdr.dev/agent-detection/index.toml仓库内对应 index.toml发起检查流程如下逐个下载每个代理的 manifest与本地缓存做版本号比较仅当远程版本更高时才以原子写入提交到状态目录~/.local/state/herdr/agent-detection/remote/提交成功后立即触发AgentDetectionManifestsUpdated事件重新加载受影响代理的内存缓存——新规则即刻生效单个代理更新失败不影响其他代理也不会错误地重载失败者的缓存整个拉取与提交逻辑位于 manifest_update.rs内存缓存的定向热重载实现在 manifest.rs。手动热更新命令立即拉取并验证等不了 30 分钟三个命令覆盖全部手动场景详见 cli-reference.mdx命令作用herdr server update-agent-manifests立即拉取远程 manifest 更新热重载进运行中的服务器并打印更新后状态herdr server agent-manifests查看当前生效的 manifest 来源bundled / remote / local override、缓存的远程版本与最近一次更新结果herdr server reload-agent-manifests手动编辑本地覆盖文件后把文件重新加载进内存缓存以上命令由 server.rs 中的 CLI 入口实现。手动更新走的是与后台轮询完全相同的校验路径行为一致。安全与可靠性为什么可以放心热更新热更新机制内置了多层防御实现见 process_agent_manifest⛔拒绝降级远程版本号低于本地缓存时直接丢弃防止规则被回滚⛔拒绝暗改版本号相同但内容不同说明上游发布流程出错同样拒绝⛔引擎兼容校验manifest 声明的min_engine_version高于当前引擎时不会加载️结构校验规则数量、门控深度等复杂度上限防止病态清单拖垮检测原子写入先写临时文件再改名落盘任何时刻都不会出现半损坏的 manifest网络限制单次拉取上限 256 KB连接超时 5 秒、总超时 15 秒、自动重试 2 次调试用 explain 查看规则是否已生效怀疑某个窗格状态不对用下面的命令让运行中的服务器评估一次并给出完整证据链herdr agent explain target输出包含最终状态、manifest 来源bundled / remote / local override、manifest 版本、缓存的远程版本、匹配的规则 id 与每条规则的匹配器证据、远程更新状态等方便快速判断是新规则没拉下来还是本地覆盖把远程遮蔽了。常见问题 如何关闭后台 manifest 检查在配置中设置[update] manifest_check false即可禁用后台远程检查手动命令仍可正常使用。 如何用自己的规则集测试设置环境变量HERDR_AGENT_DETECTION_MANIFEST_CATALOG_URL指向自定义目录清单地址Herdr 就会从你的地址拉取 manifest——这是开发自定义检测规则时的标准做法。 远程 manifest 能新增一个全新代理吗不能。远程清单只修补 Herdr 已经认识并会识别进程的代理的规则全新代理需要更新 Herdr 二进制以获得进程检测、标签与集成行为。总结Herdr 的远程 manifest 热更新把升级检测规则从重启应用中解耦出来后台 30 分钟轮询保证新规则静默生效版本比较 原子提交 引擎兼容校验保证过程安全herdr server update-agent-manifests等命令则随时提供手动控制。对于同时盯着 5 个、10 个编码代理的你来说这意味着规则修复永远不会以打断任何一次会话为代价。【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Herdr 远程 manifest 热更新：不重启升级代理检测规则的完整指南
Herdr 远程 manifest 热更新不重启升级代理检测规则的完整指南【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdrHerdr是一个让编码代理coding agents并行常驻的终端运行时。它的代理检测规则以 TOML 格式的检测 manifest 交付并支持远程 manifest 热更新规则文件更新后正在运行的 Herdr 服务器会自动拉取、校验并热重载进内存缓存全程无需重启进程也不会打断任何一个正在工作的代理窗格。什么是检测 manifest三层来源与优先级检测 manifest 是一组按代理codex、claude、cursor 等组织的 TOML 规则文件例如 codex.toml 通过正则与关键词匹配来判断该代理当前处于idle、working还是blocked。Herdr 对每个代理按固定优先级选取一份生效 manifest本地覆盖最高优先级~/.config/herdr/agent-detection/agent.toml远程 manifest缓存在状态目录只有其版本不低于内置版本时才生效内置 manifest编译进二进制文件的兜底规则见 manifest.rs 中打包的 20 份清单这种优先级设计意味着远程热更新永远不会覆盖你的本地定制远程清单只负责修补 Herdr 已认识的代理的检测规则新增全新代理仍需要更新 Herdr 本身。后台自动热更新30 分钟轮询 原子提交运行中的服务器在启动时会把生效的 manifest 载入内存。之后Herdr 每隔30 分钟自动向远程目录默认目录清单为herdr.dev/agent-detection/index.toml仓库内对应 index.toml发起检查流程如下逐个下载每个代理的 manifest与本地缓存做版本号比较仅当远程版本更高时才以原子写入提交到状态目录~/.local/state/herdr/agent-detection/remote/提交成功后立即触发AgentDetectionManifestsUpdated事件重新加载受影响代理的内存缓存——新规则即刻生效单个代理更新失败不影响其他代理也不会错误地重载失败者的缓存整个拉取与提交逻辑位于 manifest_update.rs内存缓存的定向热重载实现在 manifest.rs。手动热更新命令立即拉取并验证等不了 30 分钟三个命令覆盖全部手动场景详见 cli-reference.mdx命令作用herdr server update-agent-manifests立即拉取远程 manifest 更新热重载进运行中的服务器并打印更新后状态herdr server agent-manifests查看当前生效的 manifest 来源bundled / remote / local override、缓存的远程版本与最近一次更新结果herdr server reload-agent-manifests手动编辑本地覆盖文件后把文件重新加载进内存缓存以上命令由 server.rs 中的 CLI 入口实现。手动更新走的是与后台轮询完全相同的校验路径行为一致。安全与可靠性为什么可以放心热更新热更新机制内置了多层防御实现见 process_agent_manifest⛔拒绝降级远程版本号低于本地缓存时直接丢弃防止规则被回滚⛔拒绝暗改版本号相同但内容不同说明上游发布流程出错同样拒绝⛔引擎兼容校验manifest 声明的min_engine_version高于当前引擎时不会加载️结构校验规则数量、门控深度等复杂度上限防止病态清单拖垮检测原子写入先写临时文件再改名落盘任何时刻都不会出现半损坏的 manifest网络限制单次拉取上限 256 KB连接超时 5 秒、总超时 15 秒、自动重试 2 次调试用 explain 查看规则是否已生效怀疑某个窗格状态不对用下面的命令让运行中的服务器评估一次并给出完整证据链herdr agent explain target输出包含最终状态、manifest 来源bundled / remote / local override、manifest 版本、缓存的远程版本、匹配的规则 id 与每条规则的匹配器证据、远程更新状态等方便快速判断是新规则没拉下来还是本地覆盖把远程遮蔽了。常见问题 如何关闭后台 manifest 检查在配置中设置[update] manifest_check false即可禁用后台远程检查手动命令仍可正常使用。 如何用自己的规则集测试设置环境变量HERDR_AGENT_DETECTION_MANIFEST_CATALOG_URL指向自定义目录清单地址Herdr 就会从你的地址拉取 manifest——这是开发自定义检测规则时的标准做法。 远程 manifest 能新增一个全新代理吗不能。远程清单只修补 Herdr 已经认识并会识别进程的代理的规则全新代理需要更新 Herdr 二进制以获得进程检测、标签与集成行为。总结Herdr 的远程 manifest 热更新把升级检测规则从重启应用中解耦出来后台 30 分钟轮询保证新规则静默生效版本比较 原子提交 引擎兼容校验保证过程安全herdr server update-agent-manifests等命令则随时提供手动控制。对于同时盯着 5 个、10 个编码代理的你来说这意味着规则修复永远不会以打断任何一次会话为代价。【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考