这套导航站怎么维护

这个站是纯静态的，没有任何服务器和数据库。所有内容都是文件，改完提交就生效。

三处要改的地方

想改什么	改哪个文件
书签、分组、站点名	src/data/links.yml
写一篇笔记	在 src/content/notes/ 新建 .md
配色、字号、间距	src/styles/global.css 顶部的 :root

加一个书签

在 links.yml 找到对应分组，加一段：

- name: 示例站
  url: https://example.com
  desc: 一句话说明
  mark: 例
  region: cn

region 只有两个值：cn（国内，ICP 备案）、os（海外，免备案）。前端会按这个字段着色和筛选。

mark 是卡片左边那个方框里的字，不写就自动取名称首字。

写一篇笔记

在 src/content/notes/ 下新建文件，文件名会变成网址：

---
title: 标题
date: 2026-10-29
tags: [标签]
summary: 列表页显示的摘要
---

正文……

draft: true 的笔记只在本地开发时可见，不会被构建出去。

链接检测怎么跑

npm run check

它会遍历 links.yml 里所有链接，并发检测，把结果写回文件里的 status 和 lastChecked 字段。检测不通过的链接，前台会显示为划线加一个赭红小点。

如果配置了 CI（.cnb.yml），每天会自动跑一次，结果直接提交回仓库并触发重新部署。

本地预览

npm install     # 首次
npm run dev     # 打开 http://localhost:4321
npm run build   # 产物在 dist/

dist/ 整个目录就是成品，任何静态托管都能放。