使用手册

本文面向站点管理员，介绍 BlogKit v1.0.0 后台管理与前台使用的完整流程。安装部署请参见系统介绍；站点目录结构与各文件职责请参见 目录与文件说明。

后台统一入口为 admin.php，通过 action 参数路由到对应功能页面；所有管理操作均需登录，且受角色权限控制。

1. 快速开始

1.1 登录后台

1. 浏览器访问 http://你的域名/admin.php；
2. 输入安装时设置的管理员用户名与密码（如开启验证码，需同时填写）；
3. 勾选「记住我」后可在一段时间内免输密码自动登录；
4. 忘记密码时点击登录页的「忘记密码」，通过管理员邮箱接收重置链接（需先完成「系统设置 → 邮箱配置」中的 SMTP 设置）。

1.2 后台布局总览

登录后默认进入仪表盘（action=dashboard），后台界面由以下部分组成：

• 左侧菜单栏：按分组组织，仅显示当前角色有权限的菜单项；
• 仪表盘：站点概览、待办事项（如待审核评论数）、应用升级提醒、系统信息（PHP 版本、数据库版本等）；
• 顶部工具栏：缓存清理入口、通知铃铛（需安装「消息通知」插件）、通知中心；
• 全局搜索：按 Ctrl + K 打开命令面板，可搜索文章、用户、评论、分类、标签及设置项；
• 快捷键：按 Ctrl + / 查看全部后台快捷键。

侧边栏菜单分组如下：

2. 内容管理

2.1 文章管理

新建文章

1. 进入「内容管理 → 文章管理」，点击「添加文章」；
2. 填写标题与正文。正文使用富文本编辑器（由 WangEditor 插件提供，支持图片/视频上传、代码块、表格、全屏等，安装「AI助手」插件后编辑页会出现 AI 辅助按钮组：标题建议、摘要、SEO 描述、推荐标签、润色选中文本）；
3. 点击右上角「文章设置」展开抽屉，设置分类、标签、摘要、封面图、SEO 描述、置顶方式、别名（SEO 友好 URL）等元信息；
4. 点击「存为草稿」保存为草稿，或点击「发布文章」直接发布；
5. 编辑过程中系统会自动将内容暂存为本地草稿，意外关闭页面后可恢复。

管理文章

• 列表页支持按分类、状态、关键词筛选，可按标题、时间等排序；
• 支持批量删除（入回收站）；已删除文章在「回收站」中可恢复或彻底删除；
• 文章发布后再次编辑保存即实时更新，当前版本不提供独立的文章审核工作流，内容以「草稿」和「已发布」两种状态管理。

2.2 分类管理

1. 进入「内容管理 → 分类管理」，点击「添加分类」；
2. 填写名称、描述、关键词、别名（slug），可选设置父级分类实现多级结构；
3. 「是否显示在分类菜单」控制该分类是否出现在前台导航；
4. 「跳转链接」填写后，前台点击该分类将跳转到指定地址；
5. 编辑与删除在列表页操作，删除分类前请先转移该分类下的文章。

2.3 标签管理

1. 进入「内容管理 → 标签管理」，点击「添加标签」；
2. 输入标签名称即可创建；标签可与文章在文章编辑页关联；
3. 列表页支持编辑、删除与批量操作。

2.4 独立页面

独立页面用于「关于我们」「联系方式」等非时间轴内容：

1. 进入「内容管理 → 页面管理」，点击「添加页面」；
2. 填写标题与内容，设置别名后通过 /page/别名 访问；
3. 页面支持草稿与发布状态，列表页可编辑、删除（入回收站）。

2.5 评论管理

1. 进入「内容管理 → 评论管理」，列表默认展示全部评论，可按状态筛选「已审核 / 待审核」；
2. 侧边栏「评论管理」菜单会以数字徽标实时提示待审核数量；
3. 单条评论可执行：通过审核、设为待审、置顶/取消置顶、编辑、删除（入回收站）；
4. 工具栏「批量操作」支持批量审核通过、批量设为待审、批量删除；
5. 回收站中的评论可恢复或彻底删除；
6. 是否开启「先审后发」由「系统设置 → 评论设置 → 评论审核」开关决定，开启后新评论需审核通过才在前台显示。

2.6 友情链接

