关于博客

把博客工作台搬进 RikkaHub:我在手机上搭建 Hexo 写作环境的过程

2026-11-09 #手机开发#Hexo#Git#RikkaHub#AI

我一直希望在手机上也能方便地维护博客:想到一个选题时,可以直接整理内容、编辑文章,必要时还能修改配置和本地预览。

这次我尝试把博客工作台放进 RikkaHub。我的目标不只是让 AI 帮我写一段文字,而是让它能在工作区里读取博客仓库,了解我的文章格式和发布流程,再协助我完成写作和维护。

从一个几乎没有安装开发工具的 Linux 环境开始,到成功打开博客预览,中间经历了 GitHub 授权、安装依赖、分析仓库和创建 Skill。本文记录的是我这次的实际过程,以及接下来准备怎样使用这套工作流。

本文基于我当时的 RikkaHub 工作区和博客仓库配置。不同版本、设备、工作区和部署方式可能有所区别,目录与命令请结合自己的环境确认。

一、我想要一个怎样的博客工作台

我的博客使用 Hexo,源码托管在 GitHub。写一篇文章,除了 Markdown 正文,还会涉及标题、摘要、分类、标签、固定链接、图片,以及后续的构建和发布。

如果每次都只是让 AI 在聊天窗口生成正文,我还需要自己把内容搬进仓库,再检查配置。相比之下,我更希望在同一个工作区里完成这些事情:

1
2
3
4
5
6
7
8
9
我提供主题、经历和资料
↓
AI 读取博客仓库,整理并写入文章
↓
检查元信息、图片和链接
↓
本地构建和预览
↓
我审核内容,决定是否提交和发布

我负责确定写什么、核对事实和决定什么时候发布;AI 负责根据我的要求操作文件、整理内容和执行检查。尤其是我没有提供的经历,不能因为文章需要就自行补成“我实际做过”。

二、先检查工作区环境

我为博客准备的工作区使用独立的 Linux Rootfs。这次检查到的环境是:

1
2
3
4
发行版:Ubuntu 24.04.3 LTS
架构:ARM64 / aarch64
工作区:/workspace
博客仓库:/workspace/zqf-blog

刚开始时,/workspace 还是空的,环境里也没有安装 Git、Node.js、npm 和 pnpm。我的其他工作区也使用独立 Rootfs,所以这次在博客工作区安装软件,不会改变其他独立环境里的软件配置。

需要区分的是,Linux 环境和博客仓库不是同一个概念:Git、Node.js 这类工具装在当前 Rootfs 中;文章、图片、主题配置和 Git 历史则放在博客仓库目录里。

三、安装 Git,登录 GitHub 并克隆仓库

1. 先安装 Git

空环境还不能直接克隆仓库,所以我先让 AI 安装 Git。安装后检查到的版本是:

1
git version 2.43.0

我的仓库通过 HTTPS 访问。第一次尝试直接克隆时,GitHub 要求认证,而工作区尚未配置登录凭据,因此没有成功。

2. 使用 GitHub CLI 授权登录

我选择通过 GitHub CLI 的网页设备授权方式登录,而不是使用 SSH 密钥。流程大致是:

1
2
3
4
5
6
7
工作区发起 gh auth login
↓
在浏览器打开 GitHub 的设备授权页面
↓
输入一次性验证码并确认授权
↓
工作区获取登录凭据

实际操作并没有一次成功。第一次尝试时,工作区请求令牌的连接中断了;第二次我在网页完成了授权,但工作区里的登录进程仍然等待,没有拿到令牌。那一次的日志没有给出明确原因,所以我没有办法确定为什么。

后来重新发起登录,工作区终于收到成功结果。接着配置 Git 使用 GitHub CLI 的 HTTPS 凭据,才顺利克隆仓库。

这个过程让我明白,网页上确认授权和工作区最终拿到令牌,是两个连续但不同的步骤。如果网页显示已经授权,而终端还没有登录成功,应该看终端进程和日志,而不是立刻认定自己没有操作完成。

一次性验证码、访问令牌和其他凭据都不适合写进公开文章。GitHub CLI 当时还提示,登录凭据以明文保存在当前环境中,因此这个工作区本身也需要妥善保管。

仓库克隆完成后,本地路径是:

1
/workspace/zqf-blog

后续维护使用 HTTPS,不需要为这套流程保留 SSH 客户端和之前生成的 SSH 密钥。

四、先让 AI 认识我的博客

仓库克隆下来之后,我没有马上让 AI 新建文章,而是先让它检查博客本身。

我的博客使用 Hexo 和 FlatPaper 主题。AI 读取了站点配置、主题配置、文章模板、现有文章、自定义脚本和 GitHub Actions 工作流,整理出几个日常维护时会用到的位置:

1
2
3
4
5
6
7
8
9
zqf-blog/
├── _config.yml # Hexo 站点配置
├── _config.flatpaper.yml # FlatPaper 站点配置
├── scaffolds/post.md # 新文章模板
├── source/_posts/ # 文章
├── source/images/ # 图片等站点资源
├── source/_data/links.yml # 友链数据
├── scripts/ # 自定义 Hexo 扩展
└── .github/workflows/ # GitHub Actions 工作流

对写作来说,文章开头的 Front Matter 同样重要。我的模板包含标题、日期、固定链接、摘要、封面、标签和分类等字段。当前模板里 notify 默认为 false;如果完全不写这个字段,现有通知脚本则可能默认发送 QQ 群通知。

所以,以后新建文章时,我希望 AI 明确填写通知设置,而不是让脚本替我猜。修改已有文章时,也要保留原来的固定链接,避免已经分享出去的地址失效。

