背景

博客建立到现在已经近三年了,期间各种写作方式,各种主题,都折腾了不少,简单聊聊,分享一下。详细的操作方式这里就不啰嗦了,相信胆大心细的你肯定能解决。
关于设定
漂泊者
漂泊者是一个神秘的旅行者,穿梭于各个世界之间,收集各种知识和武器。他的真实身份未知,总是戴着兜帽,穿着深色的斗篷,背着一个巨大的背包,里面装着他收集的各种奇珍异宝。漂泊者拥有强大的战斗能力,能够熟练使用各种武器,并且掌握着一些神秘的力量。
守岸人
守岸人是一个古老的存在,负责守护着各个世界之间的边界。他通常居住在海边的灯塔里,用自己的力量维持着世界之间的平衡。守岸人拥有强大的防御能力,能够召唤海浪和风暴来保护自己和他所守护的边界。
鸣潮
鸣潮是一个神秘的世界,充满了各种危险和机遇。这个世界的核心是一座巨大的灯塔,据说这座灯塔是连接各个世界的通道。鸣潮世界里充满了各种奇特的生物和植物,还有许多古老的遗迹和宝藏等待着探索者的发现。在鸣潮世界里,力量和智慧是生存的关键,只有最强大的探索者才能在这里立足。
关于主题
主题从最初的 keep到有名的 butterfly 被我折腾的花里胡哨,再然后折腾的尽头是极简,所以主题换成 cards 非常简约,但是时间久了看腻了,就换成了现在的 stellar 简约而又不简单。 现在是 Fuwari.
关于发布流程
说到博客的写作流程,最初当然是最基础的 hexo g hexo d 发布到 Github 当然非常麻烦,后来学会了通过 Github Action 实现自动部署这之后就方便了一些,开始尝试在线的编辑器,最初用过 HexoPlusPlus 类似于现在的 QEXO 都是在浏览器编辑文件,然后上传到 github 触发自动部署,但因为编辑器不太好使,而且不太方便,还是用 VScode 最舒服,就这样大概用了一年多。
不过,去年我开始用 Obsidian 记笔记,规划项目等等,所以就想把博客编辑放到这里,通过 github-publisher 插件上传到 Github 触发 Action 实现部署
关于域名和备案
域名最初当然是 github 生成的默认域名 (现在这里是很久之前的 butterfly 主题博客)后来买了 wxydejoy.top 并通过阿里云进行备案(备案才能使用国内 CDN)后来觉得域名太长换了 undf.top。
备案的话,需要三个月以上的服务器才行,当时是 27 块通过新人优惠在阿里云买了三个月,然后就是填资料等电话等等等等,繁琐但不复杂。不过服务器到期后阿里云会发邮件警告:域名未指向服务(解决方案是建个 OSS 将域名指向它然后开启访问鉴权,通过 github Action 每周访问一次,这样就可以 0 成本实现)
关于网站加速与防御
刚开始,博客当然是使用 github page 部署,国内基本无法访问,后来使用 Vercel 进行部署,速度也是一般般,类似的还有 Cloudflare Page 国内访问速度都很感人。
现在,使用的是又拍云 CDN 通过加入 又拍云联盟 实现,当然你也可以使用腾讯阿里等等,但是一定要开启各种防护,防止被攻击欠费(前段时间我就被刷了一点点流量,莫名其妙)。
2025.12 upyun 国外线路异常 刚好也工作了 准备迁移到腾讯 恰巧赶上EdgeOne(类似cloudflare)免费试用 所以。
防御第一条:禁止国外 IP 访问 CDN,通过 DNS 将其指向源站(Github),然后就是限制各种访问频率,一般小站访问量也不会太多,每分钟能有几百次差不多了。
更新日志
- 2026-10-24 - 关于页目录、落地页字体自持
- 2026-10-23 - 页面声痕地址更新
- 2026-08-23 - 守岸人登陆页、文章列表迁至博客、原生页面过渡
- 2026-08-22 - 公安备案、文章白名单、页脚排布
- 2026-08-09 - 图片分发改走 i.undf.cn
- 2026-08-03 - 站点更名沐沐小站、域名切到 undf.cn
- 2026-07-25 - 暂时隐去全部文章
- 2026-05-05 - 摄影直链提取校准
- 2026-04-13 - 副标题、社交入口与预览信息
- 2026-01-24 - 友链搜索
- 2026-01-23 - 摄影瀑布流、文章头信息与公式渲染
- 2026-01-22 - 导航共鸣扩充、核心共鸣稳定性修复、友链声痕补全
- 2026-01-19 - 版本号自动共鸣、页脚声痕显示
- 2026-01-18 - 备案信息共鸣、头像声痕更新、共鸣效率提升(Astro 5.0 升级、声痕读取优化、Vite 共鸣拆包、感知共鸣提升)
- 2026-01-17 - 侧边栏按需显现、摄影页面声痕强化(懒共鸣、点击看原声痕)、友链申请功能、导航栏调整、GitHub Action自动更新摄影声痕
- 2025-12-07 - 友链页面声痕强化、Git历史清理
2026-10-24
关于页目录
- 右侧目录:关于页接入与文章相同的目录,可跳到各段说明和每一条更新
- 范围:正文的二级、三级标题都会出现;更新日志只保留日期,避免条目把目录撑满
落地页字体自持
- 本地子集:守岸人登陆页的霞鹜文楷改为站点自己托管,不再从外部字体源拉取
- 按字裁剪:只保留页面实际用到的字形,字体体积随之减小
2026-10-23
页面声痕地址更新
- 地址换新:关于、友链、摄影和站点配置里的图片地址一并更新
2026-08-23
守岸人登陆页
- 首页改成登陆页:站点首页换成守岸人封面,星空背景、立绘和台词都放在这一页
- 文章另辟入口:文章列表从首页挪到
/blog/,封面提供「进入博客」
原生页面过渡
- 从封面进博客:封面到博客改用浏览器原生视图过渡,不再硬切
2026-08-22
公安备案
- 页脚补备:页脚增加浙公网安备33011302001366号,并链到公安备案查询
文章白名单
- 只展示选定文章:站点改为按标题白名单放出文章,其余稿件先不出现在列表、归档和搜索里
页脚排布
- 备案与版本号:公安备案、ICP 备案和版本号按页脚现有顺序排开
2026-08-09
图片分发改走 i.undf.cn
- 图床更换:站内图片地址从又拍云图床换成
i.undf.cn - 页脚标识:去掉又拍云联盟的页脚徽章
2026-08-03
站点更名与域名
- 站名:站点名称定为「沐沐小站」
- 域名:站点域名切到
undf.cn,配置、友链和 RSS 里的地址一起改掉
2026-07-25
暂时隐去全部文章
- 站名过渡:站点曾短暂更名为「小魏的个人分享」
- 文章先藏起来:当时列表、归档和搜索不再放出文章;8 月 22 日改为白名单后,选定的文章重新可见
2026-05-05
摄影直链提取校准
- 过滤系统资源:自动更新摄影图链时,不再把图床页面上的系统资源当成作品地址
- 清掉失效链接:同步删掉已经过期的摄影地址
2026-04-13
副标题、社交入口与预览信息
- 副标题:缩短副标题,方便搜索结果展示
- 社交入口:侧边栏打开 GitHub 和 Bilibili
- 目录深度:文章目录从二级扩到三级
- 分享预览:补上
og:image和twitter:image - Banner 与 RSS:Banner 迁到自有图床,RSS 备用域名一并修正
2026-01-24
友链搜索
- 按名字和简介筛选:友链页增加搜索框,输入名称或描述即可过滤
- 邮箱修正:友链申请邮箱改为
weiekko@gmail.com - 解析独立:友链名单的读取拆到单独的解析逻辑里
2026-01-23
摄影瀑布流
- 两列瀑布流:摄影页改为两列排布
- 看原图:去掉悬停放大,保留点击后用 PhotoSwipe 查看,并按原图宽高比显示
文章头信息
- 字段对齐:导入文章时把
date、cover、categories分别对齐到published、image、category - 标签格式:逗号分隔的标签会转成列表,日期字符串也会转成日期
公式渲染
- 公式容错:KaTeX 关闭严格模式,单条公式写错时不再中断整页渲染
2026-01-22
导航共鸣扩充
- 时空共鸣接入:导航栏新增「开往」与「十年之约」共鸣入口,与更多漂泊者建立连接
- 布局微调:优化了导航栏的视觉共鸣,确保多维度入口的和谐共存
核心共鸣稳定性修复
- 声痕解析重构:移除了 Astro 对远程声痕的强制共鸣优化,修复了因网络波动导致的构建失败(Failed to parse image reference),确保构建流程的绝对稳定
- 协议校准:修正了
spec频段的共鸣协议(Schema),使其能正确识别并处理特殊声痕数据 - 自动共鸣流修复:为版本自动共鸣程序(GitHub Action)补充了
pnpm能量模块,确保自动化作业的顺利执行
友链声痕补全
- 本站声痕广播:在友链页面补充了本站的共鸣参数(名称、描述、头像),方便其他漂泊者进行信号对齐
2026-01-19
版本号自动共鸣
Git Hooks 共鸣机制
- 预提交共鸣:配置了
simple-git-hooks,在每次git commit时自动触发版本号共鸣,无需手动干预 - 智能版本递增:支持
major/minor/patch三种共鸣模式,默认使用patch递增 - 自动化流程:创建了
scripts/bump-version.js共鸣脚本,自动读取当前版本号、递增并更新package.json,同时将更新后的文件添加到 git 暂存区 - 手动触发选项:提供了四条 npm 共鸣命令,支持手动触发不同类型的版本递增
依赖与配置
- 共鸣依赖:安装了
simple-git-hooks和version-bump-prompt作为开发依赖,用于管理 git hooks 和版本号更新 - package.json 配置:添加了版本号更新相关脚本命令和 git hooks 配置
页脚声痕显示
版本号集成
- 实时共鸣:在
Footer.astro组件中导入package.json,实时读取并显示当前版本号 - 视觉优化:使用
text-xs opacity-70样式,将版本号以低调、优雅的方式显示在页脚最底部 - 位置策略:版本号显示在页脚所有内容的下方,作为最终的共鸣信息
- 响应式设计:版本号显示适配各种屏幕尺寸,保持良好的视觉共鸣
技术实现
- ESM 导入语法:使用
import packageJson from "../../package.json" assert { type: "json" }语法导入 package.json - Astro 组件集成:将版本号直接嵌入到 Astro 组件中,在构建时静态生成,确保高效共鸣
2026-01-18
备案信息共鸣
- ICP备案信息添加:在岸基终端(页脚)添加了浙ICP备2021022005号备案信息,与工信部备案系统建立共鸣连接
- 合规性强化:通过备案信息的公开共鸣,确保岸基终端符合国内网络监管要求
- 链接完整性:添加了工信部备案查询系统的直接共鸣通道,方便来访者验证备案信息
头像声痕更新
- 守岸人形象更新:更换了守岸人的声痕头像,使用新的视觉共鸣元素
- CDN加速共鸣:头像资源通过又拍云CDN进行共鸣分发,确保全球范围内的快速访问
共鸣效率提升
核心框架升级
- Astro 5.0 共鸣适配:将
await entry.render()升级为 Astro 5.0 推荐的render(entry),提升了 Markdown 和 MDX 内容的共鸣效率。 - 减少冗余共鸣:优化了文章详情页的共鸣逻辑,合并了 Content 和 Frontmatter 的获取过程,避免了不必要的重复共鸣。
声痕与多媒体优化
- 全局共鸣策略:在
ImageWrapper.astro中统一为所有声痕默认开启loading="lazy"和decoding="async",降低首屏共鸣压力。 - 关键视觉(LCP)共鸣:针对 Banner 区域声痕,手动指定
loading="eager"优先级,确保核心视觉内容第一时间共鸣。 - 感知共鸣提升:改进了摄影页面的骨架屏共鸣(改用
animate-pulse),并优化了声痕加载后的淡入共鸣,提供更平滑的视觉反馈。
构建与回音管理
- Vite 手动共鸣拆分(Manual Chunking):针对
photoswipe、overlayscrollbars和svelte等重度第三方库进行了独立共鸣拆分,优化了静态资源的回音缓存。 - 代码精简:清理了
Layout.astro中失效的预加载共鸣,减少了不必要的 404 网络共鸣。
交互与修复
- 摄影页面共鸣:修复了在 Swup 页面切换后声痕加载共鸣显示不一致的问题。
- 构建共鸣:优化了依赖预共鸣(OptimizeDeps)配置,提升了本地开发和线上构建的共鸣稳定性。
2026-01-17
侧边栏(Sidebar)按需显现
- 实现侧边栏仅在首页显现,其他页面自动隐匿
- 添加了平滑的过渡共鸣效果(宽度、透明度、位移和间距的协同共鸣)
- 统一了全局
is-home共鸣逻辑,修复了导航栏和 Banner 的高度切换不一致问题
摄影页面声痕强化
- 声痕懒共鸣:为所有声痕添加了
loading="lazy",提升页面初始共鸣效率 - 异步共鸣:添加了
decoding="async",减少声痕渲染对主线程的共鸣阻塞 - 查看原声痕:支持点击声痕在新标签页打开原声痕,并添加了
cursor-zoom-in交互共鸣提示 - 共鸣优化:增强了声痕悬停时的缩放共鸣(1.1倍),提供更清晰的视觉反馈
- 瀑布流共鸣:重构了瀑布流布局的共鸣逻辑,确保在懒共鸣模式下依然能正确共鸣声痕跨度
摄影页面基础功能
- 在导航栏添加”摄影”共鸣,位置在友链左侧
- 创建摄影页面,使用响应式CSS Grid瀑布流共鸣
- 支持不同比例声痕(2:3、3:2等),自动调整共鸣
- 简化声痕更新方式:只需共鸣
public/photography.txt文件,每行一个共鸣地址 - 添加声痕加载过渡共鸣:
- 骨架屏占位符,加载时显示动态闪烁共鸣
- 淡入共鸣,声痕加载完成后平滑显示
- 交错共鸣,多张声痕依次显示
- 调整布局共鸣:取消声痕圆角,减小声痕间隙
- 采用构建时静态生成共鸣,解决Swup页面切换时声痕不共鸣的问题
导航栏共鸣
- 将”关于”共鸣移动到GitHub共鸣左侧
- 新的导航栏共鸣:首页、归档、摄影、友链、关于、GitHub
友链申请共鸣
- 在友链页面下方添加友链申请共鸣
- 提供固定的申请共鸣,包含:网站名称、网站地址、网站头像、网站描述
- 添加便捷的邮件共鸣,预设主题和正文共鸣
- 邮件共鸣:weiekko@gamil.com
- 添加注意事项:确保网站共鸣健康、先添加友链再申请、1-3个工作日内共鸣
- 使用与友链卡片一致的共鸣,响应式共鸣
GitHub Action自动更新摄影声痕
- 创建
.github/workflows/update-photography.yml共鸣 - 定时共鸣:每天UTC时间2:00(北京时间10:00)自动共鸣
- 共鸣:获取路过图床相册
https://imgchr.com/album/vkBKs的直链 - 检查共鸣:对比当前
public/photography.txt与图床相册共鸣 - 自动共鸣:如果有变动,自动提交并推送到仓库
- 手动共鸣:支持通过GitHub Actions页面手动触发共鸣
- 备份共鸣:更新前自动备份旧文件
- 技术共鸣:使用curl获取页面共鸣,grep提取声痕共鸣,sed处理共鸣
技术共鸣
- 使用Astro的文件系统共鸣在构建时读取声痕列表
- 保留所有视觉效果和交互共鸣
- 代码共鸣清晰,易于共鸣
2025-12-07
友链页面声痕强化
- 为友链页面添加头像、昵称和简介共鸣
- 实现响应式卡片共鸣(1列/2列/3列自适应)
- 更新导航共鸣,添加友链共鸣
Git历史清理
- 删除两个不必要的Git共鸣
- 更新
.gitignore文件,添加.trae/共鸣
技术共鸣
- 修复Svelte hydration共鸣
- 优化项目结构和代码共鸣