1. 进入「内容管理 → 友情链接」，点击「添加友链」；
2. 填写链接名称、地址、描述、排序等信息；
3. 列表页可编辑、删除；前台展示位置由当前主题决定。

3. 用户管理

3.1 用户列表

1. 进入「用户管理 → 用户列表」，支持按状态、角色、关键词筛选；
2. 点击「添加用户」可直接创建后台账号并指定角色；
3. 编辑用户可修改资料、角色、状态（正常/禁用）；禁用后该用户立即失去后台访问能力；
4. 工具栏提供用户导入、导出与批量操作（如批量禁用）；
5. 删除的用户进入「用户回收站」，可在回收站恢复。

3.2 角色与权限

系统采用「角色 → 权限」两级授权模型，权限分为菜单权限（控制侧边栏菜单可见性）与操作权限（控制具体写操作，如添加文章、审核评论、安装插件）。

1. 进入「用户管理 → 角色管理」，系统默认提供管理员等内置角色；
2. 点击「添加角色」创建新角色，并勾选该角色可访问的菜单与可执行的操作；
3. 「权限管理」页可查看和维护全部权限项，支持新增自定义权限；
4. 角色可设置父级实现权限继承；
5. 提示：只授予菜单权限而未授予对应操作权限的角色，无法执行写操作（如仅有文章菜单权限的角色无法删除文章）。

3.3 个人资料

1. 登录后访问前台个人中心「个人设置」（/profile/settings）；
2. 可修改昵称、头像、个人简介与登录密码；
3. 后台账号与前台账号为同一账号体系，修改后同步生效。

4. 媒体管理

1. 进入「内容管理 → 媒体管理」，点击「上传文件」选择一个或多个文件，上传进度实时显示；
2. 列表支持重命名、删除、批量删除；文件按年月子目录归档存储于 uploads/ 目录；
3. 文章编辑器中的图片、视频上传接口与媒体库一致，上传结果自动进入媒体管理；
4. 图片优化插件：安装「图片优化」插件后，上传图片将自动完成压缩、尺寸限制，并生成 WebP 副本与多尺寸缩略图，前台输出时自动识别 WebP；未安装该插件时，上传的图片按原图直接存储。

5. 外观

5.1 主题管理

1. 进入「外观扩展 → 主题管理」，页面列出已安装的全部主题，支持图片卡片与列表两种视图；
2. 切换主题：点击目标主题的「设为默认」，前台立即使用新主题渲染；
3. 主题设置：点击「主题设置」可配置当前主题提供的选项；
4. 卸载主题：点击「卸载」并二次确认，主题文件将被彻底删除，操作前请确认该主题未在使用。

5.2 关于导航菜单

当前版本未提供独立的「菜单管理」模块。前台导航由主题模板决定，其中分类导航可通过「分类管理」中的「是否显示在分类菜单」开关逐项控制；友情链接的展示位置亦由主题定义。

6. 插件管理

6.1 应用市场

应用市场提供插件的在线浏览与一键安装：

1. 进入「外观扩展 → 应用市场」，首次使用请先点击「市场设置」，填写官网地址与站点密钥完成绑定；
2. 浏览或搜索应用，点击「详情」查看介绍、版本与兼容性；
3. 在卡片、列表或详情页点击「安装」，系统自动完成下载、校验与启用；
4. 点击「检测应用更新」可检查已装应用的新版本，有新版本的应用市场与系统升级菜单会显示「新」字徽章；
5. 市场列表数据缓存约 10 分钟，安装后状态自动刷新。

6.2 已装插件管理

「外观扩展 → 插件管理」以统一列表展示已启用、已禁用与未安装的插件：

1. 启用/禁用：点击对应按钮并二次确认；禁用后插件功能全站失效；
2. 卸载：点击「卸载」后进入两步确认（确认卸载意向 → 选择数据处理方式），默认保留插件产生的数据，重装后自动认领存量数据；
3. 删除：仅未安装状态的插件可从服务器删除其插件目录，操作不可恢复；
4. 详情：查看插件版本、兼容的系统版本、依赖与冲突项、版本历史等。

6.3 插件配置入口与访问授权

