@windcoder/astro-theme-orchid 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,119 @@
-# Temporary Holding Version
+# @windcoder/astro-theme-orchid
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+清新简约的 Astro 博客主题，以 **Astro Integration** 形式提供：站点只做三件事——声明域名、接入主题、传入配置；页面、样式引擎、路由全部由主题注入。支持版本化升级与组件覆盖（`src/overrides/` 同名替换，升级永不覆盖站点定制）。
+
+## 特性一览
+
+- **页面**：首页（featured/cover/compact/text 四种卡片混排）、文章页（TOC/相关推荐/分享海报/打赏入口）、归档（按年折叠）、分类、标签、专题、画廊（含加密相册）、友链、留言板、打赏、关于
+- **写作增强**：LaTeX（KaTeX + mhchem）、Mermaid 双主题、PlantUML、Callouts、GitHub 卡片、图语法（figure/九宫格）、Expressive Code 代码块（双主题/行号/折叠/复制/语言徽标）、邮箱防爬
+- **互动系统**：评论五套（Artalk / Twikoo / Waline / Giscus / Disqus）、文章加密、过时提醒、公告、广告位
+- **个性化**：深浅模式、hue 动态调色、樱花飘落、背景壁纸、音乐播放器（跨页不断播）、Live2D 看板娘、i18n（zh-CN / en）
+- **工程化**：配置启动即校验（Zod）、OG 分享图、LQIP 占位、字体子集化、站点统计四件套（GA / Clarity / Umami / 51.la）、RSS / sitemap
+
+## 快速上手
+
+### 1. 安装
+
+```sh
+pnpm add @windcoder/astro-theme-orchid
+# peerDependencies: astro ^7.0.0
+```
+
+### 2. 接入主题
+
+```ts
+// astro.config.ts
+import orchidTheme from "@windcoder/astro-theme-orchid";
+import { defineConfig } from "astro/config";
+
+export default defineConfig({
+	site: "https://blog.example.com",
+	integrations: [orchidTheme({ title: "我的博客" /* 其余配置见 demo 站指南系列 */ })],
+});
+```
+
+配置在 dev/build 启动即校验（Zod schema），错误会直接报出来。所有配置项都有默认值，无必填项（`title` 缺省为 `"Orchid Blog"`，正式站点应显式配置）。
+
+### 3. 内容集合
+
+Astro 要求 collections 定义在站点项目内，站点通过 `definePostSchema` 在兼容主题字段的基础上扩展自己的 frontmatter：
+
+```ts
+// src/content.config.ts
+import { defineCollection, z } from "astro:content";
+import { definePostSchema } from "@windcoder/astro-theme-orchid/schema";
+
+const posts = defineCollection({
+	type: "content",
+	schema: definePostSchema({ /* 站点自定义字段 */ }),
+});
+
+export const collections = { posts };
+```
+
+#### 可选：启用 MDX
+
+MDX 是站点能力选择：是否写 `.mdx` 文章由站点决定。主题渲染管线与其天然兼容——`@astrojs/mdx` 默认继承站点 `markdown` 配置，主题注册的自定义 unified processor（KaTeX / Mermaid / PlantUML / directives / Expressive Code）原样作用于 `.mdx`。
+
+启用三步：`pnpm add @astrojs/mdx`、在 `integrations` 数组里注册（与主题顺序无关）、集合 loader 扩为 `"**/*.{md,mdx}"`。组件写作、`.md`/`.mdx` 选型，以及已知的 `style-to-js` 依赖坑（含一行 overrides 根治配方），见 demo 站《MDX 指南》一文。
+
+### 4. 站点结构约定
+
+```text
+site/
+├── astro.config.ts          # 接入主题（见上）
+├── config/                  # 配置按模块拆分（推荐做法，也可直接内联）
+├── src/content/posts/       # 文章（.md；启用 MDX 后 .mdx 一并收录）
+├── src/content/spec/        # 独立页内容：about.md / friends.md / guestbook.md
+├── src/overrides/           # 组件覆盖（路径镜像主题，见「定制与覆盖」）
+├── scripts/new-post.mjs     # 写作辅助：pnpm new-post <标题>[.md|.mdx]（demo 站）
+└── public/                  # 静态资源（音乐/壁纸/画廊/模型等）
+```
+
+独立页 `friends.md` / `guestbook.md` 的 frontmatter 只需 `title`；页面数据（友链列表、打赏码等）来自主题配置，见 demo 站《独立页面与数据》一文。
+
+## 配置文档
+
+主题配置项全部有默认值、无必填项，dev/build 启动即经 Zod schema 校验，配错直接报出。字段语义以 [`src/schema.ts`](./src/schema.ts) 注释为准。
+
+完整配置说明与文章 frontmatter 全字段表统一放在 demo 站「主题使用指南」系列文章（源文件在本仓库 `site/src/content/posts/`），按主题分组：
+
+- 基础：《站点基础配置》｜《导航栏与首页横幅》｜《侧边栏与个人资料》｜《文章列表与归档》
+- 功能：《文章页功能》｜《视觉特效与媒体》（含 fonts 详细配置）｜《独立页面与数据》｜《评论、公告、统计与广告》
+- 写作：《写作指南》（frontmatter 全字段与增强语法）｜《MDX 指南》（MDX 启用与踩坑修复）
+
+## 定制与覆盖
+
+- **组件覆盖**：站点 `src/overrides/` 下镜像主题路径放同名文件即可整体替换，例如
+  `src/overrides/components/PostCard.astro` 替换文章卡片。主题内部统一经
+  `virtual:theme/components/X.astro` 引用组件，解析时优先命中 overrides，找不到回退包内默认实现；
+  overrides 内再 import 同名组件时强制解析到包内默认实现（保留包装扩展的能力）。
+- **样式**：主题全局样式经 `@windcoder/astro-theme-orchid/styles/global.css` 注入；强调色派生色全部走 CSS 变量（`--accent-h/s/l`），可通过覆盖变量或 overrides 组件实现深度定制。
+- **页脚注入**：`footer.customHtml` 支持注入备案号、自定义脚本/样式等任意 HTML。
+
+## 文档同步约定
+
+- 新增/修改**配置项**：同一次提交内更新 demo 站对应指南文章（`site/src/content/posts/`），并在 `docs/design.md` 记录功能节（§ 编号）。
+- 新增**frontmatter 字段**：同步更新 demo 站《写作指南》字段表。
+- 行为变更不涉及配置面时，至少在 `docs/design.md` 留痕。
+
+## 本仓库开发
+
+```text
+packages/theme   主题包（exports 直指 src，无构建步骤）
+site             中性 demo 站点（config/ 按模块拆分配置，是指南文章与配置示例的载体）
+docs/design.md   设计与实现记录（§ 编号推进，含踩坑与验证口径）
+```
+
+```sh
+pnpm install
+pnpm --filter site dev     # 本地开发
+pnpm --filter site build   # 构建
+pnpm --filter site new-post "文章标题"   # 生成 frontmatter 骨架到 site/src/content/posts/（.mdx 后缀可显式指定）
+```
+
+> 注意：改动主题渲染管线（rehype/remark 插件）后构建前需清除 content layer 渲染缓存：`rm -rf site/node_modules/.astro`。
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,71 @@
 {
-  "name": "@windcoder/astro-theme-orchid",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+	"name": "@windcoder/astro-theme-orchid",
+	"version": "0.2.0",
+	"description": "清新简约的 Astro 博客主题，以 Integration 形式提供，支持版本化升级与组件覆盖",
+	"type": "module",
+	"keywords": [
+		"astro",
+		"astro-integration",
+		"blog",
+		"theme",
+		"tailwindcss"
+	],
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/iwinder/qy-astro-theme-orchid.git",
+		"directory": "packages/theme"
+	},
+	"homepage": "https://github.com/iwinder/qy-astro-theme-orchid/tree/main/packages/theme#readme",
+	"bugs": "https://github.com/iwinder/qy-astro-theme-orchid/issues",
+	"publishConfig": {
+		"access": "public",
+		"registry": "https://registry.npmjs.org/"
+	},
+	"exports": {
+		".": "./src/index.ts",
+		"./schema": "./src/schema.ts",
+		"./routes/*": "./src/routes/*",
+		"./components/*": "./src/components/*",
+		"./plugins/*": "./src/plugins/*",
+		"./styles/*": "./src/styles/*"
+	},
+	"files": [
+		"src"
+	],
+	"peerDependencies": {
+		"@iconify-json/lucide": "^1.2.0",
+		"@iconify-json/simple-icons": "^1.2.0",
+		"astro": "^7.0.0"
+	},
+	"dependencies": {
+		"@astrojs/markdown-remark": "^7.3.2",
+		"@astrojs/rss": "^4.0.19",
+		"@astrojs/sitemap": "^3.7.3",
+		"@expressive-code/plugin-collapsible-sections": "^0.44.2",
+		"@expressive-code/plugin-line-numbers": "^0.44.2",
+		"@tailwindcss/vite": "^4.3.2",
+		"astro-icon": "^1.2.0",
+		"beautiful-mermaid": "^1.1.3",
+		"expressive-code-collapsible": "^0.1.0",
+		"expressive-code-language-badge": "^1.1.0",
+		"hastscript": "^9.0.1",
+		"katex": "^0.19.0",
+		"l2d-widget": "^0.1.2",
+		"pako": "^3.0.2",
+		"photoswipe": "^5.4.4",
+		"qrcode": "^1.5.4",
+		"rehype-expressive-code": "^0.44.2",
+		"rehype-katex": "^7.0.1",
+		"remark-directive": "^4.0.0",
+		"remark-math": "^6.0.0",
+		"satori": "^0.47.1",
+		"sharp": "^0.35.5",
+		"tailwindcss": "^4.3.2"
+	},
+	"devDependencies": {
+		"@types/pako": "^2.0.3",
+		"@types/qrcode": "^1.5.6",
+		"subset-font": "^2.5.0"
+	}
+}

