更新

.vscode/settings.json

@@ -1,22 +1,33 @@
 {
-  "editor.formatOnSave": true,
-  "editor.defaultFormatter": "biomejs.biome",
-  "[javascript]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "[javascriptreact]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "[typescript]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "[typescriptreact]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "editor.codeActionsOnSave": {
-    "source.fixAll": "explicit",
-    "quickfix.biome": "always",
-    "source.organizeImports.biome": "always"
-  },
-  "frontMatter.dashboard.openOnStart": false
+	"css.validate": false,
+	"less.validate": false,
+	"scss.validate": false,
+	"tailwindCSS.includeLanguages": {
+		"astro": "html",
+		"svelte": "html"
+	},
+	"editor.formatOnSave": true,
+	"editor.defaultFormatter": "biomejs.biome",
+	"[javascript]": {
+		"editor.defaultFormatter": "biomejs.biome"
+	},
+	"[javascriptreact]": {
+		"editor.defaultFormatter": "biomejs.biome"
+	},
+	"[typescript]": {
+		"editor.defaultFormatter": "biomejs.biome"
+	},
+	"[typescriptreact]": {
+		"editor.defaultFormatter": "biomejs.biome"
+	},
+	"editor.codeActionsOnSave": {
+		"source.fixAll.biome": "explicit"
+	},
+	"frontMatter.dashboard.openOnStart": false,
+	"[markdown]": {
+		"editor.defaultFormatter": "esbenp.prettier-vscode"
+	},
+	"markdown.validate.enabled": true,
+	"files.autoSave": "onFocusChange",
+	"editor.aiStats.enabled": true
 }

CLAUDE.md

@@ -0,0 +1,79 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Fuwari is a static blog template built on **Astro 6** with **Svelte 5** islands, **Tailwind CSS 3**, and **Stylus**. It deploys to **Vercel** at `https://zhangjun.xyz`. The site language is Chinese (`zh_CN`).
+
+## Commands
+
+```bash
+pnpm dev          # Dev server at localhost:4321
+pnpm build        # Production build (astro build → pagefind → sitemap)
+pnpm preview      # Preview production build
+pnpm check        # Astro type/error checking
+pnpm type-check   # TypeScript strict check
+pnpm lint         # Biome lint with auto-fix (biome check --write ./src)
+pnpm format       # Biome format (biome format --write ./src)
+pnpm new-post <name>  # Scaffold a new post in src/content/posts/
+```
+
+Package manager is **pnpm** (enforced via `only-allow pnpm` in preinstall script). No test framework is configured.
+
+## Architecture
+
+### Rendering Pipeline
+
+Posts (markdown in `src/content/posts/`) → Astro content collections with Zod schema (`src/content/config.ts`) → Remark/Rehype plugin chain (`astro.config.mjs`) → Static HTML. Search index built via Pagefind at build time.
+
+### Component Strategy
+
+- **`.astro` files** — static SSG components (layouts, cards, nav, sidebar widgets). Zero client JS.
+- **`.svelte` files** — interactive islands loaded with `client:only="svelte"` (search, dark mode toggle, archive panel, display settings).
+
+### Theming
+
+Color system uses oklch with a single `--hue` CSS custom property (`src/styles/variables.styl`). All colors derive from this hue. Dark mode is class-based (`class` strategy in Tailwind config), persisted in localStorage and applied before render to prevent FOUC. Users can change the hue via a slider in display settings.
+
+### Key Source Layout
+
+| Area | Path | Purpose |
+|---|---|---|
+| Blog config | `src/config.ts` | Site title, theme color, navbar, profile, license settings |
+| Content schema | `src/content/config.ts` | Zod frontmatter schema (title, published, tags, category, etc.) |
+| Content utils | `src/utils/content-utils.ts` | `getSortedPosts()`, tag/category aggregation, prev/next links |
+| Types | `src/types/config.ts` | TypeScript types for all config structures |
+| i18n | `src/i18n/` | 10 languages; enum keys in `i18nKey.ts`, translations in `languages/` |
+| Styles | `src/styles/` | `variables.styl` (theme vars), `main.css` (Tailwind components), `markdown.css` |
+| Plugins | `src/plugins/` | Remark (reading time, excerpts) and Rehype (admonitions, GitHub cards, KaTeX) plugins |
+| Layouts | `src/layouts/` | `Layout.astro` (root HTML), `MainGridLayout.astro` (navbar + sidebar + content grid) |
+| Pages | `src/pages/` | File-based routing: `[...page].astro` (home, paginated), `posts/[...slug].astro`, `archive.astro`, `about.astro` |
+
+### Path Aliases (tsconfig.json)
+
+`@components/*`, `@assets/*`, `@constants/*`, `@utils/*`, `@i18n/*`, `@layouts/*`, `@/*` — all resolve to `src/`.
+
+## Blog Post Frontmatter
+
+```yaml
+---
+title: "Post Title"
+published: 2025-01-15    # Required, Date
+updated: 2025-01-20      # Optional
+draft: false              # Excluded from production builds
+description: ""
+image: ""                 # Cover image (URL or relative path)
+tags: [tag1, tag2]
+category: "Category"
+lang: ""                  # Override site language per-post
+---
+```
+
+## Code Style
+
+**Biome** with tabs and double quotes. `.svelte` and `.astro` files have relaxed rules (no `useConst`, `useImportType`, `noUnusedVariables` enforcement). Run `pnpm lint` before committing. CI runs `biome ci ./src --reporter=github`.
+
+## Markdown Extensions
+
+Posts support: admonitions (`:::note`, `:::tip`, `:::warning`, etc.), GitHub cards (`::github{repo="user/repo"}`), KaTeX math (`$...$` inline, `$$...$$` display), Expressive Code blocks with collapsible sections, and reading time auto-calculation.