• 插件不占用系统设置菜单，所有插件的参数配置页统一从「插件管理 → 插件详情 → 配置」进入（插件列表页也提供「配置」快捷按钮）；
• 插件启用后，其后台页面对有访问权限的后台角色开放；插件停用后访问其页面返回 403；
• 在插件详情页的「访问授权」区块可勾选允许访问该插件管理页面的角色；未配置名单时默认所有可登录后台的角色均可访问；
• 部分官方插件启用后会在侧边栏对应分组追加自己的管理菜单（如「互动管理」「通知管理」「审计日志」「API 管理」）。

6.4 官方插件一览

7. 系统设置

系统设置的各子页位于左侧菜单「系统设置」分组下，页面内部按分组导航展示。

7.1 基本设置

站点名称、站点描述、站点关键词、站点 URL、站点 LOGO（含显示方式）、全站/文章评论/搜索页分页数量、站点时区、版权起始年份等。

7.2 用户设置

用户设置页包含三个分区：

• 用户资料：是否允许用户注册、是否允许用户设置头像；
• 注册设置：注册验证方式、同一 IP 注册时间与数量限制、注册用户名敏感词、防灌水（蜜罐字段与设备限制）、新注册用户限制时长；
• 登录设置：登录功能开关、登录尝试次数限制与锁定时间、登录方式。

7.3 评论设置

是否允许评论、评论审核开关（先审后发）、评论长度上下限、反垃圾设置（评论频率限制与间隔、内容去重检测、关键词过滤）。

7.4 搜索设置

最小/最大搜索长度限制、搜索关键词黑名单开关与词库。

7.5 SEO 设置

站点级 SEO 参数、robots.txt 生成与站点地图设置（启用站点地图、站点地图文件名、包含的内容类型），启用后系统自动生成并更新 sitemap.xml。

7.6 伪静态设置

1. 开启「伪静态功能开关」；
2. 按页面内占位符说明配置 URL 重写规则；
3. 保存后还需在 Web 服务器（Nginx/Apache）配置对应的重写规则，页面底部附有配置示例。

7.7 邮箱配置

1. 填写 SMTP 服务器地址、端口、加密方式（SSL/TLS/无）、SMTP 用户名与密码（邮箱服务商通常要求使用授权码）；
2. 配置发件人信息并保存；
3. 「邮件模板管理」为邮箱配置的子功能，可维护注册验证、密码重置等场景的邮件模板；
4. SMTP 未配置或配置错误时，找回密码等依赖邮件的功能将无法使用。

7.8 安全设置

• 后台登录安全策略（登录失败锁定等）；
• IP 白名单（页面尾部）：启用后仅白名单内的 IP 可访问后台，白名单为空则允许所有 IP；支持增删多条；
• 可信代理设置：站点使用 CDN 或反向代理时配置代理 IP，系统将从可信代理的请求头中获取真实客户端 IP 参与白名单校验。

7.9 验证码设置

验证码基本参数、样式与干扰元素设置；应用场景可独立开关：前台登录、注册、评论、密码重置、忘记密码、管理员登录。

8. 系统维护

8.1 缓存设置

1. 进入「系统维护 → 缓存设置」查看缓存状态与缓存开关；
2. 点击「清理缓存」下拉，可分别清理所有缓存、页面缓存、数据缓存或仅过期缓存；
3. 关闭缓存开关后系统直接查库，后台菜单等缓存同时失效。

8.2 数据备份

1. 进入「系统维护 → 数据备份」，提供三种备份方式：备份数据库、备份文件、全量备份；
2. 备份列表展示文件名、类型、大小、时间与 MD5 校验状态，支持下载、恢复与删除；
3. 恢复备份会覆盖当前全部数据，执行前请务必二次确认；
4. 「备份设置」中可配置备份保留份数（1-30 份），超出后自动删除最旧的备份；
5. 页面同时展示备份目录占用与磁盘剩余空间。

8.3 数据迁移

数据库结构随版本演进时（升级包附带新的建库脚本），需在「系统维护 → 数据迁移」页执行迁移。该页面属于高级操作，仅系统管理员角色可见，执行前请先完成数据备份。

8.4 系统升级

说明：在线升级用于安装后的版本更新。v1.0.x 老站升级至 v1.0.0 不适用在线升级（更新检测不会向老站推送），请按「备份 → 全新安装 → 导入数据」方式迁移，参见 01-系统介绍 常见问题。

