🎉 开心朋友圈 (KXpyq) — Typecho 主题介绍

版本：v1.0.0
作者：清酒
演示：p.qu.pw
类型：朋友圈风格单用户博客主题
适配：Typecho 1.2+ / PHP 7.4+

📱 简介

严格意义上本人的第一款主题，虽然之前开发过很多的，但都是残次品，都烂尾了。

开心朋友圈（KXpyq）是一款高仿真微信朋友圈风格的 Typecho 主题。设计初衷是为个人博主提供一个亲切、轻量、移动优先的"碎碎念"发布平台——像发朋友圈一样写博客。

它不是传统博客，而是你的数字朋友圈：说说、图片、音乐、视频、位置签到、互动评论……这些在微信里习以为常的表达方式，现在你可以在自己的网站上拥有了。

核心设计理念：统一渲染、移动优先、性能极致、渐进增强。

所有卡片通过 pyq_format_post_data() + pyq_render_card() 两个函数统一输出，PHP 服务端渲染与 AJAX 客户端渲染共享同一套代码，杜绝不一致。

✨ 全部功能一览

🎨 朋友圈风格

• 封面大图 + 头像 + 昵称 + 个性签名
• 卡片式信息流，圆角阴影，体验接近微信
• 移动端优先，完美适配手机/平板/桌面
• 置顶说说支持

📝 说说内容类型

🎵 音乐系统

• 全局BGM：后台配置背景音乐，PJAX 换页不中断

• 音乐卡片：每条说说可内嵌音乐播放器，支持：

  • 网易云自动获取歌曲名/歌手/封面（Metting API）
  • 播放/暂停 + 进度条拖拽 + 音量
  • LRC 歌词展开滚动（支持标准 LRC 和网易云 JSON 两种格式）
• 浮动音乐控制：右下角音符按钮 + 播放/暂停 + 定位子按钮
• 网易云代理：music-proxy.php 本地代理，解决外链失效

💻 代码高亮

• Prism.js 集成，支持 19 种语言：
  Bash, C, C++, CSS, Go, HTML, Java, JavaScript, JSON, Kotlin, Markup, PHP, Python, Ruby, Rust, SQL, Swift, TypeScript, 纯文本
• 多行代码块 \\`\`language + 行内代码 ` code ``
• 复制按钮 + 行号显示
• 按需加载：首页不加载，文章页按内容中实际语言动态引入

🖼 图片系统

• 图片代理：img-proxy.php 自动缩放 + 缓存，节省带宽
• EXIF 方向修正：竖拍照片自动旋转
• Fancybox 灯箱：图片点击放大浏览，支持手势滑动（fancybox.umd.js ~165KB）
• 懒加载：Intersection Observer + blur-in 动画
• 失败重试：图片加载失败自动重试 3 次

💬 互动功能

• 点赞：基于 Cookie + IP 去重，支持访客名显示，点赞列表一目了然
• 表情反应：长按赞按钮弹出 👍❤️😂😮😢 五种 emoji 反应

• 评论系统：

  • 嵌套回复，支持 @ 提及
  • 超过 5 条自动折叠，点击「展开全部 N 条」
  • IP 归属地显示（ip-api.com）
  • 博主标记（橙色「博主」badge）
  • 评论邮件通知（依赖 CommentNotifier 插件）
  • 首次评论标记「首评」
• 分享：二维码分享 + 浏览器原生分享 API + 海报分享（Canvas 生成卡片图）
• 搜索：全屏弹窗搜索，实时结果
• PJAX 无刷新换页：切页时音乐不中断

🎛 外观定制

• 深色/浅色模式：

  • 手动一键切换
  • 定时自动切换（19:00 ~ 07:00）
  • 跟随系统偏好
  • 状态持久化到 localStorage
• 字体大小调节：左下角 Aa 按钮，14px / 16px / 18px 三档
• 主题色：后台自定义 HEX 色值
• 最大宽度：后台调节（默认 680px，适合朋友圈风格）
• 卡片圆角：后台调节（默认 12px）
• 自定义 CSS/JS：后台直接注入

📡 SEO & 社交分享

• Open Graph 标签（og:title/description/image/url/type/site_name）
• Twitter Card 标签
• 自动 meta description
• RSS / Atom Feed 链接
• 文章底部版权声明（支持 {title} {url} {author} {date} 变量）

📱 PWA 支持

• manifest.json：可安装到手机桌面，带图标和主题色
• Service Worker：离线缓存，弱网可用
• 深色/浅色 theme-color 自适应

🚀 性能优化

• DNS 预解析 + Preconnect
• 非关键 CSS 异步预加载
• 图片懒加载 + 代理缩放
• 非首屏资源全部延迟

⚙️ 后台设置

5 个 Tab 页，分类清晰：

内置设置备份/还原功能，换主题不怕配置丢失。

📄 页面类型

🔒 安全

• 输入/输出全面 XSS 防护（htmlspecialchars + json_encode）
• CSRF Token 验证
• 图片代理 URL 白名单校验（仅允许 http/https）

🔌 必须搭配的插件

以上三个插件请务必在 Typecho 后台启用，否则对应功能无法使用。

🌐 兼容性

• 浏览器：Chrome 80+ / Edge 80+ / Firefox 80+ / Safari 14+
• PHP：7.4+（图片代理需要 GD 库）
• Typecho：1.2+

📦 安装

1. 将 kxpyq 文件夹上传到 Typecho 的 /usr/themes/ 目录
2. 后台 → 外观 → 启用「开心朋友圈」
3. 进入「设置外观」进行个性化配置
4. 安装并启用必备插件：Links / CommentNotifier / ArticlePoster
5. 在「撰写」中新建文章，选择「说说」分类（默认 slug: shuoshuo），填写自定义字段即可

📝 许可

本主题为开源免费主题，可自由使用、修改。

KXpyq 主题安装指南

朋友圈主题安装文档以及问题

🎉 开心朋友圈 (KXpyq) — Typecho 主题介绍版本：v1.0.0 作者：清酒 类型：朋友圈风格单用户博客主题 适配：Typecho 1.2+ / PHP 7.4+KXpyq 主题安装指南仿微信朋友圈 Typecho 主题，以说说为核心，支持图文、音乐、视频、链接等多种内容形...

闲言碎语

2026年07月10日 47

🍺 从朋友圈来，到朋友圈去。愿你的碎碎念，有处安放。
—— 清酒 @ qu.pw

🍺 记于 2026-07-09，AI助手-小酒出品。