更新日志

主页背景图片随机方案#

• 主页桌面端背景图支持多方案随机展示（home1/home2/home3/home4…）
• 每个方案包含背景图（home.webp）和装饰图（home2.webp），作为一套使用
• 自动扫描 public/assets/images/home/ 文件夹，新增方案无需改代码
• 使用秒数轮转确保连续刷新不会重复显示同一方案
• 移动端背景图独立随机，使用 localStorage 确保每次刷新都不同
• 移动端背景图切换时添加淡入效果，避免闪烁

无限滚动加载#

• 说说页面和更新日志页面添加无限滚动加载功能
• 初始只显示前 5 条内容，滚动到底部自动加载下一批
• 使用 IntersectionObserver 实现，支持降级方案
• 添加加载动画指示器
• 修复 Swup 导航后无限滚动失效的问题

文章封面图随机化#

• 文章列表卡片封面图每次刷新页面都会随机切换
• 服务端使用 Math.random() 实现，无需客户端 JavaScript
• 支持 62 张随机封面图

评论系统修复#

• 修复从其他页面导航到说说页面后评论按钮失效的问题
• 评论事件监听器移到 Layout.astro（Swup 容器外部），保证始终执行
• 使用事件委托处理所有评论按钮点击

说说页面优化#

• 移除外部说说功能，简化页面结构
• 添加无限滚动加载，提升页面性能

加载动画优化#

• 移动端加载动画硬超时从 2 秒缩短到 800 毫秒
• 桌面端加载动画硬超时从 2 秒缩短到 1.5 秒
• Swup 导航时强制隐藏 PageLoader，防止阻挡其他页面点击

随机封面图脚本#

• 新增 pnpm rename-images 命令，自动重命名图片为数字形式并更新配置
• 新增 pnpm import-wallpapers 命令，从 Hao Wallpaper 导入壁纸

其他改进#

• 个人资料小组件背景图改为静态图片
• 恋爱小组件标题显示总天数
• 关闭桌面端主页雨滴特效

朋友圈页面#

• 新增 /circle/ 页面，自动抓取并展示好友最新文章
• 数据来源：hexo-circle-of-friends Simple Mode，通过 EdgeOne 托管的 JSON 文件
• 4 列响应式网格布局，支持无限滚动加载
• 统计栏显示友链总数、活跃数、文章数

卡片设计#

• 标题左上角，博主名称左下角胶囊标签
• 头像右下角半透明水印，悬浮时放大变清晰
• 日期覆盖在头像图层上方
• 卡片悬浮上浮效果

动态通知条#

• 从最新 6 篇文章中随机展示一条
• 点击刷新按钮显示「钓鱼中…」动画后切换新文章
• 博主名称橙色可点击，文章标题红色可点击

AI 摘要图标#

• AI 摘要图标改为 OpenAI logo
• 亮色模式显示黑色图标，暗色模式显示白色图标

后台友链管理#

• 添加友链支持新的 YAML 格式识别
• 支持 name、link、avatar、descr 关键字
• 兼容原有格式，两种格式均可识别

技术实现#

• 使用 hexo-circle-of-friends 项目抓取好友文章
• EdgeOne Pages 托管 data.json，配置 CORS 跨域
• 自定义 Firefly 主题 CSS 选择器规则
• Astro 组件样式使用独立 CSS 文件解决 scoped 失效问题
• Swup 兼容：astro 事件 + 初始化标记重置

登录页夜空背景#

• Canvas 绘制 120 颗闪烁星星，alpha 在 0.2~1 之间循环呼吸
• 流星从右上角随机出现，每 2~7 秒一条，带白色头部光晕，滑向左下角

角色入场动画#

• 紫色：变成正方块从左边页面外顺时针翻滚 360° 进来，落地后恢复原样
• 蓝色：从上面页面外用边缘翻跟头下来，带 scaleY 压扁变形效果
• 橙色：从左侧页面外小圆球形态一蹦一跳进来，弹跳间距递减
• 黄色：从下方页面外地底先探出小脑袋，再逐渐钻出来
• 四个角色依次入场，各有不同延迟

