从 Aemeath 到 Cyan：我的博客魔改记

为什么要做#

我是一名嵌入式工程师,日常主要跟 C/C++、STM32、Linux 这些东西打交道。一直想有个地方记录嵌入式学习开发日常:踩过的坑、调通的板子、看懂的原理,都能沉淀下来。博客既是我的数字笔记本,也是一个分享出去的窗口。

目标读者其实很杂:同行开发者、身边的朋友,还有未来的自己。所以写的时候没有刻意讨好某一类人,真实记录就好。

原项目与技术栈#

原项目是一个基于 Astro 的博客主题,我沿用了它的技术栈,没有推倒重来:

• Astro 7 + Svelte 5 负责静态内容和布局,Svelte 负责需要交互的部分(搜索、设置面板、音乐播放器)
• 配置驱动:几乎所有功能开关和文案都集中在 src/config/ 里,改配置不用去翻组件代码
• Cloudflare Pages:代码推到 GitHub 自动构建部署,HTTPS、域名都托管了,零运维
• Pagefind:构建时生成搜索索引,全文搜索不依赖后端
• 多语言:中文优先,另外还有英文、繁体、日文、俄文

我改了什么#

拿到原项目后,我没有停留在换换颜色,而是做了不少结构性改动:

• 把整站改成魂系美学(艾尔登法环、黑暗之魂)的视觉风格
• 导航栏重命名,五个栏目改成旅记 / 旅人 / 浮光 / 余音 / 起源
• 首页数据层、粒子特效、开屏动画做了重设计
• 音乐页大改:资源按 audio/cover/lyrics/vinyl-record 重新组织,加了 mp4 动图背景和黑胶唱片图
• 删掉了一批用不上的组件,清理了图片资源和死代码

这套「配置驱动 + 组件分层」的结构,好处是想加一个页面、关一个功能,基本只动配置,不碰逻辑。

整体架构分层如下:

1
┌─────────────────────────────────────────────┐
2
│                  访客 / 浏览器                 │
3
└──────────────────────┬──────────────────────┘
4
                       ▼
5
┌─────────────────────────────────────────────┐
6
│       Cloudflare Pages · 静态托管 · 自动部署   │
7
└──────────────────────┬──────────────────────┘
8
                       ▼
9
┌─────────────────────────────────────────────┐
10
│           Astro 7 构建产物(dist/)             │
11
├─────────────────────────────────────────────┤
12
│  ┌──────────┐  ┌──────────┐  ┌──────────┐   │
13
│  │ .astro    │  │ .svelte  │  │ 15 个     │   │
14
│  │ 静态布局  │  │ 交互组件 │  │ 插件      │   │
15
│  └──────────┘  └──────────┘  └──────────┘   │
16
│                                             │
17
│  ┌─────────────────────────────────────┐    │
18
│  │   src/config/ 配置驱动(开关 · 文案)  │    │
19
│  └─────────────────────────────────────┘    │
20
│                                             │
21
│  ┌──────────┐           ┌──────────┐       │
22
│  │ Pagefind │           │ i18n     │       │
23
│  │ 全文搜索 │           │ 5 语言   │       │
24
│  └──────────┘           └──────────┘       │
25
└─────────────────────────────────────────────┘

开发时间线#

10 月 7 日拿到原项目开始改造,10 月 17 日基本成型,前后 11 天。中间的具体细节现在回想起来已经有点模糊了,但大致的节奏是:先摸清原项目的结构,再逐块改造——首页的数据层、粒子特效、音乐页,都是一块一块啃下来的。

踩坑与解决#

有三个问题印象比较深:

1. 和 AI 协作效率低

一开始和 AI 说不清楚需求,经常来回返工。后来去 GitHub 上找了 Claude 的 Skill 机制,把一些重复的工作流程沉淀成技能模板。有了明确的流程约束,沟通成本降了不少。

2. 视觉设计灵感枯竭

页面怎么做都差点意思。解决办法很朴素:大量浏览别人的博客,拆解它们的配色、排版、动效,再消化成自己的魂系风格。看多了,审美自然会往对的方向走。

3. 项目文件结构越来越乱

在开源项目上二次开发,改到后面慢慢成了「代码屎山」,改一个地方牵一发动全身。解决方式是让 AI 先分析整体结构,再一点一点拆、一点一点改,不追求一次到位。重构是常态,不是一次性事件。

总结#

这 11 天最大的收获,不是把博客做出来了,而是走通了一条「在开源项目上二次开发 → 落地 → 上线」的路。站在别人的肩膀上,把力气花在自己想要的那部分,比从零开始更高效。

博客会一直维护下去——记录嵌入式开发日常,也记录这个站点自己的变化。