astro.config.mjs

@@ -1,12 +1,11 @@
 import sitemap from "@astrojs/sitemap";
 import svelte from "@astrojs/svelte";
-import tailwind from "@astrojs/tailwind";
 import { pluginCollapsibleSections } from "@expressive-code/plugin-collapsible-sections";
 import { pluginLineNumbers } from "@expressive-code/plugin-line-numbers";
 import swup from "@swup/astro";
+import { defineConfig } from "astro/config";
 import expressiveCode from "astro-expressive-code";
 import icon from "astro-icon";
-import { defineConfig } from "astro/config";
 import rehypeAutolinkHeadings from "rehype-autolink-headings";
 import rehypeComponents from "rehype-components"; /* Render the custom directive content */
 import rehypeKatex from "rehype-katex";
@@ -16,23 +15,20 @@ import remarkGithubAdmonitionsToDirectives from "remark-github-admonitions-to-di
 import remarkMath from "remark-math";
 import remarkSectionize from "remark-sectionize";
 import { expressiveCodeConfig } from "./src/config.ts";
+import { pluginCustomCopyButton } from "./src/plugins/expressive-code/custom-copy-button.ts";
 import { pluginLanguageBadge } from "./src/plugins/expressive-code/language-badge.ts";
 import { AdmonitionComponent } from "./src/plugins/rehype-component-admonition.mjs";
 import { GithubCardComponent } from "./src/plugins/rehype-component-github-card.mjs";
 import { parseDirectiveNode } from "./src/plugins/remark-directive-rehype.js";
 import { remarkExcerpt } from "./src/plugins/remark-excerpt.js";
 import { remarkReadingTime } from "./src/plugins/remark-reading-time.mjs";
