Simple 主题功能特点与使用文档

版本：Simple 3.0.4　|　适配：Typecho 1.3+ PHP 8.3+　|　作者：迷你日志

Simple 是一款基于「Simple 2.3」深度改造的青绿色扁平风格 Typecho 主题，可以配合typecho手机客户端迷你日志APP来使用，单栏自适应布局，内置亮 / 暗双主题、多级分类菜单、SEO / GEO 优化等实用功能，开箱即用、无外部依赖。

一、功能特点

1. 界面与视觉

青绿扁平设计：以青绿色（#0f9d8f）为主色的扁平化界面，卡片式文章列表，视觉清爽。
亮 / 暗双主题：
- 右上角按钮一键切换亮色 ⇄ 暗色，选择保存在访客浏览器（localStorage）中；
- 后台可设默认模式：跟随系统（自动）/ 始终亮色 / 始终暗色；
- 未手动选择时自动跟随系统 prefers-color-scheme，且系统偏好变化实时响应。
自适应布局：860px 单栏内容区，桌面 / 平板 / 手机全设备适配；移动端顶栏自动折叠为汉堡菜单抽屉。
节日氛围装饰：支持「喜庆」（飘灯笼动画）与「悲哀」（灰度）两种节日模式，默认关闭。
尊重动画偏好：自动响应系统「减弱动态效果」设置。

2. 导航菜单

多级分类菜单：父分类自动聚合子分类，展示展开箭头。
PC 端：鼠标悬停父分类即展开二级下拉菜单，箭头同步转为朝上。
移动端：点击箭头展开二级分类、箭头转为朝上；再次点击收起、箭头恢复朝下。已彻底禁用移动端悬停转向（防止触屏点击后箭头停在转向状态），交互只由点击控制。
当前页高亮：首页、分类、页面、文章所在分类自动高亮。
自定义菜单项：后台可追加自定义 <li> 导航项（如外链）。
孤儿子分类保护：父分类被删除时，孤儿子分类自动平铺到菜单，不丢失入口。

3. 文章功能

列表缩略图：优先取自定义字段「缩略图」，为空自动取正文第一张图；带总开关。
文章置顶推荐：后台填入置顶文章 cid，首页顶部展示推荐位。
阅读量统计：文章页显示阅读次数，基于 Cookie 防重复计数，首次访问自动建库字段（MySQL / SQLite 均兼容）。
图片懒加载：正文图片懒加载占位，配合 InstantClick 无刷新换页。
外链新窗口打开：正文外链自动加 target="_blank" rel="noopener nofollow"。
上一篇 / 下一篇：卡片式导航，无上下篇时优雅降级。
猜您喜欢：相关文章列表（不足时自动补充随机文章）。
打赏功能：文章页底部微信 / 支付宝二维码展开按钮，可开关。

4. 评论功能

评论者归属地：显示评论者 IP 归属省份，支持关闭 / 本地内置 IP 库（qqwry.dat，速度快）/ 太平洋网络接口（更精准）三种模式。
头像加速：Gravatar 头像国内镜像源可选（Cravatar / WeAvatar / loli.net / 极客族）；QQ 号邮箱自动走 QQ 头像。
评论 @ 回复：回复自动带 @ 对方，被回复者处于审核状态时显示「审核中」标记。
作者标识：作者评论自动带「作者」徽标。
回复兜底：Typecho 原生回复脚本缺失时自动启用主题内置兜底实现，回复 / 取消回复始终可用。
原生反垃圾：保留 Typecho 原生评论令牌校验，冲突时可临时关闭。

5. SEO / GEO 优化

SEO 增强：自动输出规范化 description / keywords、Open Graph、Twitter Card；首页描述与关键词可自定义。
结构化数据（JSON-LD）：自动输出 WebSite / BlogPosting / BreadcrumbList，帮助搜索引擎理解页面。
GEO 模块（AI 收录优化）：面向 AI 搜索与大模型引擎的优化——robots 放宽快照限制（max-snippet:-1 等）；后台带一键「GEO 自检」按钮，实抓首页验证放宽是否生效。
文章页摘要卡片：文章顶部展示「内容速览」摘要卡片（可开关），摘要取自定义字段「摘要」，为空时自动截取正文。

6. 性能与其他

InstantClick 预加载：无刷新换页，静态资源可选本地 / Staticfile / BootCDN / 自定义地址。
HTML 压缩：可开启前台 HTML 压缩输出，自动跳过 <pre>、<textarea> 与 <nocompress> 区域。
搜索面板：点击放大镜展开搜索框，支持 Esc / 点击外部关闭。
返回顶部：右下角圆形按钮，实时显示阅读进度百分比，平滑滚动。
页脚耗时显示：页脚显示页面渲染耗时；底部代码位可放统计 / 备案信息。
无第三方依赖：所有 JS / CSS 随主题自带，无需外网 CDN 即可正常运行。