角色表情交互系统#

• 默认状态：眼睛、嘴巴、身体全部跟随鼠标 3D 移动（faceX/faceY/bodySkew）
• 开始输入密码：紫色前倾 + 蓝色靠拢互相看（0.8 秒），眼睛容器偏移
• 隐藏密码输入中：紫色偷看键盘，蓝色靠拢，眼睛强制看向键盘方向，身体变高
• 密码可见：所有身体转正，眼睛看向左上角假装不看，紫色每隔 2~5 秒偷瞄一次

角色造型调整#

• 黑色小人改为蓝色 #3b82f6（夜空背景下可见）
• 四个小人嘴巴各不相同：紫色微笑弧线、蓝色平线、橙色圆嘴、黄色大笑
• 嘴巴跟随鼠标微微移动，增强 3D 效果

登录表单优化#

• 新增用户名输入框，默认填充 dumplingandecake
• 密码框右侧添加显示/隐藏切换按钮（👁/🙈）
• 切换密码可见时角色会转头不看，眼睛偷偷瞄回来
• 标题改为 “Welcome back！“，副标题改为 “输入密码以进入团子的后台”
• 移除右下角主题切换按钮

相册页面优化#

• 预览照片数量从 5 张改为 4 张
• hover 摊开间隔从 80px 缩小到 30px

后台管理 UI 改造#

• 全新后台管理界面，零外部依赖，纯 CSS 手写
• 统一顶栏：横跨整个页面宽度，显示页面标题 + 博客品牌名
• 深色侧边栏：#0f0f14 深色背景，带微紫光晕，左侧 3px 紫色指示条标识当前页
• 侧边栏图标：每个导航项前有图标（◉ 仪表盘、✎ 说说、▤ 笔记、⚭ 友链、▶ 影视、◎ 足迹）
• 暗色模式：侧边栏始终深色不受影响，主内容区跟随切换
• 移动端适配：侧边栏隐藏，顶栏显示汉堡按钮，点击下拉展开导航菜单

后台架构重构#

• 新增 AdminLayout.astro 布局组件，所有后台页面共用
• 登录页独立（无侧边栏），登录后所有页面共享侧边栏
• 新增 /admin/dashboard/ 仪表盘页面，Token 统一在此管理
• 子页面不再各自管理 Token，统一从 localStorage 读取
• 移除子页面的 Token 输入栏和连接状态栏

双栏布局改造#

• 说说、友链、影视、足迹管理页面统一改为双栏布局
• 左栏：编辑/表单区
• 右栏：列表/数据区
• 桌面端左右各占一半，移动端自动堆叠
• 笔记管理保持全宽（编辑器需要宽度）

迁移脚本修复#

• gist-migrate 新增 places（足迹）迁移支持
• 修复 .env 文件读取：脚本现在自动加载 .env 中的 GITHUB_TOKEN
• 修复 readExistingIds 正则 bug：^# id: 改为 ^id:
• 足迹迁移格式统一：文件名只用日期，用 date + city 组合去重
• 数字标签自动加引号（"2026" 而非 2026）

CLI 更新#

• pnpm cli gist-migrate 新增 places 选项
• 帮助文本同步更新

构建错误修复#

• 问题：npm run build 报错 NoAdapterInstalled，无法构建
• 根本原因：src/pages/api/place.ts 声明了 prerender = false（需要 SSR），但项目未配置 SSR adapter
• 分析：该 API 的 CRUD 功能实际未被使用（后台通过 GitHub Gist 存储数据），仅地理编码功能被调用
• 修复：删除 api/place.ts，将地理编码改为前端直接调用高德 API

迁移脚本修复#