-import { pluginCustomCopyButton } from "./src/plugins/expressive-code/custom-copy-button.js";
 
 // https://astro.build/config
 export default defineConfig({
-	site: "https://fuwari.vercel.app/",
+	site: "https://zhangjun.xyz",
 	base: "/",
 	trailingSlash: "always",
 	integrations: [
-		tailwind({
-			nesting: true,
-		}),
 		swup({
 			theme: false,
 			animationClass: "transition-swup-", // see https://swup.js.org/options/#animationselector
@@ -61,12 +57,12 @@ export default defineConfig({
 				pluginCollapsibleSections(),
 				pluginLineNumbers(),
 				pluginLanguageBadge(),
-				pluginCustomCopyButton()
+				pluginCustomCopyButton(),
 			],
 			defaultProps: {
 				wrap: true,
 				overridesByLang: {
-					'shellsession': {
+					shellsession: {
 						showLineNumbers: false,
 					},
 				},
@@ -76,7 +72,8 @@ export default defineConfig({
 				borderRadius: "0.75rem",
 				borderColor: "none",
 				codeFontSize: "0.875rem",
-				codeFontFamily: "'JetBrains Mono Variable', ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New', monospace",
+				codeFontFamily:
+					"'JetBrains Mono Variable', ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New', monospace",
 				codeLineHeight: "1.5rem",
 				frames: {
 					editorBackground: "var(--codeblock-bg)",
@@ -87,20 +84,30 @@ export default defineConfig({
 					editorActiveTabIndicatorBottomColor: "var(--primary)",
 					editorActiveTabIndicatorTopColor: "none",
 					editorTabBarBorderBottomColor: "var(--codeblock-topbar-bg)",
-					terminalTitlebarBorderBottomColor: "none"
+					terminalTitlebarBorderBottomColor: "none",
 				},
 				textMarkers: {
 					delHue: 0,
 					insHue: 180,
-					markHue: 250
-				}
+					markHue: 250,
+				},
 			},
 			frames: {
 				showCopyToClipboardButton: false,
+			},
+		}),
+		svelte(),
+		sitemap({
+			filter: (page) => !page.includes('/404'), // 1️⃣ 先过滤垃圾页
+			customPages: ['https://zhangjun.xyz/about'], // 2️⃣ 非 src/pages 的静态页
+			changefreq: 'daily',
+			priority: 0.5, // 3️⃣ 权重 - 设置为单个数字
+			lastmod: new Date(), // 4️⃣ 统一时间戳
+			serialize: async (item) => {
+				// 返回默认的序列化对象，保持默认行为
+				return item;
 			}
 		}),
-        svelte(),
-		sitemap(),
 	],
 	markdown: {
 		remarkPlugins: [
@@ -169,4 +176,4 @@ export default defineConfig({
 			},
 		},
 	},
-});
+});

package.json

@@ -6,38 +6,34 @@
     "dev": "astro dev",
     "start": "astro dev",
     "check": "astro check",
-    "build": "astro build && pagefind --site dist",
+    "build": "astro build && pagefind --site dist && node scripts/generate-sitemap.js",
     "preview": "astro preview",
     "astro": "astro",
-    "type-check": "tsc --noEmit --isolatedDeclarations",
+    "type-check": "tsc --noEmit",
     "new-post": "node scripts/new-post.js",
     "format": "biome format --write ./src",
     "lint": "biome check --write ./src",
     "preinstall": "npx only-allow pnpm"
   },
   "dependencies": {
-    "@astrojs/check": "^0.9.6",
-    "@astrojs/rss": "^4.0.14",
-    "@astrojs/sitemap": "^3.6.0",
-    "@astrojs/svelte": "7.2.3",
-    "@astrojs/tailwind": "^6.0.2",
-    "@expressive-code/core": "^0.41.4",
-    "@expressive-code/plugin-collapsible-sections": "^0.41.4",
-    "@expressive-code/plugin-line-numbers": "^0.41.4",
+    "@astrojs/check": "^0.9.9",
+    "@astrojs/svelte": "8.1.2",
+    "@expressive-code/core": "^0.41.3",
+    "@expressive-code/plugin-collapsible-sections": "^0.41.3",
+    "@expressive-code/plugin-line-numbers": "^0.41.3",
     "@fontsource-variable/jetbrains-mono": "^5.2.8",
-    "@fontsource/roboto": "^5.2.9",
+    "@fontsource/roboto": "^5.2.8",
     "@iconify-json/fa6-brands": "^1.2.6",
     "@iconify-json/fa6-regular": "^1.2.4",
     "@iconify-json/fa6-solid": "^1.2.4",
-    "@iconify-json/material-symbols": "^1.2.50",
+    "@iconify-json/material-symbols": "^1.2.40",
     "@iconify/svelte": "^4.2.0",
     "@swup/astro": "^1.7.0",
-    "@tailwindcss/typography": "^0.5.19",
-    "astro": "5.13.10",
-    "astro-expressive-code": "^0.41.4",
+    "astro": "6.4.2",
+    "astro-expressive-code": "^0.41.3",
     "astro-icon": "^1.1.5",
     "hastscript": "^9.0.1",
-    "katex": "^0.16.27",
+    "katex": "^0.16.23",
     "markdown-it": "^14.1.0",
     "mdast-util-to-string": "^4.0.0",
     "overlayscrollbars": "^2.12.0",
@@ -54,23 +50,26 @@
     "remark-math": "^6.0.0",
     "remark-sectionize": "^2.1.0",
     "sanitize-html": "^2.17.0",
-    "sharp": "^0.34.5",
+    "sharp": "^0.34.4",
     "stylus": "^0.64.0",
     "svelte": "^5.39.8",
-    "tailwindcss": "^3.4.19",
     "typescript": "^5.9.3",
     "unist-util-visit": "^5.0.0"
   },
   "devDependencies": {
-    "@astrojs/ts-plugin": "^1.10.6",
+    "@astrojs/rss": "^4.0.18",
+    "@astrojs/sitemap": "^3.7.3",
+    "@astrojs/ts-plugin": "^1.10.9",
     "@biomejs/biome": "2.2.5",
     "@rollup/plugin-yaml": "^4.1.2",
+    "@tailwindcss/postcss": "^4.3.0",
+    "@tailwindcss/typography": "^0.5.19",
+    "@tailwindcss/vite": "^4.3.0",
     "@types/hast": "^3.0.4",
     "@types/markdown-it": "^14.1.2",
     "@types/mdast": "^4.0.4",
     "@types/sanitize-html": "^2.16.0",
-    "postcss-import": "^16.1.1",
-    "postcss-nesting": "^13.0.2"
+    "tailwindcss": "^4.3.0"
   },
   "packageManager": "pnpm@9.14.4"
-}
+}