源码系统概览
文章正文
Puock 是一款基于 WordPress 开发的高颜值自适应主题，支持白天与黑夜模式、无刷新加载（PJAX）、SEO 优化等特性，长期开源维护。
主题内置博客、书单、语录、归档、随机文章等多种页面模板，并支持评论 AJAX 交互与自定义登录，适合搭建个人博客与内容型网站。
源码简介
项目为标准的 WordPress 主题目录结构，核心代码位于 inc 目录，采用 PSR-4 自动加载（Puock\Theme 命名空间映射到 inc/）。
functions.php 注册主题功能与自定义函数，inc/fun 提供核心工具函数、缓存与配置读取；页面模板位于 pages 目录，含 archives、book、chatgpt、links、luck、moments、random、reads 等丰富模板。
主题通过 composer 依赖 yurun-oauth-login、ip2region、open-ai 等库，支持第三方登录与 AI 接口调用，并内置 PHP 验证码与二维码生成能力。
此外还集成了 PHP 图片处理（timthumb）、古腾堡编辑器支持与更新检查器（update-checker），功能体系完整。
适用场景
适合个人博客、技术博客、内容网站、知识分享站等基于 WordPress 的写作与展示场景。
主题自带的书单、语录、随机文章等模板，可扩展为多样化的内容聚合页。
功能亮点
高颜值自适应设计，支持白天/黑夜模式一键切换。
无刷新加载（PJAX）与异步浏览统计，浏览体验流畅。
内置书单、语录、时光机、随机文章、ChatGPT 等页面模板。
集成第三方登录、IP 归属地解析与验证码、二维码能力。
SEO 优化与分类 SEO 配置，利于搜索引擎收录。
技术架构与部署指南
| 维度 | 本套源码 | 同类通用方案 |
|---|---|---|
| 技术栈 | 前端：HTML + CSS + JavaScript（Less 编译） 后端：PHP 7.4+（WordPress 5 |
依具体方案选型，需自行搭建与维护 |
| 部署方式 | 将主题目录上传至 wp-content/themes，在后台外观中启用。 | 多托管于第三方平台或订阅云服务 |
| 功能侧重 | 高颜值自适应设计，支持白天/黑夜模式一键切换。 | 功能通用，定制深度有限 |
| 数据归属 | 数据自持，部署在自有服务器，不出站 | 数据通常留存于服务商侧 |
| 成本模式 | 获取后自主部署，无持续授权费用 | 通常按订阅或调用量计费 |
技术栈与运行环境
前端：HTML + CSS + JavaScript（Less 编译）
后端：PHP 7.4+（WordPress 5.0+）
数据库：MySQL（WordPress 自带）
运行环境：WordPress 5.0+ / PHP 7.4+ / MySQL
其他依赖：composer 依赖库（yurun-oauth-login、ip2region、open-ai 等），以及 PHP 验证码与二维码生成组件
安装与部署提示
将主题目录上传至 wp-content/themes，在后台外观中启用。
如需完整功能，先执行 composer install 安装依赖库（更新检查器依赖可跳过）。
在主题设置中配置站点信息、白天黑夜模式、SEO 与第三方登录参数。
源码前端资源基于 gulp 构建，修改 Less/JS 后可执行 npm run build 重新打包。
截图与演示说明
首页为博客卡片流布局，顶部导航含搜索与夜间模式切换，文章页支持封面图、面包屑与侧边栏。
后台外观设置可配置主题色、日夜模式、首页布局与 SEO 选项，启用后即可在 WordPress 后台预览调整。
书单、语录与随机文章等模板页各有独立布局，可在后台创建对应页面并选择模板调用。
常见问题
问：启用主题后样式错乱怎么办？
确认 PHP 版本不低于 7.4，并在后台设置中刷新固定链接与缓存，必要时重新上传构建好的静态资源。
问：夜间模式如何开启？
在主题设置中开启黑夜模式选项，前台导航栏会出现日/夜切换按钮。
问：第三方登录无法使用？
需要安装 composer 依赖并正确配置 OAuth 应用参数，检查服务器能否访问对应授权接口。
安全风险提示
主题基于 GPL V3 开源协议，整体为正常开源项目，未发现恶意后门；但内置更新检查器会请求远端接口，若来源不可信请移除 update-checker 目录。
特别提示：部署前请核对主题文件与官方 release 的一致性，及时更新 WordPress 与 PHP 版本，做好安全审计。
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
主题为开源项目（GPL V3），可到 GitHub 官方仓库获取最新版本与完整说明。