package/src/components/AlbumCard.astro

@@ -0,0 +1,73 @@
+---
+import { t } from "../i18n/index.js";
+/**
+ * 相册卡片（M3b-b8）：画廊列表页网格单元，样式对齐设计原型 §9。
+ * data-tags（标签数组）与 data-search（名称/描述/地点/标签全文小写）供 gallery-filter 筛选。
+ */
+import { getLqipStyle } from "../utils/lqip.js";
+
+interface Props {
+	id: string;
+	name: string;
+	cover: string;
+	description?: string;
+	date?: string;
+	location?: string;
+	tags?: string[];
+	photoCount: number;
+	encrypted?: boolean;
+}
+
+const {
+	id,
+	name,
+	cover,
+	description = "",
+	date = "",
+	location = "",
+	tags = [],
+	photoCount,
+	encrypted = false,
+} = Astro.props;
+
+const searchText = [name, description, location, ...tags]
+	.join(" ")
+	.toLowerCase();
+---
+
+<a class="album-card card" href={`/gallery/${id}/`} data-tags={tags.join(',')} data-search={searchText} aria-label={encrypted ? `${name}（${t('encryptedAlbum')}）` : name}>
+  <div class="album-cover">
+    {cover ? (
+      <>
+        {/* LQIP 占位渐变（b9.5）：外链封面查不到数据时降级纯色 */}
+        <div class="qy-lqip" style={getLqipStyle(cover)} aria-hidden="true"></div>
+        <img src={cover} alt={name} loading="lazy" decoding="async" data-lqip />
+      </>
+    ) : (
+      <span class="album-cover-fallback">
+        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="5" width="18" height="14" rx="2"/><circle cx="9" cy="10" r="1.6"/><path d="m21 15-4.2-4.2a1.4 1.4 0 0 0-2 0L7 18.6"/></svg>
+      </span>
+    )}
+    {encrypted && (
+      <span class="lock-badge">
+        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect width="18" height="11" x="3" y="11" rx="2" ry="2"/><path d="M7 11V7a5 5 0 0 1 10 0v4"/></svg>
+        {t('encryptedAlbum')}
+      </span>
+    )}
+  </div>
+  <div class="album-info">
+    <span class="album-name">{name}</span>
+    <span class="album-count">{t('galleryPhotos', { n: photoCount })}</span>
+  </div>
+  {(date || location) && (
+    <div class="album-sub">
+      {date && <span>{date}</span>}
+      {location && <span>{location}</span>}
+    </div>
+  )}
+  {tags.length > 0 && (
+    <div class="album-tags">
+      {tags.slice(0, 4).map((tag) => <span class="chip">{tag}</span>)}
+    </div>
+  )}
+</a>

