如何使用这个网站

这个网站是纯静态的:没有后端、没有数据库,所有内容都是构建时从文件生成的。日常使用只有四个动作。

加一篇文档

往 src/content/docs/ 里丢一个 Markdown 文件即可,文件头部用 YAML 声明标题、标签和日期:

---
title: 我的随笔
description: 一段可选的摘要
tags: [随笔]
date: 2026-10-01
---

正文从这里开始,支持标准 Markdown 语法。

保存后重新构建,列表页、首页”最近文档”、标签筛选都会自动更新,不用改任何代码。

换看板数据

看板的所有数字都在 src/data/ 下的 JSON 文件里,改完重新部署即可:

文件	对应图表	字段说明
time-allocation.json	时间去哪了(堆叠条 + 首页速览)	items[].name / items[].hours
monthly-trend.json	近 12 个月趋势(折线)	months[] / series[].values
expenses.json	本月花销(条形)	items[].name / items[].amount
habits.json	打卡日历(网格)	records[习惯][天数],1 为完成

注意:monthly-trend.json 的 months 与每条 series.values 长度要一致;habits.json 的 records 数组长度要等于 days。

本地运行

npm install     # 首次
npm run dev     # 开发预览 http://localhost:4321
npm run build   # 构建到 dist/

部署一条命令

npx wrangler pages deploy dist --project-name=muyweb

几十秒后生效。详细备忘见《Cloudflare Pages 部署备忘》。

改名字、改印章

站名、标语、导航和左上角印章上的字,都集中在 src/config.ts 一个文件里:

export const SITE = {
  title: 'muyweb',
  sealChar: '沐',   // 换成你喜欢的单字
  ...
};

改完重新构建部署即可。