更新日志
记录平平的小破站每次版本迭代的新功能、优化改进、Bug修复和工程规范变更
0
新功能
0
优化改进
0
Bug修复
0
维护更新
v2.1.0
2026-08-03
重大更新
17项优化 + 客服修复 + 知识库扩展 + RSS同步
新功能
7 项
- 新增作品集页面(portfolio.html),展示站点项目成果与开发历程
- 新增问答知识库欢迎引导,包含 11 个相似问题入口和 3 个随机回答,覆盖基础信息、博客系统、友链系统等功能介绍
- 新增站点管理员「雪希希SnowXixi」,身份为程序开发者 & 技术博主
- 新增文章末尾作者署名模块,提升内容归属可读性
- 新增静态内链系统,优化站内导航与 SEO 表现
- 新增系列内容产品化展示,提升专题系列的内容聚合度
- 新增长尾关键词布局,覆盖更多搜索场景
优化改进
8 项
- 增强邮箱订阅框可见性,提升用户转化率
- 优化分层留存钩子,改善用户留存体验
- 统一分类颜色一致性,视觉系统更协调
- 修复推荐文章加载状态显示异常,优化加载体验
- 优化代码语法高亮显示效果
-
优化客服系统缓存控制,JS/CSS 文件添加
Cache-Control: no-cache, must-revalidate - 完善微信表情映射([色]→😍、[脸红]→😳 等),提升客服对话体验
- 优化客服系统资源版本号管理,agent.js/agent.css 添加版本参数强制浏览器刷新
Bug修复
6 项
- 修复客服系统图片、视频、表情无法显示的问题(浏览器缓存旧版 agent.js 导致)
-
修复微信回调 XML 解析问题,确认消息内容从
msg字段正确提取 - 修复推荐文章加载状态异常显示
- 修复代码语法高亮显示错误
-
修复代码复制按钮重复添加问题(添加前检查已有
.code-header) - 修复客服链接从 jk.ppkjgzs.top 更正为 kf.ppkjgzs.top
维护更新
5 项
- 统一邮箱地址为 ppdxpz@qq.com100 文件
- 更新公安备案信息为「冀公网安备13020202000699号」115 HTML
- 更新RSS订阅源:移除 6 个死链,新增 14 篇文章,现有 87 篇(与文章目录同步)
-
清理临时调试日志(
[回调原始XML]和[回调解析]),保留必要事件日志 - 完成17 项网站优化(P0×3 + P1×6 + P2×6 + P3×2),共修改 99 个文件99 文件
工程规范
12 项
- 所有页面必须引用 main.css 保证样式一致性
- 内联 CSS/JS 必须提取为外部文件(index.css、index.js、article-enhance.css)
- data-animate 元素必须包含 fallback 可见性处理,防止永久隐藏
- 返回顶部按钮由 main.js 统一管理,禁止内联按钮和脚本
-
代码块复制按钮添加前检查已有
.code-header,避免重复 -
HTML 页面必须包含 skip link(
href="#main-content")和<main>元素 -
所有图片引用使用 WebP 格式并添加
type="image/webp"属性 - 折叠以下图片添加 loading="lazy" 属性(如头像 tx.webp)
- HTML 页面必须包含 manifest.json 引用以支持 PWA
- CSS 必须包含 prefers-reduced-motion 媒体查询,为减少动画偏好用户禁用动画
- 按钮、链接和卡片必须添加 touch-action: manipulation 防止移动端双击缩放延迟
- 导航栏在视口宽度 ≥768px 时切换为水平布局,调整字号(0.8rem)和间距
经验教训
8 项
- IntersectionObserver 在部分浏览器可能失效,需添加 200ms 超时兜底强制显示
- file:// 协议下 fetch 外部 API 会触发 CORS 错误,本地开发需嵌入静态数据
- API 相对路径导致请求发送到前端域名而非 API 服务器,需使用绝对路径
- Google Fonts(fonts.googleapis.com)在国内引发 502 错误,改用国内镜像 fonts.googleapis.cn
- server.js 存放在网站根目录会通过公开访问泄露敏感凭据,需 Nginx 拦截并迁移环境变量
-
Nginx 配置文件不可包含反引号(
`),Nginx 1.30.3+ 会报语法错误 - 使用 koa-connect 包装 Express 中间件会导致 ctx.state 数据丢失,需原生 Koa 中间件重写
-
GET /api/articles/latest 接口硬编码 limit 为 20,需单独的
/api/articles/list接口获取完整列表
v2.0.0
2026-07-26
架构升级
现代化主题重构 + 玻璃拟态 + 暗色模式 + PWA
新功能
6 项
- 上线现代化主题 2.0,采用蓝紫渐变色调与玻璃拟态(Glassmorphism)设计
- 新增暗色模式切换,支持手动切换与系统偏好自动跟随
- 新增PWA 支持,包含 manifest.json 和 Service Worker 离线缓存
- 新增专题系列页面(series.html),聚合同主题文章
- 新增在线客服系统(jk-kefu),支持微信消息回调与自动回复
- 新增邮件订阅系统,支持自动发送 Newsletter
优化改进
5 项
- 全面采用CSS 变量管理主题色,支持一键切换明暗主题
- 优化响应式设计,适配移动端、平板和桌面端
- 添加骨架屏加载占位,改善首屏加载体验
- 优化SEO 结构化数据,添加 JSON-LD Schema.org 标记
- 添加Open Graph 和 Twitter Card 元标签,优化社交分享
维护更新
3 项
- 后端服务迁移至 PM2 进程管理,通过 ecosystem.config.js 注入环境变量
- 部署 Nginx 反向代理,配置安全头与静态资源缓存策略
- 建立自动化备份机制,定期备份文章和数据库
v1.0.0
2025-12-01
初始版本
站点上线 + 博客系统 + 文章管理 + 资源下载
新功能
5 项
- 平平的小破站正式上线,分享 Python 游戏开发、前端技术和编程技巧
- 上线博客系统,支持文章分类、标签、归档和搜索
- 上线资源下载页面,提供 Python 游戏源码和实用脚本下载
- 上线友情链接系统,支持 API + 静态回退加载
- 上线用户反馈系统,收集用户建议与问题报告
维护更新
2 项
- 完成ICP 备案(浙ICP备2025194709号)和公安备案
- 部署 HTTPS 证书,启用全站加密访问