HOL Guard故障排查手册:如何用hol-guard doctor快速诊断与恢复扩展控制

发布时间:2026/10/23 7:19:10

HOL Guard故障排查手册:如何用hol-guard doctor快速诊断与恢复扩展控制 【免费下载链接】hol-guardOpen-source antivirus for AI agents: block risky tools, secret access, prompt injection, malicious packages, MCP servers, plugins, and skills at runtime.项目地址https://gitcode.com/gh_mirrors/ho/hol-guard点击查看免费下载先搞懂 doctor 是什么hol-guard doctor是开源 AI 智能体杀毒工具 HOL Guard 内置的一键诊断命令。当 AI Agent如 Codex、Claude Code 等 harness出现工具被拦截、hook 注册失败、daemon 掉线、扩展控制降级等问题时doctor会在本地做一次只读体检把每个组件的健康状态、原因码和修复建议一次性打印出来是排查 Guard 问题的第一站。它遵循先看后修原则默认诊断不改动任何状态确认问题后才用--repair执行幂等修复。核心诊断逻辑见 doctor_readiness.py 与 commands_dispatch_admin.py命令参数定义在 commands_parser_policy.py。doctor 常用命令速查清单命令用途hol-guard doctor自动检测本机所有 harness 并全局体检hol-guard doctor codex只诊断指定 harness如 codex、claudehol-guard doctor --json输出机器可读 JSON便于脚本分析hol-guard doctor --repair诊断并修复常见问题等价别名--fixhol-guard doctor codex --incident导出有界的离线事故报告hol-guard doctor --harnesses列出所有受支持的 harness 及其保护契约hol-guard doctor --perf附加检测器性能计时排查卡顿hol-guard settings doctor专门诊断 Guard 本地配置hol-guard repair完整修复引擎覆盖更多修复步骤 建议按检查 → 修复 → 复查三步走先hol-guard doctor harness定位原因码再运行hol-guard doctor --repair最后重跑一次 doctor 确认protection_in_effect恢复为生效状态。读懂 doctor 诊断输出的关键字段doctor的输出不是一堆散乱日志而是结构化的健康清单重点看下面几组字段1️⃣setup_status与runtime_readinesshook 是否真的在工作状态 / 原因码含义下一步setup_status: brokenGuard 注册损坏保存报告后执行doctor --repairhook_registration_unconfirmed注册不完整或缺失重新执行安装注册harness_probe_timed_out/harness_probe_failedharness 探测超时或失败检查 daemon 日志与探测项hook_evaluation_unverified注册存在但未验证到真实拦截决策注册检查不等于运行时就绪需进一步验证2️⃣package_shimsnpm/pip 等包管理器拦截是否在线doctor 会检查各包管理器的 shim 完整性问题类型包括package_shim_integrity缺失/过期/被篡改和package_shim_pathshim 目录不在 PATH 中。修复提示统一指向运行hol-guard doctor --repair重新生成 shim若 PATH 有变化再打开一个新终端验证。3️⃣native_runtime/daemon_http本地原生运行时与 daemon分别反映原生运行时可用性和本地 daemon HTTP 服务状态。native_runtime缺失时doctor --repair会尝试自动补齐。4️⃣trust与protection_in_effecttrust汇总本地信任链健康度protection_in_effect是最终结论——只有当被检查的 harness 注册完好且防护策略确实在执行时才报告为生效。如果 doctor 报告注册损坏这个字段不会假装保护在线fail-closed 设计。完整命令对照与排障入口可参考官方上手指南 get-started.md。一键修复doctor --repair 与 hol-guard repairdoctor --repair与独立的hol-guard repair共享同一个修复引擎 repair_engine.py后者额外包含两类守护进程自愈步骤。每个步骤相互隔离单步失败不会中断其余步骤daemon— 本地 daemon 不健康时自动重启native_runtime— 清理死掉的resident-v3-*目录和残留 socketfail-closedonefile_leaks— 回收泄漏的_MEI*临时解压目录hooks— 重新校验各 harness 的托管 hook重装损坏项package_shims/command_queue— 与doctor --repair相同的 shim 与队列修复⚠️ 注意修复步骤需要用户在场并经过与doctor --repair相同的认证step-up不是无人值守操作。扩展控制中心权威降级与恢复流程HOL Guard 的扩展控制中心Protection Center 背后的本地安全子系统通过签名权威authority管理每个保护模块的 allow/block 策略。当权威状态异常时终端会提示 native extension-control authority could not be verified。恢复流程官方文档见 extension-control-recovery.md实现代码见 extension_controls_commands.py。首次注册新环境hol-guard command controls enroll按提示输入审批因子并确认ENROLL EXTENSION CONTROL local-admin。已有健康 daemon 也能直接注册无需提前停服。权威过期或中断最常见的降级场景hol-guard command controls recover-authority恢复要求新鲜审批若配置了 TOTP 验证器必须使用比本会话上次更新的验证码。恢复会保留可验证的控制、归档无法验证的本地策略行并重建空权威然后自动把新权威交给运行中的 daemon。恢复后复查hol-guard command controls status注意status需要 daemon 在线恢复响应描述的是本地控制权威不代表所有子系统的运行时就绪离线 daemon 要先启动再查。 千万不要做的操作不要删除command-control-authority*、policy-verifier.key或原生快照/回滚地板rollback-floor文件。删除这些文件会毁掉恢复证据官方文档明确这不是受支持的恢复手段。若恢复无法认证保留状态应停止对应 daemon、恢复原始 keyring 或本地 vault 材料后重试。常见问题快查表Symptom → Action症状第一步然后尝试Guard 没检测到我的 harnesshol-guard detect --jsonhol-guard doctor harness --json查看适配层警告拦截/放行行为异常hol-guard doctor harness看runtime_readiness原因码再--repairnpm/pip 安装没被拦截hol-guard doctor查package_shimsdoctor --repair后开新终端重试daemon 掉线、状态未知hol-guard statushol-guard repair含 daemon 重启步骤扩展控制提示权威无法验证hol-guard command controls statusrecover-authority需新鲜 TOTPdoctor codex --incident导出报告保留报告供审计报告本身只读、有界不改变任何状态总结三句话记住排障路径诊断先于修改hol-guard doctor harness是只读体检先拿原因码再动手修复有幂等保证doctor --repair/hol-guard repair每步隔离、可重复执行扩展控制恢复走认证通道recover-authority 新鲜验证器永不手删权威文件。更多语义细节可阅读架构决策记录 0004-extension-control-center-semantics.md 与保护中心说明 protection-center.md。掌握doctor与扩展控制恢复这两条主线绝大多数 HOL Guard 运行时故障都能在本地闭环解决。赞分享【免费下载链接】hol-guardOpen-source antivirus for AI agents: block risky tools, secret access, prompt injection, malicious packages, MCP servers, plugins, and skills at runtime.项目地址https://gitcode.com/gh_mirrors/ho/hol-guard点击查看免费下载相关推荐如何用Similarities工具包实现高效文本与图片相似度计算超实用教程来了如何用Similarities工具包实现高效文本与图片相似度计算超实用教程来了 Similarities是一款功能强大的相似度计算与语义搜索工具包支持文本云原生Scenario Skills 故障排查完全手册403、429、400等常见错误的快速诊断与恢复方案Scenario Skills 故障排查完全手册403、429、400等常见错误的快速诊断与恢复方案 Scenario Skills 是一套教 AI 编码代理Motion2MixamoRig错误排查手册doctor命令诊断清单与CUDA、MPS故障一次搞定Motion2MixamoRig错误排查手册doctor命令诊断清单与CUDA、MPS故障一次搞定 Motion2MixamoRig 是一个把视频或照片中的人人工智能AI 应用计算机视觉3D渲染图形学上一篇攻克Fluxxor开发痛点10个核心问题解决方案与实战指南下一篇stable-diffusion.cpp 容器化实战Docker 构建、CLI 与 Server 运行全指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/10/23 7:19:10

