ShuFeiCat - Typecho博客主题

📖 简介

ShuFeiCat 是一款基于 Typecho 的开源博客主题，以美观和功能丰富为设计理念，融合AI大模型，支持Ai写作，Ai审核等功能。

本主题起源于 Typecho 的基础模板 Typecho Replica Theme，经过逐步美化和功能扩展而形成。

⚠️ 重要提醒

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

✨ 特色功能

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

🖼️ 主题预览

桌面端界面

电脑端首页预览

电脑端文章页面

移动端界面

移动端首页预览

移动端文章页面

特色功能

主题后台设置界面

代码高亮效果展示

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

🚀 安装使用

安装步骤

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

更新方法

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

📦 目录结构（非实时）

shufeicat-typecho/
├── assets/           # 静态资源
│   ├── css/         # 样式文件
│   ├── js/          # JavaScript 文件
│   └── vendor/      # 第三方库（ECharts、Font Awesome、jQuery-Emoji 等）
├── cache/            # 运行时缓存目录
├── core/             # 核心功能模块
│   ├── ai-moderation.php    # AI 评论审核
│   ├── ai-writer.php        # AI 写作
│   ├── ai-writer-ajax.php   # AI 写作 AJAX 接口
│   ├── ajax-handler.php     # AJAX 请求处理
│   ├── captcha.php          # 验证码
│   ├── mail.php             # 邮件通知
│   ├── phpmailer.php        # PHPMailer 库
│   ├── post-stats.php       # 文章统计
│   └── smtp.php             # SMTP 库
├── image/            # 主题默认图片
├── img/              # 图标资源
├── *.php             # 主题模板文件
└── readme.md         # 说明文档

🔧 配置说明

基本配置

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

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

🤝 参与贡献

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

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

📄 许可证

本项目采用 GPL-3.0 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 这个版本更新内容很多，她迎来了很大的进步，建议升级到这个版本哦~

• 优化文章内容列表样式，调整列表项间距和行高
• 优化编辑器工具栏样式与布局
• 新增AI写作，支持文章美化、续写、检查功能（测试）
• 新增图片处理与多存储后端功能（测试）
• 新增Mermaid和ECharts图表渲染，KaTeX 数学公式渲染，支持手动渲染开关
• 新增留言板和GitHub项目页面
• 对Markdown语法进行了扩展
• 支持自定义导航
• 支持修改分类图标
• 新增留言板和GitHub项目页面
• 文章现在支持内容弹窗和关闭点赞
• 文章现在支持插入视频和音乐
• 评论支持快捷输入颜文字以及qq、aru、tieba、weibo等多套表情图片
• 新增文章目录功能
• 评论支持图片验证码，可选cloudflare turnstile或图片验证码
• 优化评论区和底部备案内容信息显示
• 支持自定义邮件模板
• 修复了大量已知bug以及优化大量细节，提高使用体验以及安全性，详细请查看提交信息