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/           # PHPMailer 7.1.1 库
│   └── post-stats.php       # 文章统计
├── image/            # 主题默认图片
├── img/              # 图标资源
├── *.php             # 主题模板文件
└── readme.md         # 说明文档

🔧 配置说明

基本配置

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

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

🤝 参与贡献

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

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

📄 许可证

本项目采用 AGPL-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以及优化大量细节，提高使用体验以及安全性，详细请查看提交信息

版本 1.4.1

• 优化资源加载逻辑，改为按需加载重型第三方库

版本 1.5.0-rc.1

• 新增文章收藏功能
• 新增阅读进度追踪
• 添加评论引用功能，支持选中文章内容并插入引用到评论框
• 添加极验 Geetest v4 验证功能
• 重构搜索框为可收起式设计，优化移动端适配
• 调整文章按钮样式，新增点赞/收藏按钮组布局
• 重构主题后台配置页面样式，优化移动端体验
• 修复关闭pjax后cloudflare turnstile无法正常加载问题

版本 1.5.0-rc.2

• 添加文章投票功能
• 添加友链独立页面功能
• 新增天气卡片
• 新增文章浮动收藏按钮与阅读进度恢复功能
• 排除侧边栏已单独展示的留言板和GitHub页面导航
• SEO优化

版本 1.5.0-rc.3

• 默认启用半透明样式（1.5.x开始向半透明磨砂ui发展~）
• 重构侧边栏布局
• 新增渐变背景功能
• 默认启用Pjax加载、天气卡片、Mermaid和ECharts渲染默认功能
• 修复兰空图床上传问题，并对天气组件进行了美化
• 修复编辑器插入内容后自动跳转到底部的问题
• 历史文章修改后按修改时间排序的功能

版本 1.5.0-rc.4

• 切换项目许可证为AGPL-3.0
• 重构主题代码结构，拆分公共模块并优化多处逻辑
• 修复半透明背景下的文字可读性问题
• 将硬编码圆角替换为CSS变量统一管理
• 修复作者签名和github显示逻辑，空值时不渲染区块
• 新增后台表单AJAX提交和悬浮保存按钮，添加Toast提示
• 优化密码保护样式，替换原生加密逻辑，修复问题
• 修改检查更新逻辑，修复版本检测提示文案和样式错误
• 新增波浪文字和渐变圆环两种Pjax加载动画
• 添加推荐样式设置提醒与跨域图片下载功能
• 修复已知问题

版本 1.5.0-rc.5

在1.5.0正式版发布之前，不会新增功能。1.5.0的内容已确定，接下来将对之前增加以及本身存在的内容进行修复和优化，以确保其稳定性。

• 新增加载更多翻页
• 新增分类目录父子层级折叠功能
• 优化后台配置项，优化配置逻辑，优化内容
• 修复开启pjax后发布评论后无法点赞评论问题
• 修复代码块复制按钮随代码滚动的问题
• 升级灯箱到Lightbox3，以及升级PHPMailer到7.1.1版本并重构邮件功能
• 修复代码块复制按钮随代码滚动的问题
• 添加评论IP归属地显示功能
• 实现文章缩略图加载失败时自动替换为随机备用图
• 优化移动端logo显示逻辑
• 优化主题切换适配性，修复修改主题配色后部分按钮颜色不变，移除硬编码颜色
• 添加右侧边栏标签云功能并优化文章标签展示
• 修复动态加载下代码高亮不全的问题
• 新增全站后台AJAX接口CSRF防护，修复表情路径异常问题
• 移除ajax.js并整合相关逻辑到load-more.js
• 优化加载逻辑与缓存刷新机制，改进大文件上传处理
• 移除grid.css并清理相关引用，统一使用css变量替代硬编码颜色
• 修复已知问题，并进行了多项安全优化与功能完善