Shell脚本三种循环全解析:for、while、until实战避坑指南

如果你和我一样,每天都在和各种运维脚本、部署脚本打交道,你会发现一件事:真正让脚本从“能跑”变成“靠谱”的,往往不是某个冷门命令,而是循环。for、while、until 这三个循环结构,几乎撑起了 Shell 自动化…

2026/10/23 7:19:10

TCP粘包彻底解决:双缓冲区拆包器设计与C语言工程实现

粘包这个话题,前一篇里我聊过成因,也对比过定长包、分隔符、长度域几种常见拆包思路。今天这篇专门讲双缓冲区解决粘包——名字听起来基础,但实际工程里反而是最容易出bug、也最值得掰开揉碎讲透的部分。简单说,TCP给应用层的只有…

2026/10/23 7:14:10

内网离线安装deb包:APT本地仓库构建与依赖排错

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/23 9:24:36

声音肌肉训练:8类演播场景的声学参数化训练法

简介:本资源是面向声音创作者、配音初学者及演播进阶学习者的专业练习素材合集,源自喜马拉雅大学体系,聚焦朗读表达、角色塑造与情绪张力等核心能力训练。PDF文档整合了历史、悬疑、恐怖、奇幻、经管、都市、言情、儿童共八大类演播练习文本链…