二、安装与启用

在 Typecho 后台进入 控制台 → 外观；
点击 上传外观，选择本主题压缩包 simple.zip 上传并启用；
（或手动解压 simple.zip，将 simple 文件夹上传至站点 usr/themes/ 目录）
进入 控制台 → 外观 → 设置外观，按需填写配置并 保存设置。

环境要求：Typecho 1.3，PHP 8.3+（需 pdo_sqlite / mysqli / pdo_mysql 任一数据库扩展，mbstring、curl 扩展推荐开启）。

三、后台设置项说明

进入 控制台 → 外观 → 设置外观，设置项分组如下：

分组	设置项	说明
基础	站点 LOGO 地址	留空则显示站点标题文字
基础	站点 Favicon 地址	留空使用站点默认 favicon.ico
基础	文章置顶推荐	置顶文章 cid，半角逗号或空格分隔
基础	菜单导航自定义项	追加自定义导航，按 `<li>` 格式书写
基础	默认配色模式	跟随系统 / 始终亮色 / 始终暗色（访客可自行覆盖）
基础	节日氛围	正常 / 悲哀 / 喜庆
基础	HTML 压缩	压缩前台 HTML 输出，遇异常可关闭
基础	评论者归属地	关闭 / 本地内置 IP 库 / 网络接口
打赏	打赏功能 + 微信 / 支付宝二维码地址	文章页底部展示打赏二维码
文章列表	列表缩略图	缩略图总开关
广告与统计	文章页顶部 / 底部代码、底部代码	可放广告、统计、备案信息
镜像加速	静态资源镜像源 / 自定义地址	InstantClick 脚本来源，默认本地
镜像加速	Gravatar 头像镜像源	Cravatar / WeAvatar / loli / 极客族
SEO	SEO 增强 / 首页描述 / 首页关键词 / 结构化数据	见上文 SEO 说明
GEO	GEO 模块 / 摘要卡片开关 / GEO 自检按钮	AI 收录优化与自检

四、菜单与二级分类使用方法

在 管理 → 分类 中创建分类：先创建父分类（如「技术」），再创建子分类并在「父级分类」中选择该父分类（如「前端开发」「后端开发」）；
主题导航自动生成层级：
- PC（鼠标设备）：悬停父分类展开二级下拉菜单，移开自动收起，箭头随悬停转向；
- 手机 / 平板触屏：点击父分类右侧箭头展开二级分类（箭头转为朝上），再次点击收起（箭头恢复朝下）；点击分类文字仍然直接跳转分类页。
无子分类的分类项不显示箭头；子分类「菜单缩略名 / slug」用于导航高亮判断。

五、文章自定义字段

编写文章时，编辑框下方的 自定义字段 区域提供两个字段：

字段	说明
摘要	展示在文章页顶部摘要卡片（「内容速览」），同时作为 SEO description 的优先来源；留空则自动截取正文
缩略图	文章列表右侧缩略图地址；留空自动取正文第一张图片

六、常见问题（FAQ）

Q1：手机端点二级分类箭头没反应？
确认浏览器窗口宽度 ≤760px 时菜单已通过汉堡按钮展开；请清掉浏览器缓存的旧版 style.css / theme.js（本版本号已升为 3.0.4，正常更新主题后自动失效旧缓存）。

Q2：HTML 压缩开启后页面异常？
关闭「HTML 压缩」；或在需要保留原样的区域用  与  包裹。

Q3：评论归属地显示不准确？
本地模式使用内置 IP 库（精准到省级），需要更精确可切换「网络（太平洋接口）」模式。

Q4：阅读量没加一？
同一访客对同一文章的多次浏览基于 Cookie 去重，属正常行为。

Q5：如何临时关闭评论反垃圾令牌校验？
外观设置 → 评论原生反垃圾 → 临时关闭（仅建议与其他功能冲突时使用）。

Q6：GEO 自检提示无法抓取首页？
部分服务器禁止自请求（curl 本机），不影响前台 robots meta 的正常输出，可忽略该项。

Simple 3.0 系列：青绿扁平改造、多级分类菜单、移动端搜索、亮暗双主题、SEO / GEO 模块、镜像加速、阅读量统计等（见「功能特点」）。配合TpEnhance插件、AiAssistant插件和Surl插件使用，支持迷你日志APP客户端使用，风格搭配，运行快速。

文章目录

Simple 主题功能特点与使用文档

Simple V3.0 主题功能特点