• 修复 scripts/MigrationFootprint/index.js 的 remaining 逻辑 bug：无日期、重复、写入失败的条目现在始终保留在 Gist 中，避免默认模式下误清全部数据
• 新增 --token=ghp_xxx 命令行参数支持，优先级：命令行 > 环境变量 > .env 文件 > config 文件
• 修复 YAML 序列化：数组元素（tags 等）统一加引号，避免纯数字值（如 "2025"）被解析为 number 类型导致 schema 校验失败

首页标题彩虹着色#

• “Dumpling” 标题改为逐字母 <span> 渲染，每个字母独立着色
• 颜色方案：D 深红 → u 珊瑚橙 → m 琥珀金 → p/l 浅金 → i 翡翠绿 → n 蓝色 → g 紫色
• 逐字弹入动画：back.out(1.4) 弹性效果，0.04s 间隔依次入场
• 修复 HatchEffect 铅笔线条效果：originalColor: true 保留字母原色，不再覆盖为白色
• VFX canvas zIndex 降低为 10，避免遮挡弹窗等高层级元素

首页磨砂玻璃移除#

• 移除人物图片（home2.webp）背后的 .home-hero__art-window 磨砂玻璃卡片（display: none）
• 原因：新更换的人物图实际为 PNG RGBA 格式（带透明通道），透明区域露出了下方的 backdrop-filter 效果

友链页面手绘风格改造#

• 新增 FriendCard.astro 组件：垂直卡片布局，顶部胶带标签 + 头像 + 名字 + 介绍框
• 手绘风格设计：稿纸横线背景、不规则圆角（255px 14px 225px 14px）、硬阴影偏移
• 涂鸦头像 fallback：加载失败/超时时显示手绘脸（头发 + 眼睛 + 腮红 + 微笑），带眨眼动画
• 介绍框悬停扩展：默认1行，hover 时扩展到6行，所有卡片统一高度
• 标签筛选改为胶囊按钮 + 滑动指示器（ease-[cubic-bezier(0.4,0,0.2,1)]）
• 新增分页功能：每页9个友链，带页码导航
• 头像按需加载：卡片可见时才注入 src 触发请求，解决 Swup 导航后 loading=lazy 不生效的问题
• Gist 外部友链适配新卡片结构
• 修复 Swup 导航后布局错乱：双帧 requestAnimationFrame 延迟定位指示器

分类标签页面改造#

• 新增 CategoryRose.astro 组件：ECharts 玫瑰图（roseType: "area"）展示分类分布，右侧分类列表支持 hover 放大
• 新增 TagGraph.astro 组件：ECharts 力导向图展示标签共现关系，节点大小按文章数缩放，连线粗细按共现次数缩放
• 新增 tag-graph-data.ts 工具函数：构建标签共现图谱数据（nodes + links），支持配置共现阈值
• 标签图谱支持拖拽、缩放、平移，hover 高亮相邻节点（emphasis: adjacency）
• 图表动态加载 ECharts CDN，支持暗色主题实时切换
• 点击图表节点/列表项跳转对应分类/标签页

首页玻璃雨珠特效#

• 新增 Canvas 2D 雨珠系统：竖向水痕 + 底部圆点高光，模拟镜头玻璃上的雨水
• 撞击迸溅：雨滴碰到聊天框（.home-hero__speech）和装饰角标顶边时生成扇形水花粒子
• 底部迸溅：雨滴落到底部同样产生水花
• 性能控制：雨滴数量 ~20-60 个，水花上限 90 个，移动端和减弱动效模式自动禁用
• 雨珠固定白色，不随主题切换

网站导航管理脚本#

• 新增 scripts/add-daohang/index.js：交互式添加网站导航条目
• 自动获取 ICO 图标（调用 xxapi.cn 免费 API）
• URL 查重：检测网址是否已存在，支持编辑模式（预填原值）和新建模式
• 编辑模式：所有字段预填原值，回车保留，自动重新获取 ICO 以修复失效图标
• 智能分类：预设分类 + 已有文件分类自动合并，支持创建新分类
• 颜色选择：9 种预设颜色 + 自定义色值
• 自动排序：新条目自动分配 order 值
• 注册到 CLI 菜单：pnpm cli nav
• 新增使用文档文章：《网站导航管理脚本使用指南》

