# 申屠手记：新增与修改文章

网站：https://shentunotes.com/
本版通过 Markdown 文件与 Codex 协助发布。网页写稿后台留待后续建设。

## 新增

在项目 content 目录新建一个 .md 文件。文件开始填写以下字段，随后空一行写正文；无需额外 YAML 分隔线。

    Title: 文章标题
    Slug: unique-article-name
    Category: 工具实践
    Description: 这篇文章帮读者解决什么问题。
    Date: 2026-09-11
    Updated: 2026-09-11
    Status: draft

分类选“创作经验”“建站记录”“工具实践”。Slug 用小写英文字母、数字与短横线，在本站唯一；网址为 /articles/unique-article-name/。Date 是实际发布日期，Updated 是最近实质修改日期。draft 不会生成公开页面，published 才会发布。

正文从引言开始，以二级标题分节；页面自动生成一级标题和目录。图片放到公开 assets 下，填写替代文字。公开素材先脱敏。正式文章内链使用 /articles/文章网址/，站外链接注明来源。

将完整草稿交给 Codex，要求检查事实、结构、链接和手机阅读。确认公开范围后把 Status 改为 published，执行构建、检查与发布。首页显示最新六篇，目录每页十篇，分类、RSS 和站点地图自动生成。

## 修改

编辑原文件，保留 Slug 与 Date。实质改动更新 Updated；普通错字修改可保留日期。同步检查配套资源和内链。将文章改为 draft 会从公开页面与各列表移除，原链接可能返回 404；撤下前检查引用并决定是否需要说明页。

## 发布与回退（由 Codex 协助）

1. 保存当前可回退版本。
2. 运行 scripts/build.py 与 scripts/check.py；构建需要 Python Markdown 依赖。
3. 本地预览首页、文章、分类、资源与手机布局。
4. 将准确源代码状态提交并推送至本站已绑定的源仓库。
5. 按 Sites 流程打包、保存版本、部署到现有项目。
6. 核对正式域名页面、下载、RSS 和 sitemap，记录版本及结果。
7. 若线上出现回归，重新部署已保存的上一正常版本，再排查。

可以这样提出需求：“请发布这篇已确认文章，保留本站结构，完成本地与线上检查，告诉我正式链接及检查结果。”