Risuki

为什么搭建这个博客#

我希望有一个长期维护的个人技术博客，用来记录嵌入式软件、Qt/C++ 桌面开发、Linux 部署运维、TwinNook 项目以及 AI 边缘部署相关的学习和工程实践。

这类内容如果只散落在聊天记录、临时笔记或者代码注释里，时间一长就很难复用。博客的目标不是一次性写很多文章，而是把每次踩坑、验证、部署和复盘沉淀下来，形成可回看的工程笔记。

技术选型#

第一版博客使用 Mizuki 主题，底层是 Astro 静态站点。

选择静态博客的原因很简单：

1. 文章访问速度快，部署后由 Nginx 直接返回 HTML、CSS、JS 和图片资源。
2. 不需要为博客本身维护后端服务，稳定性更高。
3. 本地写文章、Git 保存、服务器构建部署的流程足够清晰。
4. 后续可以方便地接入 RSS、sitemap、搜索、分类和标签。

本地初始化过程#

当前博客项目目录为本地工作目录。公开文章里不需要写出完整磁盘路径，这里统一记作：

1
LOCAL_BLOG_DIR

初始化时先克隆 Mizuki 主题源码，再安装依赖：

1
pnpm install

启动本地开发服务器：

1
pnpm dev

启动成功后，本地可以通过下面的地址访问：

1
http://localhost:4321

内容管理方式#

第一版先采用最简单的方式：博客源码和文章内容放在同一个 Git 仓库中。

文章目录为：

1
src/content/posts/

关于页、友链页等特殊页面目录为：

1
src/content/spec/

Mizuki 也支持把内容拆到独立仓库，但第一版先不启用 CONTENT_REPO_URL。这样部署链路更短，也更适合先把 risukio.com 跑起来。

第一版目标#

第一版先保留博客最核心的能力：

1. 首页
2. 文章列表
3. 文章详情
4. 分类
5. 标签
6. 搜索
7. RSS
8. sitemap
9. 深色模式

暂时关闭或不启用音乐播放器、Live2D、复杂动画、文章加密和评论系统。等博客内容稳定后，再逐步添加真正需要的功能。

后续部署规划#

服务器上计划将源码和静态文件分开。公开文章里使用占位符，不暴露真实服务器目录：

1
BLOG_SOURCE_DIR
2
PUBLIC_WEB_ROOT

部署流程大致如下：

1
cd BLOG_SOURCE_DIR
2
git pull --ff-only
3
pnpm install
4
pnpm build
5
sudo rsync -av --delete dist/ PUBLIC_WEB_ROOT/

Nginx 负责对外提供静态资源访问：

1
risukio.com
2
www.risukio.com

后端 API 会单独使用自己的域名和服务入口。公网文章里暂时不写真实 API 子域名，统一记作：

1
API_DOMAIN

博客本身不需要 PM2，也不需要 systemd 服务常驻。构建完成后，Nginx 直接读取静态文件即可。

接下来要做的事#

下一步会修改站点配置，包括网站名称、作者信息、站点地址、导航栏、页脚备案号，以及关闭第一版暂时不需要的功能。

等这些基础配置完成后，再开始补第一批技术文章，例如 STM32 串口环形缓冲区、Ubuntu + Nginx + Certbot 配置 HTTPS、后端服务部署记录等。