足迹管理后台#

• 新增 /admin/places/ 后台页面，支持在出门在外时通过浏览器快速创建足迹
• 表单包含省份、城市、详细地址、日期、到访次数、体验描述、标签、照片等字段
• 坐标获取：填写地址后一键调用高德地图地理编码 API（含 POI 搜索 fallback），自动填充经纬度
• Token 输入框置于页面顶部，与说说、笔记本等后台保持一致的 UI 风格
• 支持编辑、删除已有足迹条目

Gist 暂存机制#

• 后台添加的足迹数据直接保存到 GitHub Gist（暂存库），不写入本地文件
• 博客足迹页面只展示本地 Markdown 数据，与 Gist 暂存数据完全隔离
• 数据格式与本地 frontmatter 字段一一对应，便于后续迁移

足迹迁移脚本#

• 新增 scripts/MigrationFootprint/index.js，一键将 Gist 中的暂存足迹迁移为本地 Markdown 文件
• 支持 --dry-run（仅预览）和 --keep-gist（迁移后保留 Gist 数据）参数
• 自动按日期+省份+城市去重，同名文件追加序号

足迹地图 Swup 导航修复#

• 问题：从首页导航栏点击跳转到足迹页面时地图不显示，需手动刷新才能加载
• 根本原因：项目使用 Swup 进行页面切换，只替换 #swup-container 内容，不重新执行外部脚本；原脚本放在 #swup-container 外部，导航时不会执行
• 修复：将初始化脚本通过 slot="head" 移入 <head>，利用 @swup/head-plugin 在导航时自动重新执行脚本

后台影视管理#

• 新增后台影视管理页面（/admin/bangumi/），支持搜索并添加影视记录
• 三源搜索聚合：同时搜索 TMDB、豆瓣、Bangumi，点击结果自动填充表单
• 搜索结果显示封面缩略图、标题、年份、来源标签
• 自动填充：标题、中文名、封面 URL、类型、标签
• 支持手动调整：类型（动漫/电影/电视剧/纪录片/游戏）、状态、评分、标签、备注、时间
• 封面预览功能
• 编辑功能：已有数据支持修改所有字段
• 删除功能
• 影视数据存储在独立 GitHub Gist 中（bangumi.json）

影视页面数据合并#

• 影视游戏页面（/movies-games/）自动从 Gist 加载外部影视数据
• 外部数据与本地数据按时间排序混合显示，不分离
• 外部数据自动匹配对应分类 Tab（动漫/电影/电视剧/纪录片/游戏）
• Tab 计数和筛选按钮计数（看过/在看/想看等）自动包含后台数据
• 修复筛选按钮在本地无对应状态数据时被隐藏的问题
• 修复抛弃状态数据不显示的问题
• 修复首次进入页面数据重复插入的问题

最近更新组件同步#

• 最近更新组件自动加载影视 Gist 数据，与本地数据合并显示
• 数据按时间排序，不与本地数据分离

首页跑马灯同步#

• 首页跑马灯公告自动统计影视 Gist 中最近 3 天更新的数据
• 在 [更新] 部分追加影视更新数量，与本地数据合并显示

影视脚本多源降级#

• fetch-media 脚本新增多源降级策略：TMDB → 豆瓣 → Bangumi → 手动模式
• 解决国内影视、动漫、纪录片在 TMDB 搜不到的问题
• 下载函数添加 User-Agent 和 Referer 头，防止被服务器拒绝

后台友链管理#

• 新增后台友链管理页面（/admin/friends/），支持通过粘贴文本自动解析并添加友链
• 支持格式：站点名称: xxx / 站点描述: xxx / 站点链接: xxx / 头像链接: xxx
• 实时预览功能，输入时自动显示友链卡片预览
• 友链数据存储在独立的 GitHub Gist 中（friends.json）
• 友链页面自动从 Gist 加载外部友链，与本地友链合并显示
• 后台首页添加友链管理入口

