Codex更新网站内容怎么做：先找到内容来源，别只改生成页面

---
title: 文件整理大全
description: 全面提高效率的好方法。
slug: file-guide
---
## 为什么先查引用
移动图片前先找使用它的页面；每一处相对路径应按来源文件所在目录计算。

## 本例只移动两张图
列出旧路径、新路径、引用来源和恢复记录，完成后重开两个入口页面。

import fs from 'node:fs';
import matter from 'gray-matter';
import MarkdownIt from 'markdown-it';
const md=new MarkdownIt({html:false});
const escape=s=>String(s).replace(/[&<>"']/g,c=>({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]));
const {data,content}=matter(fs.readFileSync('content/guide.md','utf8'));
for(const k of ['title','description','slug']) {
  if(typeof data[k]!=='string'||!data[k].trim())throw Error('Missing '+k);
}
if(!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(data.slug))throw Error('Invalid slug');
const shell=(title,description,body)=>'<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>'+escape(title)+'</title><meta name="description" content="'+escape(description)+'"></head><body>'+body+'</body></html>';
const article=shell(data.title,data.description,'<h1>'+escape(data.title)+'</h1>'+md.render(content));
const index=shell('文章目录','现有操作指南','<h1>文章目录</h1><a href="'+data.slug+'.html">'+escape(data.title)+'</a><p>'+escape(data.description)+'</p>');
fs.mkdirSync('dist',{recursive:true});
fs.writeFileSync('dist/'+data.slug+'.html',article);
fs.writeFileSync('dist/index.html',index);
console.log('Built '+data.slug+'.html and index.html');

读取 demo-content 的 build.mjs、content/guide.md 及生成页。
把文章 title 改成“整理项目图片：先查引用，再迁移两张截图”；
description 改成“用旧新路径映射移动两张截图，同步更新两处引用，并保留恢复记录。”
只改源 frontmatter 的这两项；不改 slug、正文、构建器和其他文件。
运行本项目构建，在生成文章与目录中核对 title、description、H1 和卡片文案。
交付源 diff、执行命令、实际输出路径和未完成检查；不要仅手改 dist。