歡迎來到徐風沐雨

妳好，世界

徐風從容，沐雨前行。

這個博客使用 VitePress 搭建，搭配朝華標題字體，以繁體中文書寫，記錄技術與生活的點滴。

基本信息

項目	內容
名稱	徐風沐雨
地址	https://xuguopeng.com
線上預覽	https://xufengmuyu.pages.dev
技術棧	VitePress 1.6.4 + @sugarat/theme + Vue 3 + TypeScript + UnoCSS
字體	朝華標題（ZhaohuaMinA）via ZeoSeven CDN
語言	繁體中文
源碼	Fork 自 ShyMean，主題已換成 @sugarat/theme
部署方式	阿里雲，`./publish.sh` 一鍵同步 + 構建 + rsync 上線

項目結構

shymean-blog/
├── .vitepress/          # VitePress 配置
│   ├── config.mts       # 站點配置（標題、字體CDN、插件等）
│   ├── blog-theme.ts    # @sugarat/theme 配置（主題色、導航、首頁卡片）
│   └── theme/           # 主題入口（把本站佈局接進主題 Layout）
├── data/                # 元數據（自動生成）
│   ├── meta.json        # 文章列表（含分類、標籤、摘要）
│   ├── archive.json     # 分類和標籤歸檔
│   └── pathRewrites.json # 路徑重寫映射
├── scripts/             # 構建腳本
├── theme/               # 自定義主題
│   ├── fonts.scss       # 字體變量定義
│   ├── global.scss      # 全局樣式 + 羊皮紙配色變量
│   ├── pet.ts           # 首頁桌面寵物（仙狐 Live2D，全部自托管）
│   ├── layout/          # 沿用本站佈局的頁面（歸檔 / 標籤 / 搜索）
│   └── components/      # 通用組件（Appreciate / DocTitle / SwitchDark 等）
├── views/               # 頁面（Markdown）
│   ├── index.md         # 首頁
│   ├── about.md         # 關於頁
│   ├── works.md         # 作品頁（含安裝包下載入口）
│   ├── tags.md          # 標籤頁
│   ├── archive.md       # 歸檔頁
│   ├── public/          # 靜態資源（圖片、模型）
│   └── article/         # 文章目錄（由 vault 同步而來，不手改）
└── package.json

字體方案

字段	值
CSS 變量	`--font-main: 'ZhaohuaMinA', serif;`
字體名稱	朝華標題（ZhaohuaMinA）
作者	特里王
CDN	ZeoSeven Fonts

全局統一使用 var(--font-main)，覆蓋：body、標題 h1-h4、站名、導航、鏈接。

品牌信息

站名：徐風沐雨
標語：徐風從容，沐雨前行
域名：xuguopeng.com
公眾號：徐風沐雨
Github：https://github.com/xuguopeng

文章列表（2026-05 開站時，現在 30 篇，完整清單看歸檔）

#	標題	分類	標籤
1	歡迎來到徐風沐雨	生活	隨筆
2	每天學一點-flutter篇	Flutter	Flutter, 跨平台, 學習記錄
3	個人博客快速自動部署到自己的服務器	Code	GitHub Actions, 自動部署, 雲服務器
4	Ai的作用	生活	AI, 開發
5	vuepress 博客搭建	Code	博客, VitePress
6	Astro主題-優雅的vhAstro-Theme	Code	Astro, 主題, 博客
7	HanAnalytics 訪問分析 Web 統計	Code	HanAnalytics, 網站分析
8	驟雨重山無限存儲圖床	Code	Cloudflare Pages, 免費圖床
9	使用flutter編寫一款APP	Flutter	提升
10	ios證書更換	Code	ios, 證書
11	自我管理的十大習慣	生活	自我管理, 提升

部署流程

一鍵上線跑倉庫根目錄的 ./publish.sh，它會自動：

同步 Obsidian 書庫 → views/article/，以書庫為準；書庫裡刪掉的文章會從構建目錄清掉，清掉的舊文件先備份到 .last-sync-backup/
node scripts/metadata.js — 掃描文章目錄生成元數據
vitepress build — 構建靜態站點
rsync 推到阿里雲的站點目錄（帶 --delete，但 .well-known、.user.ini、downloads/ 三個路徑除外）

./publish.sh sync 只同步，./publish.sh build 只構建。舊的 Cloudflare Pages 路徑也還在：./publish.sh cf（等價於 npm run deploy），xufengmuyu.pages.dev 就是它。

寫新文章流程

在 Obsidian 書庫 創作庫/博客/ 下新建 .md 文件（views/article/ 是同步產物，不要直接改它）
填寫 frontmatter：

yaml

---
title: 文章標題
date: 2026-05-08 10:00:00
categories: [分類名]
tags: [標籤1, 標籤2]
top: true # 可選，置頂到首頁第一位
publish: false # 可選，非文章頁用它排除出列表、統計和 RSS
---

撰寫正文（繁體中文）
執行 ./publish.sh 上線

關鍵文件速查

要改什麼	改哪個文件
站名/標語	`.vitepress/config.mts`
字體	`theme/global.scss` 的 `--font-main`
主題色/配色	`.vitepress/blog-theme.ts` 的 `themeColor` + `theme/global.scss` 的 `html:root`
導航欄	`.vitepress/config.mts` 的 `themeConfig.nav`
首頁列表	主題的 `BlogList`，單篇用 frontmatter 調：`top` 置頂、`hidden` 不出列表、`publish: false` 連統計和 RSS 一起排除
歸檔頁 / 標籤頁	`theme/layout/Archive.vue`、`theme/layout/Tags.vue`（這兩個仍是本站佈局）
關於頁	`views/about.md`
作品頁	`views/works.md` + `views/works/*.md`
桌面寵物	`theme/pet.ts`，模型和運行時在 `views/public/senko/`、`views/public/live2d/`
文章摘要邏輯	`scripts/hexo2json.js`
部署	倉庫根目錄的 `publish.sh`

開發日誌

2026-05-07: Fork ShyMean 項目，完成品牌定制和字體配置
2026-05-07: 字體從馬善政 → 霞鶩文楷 → LXGW WenKai TC → 朝華標題
2026-05-07: 全站簡體轉繁體中文
2026-05-08: 部署到 Cloudflare Pages，項目名 xufengmuyu
2026-05-08: 修復分類逐字拆開 bug，補全所有文章分類和摘要
2026-05-08: 更新「歡迎來到徐風沐雨」文章內容
2026-09-28: 主題從自研的 ShyMean 佈局換成 @sugarat/theme（釘住 vitepress 1.6.4、依賴改 pnpm），全站配色改成羊皮紙古籍色
2026-09-28: 上線從 Cloudflare Pages 搬到阿里雲，./publish.sh 一條命令跑完同步 + 構建 + rsync；順手補上 nginx 的 try_files，/about 這種無後綴地址才不再 404
2026-09-29: 文章源改到 Obsidian 書庫單向同步，倉庫裡的 views/article/ 從此是構建產物，不在裡面改稿
2026-09-29: 首頁左下角加了一隻自托管的仙狐桌面寵物（Live2D，四件套腳本和模型都在站內），按正文左側留白自動縮放，窄屏時讓位給正文
2026-09-29: 新增「作品」頁與 MuStory 項目子頁，Codex Theme 的安裝包放在 /downloads 供直接下載

歡迎來到徐風沐雨

妳好，世界 ​

基本信息 ​

項目結構 ​

字體方案 ​

品牌信息 ​

文章列表（2026-05 開站時，現在 30 篇，完整清單看歸檔） ​

部署流程 ​

寫新文章流程 ​

關鍵文件速查 ​

開發日誌 ​