核心用法
AdGuard Home Skill 是一套面向自托管 DNS 服务器的管理工具集，专为需要精细化控制网络级广告拦截的技术用户设计。该技能通过调用 AdGuard Home 的 RESTful API，实现从状态监控到规则配置的完整管理能力。
部署与配置：用户需在 VPS 或家庭服务器上安装 AdGuard Home，创建专用 API 用户后，通过三个环境变量（ADGUARD_USERNAME、ADGUARD_PASSWORD、ADGUARD_BASE_URL）完成认证配置。技能支持 HTTP 与 HTTPS 双协议端点，但强烈建议生产环境使用 HTTPS 确保凭证安全。
功能矩阵：涵盖八大核心操作——状态查询（status）、统计报表（stats）、阻断域名排行（blocked_domains）、规则增删（add_rule/remove_rule）、规则列表（list_rules）、DNS 查询日志（query_log）以及过滤开关（toggle_filtering）。时间维度支持小时/日/周/月/年多级统计，规则管理兼容 AdGuard 原生语法（如 ||example.com^ 阻断语法与 @||example.com^ 白名单语法）。
显著优点
企业级安全架构：代码通过六维深度扫描（静态分析 95 分、动态分析 98 分、依赖审计满分），无危险函数调用、无硬编码密钥、无第三方依赖包，仅依赖系统级 curl 与 jq 工具，供应链攻击面趋近于零。
隐私优先设计：所有网络请求定向至用户自托管的私有端点，零第三方 API 调用，数据不出境。认证采用环境变量注入，符合 GDPR 数据最小化原则与 CCPA 用户知情权规范。
运维效率提升：将原本需登录 Web 面板的多步操作压缩为单行命令，支持批量规则管理与程序化运维。查询日志功能可快速定位异常 DNS 解析，辅助网络安全审计。
潜在局限
协议安全依赖用户配置：虽然技能本身安全，但 HTTP Basic Auth 的 Base64 编码凭证在 HTTP 明文传输下存在截获风险，安全性高度依赖用户是否正确配置 HTTPS。
功能边界限定：仅支持管理已部署的 AdGuard Home 实例，不包含 DNS 服务器本身的安装、初始化或网络层配置（如 DHCP 分配、路由器 DNS 指）。
输入验证可加强：当前规则添加操作未对特殊字符进行严格过滤，存在潜在的注入风险（尽管 AdGuard Home API 本身具备一定防护）。
目标用户群体
- 家庭网络管理员：需在路由器层面对全家设备统一去广告的技术爱好者
- 小微企业 IT 运维：寻求轻量级、零成本的内网 DNS 安全解决方案
- VPS 自建服务用户：已部署 AdGuard Home 的云端/边缘节点管理者
- 网络安全从业者：需要程序化审计 DNS 流量与阻断日志的专业人员
常规使用风险
性能层面：高频调用 query_log 大数量级查询可能对 AdGuard Home 服务器造成 IO 压力，建议合理设置查询上限。stats 接口的聚合计算在超大规模网络（万级设备）下响应延迟可能增加。
依赖层面：依赖系统预装的 curl（≥7.50 建议版本支持 HTTP/2）与 jq 解析器，极简容器环境需额外确认工具链完整性。
配置风险：环境变量明文存储于 Shell 会话存在泄露可能，建议配合 pass 或 vault 等密钥管理工具使用。密码复杂度不足可能导致暴力破解，需确保 AdGuard Home 用户密码符合强密码策略。
升级兼容性：AdGuard Home 主版本 API 变更可能导致技能部分功能失效，建议关注上游版本发布说明。