更新日志

支持通过 UPLOADS_DIR 自定义本地上传目录，将附件存储指向 .output 之外的独立路径，避免重新打包时已上传文件被清空；同时统一运行时资源（IP 库、验证码字体、WASM 等）的存储路径

完善 Docker 部署配置与运行时权限管理：自定义上传目录的卷挂载点自动跟随 UPLOADS_DIR，并优化容器内 node 用户对存储目录的写权限处理

优化 Dockerfile 构建流程与缓存策略，并自动化数据库初始化流程，首次部署时自动建表、写入默认设置与示例数据

修复 Docker 环境下 undici 依赖缺失导致的运行异常

启用 allowPublicKeyRetrieval 以解决 MySQL 8 连接失败的问题

移除未使用的依赖并优化脚本执行命令，加快安装与构建速度

新增运维脚本依赖管理与安装说明（bun run scripts:install），将较重的运维依赖从主项目拆分至 scripts/ 单独管理

小程序音乐支持完整歌单播放与切换，并新增实况照片（Live Photo）组件，点击静态图即可播放

修复小程序代码块图标字体显示为回滚字符（豆腐块）的问题：按需懒加载 Nerd Font 代码字体，仅在页面含代码块时加载，图标正常渲染

PWA 内联 workbox 运行时并支持缓存跨域资源，减少额外请求、提升离线可用性

小程序更新日志渲染支持行内 Markdown 与嵌套列表，展示更完整

小程序 API 新增 HMAC-SHA256 签名鉴权：请求需携带 X-Mini-Timestamp / X-Mini-Nonce / X-Mini-Sign 三个头，服务端按「方法+路径+时间戳+随机串」校验签名，时间戳偏差超过 ±300 秒视为过期，用定长比较防时序侧信道，挡住 curl 直连刷接口与评论机器人

修复验证码 svg2png WASM 文件加载路径：生产环境优先读构建产物 wasm/svg2png_wasm_bg.wasm，开发环境改用 require.resolve 按包解析定位 node_modules，不再依赖当前工作目录

移除 Prisma 迁移文件，改用统一的 SQL 初始化脚本（init-db.sql）建库

小程序升级到 2.0.0 版本，并重新选择了技术栈。新版小程序的技术栈使用uni-app (Vue 3 + Vite + TypeScript) ，UI 采用 wot-design-uni，原子化样式采用 UnoCSS。

404 页面新增 Singularity 黑洞背景效果（基于 WebGL ShaderToy）

修复地图 CDN 未配置时 CSP 拼接 undefined 的问题，补充地图交互样式

文章卡片改为封面全屏背景样式

优化图标按需加载策略，改进右键菜单与封面图

懒加载 Swiper 模块，直接动态导入 Swiper 具体模块文件以避免 barrel 整体打包

重构文件结构，移除冗余的 index.vue 与 index.get.ts 等路由文件

使用 v-scroll-reveal 指令替换旧的淡入动画实现

合并全局滚动监听至单一 rAF 调度器，减少滚动卡顿

修复 InspiraShaderToy 的 WebGL 上下文泄露：dispose 时断开 ResizeObserver 并移除 canvas 事件监听的 bug

修复文章页 MetingPlayer 子应用卸载时未 unmount，导致每次导航累积 Vue 子应用与 APlayer 实例的 bug

修复 image-loader 插件对已移除图片未取消观察，导致 SPA 导航时游离 img 引用常驻的 bug

修复文章页 Markdown 轮播 Swiper 实例卸载时未 destroy，泄露模块监听与 resize observer的 bug

修复关于页数字动画 RAF 循环与 initAnimations 递归 setTimeout 在卸载后仍执行的 bug

修复 APlayer 销毁时未清理 audio 事件、拖拽 document 监听与 skipTime/noticeTime 定时器的 bug

修复 useAudioPlayer 的 canplay 一次性监听在卸载时残留导致销毁后仍触发自动播放的 bug

移除 APlayer 全局 requestAnimationFrame polyfill 覆写，清理各组件未取消的定时器与死代码

地图组件卸载时主动调用 cluster.setMap(null) 触发聚合清理，不再单靠 map.destroy 兜底

引入 ESLint flat config 严格模式（含 stylistic 规则），修复全项目 lint 与 tsc 报错

建立独立 types 目录，统一 API 响应与组件类型定义，规范类型存放约定

统一 API 响应类型定义并优化类型推断，端到端类型走 Nitro InternalApi

APlayer 播放器从 JavaScript 重构为 TypeScript，补全类型定义

系统改造为单用户模式：移除用户管理总览与角色字段，账户设置页前置至原总览位置

新增数据库初始化脚本（db:init）与无用户探测接口 /api/auth/status

