ShuFeiCat - Typecho博客主题

📖 简介

ShuFeiCat 是一款基于 Typecho 的开源博客主题，以美观和功能丰富为设计理念。

本主题起源于 Typecho 的基础模板 Typecho Replica Theme，经过逐步美化和功能扩展而形成，细心的或许还能看到其中些许的影子。在开发过程中，特别感谢 MiniMax、DeepSeek 和 Gemini 这几个大佬提供的技术支持与帮助。

⚠️ 重要提醒

• 运行环境：本主题开发环境为 Typecho 1.3 + PHP 8.3，如果在使用过程中出现问题，可以尝试切换这个运行环境（经过测试，typecho 1.2.1 + PHP 7.2可运行）
• 插件兼容性：主题内置多项功能，使用前请确认与已安装插件无冲突
• 数据备份：更新主题时请不要切换主题，否则可能导致主题设置数据丢失（当前版本暂不支持自动备份），直接覆盖即可

✨ 特色功能

1. 友链展示 - 免插件支持友情链接展示
2. 代码高亮 - 内置代码高亮功能，支持多种编程语言
3. AI评论审核 - 免插件实现AI智能评论审核
4. 邮件通知 - 评论自动邮件通知，无需额外插件
5. 评论安全 - 可对接 Turnstile 验证，有效防止机器人灌水
6. Gravatar镜像 - 可切换多种Gravatar头像加速源
7. 灯箱效果 - 图片灯箱展示功能
8. Ajax加载 - 页面无刷新加载
9. 安全防护 - 防止SQL注入、XSS攻击等常见安全威胁
10. 加密文章 - 支持文章内容加密保护
11. 资源优化 - 支持本地资源与CDN切换
12. 首页交互 - 支持文章点赞，记录浏览次数
13. Markdown 扩展 - 新增 8 项 Markdown 扩展语法
14. 图表公式 - 支持Mermaid和ECharts图表渲染，KaTeX 数学公式渲染
15. 更多自定义 - 支持自定义主题色，透明度等

🖼️ 主题预览

桌面端界面

电脑端首页预览

电脑端文章页面

移动端界面

移动端首页预览

移动端文章页面

特色功能

主题后台设置界面

代码高亮效果展示

提示：更多效果请下载主题后实际体验

🚀 安装使用

安装步骤

1. 下载主题：从 GitHub Releases 下载最新正式版本
2. 解压文件：下载主题包并解压缩
3. 上传主题：将解压后的文件夹上传至 Typecho 主题目录：/usr/themes/
4. 启用主题：登录 Typecho 后台，进入"外观"设置，选择并启用 ShuFeiCat 主题

更新方法

1. 下载新版：从 Releases 页面下载新版主题包
2. 覆盖安装：解压后直接覆盖上传到原主题目录
3. 重要提示：更新过程中请勿切换主题，否则可能导致主题设置数据丢失，如要尝试测试版本，请在Github中的code下载（测试版本会存在不稳定的情况，介意请使用Releases 页面的正式版本）

📦 目录结构（非实时）

shufeicat-typecho/
├── assets/           # 静态资源
│   ├── css/         # 样式文件
│   └── js/          # JavaScript文件
├── core/            # 核心功能模块
├── image/           # 主题默认图片
├── img/             # 图标资源
├── *.php            # 主题模板文件
└── readme.md        # 说明文档

🔧 配置说明

基本配置

主题设置可在 Typecho 后台的"外观设置"中进行调整，包括但不限于：

• 网站Logo和图标
• 备案信息显示
• 统计代码配置
• 评论验证设置
• 邮件通知
• Ai审核
• 头像源
• Pjax样式
• 备份模板数据

🤝 参与贡献

欢迎各位开发者参与主题的改进和完善！

1. 提交问题：使用 Issues 报告Bug或提出建议
2. 参与开发：Fork 项目后提交 Pull Request
3. 功能建议：提出新功能需求或改进建议

📄 许可证

本项目采用 MIT License 开源协议，您可以自由使用、修改和分发本主题。

📞 联系方式

• GitHub仓库：https://github.com/smcloudcat/shufeicat-typecho
• 问题反馈：请通过 GitHub Issues 或邮箱email.lwcat.cn提交问题

📝 更新历史

版本 1.0

• 初始版本发布
• 实现基础博客功能
• 添加响应式设计支持
• 内置多种安全防护机制

版本 1.1.0（这个版本有点忘本了，大小起飞）

• 修复开启pjax出现的渲染问题
• 支持资源加载模式（资源本地化，占用起飞）
• 优化页码显示
• 修复pjax开启后Turnstile可能重复出现的问题
• 修复开启pjax后移动端概率异常问题

版本 1.1.1

• 修复开启pjax自建cdn后Turnstile重复显示问题
• 优化内容与侧边栏的边距
• 经过一个星期，该版本已经趋近于平稳，建议更新到该版本，该版本后会减少正式版更新推送，尽量做到稳定为主

版本 1.1.2

• 修复布局问题

版本 1.2.0

• 新增点赞功能和文章浏览
• 新增文章顶置功能
• 优化布局
• 新增模板数据备份

版本 1.2.1

• 修复评论显示错误问题
• 美化评论区

版本 1.3.0

• 主题默认配色修改为#FF6B6B
• 支持修改主题配色以及背景图片
• 支持修改盒子透明度
• 美化左侧边栏，支持展示站长头像签名等内容
• 美化列表盒子，两种样式自由切换
• 新增夜间模式
• 修复一些小bug

版本 1.3.1

• 优化右侧以及头部导航栏，归档支持下拉滚动显示
• 设置默认列表样式为经典模式
• 修复文章标题背景图片比例问题

版本 1.3.2

• 优化SEO，支持自定义文章关键词
• 修复旧版typecho1.2.1升级到1.3.0后出现评论显示报错
• 修复pjax页面切换后新的点赞按钮没有被绑定点击事件
• 修复 PostgreSQL 数据库下启用主题报 500 异常的问题（post_stats 表创建 SQL 与 PostgreSQL 语法冲突）
• 修复排行榜查询中表名引号不兼容 PostgreSQL 的问题

1.4.0这个大版本更新的内容有点多，或许还要测试挺久才能正式发布，但她将是该主题进步最大的一个版本~

版本 1.4.0-rc.1

• 重构部分代码，提升性能，优化细节
• 新增Mermaid和ECharts图表渲染，KaTeX 数学公式渲染，支持手动渲染开关
• 修复顶置文章显示问题
• 更新jquery至4.0.0

版本 1.4.0-rc.2

• 移除生产环境console.log
• Markdown扩展功能
• 修复顶置文章显示问题

版本 1.4.0-rc.3

• 浏览量 Cookie 防刷，排行榜文件缓存
• 支持Markdown表格
• 评论支持图片验证码，可选cloudflare turnstile或图片验证码

版本 1.4.0-rc.4

• 修复侧边栏打开异常

版本 1.4.0-rc.5

• 修复反引号被错误解析问题
• 修复KaTeX在shufei_render_post_content中不生效
• 修复图片处理在链接内时破坏HTML结构
• 修复blockquote嵌套时正则匹配错误
• 修复"高亮"在HTML属性值中误匹配
• 修复CSS行内代码样式不一致
• 减少代码重复

版本 1.4.0-rc.6

• 缩小盒子宽度以及间隙，使其更加紧凑美观
• 修复摘要显示异常问题
• 优化css结构，并小幅度提高js运行效率
• 修复header.php和footer.php的缓存机制