主题切换修复#

• 修复从其他页面进入说说页面后，导航栏亮暗色切换按钮点击无反应的问题
• 原因：FloatingDock 使用模块脚本，Swup 替换内容后事件监听器丢失
• 将主题切换改为 document 级别事件委托，不受 Swup DOM 替换影响

置顶说说页面修复#

• 修复置顶页面图片无法点击放大的问题：添加 data-fancybox 和 data-src 属性
• 修复暗色模式下说说文字不可见的问题：var(--text-color) 改为 var(--deep-text)
• 修复暗色模式下”置顶说说”标题不可见的问题

首页导航栏遮挡修复#

• 修复首页 “Dumpling” 文字 VFX 特效遮挡导航栏的问题
• 将 VFX canvas 挂载目标从 document.body 改为 hero 元素内部

影视游戏页面按钮样式改版#

• Tab 切换和筛选按钮改为与更新日志一致的胶囊风格
• 添加滑动指示器动画效果
• 修复切换 Tab 时筛选指示器未初始化的问题

友链页面暗色模式修复#

• 修复暗色模式下标签筛选按钮选中后背景为白色、文字也为白色导致看不清的问题
• 按钮激活态添加 dark:text-neutral-900 确保暗色模式下文字为深色

音乐页面重设计#

• 全新沉浸式黑胶唱片播放器 UI（旋转唱片 + 唱针臂动画）
• 桌面端左侧播放器 + 右侧歌词并排布局
• 移动端播放器 + 歌词 + 播放列表纵向堆叠
• 歌词 3D 景深效果（当前行放大高亮，上下行渐变模糊）
• 亮色模式白色背景适配博客主题风格
• 暗色模式深色沉浸式背景 + 封面模糊光晕
• 播放列表带封面缩略图 + EQ 动画指示器
• 播放按钮暗色模式图标改为深色（解决白色不可见问题）
• 修复 MusicManager 未初始化时按钮无响应的问题（轮询等待机制）
• 修复歌词行样式因 Astro scoped CSS 不匹配动态元素的问题

导航栏重组#

• 「文章列表」「分类」「归档」合并为「文章」下拉菜单
• 导航栏结构更简洁

分页修复#

• 修复文章列表分页 /2/ 显示 404 的问题
• Pagination 组件根据当前路径自动推断基础路径

首页跑马灯#

• 统一摘要项之间的间距（组内和组间使用相同间隔）
• 移除单独的分隔符元素，间隔直接嵌入文本内容

友链页面#

• 右上角新增黑色背景「添加友链」按钮
• 点击平滑滚动到评论区

笔记后端系统（GitHub Gist）#

• 新增 externalNotebooksConfig 配置，每个笔记本对应独立 Gist 仓库
• 新增 /admin/notebooks/ 笔记本管理页面（选笔记本 → 写 Markdown → 存 Gist）
• 新增 /admin/notebooks/detail/ 笔记编辑页面（Markdown 编辑器 + 实时预览）
• 新增 /life/notebooks/remote-entry/ 远程笔记阅读页（样式与本地笔记一致）
• 前端笔记本页面自动合并显示远程笔记（通过 Gist Raw URL 获取，无需 API 认证）
• 笔记编辑器支持工具栏快捷插入（加粗、斜体、代码块、链接、图片、引用、列表）
• 6 个快速笔记模板（每日总结、日记、读书笔记、灵感、待办、空白），可在配置文件中自定义

主题切换改造#

• 导航栏骷髅头主题切换改为太阳/月亮图标按钮（旋转 + 透明度过渡动画）
• 首页封面图开关从笑脸拨动开关改为骷髅头滑块样式
• 骷髅头滑块支持二态切换（封面开启/关闭）

首页样式调整#

• 封面关闭时文章卡片显示 2.5px 黑线框（暗色模式为白线框）
• 分类/归档按钮边框同步调整为 2.5px + var(—deep-text) 颜色
• 骷髅头按钮左边缘与文章卡片黑线对齐
• 导航栏按钮 hover 时不再显示背景色

