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. 友链展示 - 免插件支持友情链接展示
18. 编辑器专注模式 - 全屏沉浸写作（隐藏后台界面）、当前段落高亮、打字机效果、专注内实时预览（左写右看，与前台同款渲染）
19. 图片滑块 - 正文插入多图轮播 [gallery:图1|图2|图3]，加 noslide: 可改为网格平铺
20. 免保存预览 - 不写草稿即可用前台同款样式预览编辑器当前内容

🖼️ 主题预览

前台页面

首页 —— 日间 / 深色双主题（一键切换）· 侧边栏目录 · 天气卡片 · AI 站点助手悬浮入口

文章页 —— 图片滑块轮播 · 引用卡片 · 代码高亮与复制 · 文章目录

移动端界面

移动端首页（日间 / 深色）

移动端文章页 —— 图片滑块轮播（左右滑动切换）、代码块复制、文章目录

主题后台

设置界面 —— 15 个分组标签 · 版本更新检测 · 右下角 AI 设置助手

编辑器

工具栏全展开 —— 格式 / 插入 / Markdown 扩展 / AI 写作助手

专注模式 —— 隐藏后台界面、当前段落高亮、打字机效果、底部悬浮操作条（Ctrl+J 进入，Esc 退出）

专注模式 · 实时预览 —— 左侧书写、右侧按前台同款样式实时渲染（支持图片滑块、引用卡片、代码块等全部扩展语法）

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

🚀 安装使用

安装步骤

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变量替代硬编码颜色
• 修复已知问题，并进行了多项安全优化与功能完善

版本 1.5.0-rc.6

原谅我又加了几个功能...。。。主要是我觉得1.5.0对比1.4.0升级的内容不够多，不够惊艳，不够有创新

• 新增文章AI总结功能，优化AI服务统一调用逻辑重构
• 新增了 Cat-Captcha 人机验证
• 新增悬浮操作组，优化文章页悬浮按钮交互
• 新增两套主题样式
• 修复加载更多后新文章链接Pjax绑定缺失问题
• 新增首页弹窗公告功能，支持多种弹窗模式和内容配置
• 新增样式存储功能，支持保存、应用和删除外观预设，优化主题设置体验
• 修复已知问题

版本 1.5.0-rc.7

dev 版本，主要针对评论与后台保存的稳定性修复

• 修复评论提交超时问题：邮件通知 SMTP 增加超时限制，Pjax 评论提交超时放宽至 45 秒
• 修复后台设置保存静默失败问题：改为逐字段校验的 JSON 保存接口，非法 URL 自动清洗或忽略并高亮提示

版本 1.5.0-rc.8

历经一个月的密集开发：编辑器三阶段重构 + AI 助手全套 + 文章引用语法 + 评论区增强，内容较多较杂，稳定度请以实际体验为准

• 编辑器重构（三阶段）：焦点写作模式（隐藏干扰元素、段落高亮、打字机效果、悬浮操作条）；本地自动保存与恢复横幅（原生自动保存选项读取有缺陷，主题侧补齐）；图片粘贴/拖拽直传与工具栏「更多」收纳；移动端 395px 实测适配
• 悬浮操作条后台化：去除浓重的 AI 风格，对齐 Typecho 后台设计语言（圆角、配色、Font Awesome 图标体系）
• 免保存实时预览：点击预览即用前台同款渲染管线渲染编辑器当前内容（无需先保存），预览正文与前台逐字节一致；修复 Typecho 原生预览对新文章静默无响应的问题
• 文章引用语法：正文支持 [cite:cid] Markdown 增强语法，独占段落渲染为块级引用卡片、行内渲染为小卡片，可跳转被引文章
• 评论引用：评论区支持引用站内其他文章，与表情按钮合并为同一工具行
• 评论区增强：「加载更多」分批显示（每页 6 条）+ 渐变胶囊按钮动效；修复 pjax 进入文章页评论不折叠的问题
• AI 站点助手重构：流式输出（SSE）、推荐问题、停止生成、快捷键、复制；AI 回复支持 Markdown 渲染；入口与悬浮展开按钮合并；修复 JSON Schema 空数组导致接口 400 的工具调用失效问题
• AI 连续对话与后台设置助手：文章页对话区连续对话，后台 AI 设置助手（悬浮入口、流式回复、工具调用双通道、文本协议兜底），后台 AI 设置区整理为「开关 → 接口 → 参数」五分区
• Cat-Captcha 升级：SDK 2.0.0，启用算法 v2（行为轨迹分析）
• 推荐样式扩至 8 套，预览图全部使用当前站点真实截图
• 修复窄屏（≤480px）横向溢出 5px；修复移动端卡片模式列表圆角不统一
• 收紧侧边栏「其它」板块展开后首项上方空白；收紧引用卡片上下间距

