@xingwangzhe/stalux 1.22.7 → 1.23.1

package/README.md

@@ -8,7 +8,7 @@
 
 **[stalux.needhelp.icu](https://stalux.needhelp.icu)**
 
-A dark-themed, high-performance Astro blog theme with elegant glassmorphism design, per-route font subsetting, and a focus on content-first reading experience.
+A dark-themed, high-performance Astro blog theme with elegant glassmorphism design, unicode-range font slicing, and a focus on content-first reading experience.
 
 ---
 
@@ -76,7 +76,7 @@ bun run dev
 ## ✨ Features
 
 - 🌙 **Dark mode** with elegant glassmorphism design
-- 🔤 **Per-route font subsetting** — 25 MB font → ~350 KB shared + ~1 KB per page
+- 🔤 **Unicode-range font slicing** — 25 MB font → ~22 woff2 chunks, browser downloads only what matches the page
 - 🔍 **Full-text search** via Pagefind (auto-indexed on build)
 - 📡 **RSS & Atom feeds**
 - 🖼️ **PhotoSwipe** image lightbox
@@ -95,16 +95,11 @@ bun run dev
 
 ## 🔤 Font Optimization
 
-Stalux ships with a 25 MB Chinese font (LXGW WenKai). Instead of loading the full file, the build generates minimal subsets per route:
+Stalux ships with a 25 MB Chinese font (LXGW WenKai) and a variable code font (Google Sans Code). Instead of loading the full files, the build slices the body font into ~22 woff2 chunks by `unicode-range` (via the official Astro Fonts API, `fontProviders.local()`), and the browser downloads only the chunks whose range matches characters on the page — typically 1–2 chunks (~200–600 KB each) for the above-the-fold content.
 
-| Subset    | Size      | Content                                    |
-| --------- | --------- | ------------------------------------------ |
-| Common    | ~350 KB   | UI text, nav, i18n, shared post characters |
-| Per-route | ~0.5–3 KB | Unique characters for each page            |
+Every page emits `@font-face` rules with continuous `unicode-range` descriptors from the `<Font />` component; chunk filenames are content-addressed and deterministic across builds, keeping `experimental.incrementalBuild` caches stable (Astro ≥ 7.2.2).
 
-Every page loads `common.css` + `subset-{route}.css`. All route types are covered: `/`, `/about`, `/words`, `/posts/*`, `/archives`, `/tags`, `/categories`, `/links`.
-
-Powered by `subset-font` (Harfbuzz WASM), running at build time and on-demand in dev mode.
+Powered by `subset-font` (Harfbuzz WASM), slicing at build time into `node_modules/.astro/stalux-fonts/`; the local provider reads files from disk with no network access.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@xingwangzhe/stalux",
-    "version": "1.22.7",
+    "version": "1.23.1",
     "description": "A powerful, modern Astro blog theme — use as template or install as plugin",
     "keywords": [
         "astro",
@@ -82,15 +82,14 @@
         "@mcp-b/webmcp-polyfill": "^4.0.0",
         "@pagefind/component-ui": "^1.5.2",
         "@waline/client": "^3.15.2",
-        "@xingwangzhe/satteri-mermaid": "0.7.3",
-        "@xingwangzhe/satteri-photoswipe": "^0.2.2",
-        "@xingwangzhe/tags-cloud": "^1.2.5",
+        "@xingwangzhe/satteri-mermaid": "0.7.6",
+        "@xingwangzhe/satteri-photoswipe": "^0.2.3",
+        "@xingwangzhe/tags-cloud": "^1.2.6",
         "animejs": "^4.5.0",
         "astro-expressive-code": "^0.44.1",
         "astro-seo": "^1.1.0",
         "astro-typewriter": "^1.2.0",
         "badge-maker": "^6.0.0",
-        "js-yaml": "^5.3.0",
         "pagefind": "^1.5.2",
         "photoswipe": "^5.4.4",
         "satteri": "^0.9.5",

package/src/components/stalux/layout/head.astro

@@ -1,4 +1,5 @@
 ---
+import { Font } from "astro:assets";
 import { SEO } from "astro-seo";
 import { ClientRouter } from "astro:transitions";
 import { getCollection } from "astro:content";
@@ -217,9 +218,10 @@ const ldJson = JSON.stringify(schema, null, 2).replace(/<\//g, "<\\/");
       meta: extendedMeta,
     }}
   />
-  <style set:html={`:root{--font-body:"LXGW WenKai Subset","Noto Sans SC","Noto Sans CJK SC",system-ui,-apple-system,sans-serif}`} />
-  <!-- 代码字体：静态 code.css（font-subset.ts 生成，确定性，不经过 Astro <Font> 管线） -->
-  <link rel="stylesheet" href="/fonts/code.css" />
+  <!-- 字体：由 Astro Fonts API 注入（--font-body 分片 / --font-code 可变字体），
+       <Font /> 输出 @font-face 样式；浏览器按 unicode-range 按需下载正文分片 -->
+  <Font cssVariable="--font-body" />
+  <Font cssVariable="--font-code" />
   {
     (headConfig?.anyhead) && (
       <Fragment set:html={headConfig.anyhead} />

package/src/components/stalux/layout/listPage.astro

@@ -10,15 +10,14 @@ interface Props {
     description: string;
     heading: string;
     subheading?: string;
-    fontSubsetId?: string;
 }
 
-const { title, description, heading, subheading, fontSubsetId } = Astro.props;
+const { title, description, heading, subheading } = Astro.props;
 const configEntries = await getCollection("config");
 const siteConfig = getSiteData(configEntries);
 ---
 
-<Stalux title={title + " | " + siteConfig.title} description={description} fontSubsetId={fontSubsetId}>
+<Stalux title={title + " | " + siteConfig.title} description={description}>
     <div style="height: 3em;"></div>
     <Navs />
     <h1 class={styles.title}>{heading}</h1>

package/src/index.ts

@@ -10,20 +10,64 @@
 
 import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
-import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
 import type { AstroIntegration } from "astro";
+import { fontProviders } from "astro/config";
 // pagefind 是 ESM-only 包，需要在模块顶层导入
 // 因为 astro:build:done 钩子中 Vite module runner 已关闭，无法动态 import
 import { createIndex as pagefindCreateIndex } from "pagefind";
 
 import type { StaluxOptions } from "./config";
 import { staluxComponentsAlias } from "./internal/components-plugin";
-import { runFontSubsetting } from "./internal/font-subset";
+import { runFontSlicing, type FontSlice } from "./internal/font-slices";
 import { featureFlagsHast, featureFlagsMdast } from "./plugins/feature-flags";
 import { temml } from "./plugins/satteri-temml";
 
+// 字体配置（Astro Fonts API）通过 updateConfig 注入，两种模式（源码模板/npm 插件）都生效。
+// 官方 local provider 完全本地读文件（readFile），不联网；
+// 7.2.2 已修复 Fonts API 随机端口污染 incrementalBuild dependencyHash 的问题（PR #17659）。
+function buildFontsConfig(slices: FontSlice[], codeNormal: string, codeItalic?: string) {
+    return [
+        {
+            // 正文：LXGW WenKai 按 unicode-range 分片，浏览器只下载命中区间的分片
+            provider: fontProviders.local(),
+            name: "LXGW WenKai",
+            cssVariable: "--font-body",
+            fallbacks: ["Noto Sans SC", "Noto Sans CJK SC", "system-ui", "sans-serif"],
+            optimizedFallbacks: true,
+            options: {
+                variants: slices.map((slice) => ({
+                    weight: 400,
+                    style: "normal",
+                    src: [slice.src],
+                    unicodeRange: slice.unicodeRange,
+                })),
+            },
+        },
+        {
+            // 代码：Google Sans Code 可变字体，原样注册，不切片
+            provider: fontProviders.local(),
+            name: "Google Sans Code",
+            cssVariable: "--font-code",
+            fallbacks: ["JetBrains Mono", "Fira Code", "Consolas", "Courier New", "monospace"],
+            optimizedFallbacks: true,
+            options: {
+                variants: [
+                    {
+                        weight: "100 900",
+                        style: "normal",
+                        src: [codeNormal],
+                    },
+                    ...(codeItalic
+                        ? [{ weight: "100 900", style: "italic", src: [codeItalic] }]
+                        : []),
+                ],
+            },
+        },
+    ];
+}
+
 // ---------------------------------------------------------------------------
 // 页面条目定义
 // ---------------------------------------------------------------------------
@@ -326,54 +370,37 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration {
                     logger.debug("Stalux: site.yml not found, skip site sync");
                 }
 
-                // 7. 字体裁剪（在 config:setup 阶段执行，保证 dev/build 都能生成）
+                // 7. 字体：构建期把正文切成 unicode-range 分片，通过官方 Fonts API 注入
+                // （config:setup 阶段执行，保证 dev/build 都能生成；local provider 纯本地读文件）
                 try {
-                    const projectRoot = process.cwd();
-                    await runFontSubsetting(projectRoot, logger, true);
+                    const sliced = await runFontSlicing(process.cwd(), logger);
+                    if (sliced) {
+                        updateConfig({
+                            fonts: buildFontsConfig(
+                                sliced.body,
+                                sliced.codeNormal,
+                                sliced.codeItalic,
+                            ),
+                        });
+                        logger.info(
+                            `Stalux: injected ${sliced.body.length} body font chunks + code font via Fonts API`,
+                        );
+                    }
                 } catch (error) {
-                    logger.debug(`Font subsetting deferred: ${String(error)}`);
+                    logger.warn(`Stalux: font injection failed: ${String(error)}`);
                 }
             },
 
             "astro:build:start": async ({ logger }) => {
-                // 8. 字体裁剪（构建时，生成全部路由子集）
-                try {
-                    const projectRoot = process.cwd();
-                    await runFontSubsetting(projectRoot, logger);
-                } catch (error) {
-                    logger.warn(`Font subsetting skipped: ${String(error)}`);
-                }
+                // 字体分片已在 astro:config:setup 阶段生成并注入，这里无额外处理。
+                // 保留钩子为空实现，便于将来在此处追加构建期逻辑。
+                logger.debug("Stalux: build start (font slices handled in config:setup)");
             },
 
-            "astro:server:setup": async ({ server, logger }) => {
-                // 9. 字体裁剪（开发模式，生成 common 子集 + 按需路由切片）
-                try {
-                    const projectRoot = process.cwd();
-                    // 清除旧的字体缓存
-                    const oldFontDir = resolve(projectRoot, "public/fonts");
-                    if (existsSync(oldFontDir)) {
-                        // 删除旧的 subset-*.css 和 common-*.woff2，让按需中间件重新生成
-                        for (const f of readdirSync(oldFontDir)) {
-                            if (f.startsWith("subset-") || f.startsWith("common-")) continue;
-                        }
-                    }
-                    // 先生成 common 子集
-                    await runFontSubsetting(projectRoot, logger, true);
-                    // 再添加按需路由切片中间件（放在最前面，优先拦截字体请求）
-                    const { createDevFontMiddleware } = await import(
-                        /* @vite-ignore */
-                        new URL("./internal/font-subset-dev.ts", import.meta.url).href
-                    );
-                    const fontMiddleware = createDevFontMiddleware(projectRoot, logger);
-                    server.middlewares.use((req: any, res: any, next: any) => {
-                        if (req.url?.startsWith("/fonts/")) {
-                            return fontMiddleware(req, res, next);
-                        }
-                        next();
-                    });
-                } catch (error) {
-                    logger.debug(`Font subsetting deferred in dev: ${String(error)}`);
-                }
+            "astro:server:setup": async ({ logger }) => {
+                // 字体分片在 config:setup 阶段已生成，dev 模式由官方 Fonts API 的
+                // dev 中间件按需提供，无需自研按需切分中间件。
+                logger.debug("Stalux: dev server ready (fonts served by Astro Fonts API)");
             },
 
             "astro:build:done": async ({ dir, logger }) => {

package/src/internal/font-slices.ts

@@ -0,0 +1,207 @@
+/**
+ * Build-time CJK font slicing engine (Astro Fonts API variant).
+ *
+ * Slices the full-size LXGW WenKai font (25 MB TTF) into ~20 woff2 chunks
+ * by unicode-range, registered through the official `fontProviders.local()`
+ * pipeline (`updateConfig({ fonts })`). The browser downloads only the chunks
+ * whose unicode-range matches characters on the page.
+ *
+ * Astro's local provider reads font files from disk (`readFile`), so no
+ * network access is involved at build time — identical behavior on GitHub
+ * Actions and CN mirrors. Slices are emitted to `node_modules/.astro/`
+ * (the Astro cacheDir) so they stay out of the repo and out of `dist/fonts`.
+ *
+ * Output layout:
+ *   node_modules/.astro/stalux-fonts/
+ *     lxgw-wenkai-slice-{n}-{hash}.woff2   — unicode-range chunk (content-addressed)
+ */
+
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import type { AstroIntegrationLogger } from "astro";
+import subsetFont from "subset-font";
+
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+
+/** Full font input path (relative to project root or package) */
+const FONT_INPUT = "src/assets/fonts/LXGWWenKai-Regular.ttf";
+
+/** Code font input paths (variable fonts, registered as-is, no slicing) */
+const CODE_FONT_INPUT = "src/assets/fonts/GoogleSansCode.woff2";
+const CODE_FONT_ITALIC_INPUT = "src/assets/fonts/GoogleSansCode-Italic.woff2";
+
+/** Output directory for generated slices (under the Astro cacheDir) */
+const SLICE_OUT_DIR = "node_modules/.astro/stalux-fonts";
+
+/** Chunk size (code points) for the CJK Unified Ideographs block */
+const CJK_CHUNK_SIZE = 1050;
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+export interface FontSlice {
+    /** Absolute path to the generated woff2 file */
+    src: string;
+    /** Unicode ranges for the @font-face unicode-range descriptor */
+    unicodeRange: string[];
+}
+
+export interface SlicedFonts {
+    /** Body font slices (LXGW WenKai), one variant per chunk */
+    body: FontSlice[];
+    /** Absolute path to the code font woff2 */
+    codeNormal: string;
+    /** Absolute path to the code italic woff2, if present */
+    codeItalic?: string;
+}
+
+interface SliceDef {
+    /** Ordinal used in the output filename */
+    id: number;
+    /** [start, end] code-point ranges covered by this slice */
+    ranges: Array<[number, number]>;
+}
+
+// ---------------------------------------------------------------------------
+// Slice definitions
+// ---------------------------------------------------------------------------
+
+/**
+ * CJK Unified Ideographs (U+4E00–U+9FFF) split into fixed-size chunks.
+ * Chunk boundaries are content-independent, so slices are deterministic
+ * across builds (no per-page character scanning).
+ */
+function buildCjkChunks(start = 0x4e00, end = 0x9fff, size = CJK_CHUNK_SIZE): SliceDef[] {
+    const chunks: SliceDef[] = [];
+    for (let s = start, id = 2; s <= end; s += size, id++) {
+        chunks.push({ id, ranges: [[s, Math.min(s + size - 1, end)]] });
+    }
+    return chunks;
+}
+
+const SLICES: SliceDef[] = [
+    // ASCII printable + Latin-1 supplement
+    { id: 0, ranges: [[0x20, 0x7e]] },
+    // CJK punctuation / fullwidth forms / general punctuation
+    {
+        id: 1,
+        ranges: [
+            [0x2000, 0x206f],
+            [0x3000, 0x303f],
+            [0xff00, 0xffef],
+        ],
+    },
+    ...buildCjkChunks(),
+];
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/** Locate a font file: project root → stalux package → this package. */
+function findFont(projectRoot: string, rel: string): string | undefined {
+    const candidates = [
+        resolve(projectRoot, rel),
+        resolve(projectRoot, "node_modules", "@xingwangzhe", "stalux", rel),
+        resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", rel),
+    ];
+    return candidates.find((p) => existsSync(p));
+}
+
+/** Render a [start, end] range as a CSS unicode-range value. */
+function toUnicodeRange(ranges: Array<[number, number]>): string[] {
+    const fmt = (cp: number) => `U+${cp.toString(16).toUpperCase().padStart(4, "0")}`;
+    return ranges.map(([s, e]) => (s === e ? fmt(s) : `${fmt(s)}-${fmt(e)}`));
+}
+
+/** Collect every code point in the ranges as a deduped, sorted string. */
+function rangesToChars(ranges: Array<[number, number]>): string {
+    const set = new Set<string>();
+    for (const [s, e] of ranges) {
+        for (let cp = s; cp <= e; cp++) {
+            set.add(String.fromCodePoint(cp));
+        }
+    }
+    return [...set].sort().join("");
+}
+
+// ---------------------------------------------------------------------------
+// Main entry
+// ---------------------------------------------------------------------------
+
+/**
+ * Slice the body font into unicode-range woff2 chunks and resolve the code
+ * fonts, all from local disk. Returns `null` when the body font is missing so
+ * the caller can skip font injection (pages fall back to system fonts).
+ *
+ * Called from the `astro:config:setup` hook before `updateConfig({ fonts })`.
+ */
+export async function runFontSlicing(
+    projectRoot: string,
+    logger: AstroIntegrationLogger,
+): Promise<SlicedFonts | null> {
+    // 1. Locate fonts (check project root first, then stalux package dir)
+    const fontPath = findFont(projectRoot, FONT_INPUT);
+    if (!fontPath) {
+        logger.warn(`Body font not found at ${FONT_INPUT}, skipping font injection`);
+        return null;
+    }
+    const codeNormal = findFont(projectRoot, CODE_FONT_INPUT);
+    if (!codeNormal) {
+        logger.warn(`Code font not found at ${CODE_FONT_INPUT}, skipping font injection`);
+        return null;
+    }
+    const codeItalic = findFont(projectRoot, CODE_FONT_ITALIC_INPUT);
+
+    const fontBuffer = readFileSync(fontPath);
+    const outDir = resolve(projectRoot, SLICE_OUT_DIR);
+    mkdirSync(outDir, { recursive: true });
+
+    // 2. Slice the body font into unicode-range chunks.
+    // Filename is content-addressed (md5 of the character set): identical
+    // input chars → identical bytes → identical name across builds, keeping
+    // the incremental-build dependency graph stable.
+    const body: FontSlice[] = [];
+    for (const def of SLICES) {
+        const chars = rangesToChars(def.ranges);
+        if (!chars) continue;
+        const hash = createHash("md5").update(chars).digest("hex").slice(0, 12);
+        const filename = `lxgw-wenkai-slice-${def.id}-${hash}.woff2`;
+        const outPath = join(outDir, filename);
+
+        if (!existsSync(outPath)) {
+            try {
+                const data = await subsetFont(fontBuffer, chars, { targetFormat: "woff2" });
+                if (data.length > 0) {
+                    writeFileSync(outPath, data);
+                    logger.debug(
+                        `  body slice ${def.id}: ${(data.length / 1024).toFixed(1)} KB → ${filename}`,
+                    );
+                }
+            } catch (error) {
+                logger.warn(`  body slice ${def.id} failed: ${String(error)}`);
+            }
+        }
+
+        if (existsSync(outPath)) {
+            body.push({ src: outPath, unicodeRange: toUnicodeRange(def.ranges) });
+        }
+    }
+
+    if (body.length === 0) {
+        logger.warn("Body font slicing produced no chunks, skipping font injection");
+        return null;
+    }
+
+    logger.info(
+        `Font slicing done: ${body.length} body chunks + code font ` +
+            `(source ${(fontBuffer.length / 1024 / 1024).toFixed(1)} MB → woff2 chunks)`,
+    );
+    return { body, codeNormal, codeItalic };
+}

package/src/layouts/Stalux.astro

@@ -7,9 +7,6 @@ import "@styles/shared/stagger.css";
 import "@styles/shared/view-transitions.css";
 import { getAuthorData, getAiDiscoveryData, getPromoteData, getSiteData } from "@utils/config-utils";
 import { getRouteAnimation, getRouteKind } from "@utils/view-transitions";
-// font-subset.ts 构建期生成的 manifest 副本（进入 Astro 依赖图，
-// manifest 变化 → 页面重建 → 增量构建 restored 的页面不会引用旧字体资源）
-import fontsManifest from "../internal/generated/fonts-manifest.json";
 const props = Astro.props as Props;
 
 interface Props {
@@ -23,8 +20,6 @@ interface Props {
   categories?: string[];
   author?: string;
   noindex?: boolean;
-  /** Font subset ID for per-route font optimization */
-  fontSubsetId?: string;
 }
 
 const configEntries = await getCollection("config");
@@ -34,39 +29,6 @@ const promoteConfig = getPromoteData(configEntries);
 const aiConfig = getAiDiscoveryData(configEntries);
 const htmlLang = siteConfig.lang || "zh-CN";
 
-// Resolve font subset CSS URLs（内容寻址，避免浏览器缓存旧 CSS 引用已删除 TTF → 404）
-// 生产构建：font-subset.ts 生成带 hash 的 CSS 文件名并写入 manifest（副本 import 至此），
-// 这里从 manifest 取文件名，内容变化必然换名、浏览器自动拉新。
-// dev 模式：manifest 的 routes 为空（skipPerRoute），回退固定名 /fonts/common.css 与
-// /fonts/subset-<id>.css，由 dev 按需中间件生成。
-const fontManifest = fontsManifest as
-    | {
-          commonCss?: string;
-          routes?: Record<string, string>;
-      }
-    | null
-    | undefined;
-
-let commonFontCssUrl = "/fonts/common.css";
-let fontSubsetUrl: string | undefined;
-if (props.fontSubsetId) {
-    fontSubsetUrl = `/fonts/subset-${props.fontSubsetId}.css`;
-}
-if (fontManifest?.commonCss) {
-    commonFontCssUrl = `/fonts/${fontManifest.commonCss}`;
-}
-if (props.fontSubsetId && fontManifest?.routes) {
-    // route 键可能是 posts/xxx（页面对应 posts-xxx）或含原始 unicode（tag/category），
-    // 统一归一化比较：route.replace("/", "-") === decodeURIComponent(fontSubsetId)
-    const want = decodeURIComponent(props.fontSubsetId);
-    for (const [route, cssFile] of Object.entries(fontManifest.routes)) {
-        if (route.replace("/", "-") === want) {
-            fontSubsetUrl = `/fonts/${encodeURIComponent(cssFile)}`;
-            break;
-        }
-    }
-}
-
 // 背景 SVG 以静态 URL 硬编码在 background.ts（纯客户端），
 // 集成在 config:setup 时把 SVG 复制到用户项目 public/background/。
 // SSR 不渲染背景图，默认露出 .bg-layer 的灰墙底色（--stalux-bg-color），
@@ -96,9 +58,6 @@ const routeAnimation = getRouteAnimation(routeKind);
     author={props.author}
     noindex={props.noindex}
   />
-  <!-- Per-route font subset (generated at build time) -->
-  <link rel="stylesheet" href={commonFontCssUrl} />
-  {fontSubsetUrl && <link rel="stylesheet" href={fontSubsetUrl} />}
   <script>
     import "../scripts/background.ts";
     import "../scripts/view-transitions.ts";

package/src/pages/about.astro

@@ -27,7 +27,6 @@ const author = authorConfig.name;
 <Stalux
     title={aboutPage.data.title + " | " + siteConfig.title}
     description={aboutPage.data.description}
-    fontSubsetId="about"
 >
     <div style="height: 3em;"></div>
     <Navs />

package/src/pages/archives.astro

@@ -12,7 +12,7 @@ const { t } = createTranslator(siteConfig.lang || "zh-CN");
 const posts = await getCollection("posts", ({ data }) => !data.draft);
 ---
 
-<Stalux title={t("archives.title") + " | " + siteConfig.title} description={t("archives.description", { title: siteConfig.title })} fontSubsetId={posts.length > 0 ? "archives" : undefined}>
+<Stalux title={t("archives.title") + " | " + siteConfig.title} description={t("archives.description", { title: siteConfig.title })}>
     <div style="height: 3em;"></div>
     <Navs />
     <h1 class={styles.h1}>{t("archives.heading")}</h1>

package/src/pages/categories/[category].astro

@@ -27,7 +27,6 @@ const props = Astro.props as Props;
 <Stalux
     title={t("taxonomy.category") + ": " + props.category + " | " + siteConfig.title}
     description={t("taxonomy.browseCategory", { title: siteConfig.title, category: props.category, count: props.count })}
-    fontSubsetId={props.posts.length > 0 ? `categories-${encodeURIComponent(props.category)}` : undefined}
 >
     <div style="height: 3em;"></div>
     <Navs />

package/src/pages/categories/index.astro

@@ -16,7 +16,6 @@ const hasContent = posts.length > 0;
 <Stalux
     title={t("categories.title") + " | " + siteConfig.title}
     description={t("categories.description", { title: siteConfig.title })}
-    fontSubsetId={hasContent ? "categories" : undefined}
 >
     <div style="height: 3em;"></div>
     <Navs />

package/src/pages/index.astro

@@ -17,7 +17,7 @@ import ToArchive from "@components/stalux/archives/toArchive.astro";
 import { getSiteData, getAuthorData, getHeadData, getNavsData, getLinksData, getCommentData, getFooterData, getPromoteData, getTypetextsData, getMediaLinksData } from "@utils/config-utils";
 ---
 
-<Stalux title={siteTitle} description={siteDescription} fontSubsetId="home">
+<Stalux title={siteTitle} description={siteDescription}>
   <div class={styles.homeBody}>
     <div class={styles.homeNavs}>
       <Navs />

package/src/pages/links.astro

@@ -14,11 +14,10 @@ const linksDescription = linksConfig.description;
 ---
 
 		<ListPage
-		    title={siteTitle}
-		    description={siteDescription}
-		    heading={linksTitle}
-		    subheading={linksDescription}
-		    fontSubsetId="links"
-		>
+			    title={siteTitle}
+			    description={siteDescription}
+			    heading={linksTitle}
+			    subheading={linksDescription}
+			>
     <LinkList />
 </ListPage>

package/src/pages/posts/[post].astro

@@ -68,7 +68,6 @@ export async function getStaticPaths() {
     tags={props.post.data.tags}
     categories={props.post.data.categories}
     author={authorConfig.name}
-    fontSubsetId={`posts-${props.post.data.abbrlink}`}
 >
     <div style="height:3em"></div>
     <Navs /><div style="height:3em"></div>

package/src/pages/tags/[tag].astro

@@ -29,7 +29,6 @@ const props = Astro.props as Props;
     title={t("taxonomy.tag") + ": " + props.tag + " | " + siteConfig.title}
     description={t("taxonomy.browseTag", { title: siteConfig.title, tag: props.tag, count: props.count })}
     noindex={props.count < 3}
-    fontSubsetId={props.posts.length > 0 ? `tags-${encodeURIComponent(props.tag)}` : undefined}
 >
     <div style="height: 3em;"></div>
     <Navs />

package/src/pages/tags/index.astro

@@ -16,7 +16,6 @@ const hasContent = posts.length > 0;
 <Stalux
     title={t("tags.title") + " | " + siteConfig.title}
     description={t("tags.description", { title: siteConfig.title })}
-    fontSubsetId={hasContent ? "tags" : undefined}
 >
     <div style="height: 3em;"></div>
     <Navs />

package/src/pages/words.astro

@@ -13,7 +13,7 @@ const { t } = createTranslator(siteConfig.lang || "zh-CN");
 const entries = await getCollection("words", ({ data }) => !data.draft);
 ---
 
-<Stalux title={t("words.title") + " | " + siteConfig.title} description={t("words.description")} fontSubsetId="words">
+<Stalux title={t("words.title") + " | " + siteConfig.title} description={t("words.description")}>
     <div style="height: 3em;"></div>
     <Navs />
     <h1 class={styles.title}>{t("words.heading")}</h1>

package/src/styles/base/init.css

@@ -221,7 +221,7 @@ ul {
     --border-color-light: #e5e5e5;
 
     /* 字体族栈 */
-    /* --font-body 由 Astro Fonts API 生成（见 astro.config.mjs fonts 配置） */
+    /* --font-body 由 Astro Fonts API 提供（--font-code 同理，见集成注入的 fonts 配置） */
     --font-body-serif: "Noto Serif CJK SC", "Source Han Serif SC", "STSong", Georgia, serif;
 
     /* 字体大小系统 */