一款面向内容站点打造的高颜值自适应 WordPress 主题，自研架构全新编写。后台可视化配置中心、暗色模式、文章增强与用户互动一应俱全——开箱即用，无需写一行代码。
核心特性
- 暗色模式：手动切换与「跟随系统」自动切换，正文字号可调节；主题主色在暗色下按配置自动派生可读变体，不再写死。
- 首页头部版块：幻灯片 / 四宫格 / 分类两栏，可视化配置即开即用。
- 后台配置中心：10 个设置分组 + 1 个维护工具面板，改完即预览生效。
- 文章增强：目录(TOC)、面包屑、返回顶部、代码高亮、阅读进度、相关文章、上一篇 / 下一篇。
- 文章互动：点赞、收藏、分享、海报生成、二维码。
- 评论体验：UA 解析、表情选择器、防暴破限流、评论分页；邮件通知由配套插件提供。
- 自定义内容：内置「动态 / 友链」文章类型与「系列」分类法。
- Gutenberg 区块图案：6 组图案（图文横排 / 三栏特性卡 / 常见问答 / 行动号召 / 精选文章三栏 / 作者介绍卡），插入面板自带「金玉」分类，样式跟随明暗模式与主题主色。
- 归档与维护：分类 / 标签 / 作者 / 日期 / 自定义类型模板齐备；一键维护页、自定义 404 、站点地图页模板。
- 一键更新：后台「检查更新」直接接入 WP 原生更新流程，更新包校验在更新通道侧完成。
- 资源体积：图标字体按实际用量子集化（brands 117KB → 11.8KB 、 solid 157KB → 33KB），零第三方 JS 依赖。
后台可视化配置中心
所有外观与功能都在顶层菜单「金玉主题配置」里完成（与 Astra / OceanWP 一样从「外观」提到了顶层），共 10 个设置分组 + 1 个维护工具面板，改完即预览生效。
- 分组与备份：基础设置 / 全局 / 风格 / 内容 / 评论 / 首页模块 / 扩展 / 用户 / 页脚 / 代码注入，外加「维护工具」（封面重建、配置导出导入、页脚运行信息）；支持导入导出 JSON 配置备份，单组「重置本组」，敏感字段（邮箱密码等）密文存储。
- 资源与存储：本地图片处理链路内置，上传与 WebP 转码可对接又拍云 / 阿里云 / 腾讯云 / 七牛 CDN（对象存储凭据在配套插件面板填写）。
- 兼容旧配置：1.1.0 解耦后保留兼容层，插件接管前保存的历史设置键仍可读取，升级不丢配置。
SEO 与流量增长
- 自动内链（主题内置）：正文出现的其它文章标题自动转站内链接，长词优先、单篇上限 5，跳过标题与代码块。
- 结构化数据（插件）：Open Graph / Twitter Card / JSON-LD（含 FAQPage）。
- GEO / llms.txt（插件）：动态生成
/llms.txt，供 ChatGPT / Claude / Perplexity / 元宝抓取引用。 - 收录推送（插件）：IndexNow 与百度主动推送，新文即时通知搜索引擎。
- 归档自定义标题（插件）：分类 / 标签 / 作者 / 日期归档页可设独立标题。
- 访问统计（插件）：内置统计面板与代码注入位，掌握流量来源。
说明：除「自动内链」外，上述 SEO 输出项自 1.1.0 起按官方评审口径迁至配套插件，详见下文「主题与插件的分工」。
用户与社区
- 用户中心（主题）：前端登录 / 注册弹窗、找回密码；验证码策略、登录防暴破（5 次锁 15 分）；支持前台投稿（待审核）。
- 第三方登录（主题）：QQ / GitHub / Gitee 等一键登录。
- 实时搜索（主题）：输入即出下拉建议，带封面、日期与阅读时长。
- 邮件订阅：前台订阅入口与小工具由主题提供，名单管理与 CSV 导出在配套插件。
- 外链中转（插件）：出站链接统一中转，防权重流失并统计点击。
- 小工具套件（主题）：作者卡 / 热门文章 / 标签云 / 最新评论 / 相关文章 / 实时概况。
性能与安全
- 主题侧优化：HTML 输出压缩、关键 CSS 内联并按修改时间缓存、站点地图与归档列表分级缓存、封面探测带 SSRF 防护（拒绝内网与保留段地址）。
- 性能开关（插件）：整页静态缓存 / 对象缓存 / 图片 WebP 等在配套插件的性能面板统一管理；插件缺席时主题按默认值降级，站点不会报错。
- 安全加固：ABSPATH 守卫，禁止直接访问主题文件；查询全部预处理防注入；REST API 可收敛、评论防暴破 + 验证码 + 内置垃圾词库；后台写操作统一 nonce 校验。
- 旧浏览器兼容：关键样式不依赖
:has()（Chromium 105+ 才支持），在 Edge 100 / Safari 15.4 等旧版下功能完整，仅个别增强效果降级。
扩展与二次开发：主题只做呈现层，函数、类名、常量统一 jinyu_ 前缀，模板层级、区块图案与区块样式齐备；广告位 / 联盟角标 / 订阅追踪等非呈现功能已按官方评审口径迁出主题。
界面预览
技术规格
| 主题名称 | 金玉 (Jinyu) |
|---|---|
| 当前版本 | 1.2.8（仓库最新 Release 为 v1.2.8） |
| 最低要求 | WordPress 6.0+ · PHP 8.0+（已实测至 WordPress 7.1 / PHP 8.5） |
| 许可协议 | GPL v3 or later |
| 主题地址 | https://www.qicaiyun.top |
| 布局 | 响应式 / 两栏 / 三栏 / 无侧栏，侧栏左右可配 |
| 设置面板 | 10 个设置分组 + 1 个维护工具面板，支持 JSON 导入导出 |
| 云存储 | 又拍云 / 阿里云 / 腾讯云 / 七牛 CDN |
| 主题体积 | 约 3.9 MB（含全部图标字体与编译产物） |
主题与插件的分工
自 1.1.0 起，金玉按官方评审口径收敛为纯呈现层：主题负责外观、模板与前台交互，以下能力由配套插件「金玉增强（jinyu-theme-companion）」提供。
- 内容短代码（下载按钮 / 提示框 / 分栏 / 徽标 / 订阅表单等）
- SEO 输出：Open Graph 、 Twitter Card 、 JSON-LD 、
/llms.txt、 IndexNow 与百度推送 - 性能优化中心：整页静态缓存、对象缓存、关键 CSS 、 HTML 压缩
- 邮件 SMTP 与评论邮件通知
- 对象存储（又拍云 / 阿里云 / 腾讯云 / 七牛）与图片 WebP 转码
- 外链中转、访问统计面板、订阅名单与 CSV 导出
插件未安装时，对应功能静默关闭，主题侧只读取开关值并降级，站点不会报错。若你需要短代码或完整 SEO / 缓存能力，安装「金玉增强」即可，配置无需迁移。
金玉增强插件 v1.2.12（可安装包，898 KB，含 SEO 输出 / 短代码 / 缓存 / SMTP 等全部功能层）：下载 jinyu-theme-companion-1.2.8.zip Gitee 下载 (v1.2.8) 查看插件仓库
安装步骤
- 上传主题：将主题文件夹上传到
/wp-content/themes/，或后台「外观 → 主题 → 上传」。 - 启用金玉：在「外观 → 主题」中启用「金玉」。
- （可选）装配套插件：需要短代码 / SEO / 缓存 / SMTP 时，下载「金玉增强」 v1.2.12 安装包，到「插件 → 安装插件 → 上传插件」安装并启用。
- 按需配置：进入顶层菜单「金玉主题配置」调整选项；到「设置 → 固定链接」保存一次刷新重写规则。
升级前建议做三件事：① 到「金玉主题配置 › 维护工具」导出当前配置 JSON；② 若用到短代码 / SEO / 缓存 / SMTP，先确认「金玉增强」已是最新版；③ 升级后清理一次缓存，旧配置才会重新生效。
更新记录
版本口径以主题包内 style.css 的 Version 为准，完整日志见随包附带的 readme.txt（Changelog 段）。
| 版本 | 日期 | 要点 |
|---|---|---|
| 1.2.11 | 2026-10-04 | 补全 1.2.10 遗漏的性能中心频率下拉样式；补回 SMTP 表单 phpcs 忽略注释；修正审计脚本 CRLF 误报 |
| 1.2.12 | 2026-10-06 | 悬浮保存落库与回滚修复、缓存预热折叠段、 WP.org Plugin Check 清零 |
| 1.2.8 | 2026-10-02 | 常规维护与缺陷修复。；code style: WPCS 全量合规治理 |
| 1.2.7 | 2026-10-02 | 订阅增强：RSS / Atom 输出文章缩略图（特色图 → 正文首图 → 子附件）并注入 enclosure，摘要与正文自动前置封面图；页脚社交图标支持 RSS 条目未填链接时兜底指向全站 feed 。全站界面文案国际化（原文转英文并附 zh_CN 翻译包 901 条），修复 WP 7.x 下主题内置语言目录不被加载（翻译包改名 zh_CN.mo）。 WPCS 全量归零（0 error / 0 warning），移除废弃的 imagedestroy() 调用。 |
| 1.2.3 | 2026-09-30 | 架构级：与配套插件彻底解耦，主题回归纯呈现层；修复「外观 → 自定义」主题设置面板偶发消失与前端顶栏滚动偏移；缓存键拼入版本盐值即时失效；评论父级批量预取消除 N+1；theme.json 注册全部页面模板；界面文案全面接入翻译体系；官方标签规范化并对齐 w.org 提交口径。 |
| 1.2.2 | 2026-09-27 | 后台设置页双垂直滚动条修复；外壳高度扣除 WP 固定顶栏；移除对 :has() 的依赖，兼容 Chromium 105 以下；正文任务列表 checkbox 在旧版浏览器下正确对齐。 |
| 1.2.0 | 2026-09-25 | 新增 6 个 Gutenberg 区块图案，编辑器插入面板新增「金玉」图案分类。 |
| 1.1.1 | 2026-09-24 | 补全 .org 官方标签与多语言、页面构建器兼容说明；新增「全宽页面」模板。 |
| 1.1.0 | 2026-09-23 | 架构级：主题回归纯呈现层，短代码 / SEO / 对象存储 / 性能优化等迁至配套插件；隐私合规（IP 归属地默认关闭）；Requires at least 降为 6.0 。 |
| 1.0.9 | — | 修复暗色模式下主题主色失效（改按配置主色派生暗色变体）；新增「自动内链」。 |
| 1.0.8 | — | /llms.txt 升级为完整内容地图（热门文章 / 系列教程 / 重要页面）。 |
| 1.0.7 | — | 归档页自定义标题；/llms.txt 加后台开关。 |
常用短代码
短代码由配套插件「金玉增强」提供，安装启用后即可在正文直接使用，古登堡编辑器同样支持。
[jinyu_download url="https://example.com/jinyu-theme.zip" name="下载主题" /]
[jinyu_tip type="info" title="提示"]升级前记得先导出配置备份[/jinyu_tip]
v1.2.8 [jinyu_badge]PHP 8.0+[/jinyu_badge]
[subscribe]更多短代码见插件面板内的短代码说明文档，或「金玉主题配置 › 扩展」中的清单。
获取与支持
Gitee 下载 (v1.2.8)
GitHub 下载 (v1.2.8)
下载后解压得到 jinyu/ 文件夹，按上方安装步骤上传启用即可。两个仓库的最新正式 Release 均为 v1.2.8，直接用上面的按钮下载安装包即可；安装包顶层是 jinyu/ 目录，解压后按上方步骤上传启用。历史版本可在对应仓库的 Release 页取。
评论 (0)