版本 1.5.0-rc.9

以编辑器体验与文章排版为主的一轮，含一处破坏性变更（移除内置免费 AI 接口）

• 文章图片滑块 [gallery:]：[gallery:图1|图2|图3] 轮播（自动播放 5s、悬停与切后台暂停、左右箭头、指示点、计数、移动端触摸滑动）；[gallery:noslide:图1|图2] 网格平铺；仅一张图时自动降级为静态图；灯箱自动接管，滑动后 400ms 内的点击被拦截以防误开
• 专注模式实时预览：专注悬浮条新增「预览」按钮，右侧 480px 双栏实时渲染，走前台同款渲染管线（[cite:]、[gallery:]、图片扩展全部生效）；输入 700ms 防抖、请求序号丢弃过期响应、刷新保持滚动位置、开关写入偏好记忆
• 编辑器工具栏全展开：取消「更多」收纳，全部插入按钮平铺主行（桌面 2 行、395px 移动端 6 行，逐按钮命中测试无遮挡误触）
• 全屏与专注合并：专注模式即全屏沉浸写作，移除原生「全屏」按钮及相关布局补丁；Ctrl+J / Ctrl+E 改接专注模式切换与退出
• 图片存储后台统一风格：Profile 列表由第三方组件风（8px 圆角、绿色系激活态、蓝底弹窗头）改为 Typecho 后台设计语言（白卡细边框、浅蓝激活态 + 左侧主色竖条、仿原生按钮、灰底弹窗头）
• AI 接口错误中文化：连接被中断、域名解析失败、连接超时、无法连接、SSL 证书问题均追加中文可操作提示，不再只抛原始英文
• 移除内置免费 AI 接口（破坏性）：其地址与密钥硬编码在主题内且已随公开仓库泄露，三处提供商选项仅保留自定义接口；老配置 provider=free 自动降级为「自定义 Chat Completions」（不报错，仅提示需自行填写接口）
• 修复：代码块内的 [gallery:...] 语法示例被当作真实语法渲染出破图（新增 <code>/<pre> 占位保护）；内容缓存版本因子漏算 media.php，改短代码渲染后线上不更新
• 修复：点「预览」后编辑区宽度跳变、右侧「发布日期/分类」被挤开——预览改为独立 fixed 浮层（不再借用原生 fullscreen/preview class），尺寸改用 width:100%（100vw 含传统滚动条会横向溢出，四边定位对 iframe 这类替换元素不拉伸）
• 修复：编辑器自带「撰写 / 预览」标签页切换后主栏变宽、右侧信息栏被推走（flex 子项 min-width:auto 被长代码块顶开）
• 修复：前台 AI 对话窗透明度过高导致背景正文透出、内容看不清（面板改为 97% 不透明 + 毛玻璃，气泡、输入框、建议项改实色）
• readme 演示图全部重拍：桌面 6 张（首页日间/暗色、文章页、主题后台、编辑器、专注模式、专注实时预览）+ 移动端 3 张（390×844 @2x）

版本 1.5.0

历时四个月、109 个提交的大版本升级：半透明磨砂 UI、AI 能力全套接入、编辑器全面重构、文章互动体系与人机验证全新升级

• 新增：[gallery:] 文章图片滑块（轮播/网格）、[cite:] 文章引用语法、文章 AI 总结、AI 站点助手（流式输出/连续对话/推荐问题）、后台 AI 设置助手（对话式读写设置）、免保存实时预览、专注模式实时预览双栏、焦点写作模式（段落高亮/打字机）、本地自动保存与恢复、文章收藏/点赞/投票、阅读进度追踪与续读、评论引用/点赞/IP 归属地/加载更多、Cat-Captcha v2（行为轨迹分析）与极验 Geetest v4、天气卡片、首页弹窗公告、标签云、分类层级折叠、加载更多翻页、友链独立页面、样式预设存储（8 套推荐样式）、半透明磨砂 UI 与渐变背景、多 Profile 图床管理与图片粘贴/拖拽直传
• 优化：编辑器工具栏全展开、全屏与专注合并为单入口、图片存储后台统一设计语言、AI 接口报错中文化、移动端 395px 全面实测适配
• 安全：后台 AJAX 接口 CSRF 防护、密码保护逻辑替换原生实现、许可证切换为 AGPL-3.0
• 移除：内置免费 AI 接口（升级后自动降级为自定义接口并提示，需自行填写 AI 接口）
• 修复：大量已知问题，完整变更请查看提交日志与各 rc 版本说明