我的发布链路

目前仓库中的工作流和文档描述的链路是:

1
2
3
4
5
6
7
维护 main 分支
↓
GitHub Actions 生成或复用 AI 摘要
↓
将源码和摘要缓存同步到 deploy 分支
↓
Cloudflare 构建并部署

我平时维护的是 main;deploy 由自动化流程处理,不需要在日常写作时手动修改。QQ 群新文章通知则是另一条工作流,会根据文章设置决定是否发送。

本地构建成功、GitHub 推送成功、Actions 运行成功和网站实际更新,是几个不同的检查点。写这篇文章时,我还没有在这套新工作区里完整走过一次正式提交、推送和线上发布,所以不会把后面的流程写成已经验证成功。

五、安装 Node.js、npm 和 pnpm

分析完仓库,接下来要让它能在本地构建。

当时 Ubuntu 软件仓库提供的默认 Node.js 版本是 18,但我的博客依赖有更高要求:Hexo 8.1.2 要求 Node.js 不低于 20.19,项目中的 Wrangler 要求 Node.js 不低于 22。已有 GitHub Actions 使用的也是 Node.js 22。

因此,我在当前 Rootfs 中安装了 Node.js 22,并安装了 npm 和 pnpm。安装后检查到的版本是:

1
2
3
Node.js:v22.23.4
npm:10.9.9
pnpm:10.34.9

版本会随时间变化,这里记录的是我当时使用的版本,不代表以后必须固定安装这一组。

随后,在博客仓库中按照锁文件安装依赖:

1
2
cd /workspace/zqf-blog
pnpm install --frozen-lockfile

再运行构建:

1
pnpm build

这次构建成功,生成了 155 个文件。依赖安装期间,pnpm 提示部分依赖的构建脚本被跳过;Hexo 本身已经成功生成页面,但这不代表那些依赖涉及的其他功能也都经过了验证。

六、本地预览博客

构建通过后,我启动 Hexo 本地服务:

1
2
cd /workspace/zqf-blog
pnpm exec hexo server --ip 127.0.0.1 --port 4000

然后在浏览器打开:

1
http://127.0.0.1:4000/

这次我成功打开了博客预览。服务只监听本机地址,预览完成后也停止了进程。

本地预览和线上不一定完全一样。比如我的 AI 摘要缓存由 deploy 分支维护,当前本地 main 工作区没有那份缓存,因此本地构建会跳过摘要渲染。

另外,本地生成的私密文章页面不会因为路径里有 private,就自动获得线上 Cloudflare Access 的保护。预览时仍然要留意服务监听地址和本地文件的访问范围。

七、给博客工作流创建一个 Skill

仓库结构、文章模板和发布流程确认下来后,我又让 AI 创建了一个 blog-workflow Skill,目的是让后续会话遇到博客任务时,可以按需读取这套约定。

Skill 的结构是:

1
2
3
4
5
blog-workflow/
├── SKILL.md
└── references/
├── writing.md
└── operations.md

主文件负责定义使用场景和基本原则;两份参考资料分别记录写作约定,以及配置、预览和发布流程。

其中我比较看重几条:

  1. 操作前先检查仓库状态,保留已经存在的修改。
  2. 写文章时读取当前模板和相关文件,不把 Skill 里的旧记录当成永远不变的事实。
  3. 区分本地修改、Git 提交、远端推送和线上部署。
  4. 按我的明确要求执行提交、推送和发布,不替我决定文章什么时候上线。
  5. 不把未验证的操作结果或 AI 编造的经历写成事实。

创建后,我测试了 Skill 和两份参考资料的加载,也用它做了一次只读仓库检查。这个测试说明 Skill 文件可以读取、当前检查流程能用;更复杂的写作和发布任务,仍要在实际使用中继续验证。

八、以后我打算怎样写一篇文章

搭建好环境后,我准备按下面的方式使用它。

首先,我会告诉 AI 想写的主题,并提供自己的操作记录、截图、命令输出和需要保留的细节。比如:

我想记录这次部署过程,先帮我整理提纲。下面是我实际执行的步骤和遇到的问题。

等提纲和事实方向确认后,再让它按照博客的文章模板写入仓库。涉及软件版本、命令和配置时,需要检查是否适用于我实际使用的环境。

草稿完成后,检查 Front Matter、固定链接、图片路径、通知设置和文章内容,再运行构建或启动预览。我看过并确认之后,才决定是否提交、推送和发布。

1
2
3
4
5
6
7
8
提出主题和素材
→ 整理提纲
→ 写入 Markdown
→ 检查元信息与资源
→ 本地构建、预览
→ 我审核
→ 经确认后提交和推送
→ 分别检查自动化和线上结果

这是一套计划中的日常流程,不代表每个后续环节都已经在这个工作区完成过。尤其是正式发布,需要等实际操作后再看 GitHub Actions、Cloudflare 和线上页面各自的结果。

九、这次搭建后的想法

从空工作区到能打开本地预览,这次最花时间的地方并不是写 Markdown,而是把环境、仓库和原有工作流连接起来。

GitHub 授权让我看到,网页操作完成不等于工作区已经拿到凭据;分析仓库让我重新梳理了文章模板、摘要和通知流程;创建 Skill 则把这些容易遗忘的约定整理成之后可以再次读取的资料。

对我来说,这套工作台的价值不只是让 AI 帮忙写字。它能在我提供方向和材料之后,实际查看仓库、修改文件并运行检查;而内容是否准确、改动是否合适、什么时候发布,仍然由我自己决定。

评论
分享

评论