开发维护

目录边界

• src/pages/：页面路由和静态生成入口。
• src/layouts/：页面骨架与文章布局。
• src/components/：可复用组件和交互运行时。
• src/content/：Markdown 内容集合。
• src/data/：友链、相册、装备、音乐等站点数据。
• src/utils/：文章工具、分页和短代码转换。
• public/：构建时直接复制的静态资源。

推荐流程

1. 先确认数据模型和页面路由。
2. 在内容配置中补齐字段校验。
3. 把交互限制在确实需要浏览器的部分。
4. 同时检查桌面端、移动端、明暗主题和空数据状态。
5. 执行 npm run check 与 npm run build。

扩展约定

主题默认值应保持简单，复杂能力通过配置逐步开启。避免在页面组件中复制站点配置，也不要把构建产物 dist/ 当作源码维护。