附件支持显示文件大小，上传时记录字节数并兼容历史记录

移除 Prisma 迁移与种子数据，改用幂等 SQL 脚本同步数据库结构

清理项目死代码：移除重复端点、未使用组件/工具函数与遗留迁移脚本

修复地图组件多余的 @amap/amap-jsapi-types 导入导致的生产构建报错

修复组件中的 Tailwind CSS 警告与 error 报错归一化

得益于全面的类型重构、死代码移除和用户模块精简，现在server的打包体积从23MB减少到14MB（压缩包）

重构更新日志数据模型，一条记录可承载多个更新条目并按类型分类展示

后台更新日志新增 JSON 文件一键导入能力

补充更新日志导入接口类型定义

首页更新日志展示调整为单条记录聚合展示

新增远程重启宝塔面板服务与清空 Redis 缓存接口

修复后台数据加载未完成时误显示暂无内容的问题

博客网络地图支持显示归属地和 ISP 信息

修复地图页面切换时重复缩放的问题

移除分类页骨架屏动画延迟，优化卡片间距与容器宽度限制

优化图片分类布局，现在图片分类每个图片更紧凑，分类按钮固定在左下角

修复留言板不支持评论锚点定位与高亮闪烁提示的bug

调整地图视图切换按钮的响应式样式

优化内容卡片布局，修复链接过长时图标不显示、文本溢出的bug

访客分布点改为显示头像（支持 Gravatar / Cravatar / WeAvatar，加载失败降级为首字母圆盘），不再只显示一个小圆点

优化地图渲染性能，新增标记 DOM 复用机制，解决缩放与聚散切换时头像闪烁、重复加载的问题

修复地图页 XSS 风险

修正访客分布聚合点数字，统一显示聚合点内访客人数

修正我的足迹省市统计，改为按坐标最近邻归类

IP 地址库由纯真 QQWry 切换为 ipdb，重写 IP 解析逻辑与数据同步脚本

优化主题切换颜色过渡，View Transition 期间禁用元素自身 transition，避免颜色滞后，顺便提升了亮暗模式切换的性能

移除评论提交后 3 秒的延迟，改为立即刷新列表，优化评论列表刷新时的布局偏移，增加静默刷新模式

修正部分城市坐标数据（安庆、烟台、昆明、西安等）

新增地图入口胶囊组件，在首页、分类、标签、留言、友链等页面展示旅行地图入口

文章版权区复用地图胶囊，支持按旅行地点逐个跳转

分类页、标签页、首页封面展示关联地图点数量角标

新增高德地图前端加载器与服务端代理配置

修复评论锚点 SPA 导航时的 scrollBehavior 告警

评论验证码由 SVG 明文改为 PNG 栅格化输出，降低被解析破解的风险

补充 robots、sitemap 与相关 API 字段

新增高德地图 JS API 依赖与环境配置

新增旅行地点数据库模型与管理接口

新增文章与旅行地点多对多关联功能

新增地图中心页、访客分布与博客网络地图

评论区新增反垃圾蜜罐与人机验证

优化搜索页请求逻辑与导航样式

修复评论表单字段校验与响应式问题

优化音乐播放容错机制，失败计数阈值下调至 3 次，卡顿或加载失败时自动停用并重置，播放成功重置计数

目录导航改为滑动指示框高亮，非激活态增加内嵌药丸悬浮效果

统一资源处理逻辑，强化 XSS 防护与资源路径校验

移除默认管理员种子数据，提升部署安全性

优化导航菜单交互（修复移动端溢出）与站点地图展示

根据站点 CDN 配置动态控制构建流程，支持无 CDN 部署模式

减少打包体积

重构音频播放器状态管理，保证 SSR 请求隔离防止状态串号

统一封面解析逻辑，修复因解析不一致导致封面显示缺失

优化友情链接页面和关于页面

实况照片支持移动端常驻播放按钮：点击后隐藏按钮并播放视频，播放结束自动恢复显示

将文章正文中的实况照片渲染逻辑提取为公共组件，与封面、列表页保持一致

新增 site.config.ts 全站配置中心，统一管理站点元数据、域名与各页面 SEO 文案

引入 uncategorized 虚拟分类，未分类的文章也能通过路由正常访问

增加免 nginx 的静态资源跳转，部署更灵活

列表页支持多封面图片及角标展示

代码块支持基于文件类型的动态语言图标

完善全站无障碍属性与键盘交互（a11y）：新增“跳转到主要内容”、ARIA 标签、键盘导航支持

修复图片分类与首页中实况照片点击播放按钮会触发链接跳转的问题

修复首页生产环境偶发的 SSR 水合错误（文章列表相对时间、canonical 链接在服务端与客户端不一致）

