Hello World：我的第一篇博客

2026-10-07T13:30:00.000Z

折腾了很久，终于把这块地方搭起来了。它很轻：没有数据库，没有后端，只有一堆静态文件；它也很吵：背景图每次刷新都会换一张。

为什么是 Hexo

理由很朴素 —— 我想把注意力放在写字上，而不是维护服务器上。

需求	Hexo 方案
写作	纯 Markdown，扔进 `source/_posts` 就好
部署	生成静态文件，随便丢给 GitHub Pages
速度	没有接口请求，首屏就是 HTML
成本	零

一个最小的构建流程

npm install          # 装依赖
npm run images       # 增量上传图片到 ImgBB，更新清单
npm run build        # 生成静态站点到 public/
npm run publish      # 一步到位：上传图片 + 构建 + 提交推送

图片走图床的好处很直接：仓库里不会塞进几百 MB 的壁纸，clone 下来依然很快。

顺手贴一段代码

写博客总要贴代码，这里验证一下高亮效果。

from pathlib import Path

def walk_images(root: Path, exts: set[str]) -> list[Path]:
    """列出目录下所有图片，忽略隐藏文件。"""
    return sorted(
        path
        for path in root.rglob("*")
        if path.is_file()
        and path.suffix.lower() in exts
        and not path.name.startswith(".")
    )


if __name__ == "__main__":
    for image in walk_images(Path("img"), {".png", ".jpg", ".webp"}):
        print(image)

Java 也来一段：

public record Link(String name, String url) {
    public static Link of(String name, String url) {
        return new Link(name, url == null ? "" : url.trim());
    }
}

写下来的东西不一定要给别人看，但一定要给未来的自己看。

图片走图床的样子

下面这张图并不是塞在仓库里的，而是构建时上传到 ImgBB 之后写进页面的链接 —— 用 imgx 标签引用本地路径即可，构建脚本会自动换成图床地址：

用 imgx 标签引用的图床图片

接下来想写什么

一些 Python 的小工具，以及踩过的坑
Minecraft 里自己盖的东西
Blue Archive 的剧情碎碎念
用 Claude Code、Codex 这些 Agent 干活的记录

写博客这件事，最重要的从来不是工具，而是真的动手写。

让静态博客不丢图：Hexo + ImgBB 增量上传方案

2026-10-06T12:15:00.000Z

GitHub 对「仓库里全是图片」的项目不太友好，体积大、clone 慢，还容易被当成图床。这个站点把所有图片都放在本地 img/ 目录（已被 .gitignore 排除），构建时再增量上传到 ImgBB。

增量上传是怎么做的

核心是一个清单文件 tools/image-manifest.json，它以「相对路径」为键，记录图片的内容哈希和上传后的链接：

{
  "img/bg_img/theme_ba/pc/139649.webp": {
    "sha256": "0f3c…",
    "url": "https://i.ibb.co/xxxx/139649.webp",
    "thumb": "https://i.ibb.co/xxxx/139649.webp",
    "uploadedAt": "2026-10-06T12:00:00.000Z"
  }
}

于是上传逻辑就变成三句话：

扫描 img/ 下的所有图片，算出 sha256；
清单里有相同哈希 → 直接跳过；文件变了或没记录 → 上传；
上传完校验一次链接是否可访问，坏掉的条目从清单里删掉，下次自动重传。

页面是怎么拿到链接的

构建阶段，Hexo 脚本读取清单，把每个皮肤、每种设备的背景图整理成一个数组塞进页面：

// scripts/lib/image-index.js（节选）
const entry = manifest.images[relPath];
if (entry && entry.url) {
  return { path: relPath, url: entry.url, uploaded: true };
}
// 没传过也不怕：退化成本地路径，构建收尾会把文件复制进 public/
return { path: relPath, url: encodeLocalPath(relPath), uploaded: false };

这样即使某次上传失败、或者你刚 clone 完还没有图片，站点也不会出现空白背景或坏图。

上传失败怎么办

脚本带了三层保险：

网络错误与 429/5xx 会指数退避重试；
单张失败不影响其它图片，重新执行一次即可续传；
npm run verify 可以单独体检所有链接，--fix 会把坏链接标记为待重传。

静态站点最大的好处是：构建产物就是最终产物。只要构建时确认链接可用，上线之后就不会有「图片加载失败」这种意外。

顺手记一下命令

node tools/upload-images.mjs --dry-run    # 只看这次会上传哪些
node tools/upload-images.mjs --limit=5    # 先试传 5 张
node tools/upload-images.mjs --force      # 忽略缓存全部重传
node tools/verify-images.mjs --fix        # 体检 + 标记坏链接

Lawson_Hui的博客