新增 Slug 模式配置#

在文章内容页配置中增加 slug 模式配置项：

1
post: {
2
  slug: "random",
3
}

配置类型同步新增：

1
slug: "pinyin" | "random";

其他模块通过 PostSlugMode 复用该配置项的派生类型，避免再次定义相同的模式范围。

1
export type PostSlugMode = SiteConfig["post"]["slug"];

生成业务无关的随机 Slug#

random 模式使用 Node.js 的 crypto.randomBytes 生成 8 字节随机数，再转换为 16 位小写十六进制字符串。

1
function createRandomSlug(): string {
2
  return randomBytes(8).toString("hex");
3
}

随机值不读取文章标题、正文、分类或路径，因此这些业务内容发生变化时不会影响已写入的 slug。

setup 生命周期阶段补全 Slug#

通过 Astro Integration 接入配置生命周期：

1
integrations: [
2
  postSlugIntegration(siteConfig.post.slug),
3
]

该 Integration 在 astro:config:setup 阶段检查文章，仅允许 dev 命令写入缺失的 slug：

1
const generated = await syncPostSlugs({
2
  mode,
3
  write: command === "dev",
4
});

运行 pnpm dev 时，缺少 slug 的文章会生成随机 slug 并写回 frontmatter。已有非空 slug 不会重新生成。运行构建、检查、Astro 同步或预览命令时只进行校验，如果仍有文章缺少 slug ，流程会报错提醒。

创建文章时直接生成随机 Slug#

当前配置为 random 时，新文章会立即得到 16 位随机 slug。写入文件前还会检查该值是否已被其他文章占用：

1
await assertPostSlugAvailable(slug, targetDir);

检查通过后，随机 slug 与其他 frontmatter 字段一同写入新文章，使文章从创建时开始就使用稳定的访问路径。