Nvirya AdGuard v11.7.0
Ctrl K

问题反馈与报告

当遇到漏拦广告、页面布局异常或视频播放器故障时，提交问题反馈可以帮助维护者快速复现并修复问题，无需您具备 HTML 或 JavaScript 编程经验。

选择正确的反馈渠道#

Nvirya AdGuard 在 关于 → 社区与支持 中提供了内置反馈与联系入口：

您的需求操作入口响应方式
报告 Bug (漏拦广告、页面布局异常、视频播放问题、误拦截、页面卡顿)在 关于 → 社区与支持 中点按反馈，选择漏拦广告、页面布局异常、视频播放问题或其他向维护者的 Discord Webhook 发送单向诊断报告；不会开启实时对话
提出功能建议点按反馈并选择功能建议仅发送您的建议文本、脚本版本（v11.7.0）与设备平台类别（iOS / iPadOS 或 Android / Desktop）
一般咨询或需要双向交流协助点按 关于 → 社区与支持 中的 Telegram（https://t.me/nvirya）或 Discord打开社区或作者直接联系渠道，可获得双向回复

发送频率限制： 为防止误触重复提交，内置发送反馈功能对每个域名设有 30 秒冷却时间（nvirya_x_last_report）。如果在 30 秒内对同一网站再次提交，会提示：请等待 {sec} 秒后再发送。

Bug 报告会收集哪些数据？#

当您在发送反馈弹窗中选择漏拦广告、页面布局异常、视频播放问题或其他并点按提交时，submitReport() 会构造 JSON 负载并通过 HTTP POST（GM_xmlhttpRequest 或 fetch）发送至脚本配置的 Discord Webhook。

每份 Bug 报告仅包含以下确切字段：

  1. 网站域名（Domain）： 当前页面的 location.hostname（例如 news.example.com）。
  2. 脚本版本（Phiên bản / Version）： v11.7.0。
  3. 所选问题分类（Lý do / Reason）： Missed ad、Broken layout、Player issue 或 Other。
  4. 脱敏后的页面 URL（URL (Sanitized)）： 由 getSanitizedUrl() 生成（最长截断至 1,000 个字符）：
    • 完全移除 URL 末尾的 #hash 锚点片段。
    • 扫描所有 URL 查询参数键名（?key=value）。凡是参数名匹配 /auth|token|session|key|pass|code|secret|credential|email|user/i 的参数，其值均会被替换为 [REDACTED]。
  5. 可选用户备注（Ghi chú / Note）： 您在详情（可选）：输入框中填写的文本（最长 1,000 个字符），留空则为 (Không có)。
  6. 拦截统计计数：
    • Session（本次会话）： stats.session.ads、stats.session.hidden 与 stats.session.popups。
    • Lifetime（累计）： stats.lifetime.ads 与 stats.lifetime.hidden。
  7. 最近过滤日志： 内存环形缓冲区 logRing 中的最后 4 条记录（[LEVEL] type: message extra，最长 900 个字符）。
  8. 浏览器 User-Agent： 浏览器的 navigator.userAgent 字符串（最长截断至 200 个字符），用于判断问题发生在哪个浏览器与操作系统版本上。

提交“功能建议”时发送的数据#

当您选择功能建议（Feature request）时，必须填写说明文本（若为空会提示 请先填写简要说明）。脚本仅发送：

  • 您的建议文本（最长 1,000 个字符）
  • 脚本版本（v11.7.0）
  • 设备平台类别（iOS / iPadOS 或 Android / Desktop）

功能建议模式不会发送当前网站域名、页面 URL、拦截统计、日志或完整 User-Agent。

隐私边界：提交前请留意#

Nvirya AdGuard 不会夸大或作出不切实际的匿名承诺：

  • Webhook 传输通道： 反馈报告通过 HTTPS 发送至项目配置的 Discord Webhook，这意味着报告数据会经过 Discord 的基础设施（discord.com / discordapp.com）处理。
  • 自动 URL 脱敏的局限性： 虽然 getSanitizedUrl() 会自动遮蔽参数名包含 token、session、auth、key、pass、code、secret、email 或 user 的查询参数值，但它无法识别网站是否将私人标识符直接嵌入在 URL 路径中（例如 https://example.com/account/orders/987654），也无法识别非标准查询参数名（如 ?id=12345）。

在点按提交 Bug 报告之前：

  1. 请检查您当前是否正处于已登录的个人账户页、私密文档链接或企业内网门户。如果 URL 路径本身包含敏感信息，请勿在该页面直接提交自动报告。
  2. 请勿在详情（可选）：输入框中粘贴密码、会话 Cookie、个人联系方式或私有令牌。

手动查看诊断信息（复制诊断信息）#

如果您希望在分享前自行查看完整的诊断内容，请打开 关于 → 诊断 → 复制诊断信息（“复制系统和过滤日志到剪贴板”）。这会将 collectDebugInfo() 生成的纯文本摘要复制到剪贴板，方便您在发送到 Telegram 或 Discord 之前自行检查或删减。