【免费下载链接】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），仅供参考