一键调试模式插件 v2.0.0 使用说明书

📦 插件基础信息

🚀 安装启用

1. 将zibll-debug-mode文件夹上传至/wp-content/plugins/目录
2. WP 后台 – 插件列表，找到「一键调试模式」点击启用
3. 启用后后台左侧自动生成「一键调试」独立菜单

🎯 快速开启调试

1. 进入一键调试 – 仪表盘
2. 点击「一键开启调试」
3. 确认即可启用推荐调试配置

📋 核心功能详解

仪表盘

• 实时展示 5 大调试常量运行状态
• 支持一键开启 / 关闭全局调试
• 可单独手动控制每项调试开关

• WP_DEBUG：主调试开关，展示所有 PHP 错误
• WP_DEBUG_LOG：错误写入wp-content/debug.log日志文件
• WP_DEBUG_DISPLAY：页面直接展示错误，生产环境禁用
• SAVEQUERIES：记录数据库查询，用于性能分析
• SCRIPT_DEBUG：加载开发版 CSS、JS 源文件

• 调试环境：开启 WP_DEBUG、WP_DEBUG_LOG，关闭 WP_DEBUG_DISPLAY
• 生产环境：全部关闭所有调试常量

日志查看

• 读取展示debug.log完整内容
• 显示文件大小、总行数、最后修改时间
• 支持一键刷新、日志下载、一键清空日志
• 清空操作不可逆，谨慎使用

系统信息

1. WordPress：版本、站点地址、内存限制、多站点状态
2. PHP：版本、执行时间、上传限制、已加载扩展
3. 服务器：软件类型、操作系统
4. 数据库：版本、字符集、排序规则
5. 主题：当前主题名称、版本、作者
6. 插件：全部插件启用 / 禁用状态
    

   支持一键导出为 TXT 文件，方便技术排查。

操作历史

• 自动记录所有调试配置操作
• 留存操作时间、内容、管理员账号
• 最大保存 50 条记录，超出自动淘汰旧记录
• 按时间倒序展示

前台提醒

• 调试开启时，前台顶部红色提醒条
• 仅管理员可见，附带快速关闭入口
• 可在设置页自由开关该功能

⚙️ 插件设置

• 自动备份 wp-config.php（修改配置自动备份）
• 后台顶部工具栏显示调试状态
• 前台调试提醒开关
• 日志查看每页显示行数
• 日志自动清理保留天数

🔒 安全规范

1. 正式站点必须关闭全部调试模式，防止敏感信息泄露
2. 定期查看、清理日志，避免文件占用过大
3. 公开站点禁止开启 WP_DEBUG_DISPLAY
4. 插件自动备份wp-config.php，备份格式：wp-config.php.backup.时间戳，可手动 FTP 恢复

📌 菜单入口

• 后台侧边主菜单：一键调试
• 顶部管理工具栏：实时显示调试状态，点击可跳转配置页

🛠️ 常见问题

1. 保存配置无反应：检查wp-config.php文件权限，推荐 644/755
2. 日志文件位置：站点wp-content/debug.log
3. 配置自定义：仪表盘为主功能区，设置页为附加个性化配置
4. 操作历史限制：固定保留 50 条，自动轮转清理

📞 技术支持