博客指南 - 分类

使用 PagesCMS 给静态博客接入后台

免费开源静态博客后台 PagesCMS 的完整接入指南：原理、配置文件、授权连接、踩坑记录

使用 hexo-circle-of-friends 搭建博客朋友圈

记录如何使用 hexo-circle-of-friends 项目为 Astro 博客搭建朋友圈功能，包括部署、踩坑和最终效果。

足迹页面使用指南：地图与数据格式

介绍博客足迹页面的功能和本地数据格式

Gist 数据迁移工具使用指南

将 GitHub Gist 中的外部数据（说说、友链、影视、笔记本）迁移到博客本地，避免前端重复渲染

AI摘要实现原理解析

从零拆解博客AI摘要功能的完整实现：构建时调用千问API批量生成摘要、前端打字机动画组件、IntersectionObserver懒触发、以及标点停顿节奏控制，附全部源码。

博客导航栏模块完整构建方案

深度解析导航栏模块的完整架构设计，包含类型定义、配置系统、预设映射、多端适配、下拉菜单、搜索栏、亮暗色切换、音乐播放器、毛玻璃效果等全部实现代码与原理。

影视封面一键下载与博客导入教程

博客影视收藏页每次手动搜海报、下载、写 Markdown 太麻烦，于是写了个 Python 脚本 fetch-media.py，只需一条命令就能通过 TMDB API 自动搜索影视信息、下载海报生成封面、写出完整的 bangumi Markdown 文件，搜不到还能切换手动模式。

M4A音乐自动提取歌词与封面教程

最近整理博客的音乐收藏页，被手动扒歌词、下封面、写 Markdown 磨得没脾气……于是撸了个 Python 脚本，现在只要一条命令，就能自动从 M4A 文件里抽封面、调 API 下同步歌词、生成带评分和状态的博客用 Markdown——本地有文件就直接提，没文件也能搜歌名一键下载全包，连空格和特殊字符都帮你清理好，真的解放双手。

微信读书 × Obsidian × Astro 博客：阅读数据与笔记的完美集成方案

最近一直在折腾怎么把微信读书里的划线、笔记和书评，自然地“长”进自己的博客里——既不想手动复制粘贴丢掉上下文，也不愿让数据散落在各处变成数字孤岛。这篇文章就是我踩完坑后整理出的完整链路：从 Obsidian 用 Weread 插件自动同步读书数据，到 Astro 博客通过内容集合动态渲染成美观可交互的「阅读记录」页。整个过程不碰 API 密钥、不写爬虫、不依赖第三方服务，所有数据都在自己电脑上流转，安心又可控。