{{ tags.important.name }}WordPress内容合规检测插件

1. 功能概览

内容合规检测 是面向中文 WordPress 站点的广告法/行业敏感话术风险筛查辅助工具。它不会自动改稿，只做标记、报表和人工修改提示。

免费版与 PRO 版的关系：

• 免费版已包含日常文章、页面的完整检测流程；
• PRO 功能入口在免费版显示 PRO 标识，点击弹出升级说明，不会报错；
• PRO 通过 WP_ADLAW_CHECKER_PRO 常量或 wp_adlaw_is_pro 过滤器解锁；后端也会强制校验，免费版无法通过表单绕过 PRO 限制。
• 免费版与 PRO 版使用同一个插件目录 adlaw-checker/；PRO 安装包是已内置授权常量的独立构建，安装后自动解锁，安装其一即可，不要同时安装。

2. 词库体系

2.1 内置分类

内置 JSON：adlaw-checker/includes/data/builtin-words.json（7 分类、原始 694 条词源；插件默认只导入其中的高风险词 352 条）。

2.2 词条字段

• 敏感词文本
• 风险等级：高 / 中 / 低
• 备注
• 启用开关

2.3 分类与白名单

• 词库管理采用「分类目录 → 分类详情」流程：先在分类目录添加分类，再点击分类名称或「管理词汇」进入该分类添加、编辑词汇。
• 分类详情页支持修改分类名称与备注；分类创建后会自动进入新分类，可直接添加词汇。
• 分类支持启用/停用；停用后扫描不再读取该分类词汇。
• 内置分类默认只启用「通用广告法极限词分类」，其余内置分类默认停用；内置词库仅保留高风险词。
• 内置分类和用户自建分类均可删除，并同时删除该分类下所有词汇；删除内置分类后可通过「补齐内置词库」恢复。
• 白名单优先级最高：命中白名单的词/短语直接豁免，不写入风险记录。
• 分类 JSON、白名单 JSON 均支持导入/导出；导入时逐条校验并返回新增/跳过数量。

3. 扫描机制

3.1 扫描流程

1. 点击「开始全站扫描」→ AJAX 创建任务（记录执行人、总数、配置快照）。
2. 每批按「批大小」拉取文章/页面，调用本地词库检测。
3. 命中后按「文章 + 字段」合并为一条风险记录，取最高风险等级。
4. 进度条实时更新：已处理/总数、百分比、当前标题、新增风险数。
5. 支持 暂停 / 继续 / 终止；任务状态写入 adlaw_check_tasks。
6. 扫描范围字段：标题、正文、摘要；PRO 可扩展 WooCommerce、ACF、SEO、分类/标签描述。
7. 定时扫描（PRO）：在「设置 → 定时扫描」中开启，可设置每天或每周的执行时间；到点后自动创建全站扫描任务并分批处理。
8. WP-Cron 队列：免费版的「同时注册 WP-Cron 队列」仅用于继续未完成扫描，不会自动启动新的全站扫描。

3.2 风险记录与报表

• 字段：标题、内容类型、命中字段、命中来源、命中敏感词、风险等级、扫描时间、处理状态。
• 操作：编辑原文、重新检测本条、标记已处理、临时豁免本条（仅本条标记处理，不改全局词库）。
• 筛选：风险等级、处理状态、内容类型、关键词；分页 20 条/页。
• CSV 导出：UTF-8 BOM，Excel 打开中文不乱码。

3.3 扫描日志（已合并到全站扫描页）

• 任务 ID、执行人、开始/结束时间、处理进度、风险数、状态、配置快照（启用词库分类数、是否开启 API）。
• 支持查看任务报表、删除单条日志、清空全部日志。

4. 编辑器检测

• 支持 Gutenberg 与经典编辑器（通过 add_meta_box 注册「广告法合规检测」面板）。
• 点击「立即检测」调用 AJAX，返回标题/正文/摘要命中词、所属分类与风险等级；替换建议由 AI 按钮按上下文生成。
• Gutenberg 高亮：适配新版 Gutenberg 的 iframe 画布，命中词显示为红色 ，并随内容变化重新高亮。
• 保存文章时自动检测；严格拦截模式下，命中高风险词：
  • Gutenberg/REST：返回 WP_Error（HTTP 422），阻止发布；
  • 经典编辑器：wp_die 显示命中列表；
  • 草稿保存不受影响。
• 检测结果同时写入风险记录（来源标记为「编辑器实时检测」），可在报表中统一处理。

5. PRO：AI 智能替换建议

• PRO 专属功能，需自备服务商 API Key；支持 DeepSeek、通义千问（DashScope OpenAI 兼容模式）、豆包（火山方舟 Chat Completions）。
• 设置页独立配置：服务商、API Key（加密存储）、模型 / 豆包推理接入点 ID、请求超时、开启开关。
• 编辑器检测后点击「AI 智能建议」，将标题、正文/摘要与命中词发送给所选服务商，返回：
  • 原词 → 建议替换表达；
  • 简短理由（避免绝对化、避免疗效承诺等）。