package/src/components/Analytics.astro

@@ -0,0 +1,22 @@
+---
+/**
+ * 站点统计聚合挂载点（P1-16）：BaseLayout body 尾部统一挂载。
+ * 各统计 ID 留空即完全不注入对应脚本；全部留空本组件零输出。
+ */
+import config from "virtual:theme/config";
+import GoogleAnalytics from "./analytics/GoogleAnalytics.astro";
+import La51Analytics from "./analytics/La51Analytics.astro";
+import MicrosoftClarity from "./analytics/MicrosoftClarity.astro";
+import UmamiAnalytics from "./analytics/UmamiAnalytics.astro";
+
+const a = config.analytics;
+const showGA = a.googleAnalyticsId.trim() !== "";
+const showClarity = a.microsoftClarityId.trim() !== "";
+const showUmami = a.umami.websiteId.trim() !== "";
+const show51la = a.la51.id.trim() !== "";
+---
+
+{showGA && <GoogleAnalytics analyticsId={a.googleAnalyticsId} />}
+{showClarity && <MicrosoftClarity clarityId={a.microsoftClarityId} />}
+{showUmami && <UmamiAnalytics {...a.umami} />}
+{show51la && <La51Analytics analyticsId={a.la51.id} sdkUrl={a.la51.sdkUrl} ck={a.la51.ck} autoTrack={a.la51.autoTrack} hashMode={a.la51.hashMode} screenRecord={a.la51.screenRecord} />}

