@xingwangzhe/stalux 1.7.8 → 1.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@xingwangzhe/stalux",
-    "version": "1.7.8",
+    "version": "1.8.0",
     "description": "A powerful, modern Astro blog theme — use as template or install as plugin",
     "keywords": [
         "astro",

package/src/components/stalux/posts/postContent.astro

@@ -59,9 +59,9 @@ const mdSourceUrl = exportMd
                 )
             }
         </div>
-        {
-            <div class={style.pageStats}>
-                    {(props.readingTime || props.readingMinutes) && (
+            {
+                <div class={style.pageStats}>
+                    {(Boolean(props.readingTime) || (props.readingMinutes ?? 0) > 0) && (
                         <span class={style.readingTime}>
                             {t("post.readingTime")}{props.readingMinutes && props.readingMinutes > 0
                                 ? (props.readingMinutes < 1
@@ -70,7 +70,7 @@ const mdSourceUrl = exportMd
                                 : props.readingTime}
                         </span>
                     )}
-                    {props.wordCount && props.wordCount > 0 && (
+                    {(props.wordCount ?? 0) > 0 && (
                         <span class={style.wordCount}>
                             {t("post.wordCount")}{props.wordCount}
                         </span>

package/src/i18n/en.json

@@ -136,7 +136,7 @@
         "author": "xingwangzhe",
         "copyright": "© xingwangzhe. All rights reserved.",
         "certNumber": "Software Copyright No. 16914672",
-        "certUrl": "https://stalux.needhelp.icu/软著证明.pdf",
+        "certUrl": "/软著证明.pdf",
         "regDate": "2025-11-24",
         "labelVersion": "📦 Version: ",
         "labelAuthor": "👤 Author: ",

package/src/i18n/zh-CN.json

@@ -136,7 +136,7 @@
         "author": "王兴家 (xingwangzhe)",
         "copyright": "© 王兴家. All rights reserved.",
         "certNumber": "软著登字第16914672号",
-        "certUrl": "https://stalux.needhelp.icu/软著证明.pdf",
+        "certUrl": "/软著证明.pdf",
         "regDate": "2025年11月24日",
         "labelVersion": "📦 版本：",
         "labelAuthor": "👤 著作权人：",

package/src/index.ts

@@ -8,7 +8,7 @@
  * 基于 Astro 7.1.3 Integration API（astro:config:setup / injectRoute / injectScript）
  */
 
-import { existsSync, readdirSync } from "node:fs";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -21,6 +21,8 @@ import { createIndex as pagefindCreateIndex } from "pagefind";
 import type { StaluxOptions } from "./config";
 import { staluxComponentsAlias } from "./internal/components-plugin";
 import { runFontSubsetting } from "./internal/font-subset";
+import { featureFlagsHast, featureFlagsMdast } from "./plugins/feature-flags";
+import { temml } from "./plugins/satteri-temml";
 
 // ---------------------------------------------------------------------------
 // 页面条目定义
@@ -143,7 +145,7 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration {
                 injectScript,
                 updateConfig,
                 addDevToolbarApp,
-                _config,
+                config,
                 logger,
             }) => {
                 const srcDir = fileURLToPath(new URL(".", import.meta.url));
@@ -191,7 +193,81 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration {
 
                 logger.info(`Stalux initialized (contentDir: ${opt.contentDir})`);
 
-                // 5. 字体裁剪（在 config:setup 阶段执行，保证 dev/build 都能生成）
+                // 5. 注入 satteri 插件（字数统计/特性标记/数学公式），按插件 name 去重
+                // 源码模式下 astro.config 会显式注册同款插件，插件模式则由集成补齐，
+                // 保证两种模式行为一致（wordCount/readingMinutes/hasImage 由构建期插件写入）。
+                // 去重是必须的：重复注册 featureFlagsMdast 会导致字数统计翻倍。
+                try {
+                    const processor = (config.markdown?.processor ?? undefined) as
+                        | { name?: string; options?: { mdastPlugins?: any[]; hastPlugins?: any[] } }
+                        | undefined;
+                    if (processor?.name === "satteri") {
+                        const mdastPlugins = processor.options?.mdastPlugins ?? [];
+                        const hastPlugins = processor.options?.hastPlugins ?? [];
+                        const seen = new Set<string>();
+                        for (const p of [...mdastPlugins, ...hastPlugins]) {
+                            if (p?.name) seen.add(p.name);
+                        }
+                        const pushUnique = (list: any[], plugin: any) => {
+                            if (plugin?.name) {
+                                if (seen.has(plugin.name)) return;
+                                seen.add(plugin.name);
+                            }
+                            list.push(plugin);
+                        };
+                        pushUnique(mdastPlugins, temml());
+                        pushUnique(mdastPlugins, featureFlagsMdast);
+                        pushUnique(hastPlugins, featureFlagsHast);
+                        logger.debug("Stalux: injected satteri plugins (temml/feature-flags)");
+                    } else {
+                        logger.warn(
+                            "Stalux: markdown.processor 不是 satteri，无法注入字数统计/数学公式插件。" +
+                                "请在 astro.config 中配置 `processor: satteri({...})`。",
+                        );
+                    }
+                } catch (error) {
+                    logger.warn(`Stalux: 注入 markdown 插件失败: ${String(error)}`);
+                }
+
+                // 6. 站点 URL 单源化：以 stalux/config/site.yml 的 url 为准
+                // sitemap 与 context.site 都派生自 astro.config 的 site 字段，
+                // 这里在构建前将其与主题配置对齐，避免输出与配置不一致的 URL
+                // （例如 README 里的 https://example.com 占位、或用户只改了 site.yml 忘了改 astro.config）。
+                try {
+                    const contentDir = opt.contentDir ?? "stalux";
+                    const siteYamlPath = path.resolve(
+                        process.cwd(),
+                        contentDir,
+                        "config",
+                        "site.yml",
+                    );
+                    const siteYaml = readFileSync(siteYamlPath, "utf-8");
+                    const urlMatch = siteYaml.match(/^url\s*:\s*(.+)$/m);
+                    const yamlUrl = urlMatch?.[1]
+                        .trim()
+                        .replace(/^["']|["']$/g, "")
+                        .replace(/\/+$/, "");
+                    if (yamlUrl) {
+                        const configuredSite = config.site?.replace(/\/+$/, "");
+                        if (!configuredSite || configuredSite === "https://example.com") {
+                            // 未配置或为占位符 → 直接以 site.yml 为准
+                            updateConfig({ site: yamlUrl });
+                            logger.info(
+                                `Stalux: site set to ${yamlUrl} (from ${contentDir}/config/site.yml)`,
+                            );
+                        } else if (configuredSite !== yamlUrl) {
+                            // 用户显式配置了不同的域名 → 保留用户配置，但提示差异
+                            logger.warn(
+                                `Stalux: astro.config site (${configuredSite}) 与 ${contentDir}/config/site.yml 的 url (${yamlUrl}) 不一致。` +
+                                    "sitemap 将使用 astro.config 的 site，llms.txt / *.md 导出将使用 site.yml 的 url，请统一二者。",
+                            );
+                        }
+                    }
+                } catch {
+                    logger.debug("Stalux: site.yml not found, skip site sync");
+                }
+
+                // 7. 字体裁剪（在 config:setup 阶段执行，保证 dev/build 都能生成）
                 try {
                     const projectRoot = process.cwd();
                     await runFontSubsetting(projectRoot, logger, true);
@@ -201,7 +277,7 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration {
             },
 
             "astro:build:start": async ({ logger }) => {
-                // 6. 字体裁剪（构建时，生成全部路由子集）
+                // 8. 字体裁剪（构建时，生成全部路由子集）
                 try {
                     const projectRoot = process.cwd();
                     await runFontSubsetting(projectRoot, logger);
@@ -211,7 +287,7 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration {
             },
 
             "astro:server:setup": async ({ server, logger }) => {
-                // 7. 字体裁剪（开发模式，生成 common 子集 + 按需路由切片）
+                // 9. 字体裁剪（开发模式，生成 common 子集 + 按需路由切片）
                 try {
                     const projectRoot = process.cwd();
                     // 清除旧的字体缓存

package/src/utils/ai-discovery.ts

@@ -49,10 +49,16 @@ function getSiteConfig(config: ConfigMap): Record<string, unknown> {
     return config.get("site") ?? {};
 }
 
-/** 解析站点根 URL */
+/**
+ * 解析站点根 URL。
+ *
+ * 唯一真源是 stalux/config/site.yml 的 url；context.site（astro.config.mjs 的 site）
+ * 仅作为 site.yml 缺失时的兜底，避免 llms.txt / *.md 导出与 sitemap / canonical 输出不一致。
+ */
 export function getSite(config: ConfigMap, contextSite?: string): string {
     const siteData = getSiteConfig(config);
-    return (contextSite || (siteData.url as string) || "").replace(/\/$/, "");
+    const configUrl = siteData.url as string | undefined;
+    return (configUrl || contextSite || "").replace(/\/$/, "");
 }
 
 /** 将任意空白压缩为单行 */