修复关于页技能图标悬浮样式错位及统计项显示逻辑

修复严格模式下的多个类型安全问题和潜在空指针错误

修复导航菜单点击后未收起的问题

修复音频播放器随机歌曲可能的越界风险

修复Fancybox组件全局销毁导致页面切换时灯箱插件失效的bug，现在使用Fancybox.unbind而不是Fancybox.destroy

后台订阅源新增编辑功能

归档页面新增折叠交互，文章过多时页面不会过长

更新日志支持通过侧边类别筛选

我的订阅页面支持选择某一具体订阅者查看详细文章

优化了搜索功能，由于现在网站文章数量不多，暂时使用LIKE关键字查询，并使用Redis做搜索结果的缓存。

重构首页数据查询，修复 N+1 查询问题

优化首页大标题字体大小

友情链接页面新增一键通过功能

优化了修改友情链接的功能

页面首次加载时可以点击以直接加载内容

后台页面现在可以区分一个友链申请是新增的还是修改已有链接的

统一页面加载时间为0.3秒

优化Service Worker和Workbox设置

优化全局右键菜单，新增v-context-memu指令，可在vue组件内自由定义右键菜单内容

优化亮色模式切换性能，为firefox的亮暗模式切换做好回退

友情链接页面新增加入的博客组织模块

修复评论间隔设置总为60秒的bug

修复移动端协议页面渐入动画不加载的bug

修复移动端MBTI组件溢出的bug

分类页面新增骨架屏效果

优化用户获取和站点信息获取，由每个页面单独请求改为全局复用

修复评论组件 IP 不能正确存储到数据库的 bug

增强 API 端点 Referer 校验

移除未使用的头像预加载

更新 Shiki 代码高亮主题，采用 Jetbrains Island 主题

系统后台增加最新评论显示、热门文章显示、详细统计数据

优化实况照片的显示效果

文章正文新增瀑布流图片和小卡片链接

修复了生产环境Redis缓存不生效的bug

移除了主页的二维码显示

更新日志支持输入更长的内容，支持简易 Markdown 解析

修复相关文章总是显示最新3篇文章的bug

本次更新完成了缓存策略优化（Redis配置与ISR缓存）、组件性能改进（修复内存泄漏、优化渲染）以及本站信息卡片模块新增。

refactor(nuxt): 重构Nitro存储配置与ISR缓存策略，重构storage配置，分离redis、cache与fs存储点

feat(feed): 缓存并优化 RSS Feed 生成逻辑

fix(components): 修复组件卸载时的内存泄漏问题；修复 FrontNotification 事件监听器未正确移除的问题；为 LivePhoto 组件添加定时器清理和 Blob URL 释放；优化内容页面 DOM 事件监听器的清理逻辑

refactor(首页): 优化数据加载，合并API请求并添加缓存策略，优化分类文章查询，减少数据库往返

增加前台通知系统，支持显示系统通知和消息

优化邮件通知功能，增加评论锚点跳转

实现实况照片功能，支持在文章中嵌入实况照片，鼠标悬停或点击可播放动态效果

订阅源管理页面增加操作成功提示，包括添加、删除、手动更新订阅源等操作的成功和失败提示

后台管理页面增加管理员快捷入口，支持快速访问常用功能

实现后台响应式布局

优化后台管理功能与交互体验

增加操作成功提示

完善全站 SEO 元信息配置，包括标题、描述、关键词等

增加社交媒体分享卡片配置，支持 Open Graph 和 Twitter Card

实现 XML 站点地图功能

集成 PWA 功能，支持离线访问和安装到主屏幕

支持 PWA 动态图标功能，根据设备主题自动切换图标样式

配置 Nginx 静态资源重定向至 CDN，优化网站加载性能

集成 CDN 支持到 PWA 配置中

优化主题切换性能

优化构建配置，增加 Node 内存限制

实现全局右键菜单功能

集成 Floating-Vue 实现工具提示交互

实现滚动条主题定制功能

实现 Header 基于滚动方向的内容切换与动效

优化移动端底部按钮组交互与布局

分类页面增加分页功能

优化分类创建流程，重构路由结构

重构标签系统与分类模型，支持多对多关联

文章管理页面增加预览功能，支持在新标签页中预览文章

文章页面底部增加最近文章展示，展示最新的4篇文章

实现代码块文件名显示功能，优化编辑器样式

实现评论同步主楼与回复框的用户信息功能

实现评论显示 IP 属地与运营商信息功能

优化评论表情解析逻辑

优化邮件通知功能，增加评论锚点跳转

增加 CSRF 安全校验，保护后台管理接口免受跨站请求伪造攻击

优化登录认证流程，修复 Dialog 状态管理问题，提升系统安全性