• 风险报表每条记录也提供「AI 建议」按钮，按文章上下文生成建议。
• AI 只提供修改参考，不做违法判定；接口失败不影响本地扫描与检测，可继续人工修改。
• 请求端点/参数提供 wp_adlaw_ai_endpoint、wp_adlaw_ai_request_args 过滤器，便于代理或自定义网关。
• 内置网站内容不会主动上传；仅在用户点击 AI 建议时发送所选文章的标题/正文/摘要与命中词。

6. PRO：百度 / 阿里云内容安全 API

• 设置页选择服务商（单选）：阿里云内容安全 / 百度内容安全。
• 配置 AccessKey/SecretKey、地域、场景标识、超时时间、风险等级阈值。
• 密钥使用 wp_salt('auth') 派生 AES-256-CBC 加密后存入 options，页面不回显明文。
• 「测试连接」AJAX 校验密钥；失败不影响本地词库扫描。
• API 与本地词库结果双通道合并：分别标记来源（本地词库 / 阿里云 API / 百度 API），按来源展示。
• 阿里云使用 ACS3-HMAC-SHA256 签名调用 TextModeration；百度使用 OAuth access_token + text_censor 接口。
• 已提供 mock HTTP 测试，验证请求签名构造、响应解析和失败降级。

说明：两家 API 的产品版本、地域和返回字段可能不同，代码已提供 wp_adlaw_aliyun_endpoint、wp_adlaw_baidu_endpoint、wp_adlaw_api_audit_result 等过滤器，方便按实际账号适配。

7. 数据存储

数据表（前缀自动读取 $wpdb->prefix）：

• 通用配置：wp_adlaw_checker_settings（options，前缀 wp_adlaw_checker_）。
• 卸载：默认保留数据；勾选「卸载时删除全部数据」后执行 uninstall.php，删除数据表与 options。

8. 安全与权限

• 主权限：manage_options；可开启「编辑角色只读查看」：
  • 编辑角色可查看仪表盘/扫描报表/日志/PRO 页；
  • 不能访问词库管理、设置，不能执行扫描或修改数据；
  • AJAX 端点仍强制权限校验。
• 所有后台表单/链接使用 wp_nonce_field() / wp_nonce_url()；AJAX 使用 check_ajax_referer()。
• 数据库查询使用 $wpdb->prepare()；表名来自内部常量。
• 输出使用 esc_html / esc_attr / esc_url；静态 SVG 输出使用受控图标函数。
• 文件导入限制 2MB，JSON 解析失败返回详细错误。
• 前端不输出任何检测标记，所有功能仅限后台授权用户。

安装与使用

1. 在「插件 → 安装插件 → 上传插件」选择对应版本：
   • 免费版上传 adlaw-checker-free-1.7.6.zip；
   • PRO 版上传 adlaw-checker-pro-1.7.6.zip（需已获得 PRO 授权）。
   • 两者插件目录均为 adlaw-checker/，安装其中一个即可；升级到 PRO 或回退免费版时直接覆盖安装，现有数据、词库和设置会保留。
2. 激活后插件自动建表，并写入 7 个内置分类；默认只启用「通用广告法极限词分类」，其余内置分类默认停用，内置词库只导入 352 条高风险词汇。
3. 后台左侧菜单「内容检测」：
   • 仪表盘：扫描统计、风险进度、最近风险、快捷操作、免责声明。
   • 全站扫描：开始异步扫描，进度条、暂停/继续/终止、风险报表、筛选、分页、CSV 导出。
   • 词库管理：分类目录、分类详情词汇管理、白名单、JSON 导入导出。
   • 扫描任务日志：已合并到「全站扫描」页面下方，可查看任务历史、配置快照、报表、删除/清空。
   • 设置：扫描范围、词库、编辑器、AI 与 API、定时扫描（PRO）、性能、权限与数据清理。
   • 升级 PRO：功能对比、FAQ、升级入口。
4. 在「设置 → 词库管理」按站点行业停用不需要的行业分类，减少误报。
5. 在「设置 → 编辑器检测」选择提醒模式或严格拦截模式。

1.7.6 — 2026-10-28 正式发布公告

本次更新已合并今日全部改动，重点如下：

命名与品牌调整

• 插件显示名称统一为「内容合规检测」，后台左侧菜单名称调整为「内容检测」。

• 后台菜单、页脚、PRO 页面标题及免责声明标题同步更新；插件作者与版权归属更新为 SEOGW。

PRO 新增定时扫描

• PRO 版新增「定时扫描」，支持按每天或每周固定时间自动启动全站扫描。

• 扫描任务在后台分批执行，完成后可在风险报表与扫描任务日志中查看。

• 免费版 WP-Cron 队列不再自动创建新扫描任务，仅用于继续未完成任务。

PRO 升级页重设计

• 重新设计 PRO 升级页，补充价值说明、免费/PRO 方案卡、PRO 能力场景卡、分组对比表及用户视角 FAQ。

• 对比表整列高亮 PRO，免费版不支持项改为红色 X，并清理重复说明、优化页面间距。

问题修复

• 修复重复扫描后仪表盘「最近风险」与全站扫描「风险报表」重复叠加显示的问题。

• 报表按「页面 + 命中字段」取最新记录，仪表盘风险统计同步按去重后的记录计算。