2026/10/23 9:24:36

Redis集群搭建实战:Ubuntu 16.04单机与集群环境配置及投票后端验证

简介:本资源为南京邮电大学大数据存储与管理课程实验一的完整报告文档,面向大数据、云计算方向的学生及Redis初学者,帮助读者在Ubuntu环境下完成Redis单机与集群的安装配置,并动手实现一个文章投票网站后端。压缩包内仅含1个doc文…

2026/10/23 9:24:36

发卡网源码核心逻辑与自动发货部署实战解析

简介:最新发卡系统网站源码是一套修复版发卡网完整源代码,面向需要搭建虚拟商品自动售卖平台的运营者,以及想学习PHP商城开发的工程师。系统覆盖商品管理、订单处理、支付集成、用户管理和安全防护等核心模块,并通过定时脚本清理过…

2026/10/23 9:24:36

VMware 虚拟机安装 Ubuntu 搭建 ROS 开发环境完整教程与避坑指南

简介:这份PDF教程面向ROS机器人开发的入门学习者,聚焦机器人学习环境搭建中最基础也最容易踩坑的一环——Ubuntu系统的安装。内容从Ubuntu镜像的下载与位数选择讲起,逐步延伸到虚拟机软件的安装配置、虚拟机创建与参数设置、Ubuntu镜像加载与…

2026/10/23 9:24:36

PLC标准化编程实战:从架构设计到IO映射的八步法

简介:这份PDF资料面向工业自动化工程师与PLC编程学习者,聚焦S7-1200/S7-1500平台的标准化编程方法与设计,帮助解决程序严谨性差、可复制性低、技术提升难等常见痛点。内容围绕程序结构规划、变量命名规则、设备对象分解与状态模型构建展开&am…

2026/10/23 9:19:34

RISC-V AI全栈软件生态构建与优化实践

1. RISC-V与AI全栈软件生态的现状与挑战RISC-V作为开放指令集架构,近年来在AI领域展现出独特优势。与传统x86和ARM架构相比,RISC-V的模块化设计允许开发者根据AI工作负载特点定制指令集,这种灵活性为AI加速提供了新的可能性。但在实际落地过程…

2026/10/22 11:29:28

金融AI落地指南:从调研报告到技术选型与工程实践

简介:这份PDF报告聚焦2025年金融服务业中国AI现状与趋势,面向金融科技从业者、AI战略规划人员及关注行业数字化转型的研究者,帮助读者把握生成式AI在银行、支付、交易等场景中的落地路径与投资方向。资源包内含1个PDF文件,大小约1…

2026/10/23 0:02:26

Verilog实现FPGA密码锁:矩阵键盘与状态机设计实战

说实话,这几年接触了不少想入门FPGA的朋友,如果你问哪个项目能一口气把Verilog的核心基本功串起来,我通常会推荐电子密码锁。这个项目看着不起眼,却把矩阵键盘扫描、按键消抖、状态机设计、动态显示刷新、外设控制这些数字逻辑里的…

2026/10/23 0:02:26

数据服务监控运维实战:从指标体系到告警治理与故障排查

周末凌晨两点,手机震了。第一反应是“数据服务挂了”。打开电脑看了下,果然,某张核心报表的数据产出时间已经超过SLA两小时,下游三个业务方连着发来问询。这种场景,做过大数据运维的人都不会陌生。数据服务的监控与运维…

2026/10/23 0:02:26

FreeRTOS任务通知实战详解:内核原理、API与避坑指南

裸机编程切到RTOS之后,任务之间的通信和同步永远是躲不开的坎。前面聊过队列、信号量、互斥锁、事件组,这次把FreeRTOS任务通知(Task Notification)单独拎出来讲透。原因很简单:任务通知是FreeRTOS里最容易用错、也最容…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