# 我的博客与写作工具

从 Hexo 到 Astro，边写文章边改网站，也给配图做了自己的工具

Source: https://works.im0o.top/projects/blog/
Date: 2019-07-23
End date: present
Tags: Web开发, Astro, 开发工具, 内容创作

## Project links

- [阅读博客](https://blog.im0o.top/)


博客从 2019 年开始写，文章里有小工具、Minecraft、数据恢复教程，也有后来做项目时留下的记录。站点本身跟着折腾过几版：早期用 Hexo 和主题，最近一版换成 Astro，样式和页面自己写。

这次重做，我先整理内容怎么放、读者怎样找，再处理页面和后端。

## 系列文章不用挤在时间流里

普通文章适合按时间看，数据恢复和软件测试这样的系列更像一份连续教程。如果把章节全部混进首页，连续发布的几十篇内容会挤成很长一段，也不容易从中间找到目录。

新站把系列单独组织：首页出一张系列入口，里面按章节阅读。章节有顺序和前后导航，文章地址继续用稳定的 `abbrlink`，调整排序时不必跟着改链接。

动态和相册则是另一种内容。动态适合短文字和图片，相册从动态里的图片聚合，不用再维护第二份图片清单。文章仍然保存在 Markdown，普通文章不需要为了几个组件全部改成 MDX。

## 从 Hexo 迁移旧文章

从 Hexo 迁移过来，里面还有 Butterfly 的 note、标签和特殊语法。直接换一个 Markdown 渲染器，有的块不会报错，却会把内容丢掉。

我先统计旧语法，再批量转换，给提示块补上明确的输出映射。文章元信息、系列归属、隐藏内容和图片路径也一起处理。旧地址继续保留原有 ID，迁移报告把需要人工看的地方逐项列出来。

图片在内容里使用统一路径，构建时再处理部署前缀。封面和正文图也分开：封面服务列表识别，正文图跟着正在讲的内容放。

## 动态发布与评论

早期可以靠静态构建更新所有内容，但短动态每次都走构建不太合适。后来我把动态移到 PostgreSQL，通过 Worker API 运行时读取，Telegram 作为发布客户端之一。

文章仍然走静态页面，评论、动态和发布由独立服务处理。旧动态迁移时也保留日期精度，只有日期的内容不伪装成有准确时分。

评论系统这次自己做了，包括访客评论、审核、回复邮件和站长免密登录。站长在网页里能看到对应的身份与审核入口，不需要为了处理一条留言再去翻数据库。

## 搜索和继续阅读

站内搜索用 Pagefind，读者搜索文章不需要先调用模型。作品集想找博客材料时，则通过内容 HTTP API 搜索和读取。构建时产出公开内容数据集，部署流程把它推给查询服务，两边使用相同的公开内容范围。

最近还做了给作品集侧栏使用的精简文章入口，沿用同一份文章展示。读者在作品集里问到某段经历，可以直接打开博客继续读，而不是停在一个被截短的搜索摘要上。

页面本身偏简单，配色、字宽、目录和图注都围绕长文阅读调整。主题切换、图片加载和返回阅读位置这些小地方，也在日常写文章、看文章时继续改。

[打开博客](https://blog.im0o.top/)


![博客首页：系列专题与普通文章](https://image.im0o.top/2026/20261117104051111.webp)

## 给博客做封面的 Cover Studio

为了做一张封面专门打开 Photoshop，有些麻烦。我给博客写了 Cover Studio，把底图、标题、滤镜和裁切放在一个画布里。封面在列表里只有两百多像素宽，得先看清标题；文章里的头图则保留无字原图。

文字和图片都是可编辑图层，可以调位置、字号和遮罩。保存成 `.cover` 文件后，图片也嵌在里面，换台机器还能继续改，最后再导出 WebP 或 PNG。

后来给编辑器接了 MCP。Agent 可以读画布结构，按图层修改，再截图、导出；我也能在同一个画布里接着调整。写文章、选底图和排标题因此可以连着做，源文件仍然留得下来。

![Cover Studio 的画布与图层编辑界面](https://image.im0o.top/2026/20261117104055970.webp "Cover Studio 的画布与图层编辑界面")

