我一直希望在手机上也能方便地维护博客:想到一个选题时,可以直接整理内容、编辑文章,必要时还能修改配置和本地预览。
这次我尝试把博客工作台放进 RikkaHub。我的目标不只是让 AI 帮我写一段文字,而是让它能在工作区里读取博客仓库,了解我的文章格式和发布流程,再协助我完成写作和维护。
从一个几乎没有安装开发工具的 Linux 环境开始,到成功打开博客预览,中间经历了 GitHub 授权、安装依赖、分析仓库和创建 Skill。本文记录的是我这次的实际过程,以及接下来准备怎样使用这套工作流。
本文基于我当时的 RikkaHub 工作区和博客仓库配置。不同版本、设备、工作区和部署方式可能有所区别,目录与命令请结合自己的环境确认。
一、我想要一个怎样的博客工作台
我的博客使用 Hexo,源码托管在 GitHub。写一篇文章,除了 Markdown 正文,还会涉及标题、摘要、分类、标签、固定链接、图片,以及后续的构建和发布。
如果每次都只是让 AI 在聊天窗口生成正文,我还需要自己把内容搬进仓库,再检查配置。相比之下,我更希望在同一个工作区里完成这些事情:
1 | 我提供主题、经历和资料 |
我负责确定写什么、核对事实和决定什么时候发布;AI 负责根据我的要求操作文件、整理内容和执行检查。尤其是我没有提供的经历,不能因为文章需要就自行补成“我实际做过”。
二、先检查工作区环境
我为博客准备的工作区使用独立的 Linux Rootfs。这次检查到的环境是:
1 | 发行版:Ubuntu 24.04.3 LTS |
刚开始时,/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 | 工作区发起 gh auth login |
实际操作并没有一次成功。第一次尝试时,工作区请求令牌的连接中断了;第二次我在网页完成了授权,但工作区里的登录进程仍然等待,没有拿到令牌。那一次的日志没有给出明确原因,所以我没有办法确定为什么。
后来重新发起登录,工作区终于收到成功结果。接着配置 Git 使用 GitHub CLI 的 HTTPS 凭据,才顺利克隆仓库。
这个过程让我明白,网页上确认授权和工作区最终拿到令牌,是两个连续但不同的步骤。如果网页显示已经授权,而终端还没有登录成功,应该看终端进程和日志,而不是立刻认定自己没有操作完成。
一次性验证码、访问令牌和其他凭据都不适合写进公开文章。GitHub CLI 当时还提示,登录凭据以明文保存在当前环境中,因此这个工作区本身也需要妥善保管。
仓库克隆完成后,本地路径是:
1 | /workspace/zqf-blog |
后续维护使用 HTTPS,不需要为这套流程保留 SSH 客户端和之前生成的 SSH 密钥。
四、先让 AI 认识我的博客
仓库克隆下来之后,我没有马上让 AI 新建文章,而是先让它检查博客本身。
我的博客使用 Hexo 和 FlatPaper 主题。AI 读取了站点配置、主题配置、文章模板、现有文章、自定义脚本和 GitHub Actions 工作流,整理出几个日常维护时会用到的位置:
1 | zqf-blog/ |
对写作来说,文章开头的 Front Matter 同样重要。我的模板包含标题、日期、固定链接、摘要、封面、标签和分类等字段。当前模板里 notify 默认为 false;如果完全不写这个字段,现有通知脚本则可能默认发送 QQ 群通知。
所以,以后新建文章时,我希望 AI 明确填写通知设置,而不是让脚本替我猜。修改已有文章时,也要保留原来的固定链接,避免已经分享出去的地址失效。
我的发布链路
目前仓库中的工作流和文档描述的链路是:
1 | 维护 main 分支 |
我平时维护的是 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 | Node.js:v22.23.4 |
版本会随时间变化,这里记录的是我当时使用的版本,不代表以后必须固定安装这一组。
随后,在博客仓库中按照锁文件安装依赖:
1 | cd /workspace/zqf-blog |
再运行构建:
1 | pnpm build |
这次构建成功,生成了 155 个文件。依赖安装期间,pnpm 提示部分依赖的构建脚本被跳过;Hexo 本身已经成功生成页面,但这不代表那些依赖涉及的其他功能也都经过了验证。
六、本地预览博客
构建通过后,我启动 Hexo 本地服务:
1 | cd /workspace/zqf-blog |
然后在浏览器打开:
1 | http://127.0.0.1:4000/ |
这次我成功打开了博客预览。服务只监听本机地址,预览完成后也停止了进程。
本地预览和线上不一定完全一样。比如我的 AI 摘要缓存由 deploy 分支维护,当前本地 main 工作区没有那份缓存,因此本地构建会跳过摘要渲染。
另外,本地生成的私密文章页面不会因为路径里有 private,就自动获得线上 Cloudflare Access 的保护。预览时仍然要留意服务监听地址和本地文件的访问范围。
七、给博客工作流创建一个 Skill
仓库结构、文章模板和发布流程确认下来后,我又让 AI 创建了一个 blog-workflow Skill,目的是让后续会话遇到博客任务时,可以按需读取这套约定。
Skill 的结构是:
1 | blog-workflow/ |
主文件负责定义使用场景和基本原则;两份参考资料分别记录写作约定,以及配置、预览和发布流程。
其中我比较看重几条:
- 操作前先检查仓库状态,保留已经存在的修改。
- 写文章时读取当前模板和相关文件,不把 Skill 里的旧记录当成永远不变的事实。
- 区分本地修改、Git 提交、远端推送和线上部署。
- 按我的明确要求执行提交、推送和发布,不替我决定文章什么时候上线。
- 不把未验证的操作结果或 AI 编造的经历写成事实。
创建后,我测试了 Skill 和两份参考资料的加载,也用它做了一次只读仓库检查。这个测试说明 Skill 文件可以读取、当前检查流程能用;更复杂的写作和发布任务,仍要在实际使用中继续验证。
八、以后我打算怎样写一篇文章
搭建好环境后,我准备按下面的方式使用它。
首先,我会告诉 AI 想写的主题,并提供自己的操作记录、截图、命令输出和需要保留的细节。比如:
我想记录这次部署过程,先帮我整理提纲。下面是我实际执行的步骤和遇到的问题。
等提纲和事实方向确认后,再让它按照博客的文章模板写入仓库。涉及软件版本、命令和配置时,需要检查是否适用于我实际使用的环境。
草稿完成后,检查 Front Matter、固定链接、图片路径、通知设置和文章内容,再运行构建或启动预览。我看过并确认之后,才决定是否提交、推送和发布。
1 | 提出主题和素材 |
这是一套计划中的日常流程,不代表每个后续环节都已经在这个工作区完成过。尤其是正式发布,需要等实际操作后再看 GitHub Actions、Cloudflare 和线上页面各自的结果。
九、这次搭建后的想法
从空工作区到能打开本地预览,这次最花时间的地方并不是写 Markdown,而是把环境、仓库和原有工作流连接起来。
GitHub 授权让我看到,网页操作完成不等于工作区已经拿到凭据;分析仓库让我重新梳理了文章模板、摘要和通知流程;创建 Skill 则把这些容易遗忘的约定整理成之后可以再次读取的资料。
对我来说,这套工作台的价值不只是让 AI 帮忙写字。它能在我提供方向和材料之后,实际查看仓库、修改文件并运行检查;而内容是否准确、改动是否合适、什么时候发布,仍然由我自己决定。
评论