开始使用澄屿

下载模板后，在包含 package.json 的目录打开终端。下列命令都在该目录执行。

检查本机环境

项目要求 Node.js 24 或更高版本，锁定的包管理器为 pnpm 11.25.0；当前示例在 Node.js 24 环境验证。先检查版本：

1node --version2pnpm --version

如果终端提示找不到命令，先安装对应运行环境。保留项目的 pnpm-lock.yaml，这样安装使用同一套依赖版本。

1pnpm install --frozen-lockfile2pnpm dev

打开终端显示的地址，默认是 http://127.0.0.1:4321/。这是本机开发服务，不是已经上线的站点。若该端口正被另一份预览占用，可以先停止它，或者执行 pnpm dev --port 4322。

修改站名和作者

打开 site.config.ts，在现有对象中修改下列字段，其他配置保留。下面是局部修改示意，不要用它替换整个文件：

1title: '我的记录',2subtitle: '技术笔记与日常记录',3author: {4  name: '你的名字',5  bio: '用自己的话介绍这里。',6  tags: ['写作', '阅读'],7  github: '',8  email: '',9},

保存后检查页头、首页、关于页和文章署名。邮箱与 GitHub 留空时相应入口隐藏。首页首屏、生活切片与关于页介绍分别由 hero、life、about 配置；修改图片时同时更新替代文字和来源提示。

设置部署地址

site 是公开网站的完整地址，base 是部署路径。它们影响规范地址、RSS、站点地图和资源链接。下面的域名只是示意，发布前替换成自己的地址：

1site: 'https://your-domain.example',2base: '/',

如果网站将放在某个 /blog/ 子目录，使用 base: '/blog/'，构建与托管位置保持一致。本机仍打开终端地址，无需把 site 改成 127.0.0.1。

开发预览和产物预览

需要核对完整全文搜索时，先在开发终端按 Ctrl+C，再执行：

1pnpm check2pnpm build3pnpm preview

浏览首页、文章、资料和搜索。预览服务读取已有 dist，此时修改源文件需要重新构建才会出现变化。构建成功只更新本机产物，不会自动上传 GitHub 或部署。

新建文章

模板没有预装 first-note 这个 ID，你可以在停止预览后运行：

1pnpm new article first-note

新文章默认为私人草稿。接着阅读新建、预览与发布文章，使用本机草稿模式查看它。