如何更新这个博客

这是一篇备忘录，记录本博客的日常更新流程。现在有两种方式：**本地笔记工作台（推荐）**和手工流程。

1. notes-ui 本地工作台（推荐）

仓库里的 tools/notes-ui/ 是一个只监听本机的 Web 工具，双击 start.bat 启动后浏览器自动打开 http://127.0.0.1:8091 ：

导入笔记：拖拽 .md 文件或整个笔记文件夹（图片会自动带上），也可以直接粘贴文本
检查元数据：标题、描述、分类、标签、发布时间都会自动预填，slug 实时查重；右侧图片清单能看到正文引用的图片是否齐全，缺的可补传
生成页面包：图片自动拷入 images/、正文路径自动改写、front matter 按站内规范生成
本地预览：弹窗内嵌真实主题渲染（含公式和 Mermaid）
分步发布：构建验证 → 部署上线（二次确认）→ 线上抽查 → git 提交，每步独立日志，出问题可停在中途

「文章管理」页还能改历史文章的元数据、切换草稿、改 slug、删除（进本地回收站）。

2. 手工流程（备用）

不用工具时，流程如下。

写新文章

在 content/post/ 目录下新建页面包 my-new-post/index.md（图片放同目录 images/），或单文件 my-new-post.md：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
---
title: "文章标题"
date: 2025-03-15T11:30:00+08:00
slug: my-new-post
draft: false
description: "文章摘要，会显示在首页卡片上。"
categories:
  - 分类名
tags:
  - 标签
---

正文从这里开始，支持标准 Markdown。

把 draft 设为 true 可以存草稿，构建时不会发布。注意 front matter 的 date 不要写成未来时间，否则 Hugo 默认不构建该文章。

本地预览（可选）

1
hugo server -D

浏览器打开 http://localhost:1313 实时预览，Ctrl+C 退出。

构建并部署

1
2
# 在博客根目录执行一键部署脚本（构建 + 上传 + 原子替换）
bash deploy/deploy.sh

部署完成，访问 https://zeseanblog.top 即可看到新文章。

3. 让 AI 助手代劳

直接说一句「帮我发布新文章」即可——本文件夹的 AGENTS.md 里记录了完整的环境信息和部署流程。

4. 提交代码（备份）

1
2
3
# 只提交这篇 文章 的路径，避免带上工作区其他未完成的改动
git add content/post/my-new-post
git commit -m "post: 新文章标题"