欢迎卡片改造#

• 翻转逻辑从拖拽点击改为「查看详情」按钮翻转
• 背面新增「返回」按钮翻回正面
• 按钮下方显示「↕ 拖拽弹射」提示文字
• 移除卡片显示时的背景暗化效果（遮罩层改为透明）
• 正面摘要和背面列表自动合并远程说说和笔记数据

最近更新小组件#

• 侧边栏最近更新小组件自动获取远程说说和笔记数据
• 使用 Gist Raw URL 获取数据（Secret Gist 也能访问）
• 整体条数限制为 10 条（本地 + 远程合并）
• 远程数据最多显示 3 条，其余留给本地数据
• 支持桌面端和移动端两个实例同时更新

暗色模式色调修复#

• 修复导航栏链接在暗色模式下不可见的问题（btn-plain 文字色）
• 修复文章目录（侧边栏 + 浮动目录）暗色模式文字不可见
• 修复 PostMeta 日期/分类/标签/浏览量暗色模式不可见
• 修复 text-50、text-30、text-75 等文字透明度工具类暗色模式失效
• 修复今日一言小组件使用不存在的 --text-color 变量
• 修复笔记本详情页硬编码背景色（#fff/#1a1a1a）改用设计令牌
• 修复音乐播放按钮暗色模式图标不可见
• 修复分类小组件徽章数字暗色模式不可见
• 修复所有 bg-(--primary) text-white 按钮暗色模式白底白字

设计令牌调整#

• 暗色模式 --primary 从 oklch(0.85) 改为 oklch(0.98)（更白）
• 暗色模式 --title-active 从 oklch(0.70) 改为 oklch(0.80)

样式架构重构#

• variables.styl 迁移为纯 CSS（tokens/colors.css、breakpoints.css、animation.css、z-index.css）
• main.css（938行）拆分为 17 个模块文件（base/components/features/layout/transitions/vendor）
• markdown-extend.styl 迁移为 CSS
• 4 个组件的 Stylus 样式迁移为纯 CSS
• 建立 CSS Cascade Layers 分层架构

Swup 过渡修复#

• 修复子元素 onload-animation 与容器双重 opacity 冲突
• 修复过渡期间 Banner 高度跳动
• 修复隐藏侧边栏容器动画期间闪烁
• 将 lg 类切换从 visit 移到 content

首页工具栏改造#

• 移除顶部 CategoryBar 分类导航栏
• 新增 CategoryTools 组件（封面图开关 + 分类气泡菜单）
• 封面图开关采用拨动开关样式（:) / :( 表情）
• 分类按钮采用 BubbleMenu 样式（药丸形状、奇偶交替旋转、弹入动画）
• 工具栏仅在首页显示

侧边栏调整#

• 左侧边栏关闭：公告、音乐、分类、标签、生活统计
• 右侧边栏日历和站点统计移到左侧边栏底部
• 站点统计合并影视/书籍/游戏/音乐/足迹/日常规划为「记录次数」

导航栏改造#

• 主题切换按钮从右下角浮动栏移到导航栏登录按钮左侧
• 采用 an.md 骷髅开关样式（原版 CSS + scale 缩放适配）
• 封面图开关默认为隐藏状态

新功能：fetch-media.py 影视脚本 + 影视卡片交互优化#

新增：

• scripts/fetch-media.py：输入影视名称即可通过 TMDB API 搜索影视信息，自动下载海报封面到本地，生成符合博客 bangumi 格式的 Markdown 文件
• 支持快速模式（-y）和交互模式，TMDB 搜不到自动降级为手动填写
• 封面图自动保存在 scripts/img-anime/，MD 文件输出到 src/content/bangumi/anime/

变更：

• 影视与游戏页面卡片点击行为改为跳转站内 /bangumi/{slug}/ 详情页，不再跳转外部 Douban 链接