package/src/components/BaseLayout.astro

@@ -0,0 +1,188 @@
+---
+// 字体（§4.66）：Astro Fonts API 官方组件，按 cssVariable 渲染 @font-face
+// 与变量定义（preload 开启时附带 <link rel=preload>）
+import { Font } from "astro:assets";
+import { ClientRouter } from "astro:transitions";
+import Analytics from "virtual:theme/components/Analytics.astro";
+import Footer from "virtual:theme/components/Footer.astro";
+import Header from "virtual:theme/components/Header.astro";
+import Live2DWidget from "virtual:theme/components/Live2DWidget.astro";
+import MusicPlayer from "virtual:theme/components/MusicPlayer.astro";
+import SakuraEffect from "virtual:theme/components/SakuraEffect.astro";
+import config from "virtual:theme/config";
+import { t } from "../i18n/index.js";
+import { hexToHsl } from "../utils.js";
+import "@windcoder/astro-theme-orchid/styles/global.css";
+/* 灯箱（§4.69）：PhotoSwipe 样式随页面 CSS 一起打包，JS 由 app.ts 惰性动态加载 */
+import "photoswipe/photoswipe.css";
+
+interface Props {
+	title?: string;
+	description?: string;
+	/** meta keywords（§4.19）：默认站点级配置，文章页传 frontmatter tags 覆盖 */
+	keywords?: string[];
+	/** body[data-page]，驱动导航高亮（home/archive/tags/post...） */
+	page?: string;
+	/** OG 分享图路径（b9.4，文章页传 /og/<slug>.png）；绝对链接依赖站点 site 配置 */
+	ogImage?: string;
+}
+
+const {
+	title,
+	description = config.description,
+	keywords = config.keywords,
+	page,
+	ogImage,
+} = Astro.props;
+const pageTitle = title ? `${title} · ${config.title}` : config.title;
+const { h, s, l } = hexToHsl(config.accentColor);
+/* 首页 banner（§4.42，hero+壁纸合并单配置）：数组时构建期随机选一张（每页构建各自取，零 JS）；
+   enabled=false 或 src 未配置不渲染图 */
+const bannerSrc = Array.isArray(config.banner.src)
+	? config.banner.src.length
+		? config.banner.src[Math.floor(Math.random() * config.banner.src.length)]
+		: ""
+	: config.banner.src || "";
+const showBanner =
+	config.banner.enabled &&
+	Boolean(bannerSrc) &&
+	(!config.banner.homeOnly || page === "home");
+/* hero 文案（§4.42）：quote 留空不渲染；有 banner 时叠加其上，否则渲染为列表上方独立区块 */
+const heroEnabled = config.banner.enabled && Boolean(config.banner.quote);
+const heroOnBanner = heroEnabled && showBanner && page === "home";
+/* 字体角色映射（§4.66）：配置了 role 的字体生成 html:root 规则，把主题三角色
+   变量重定向为 var(字体变量), 原角色回退栈（取自 global.css :root 默认值，
+   字体未覆盖的字形如中文自然回落）。html:root Specificity (0,1,1) 高于
+   :root (0,1,0)，稳定覆盖不赌样式顺序；CSS 自定义属性引用是惰性求值，
+   与 <Font> 产出的变量定义先后无关 */
+const fontRoleFallback: Record<string, string> = {
+	display: '"Noto Serif SC", "Songti SC", "STSong", "SimSun", serif',
+	body: '-apple-system, "PingFang SC", "Segoe UI", "Microsoft YaHei", sans-serif',
+	mono: 'ui-monospace, "SF Mono", "JetBrains Mono", "Fira Code", monospace',
+};
+const fontRoleCss = config.fonts
+	.filter((f) => f.role)
+	.map(
+		(f) =>
+			`html:root{--font-${f.role}:var(${f.cssVariable}),${fontRoleFallback[f.role]};}`,
+	)
+	.join("");
+---
+
+<!doctype html>
+<html lang={config.lang} style={`--accent-h:${h};--accent-s:${s}%;--accent-l:${l}%;--page-width:${config.pageWidth}px`} data-accent-h={h} data-color-mode={config.colorMode}>
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="generator" content={Astro.generator} />
+    <title>{pageTitle}</title>
+    <meta name="description" content={description} />
+    {/* keywords（§4.19）：非空才输出；文章页以 tags 覆盖站点级配置 */}
+    {keywords.length > 0 && <meta name="keywords" content={keywords.join(", ")} />}
+    <meta name="author" content={config.author} />
+    {/* favicon（§4.30）：配置非空时按列表输出，theme 指定 light/dark 经 media 按系统深浅切换 */}
+    {config.favicon.length > 0
+      ? config.favicon.map((f) => (
+          <link
+            rel="icon"
+            href={f.src}
+            type={f.type}
+            sizes={f.sizes}
+            media={f.theme ? `(prefers-color-scheme: ${f.theme})` : undefined}
+          />
+        ))
+      : <link rel="icon" href="/favicon.svg" type="image/svg+xml" />}
+    {/* SEO 头部补全（§4.12）：canonical 防重复内容；RSS 供阅读器发现；theme-color 与 global.css :root 同步 */}
+    {Astro.site && <link rel="canonical" href={new URL(Astro.url.pathname, Astro.site).href} />}
+    <link rel="alternate" type="application/rss+xml" title={config.title} href={Astro.site ? new URL("rss.xml", Astro.site).href : "/rss.xml"} />
+    <meta name="theme-color" media="(prefers-color-scheme: light)" content="#f6f4ef" />
+    <meta name="theme-color" media="(prefers-color-scheme: dark)" content="#131516" />
+    {/* OG/Twitter meta（b9.4）：ogImage 仅文章页传入；绝对链接依赖 site 配置 */}
+    <meta property="og:type" content={ogImage ? 'article' : 'website'} />
+    <meta property="og:title" content={pageTitle} />
+    <meta property="og:description" content={description} />
+    <meta property="og:site_name" content={config.title} />
+    <meta property="og:locale" content={config.lang.replace("-", "_")} />
+    {Astro.site && <meta property="og:url" content={new URL(Astro.url.pathname, Astro.site).href} />}
+    {ogImage && Astro.site && <meta property="og:image" content={new URL(ogImage, Astro.site).href} />}
+    <meta name="twitter:card" content={ogImage ? 'summary_large_image' : 'summary'} />
+    <ClientRouter />
+    {/* 字体（§4.66）：Astro Fonts API 标准方案。每个 <Font> 按注入配置产出
+        @font-face + 变量定义（preload 时附带预载链接）；角色映射规则随后输出 */}
+    {config.fonts.length > 0 && (
+      <>
+        {config.fonts.map((f) => (
+          <Font cssVariable={f.cssVariable} preload={f.preload} />
+        ))}
+        <style is:global set:html={fontRoleCss} />
+      </>
+    )}
+    <!-- 深浅模式 boot：先于首帧执行防 FOUC；is:inline 在 VT swap 时不重复执行。
+         默认模式读 html[data-color-mode]（§4.16 colorMode），用户选择以 localStorage('qy-mode') 优先 -->
+    <script is:inline>
+      (function(){var m=localStorage.getItem('qy-mode');var d=document.documentElement.dataset.colorMode||'system';if(m==='dark'||(!m&&d==='dark')||(!m&&d==='system'&&matchMedia('(prefers-color-scheme: dark)').matches))document.documentElement.classList.add('dark');var h=localStorage.getItem('qy-hue');if(h)document.documentElement.style.setProperty('--accent-h',h);})();
+    </script>
+  </head>
+  <!-- 客户端动态文案载体（i18n，M3b-b5）：app.ts 读取，VT swap 后随新 body 重建 -->
+  <script type="application/json" id="qy-ui-labels" set:html={JSON.stringify({ close: t('close'), prevImage: t('prevImage'), nextImage: t('nextImage'), copied: t('copied'), fullscreen: t('fullscreen'), slideshow: t('slideshow'), thumbs: t('thumbs'), sharePoster: t('sharePoster'), generatingPoster: t('generatingPoster'), copyLink: t('copyLink'), savePoster: t('savePoster'), scanToRead: t('scanToRead'), author: t('author'), searchLoading: t('searchLoading'), searchNoResults: t('searchNoResults'), searchUnavailable: t('searchUnavailable'), searchTypeSomething: t('searchTypeSomething') })} />
+  <body data-page={page}>
+    <a class="skip-link" href="#main">{t('skipToContent')}</a>
+    <Header />
+    <!-- 首页 banner（§4.42，hero+壁纸合并单配置）：Header 之后下沉横幅 + 黑蒙层；enabled=false / src 未配置 / homeOnly 非首页不渲染 -->
+    {
+      showBanner && (
+        <div
+          class="wallpaper-banner"
+          style={`--banner-h:${config.banner.height}vh;--banner-dim:${config.banner.dimOpacity};--banner-pos:${config.banner.position}`}
+        >
+          <img src={bannerSrc} alt="" aria-hidden="true" loading="eager" />
+          <div class="wallpaper-dim" aria-hidden="true" />
+          {/* hero 文案叠加（§4.42）：quote 配置时主句/副句居中显示在 banner 上 */}
+          {heroOnBanner && (
+            <div class="wallpaper-hero reveal">
+              <h1 class="hero-quote" set:html={config.banner.quote} />
+              {config.banner.sub && <p class="hero-sub">{config.banner.sub}</p>}
+            </div>
+          )}
+        </div>
+      )
+    }
+    <main id="main" class="site-main">
+      <div class="shell">
+        {/* hero 独立区块形态（§4.42）：无 banner 图时的首页 hero 文案，保持原列表上方位置 */}
+        {
+          heroEnabled && page === "home" && !heroOnBanner && (
+            <section class="hero reveal">
+              <h1 class="hero-quote" set:html={config.banner.quote} />
+              {config.banner.sub && <p class="hero-sub">{config.banner.sub}</p>}
+            </section>
+          )
+        }
+        <slot />
+      </div>
+    </main>
+    <!-- 列表形态恢复（§4.34→§4.55）：首帧绘制前按 localStorage > defaultLayout 应用防闪烁；
+         is:inline 在 VT 换页不重执行，跨页返回由 app.ts initPage 接管 -->
+    <script is:inline>
+      (function(){try{var l=document.getElementById('postList');var m=localStorage.getItem('qy-postList')||(l&&l.dataset.defaultLayout)||'list';if(m!=='grid'||!l)return;l.classList.add('grid-mode');l.style.setProperty('--col-w',(l.dataset.gridCol||'320')+'px');var b=document.getElementById('layoutSwitch');if(b)b.setAttribute('aria-pressed','true');}catch(e){}})();
+    </script>
+    <Footer />
+    <!-- 站点统计（P1-16）：ID 全空零输出，挂 body 尾与 orchid-blog 口径一致 -->
+    <Analytics />
+    <!-- 樱花飘落特效（§4.30）：sakura.enabled 开启才渲染 -->
+    {config.sakura.enabled && <SakuraEffect density={config.sakura.density} />}
+    <!-- 悬浮音乐播放器（§4.36）：music.enabled 且歌单非空才渲染 -->
+    {config.music.enabled && config.music.playlist.length > 0 && (
+      <MusicPlayer music={config.music} />
+    )}
+    <!-- Live2D 看板娘（§4.38）：live2d.enabled 且配置了 model 才渲染 -->
+    {config.live2d.enabled && config.live2d.model && <Live2DWidget live2d={config.live2d} />}
+    <button class="back-top" id="backTop" type="button" aria-label={t('backToTop')} hidden>
+      <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m18 15-6-6-6 6"/></svg>
+    </button>
+    <!-- 全局交互（VT 兼容：document 级委托 + astro:page-load 重初始化） -->
+    <script>
+      import '../scripts/app';
+    </script>
+  </body>
+</html>