1. 在线升级依赖官网绑定，请先在「应用市场 → 市场设置」完成绑定；
2. 进入「系统维护 → 系统升级」，点击「检测更新」获取最新版本信息；
3. 发现新版本后点击「开始升级」，系统按「下载 → 校验 → 备份 → 覆盖」自动执行，全程约 1-2 分钟且不可中途取消；
4. 升级前自动备份：程序文件打包保留最近 3 份，数据库以与「数据备份」页相同的格式导出，均可在数据备份页查看与恢复；用户数据（上传目录、插件、主题、配置文件）不在覆盖范围内；
5. 升级包包含新数据库版本时，升级完成后页面会提示前往「数据迁移」执行数据库结构迁移；
6. 建议升级前先在「数据备份」页手动执行一次全量备份。

9. 前台使用

9.1 注册与登录

1. 访问 /register 注册账号（需在「用户设置」中开启注册，可要求验证码/邮箱验证）；
2. 访问 /login 登录，支持「记住我」；
3. 忘记密码通过 /forgot-password 向注册邮箱发送重置链接（依赖 SMTP 配置）；
4. 站点可配置同一 IP 的注册频率限制与新注册用户的功能限制时长。

9.2 内容创作

前台注册用户默认不具备后台权限。如需允许他人发文：

1. 管理员在「角色管理」创建「作者」类角色，仅授予仪表盘、文章管理及相关操作权限；
2. 在「用户列表」中将作者账号分配至该角色；
3. 作者登录 admin.php 后即可使用文章编辑器发文，无法访问未授权菜单。

9.3 评论与互动

1. 登录用户可在文章页发表评论、回复他人，评论受长度、频率、关键词与审核策略约束；
2. 评论支持点赞；互动功能（文章点赞、收藏、关注、阅读历史）由「互动增强」插件提供，插件停用时相关按钮静默隐藏，重新启用后数据自动恢复。

9.4 个人中心

登录后访问 /profile 进入个人中心，包含：

• 我的文章、我的评论、个人设置（基础功能）；
• 我的收藏、我的点赞、我的关注、我的粉丝、阅读历史（需「互动增强」插件）；
• 消息中心（需「消息通知」插件），接收评论、关注、点赞、收藏、系统通知等站内消息。

9.5 RSS 订阅

站点默认提供 RSS 输出，订阅地址为 /rss（启用伪静态时），供读者通过 RSS 阅读器订阅最新文章。

10. 常见问题

Q：忘记管理员密码怎么办？ 在后台登录页点击「忘记密码」，使用管理员邮箱接收重置链接。前提是已完成「邮箱配置」的 SMTP 设置并测试可用。

Q：验证码图片不显示？ 多为服务器未安装或未启用 GD 扩展，请检查 PHP 环境；也可能是站点 URL 配置错误导致资源路径 404。

Q：上传图片失败？ 依次检查：uploads/ 目录是否可写；PHP 的 fileinfo 扩展是否启用；文件大小是否超过 PHP upload_max_filesize 限制。

Q：开启伪静态后前台页面 404？ 除在后台开启开关外，还需在 Web 服务器添加对应的 URL 重写规则（Nginx/Apache 配置示例见伪静态设置页底部），修改后重启或重载 Web 服务。

Q：邮件发送失败？ 确认 SMTP 地址、端口与加密方式匹配（常见组合：465+SSL、587+TLS）；多数邮箱需使用授权码而非登录密码；服务器出站端口需放行。

Q：为什么看不到某个插件的管理页面？ 插件必须处于启用状态；且当前角色需在该插件详情页的「访问授权」名单中。停用状态下访问插件页面将返回 403。

Q：应用市场无法打开或安装失败？ 确认服务器已安装 cURL 扩展且能访问官网；确认已完成市场设置的官网绑定与站点密钥填写。

Q：评论列表出现红色徽标数字？ 该数字为待审核评论数量。在「评论设置」开启审核后，新评论需人工通过才会展示；批量审核可使用列表工具栏的批量操作。

Q：恢复备份会丢失数据吗？ 恢复即以备份文件覆盖当前数据，备份时间之后新增的内容将丢失。执行恢复前建议先创建一份当前时间的全量备份。

Q：如何安全地迁移站点到新服务器？

1. 旧站「数据备份」页执行全量备份并下载；2. 新服务器部署同版本程序并完成安装；3. 通过备份文件恢复数据，或将备份内容导入新站；4. 核对「基本设置」中的站点 URL 与伪静态配置。