@xingwangzhe/stalux 1.2.0

package/src/i18n/zh-CN.json

@@ -0,0 +1,193 @@
+{
+    "nav": {
+        "menu": "打开导航菜单",
+        "scrollLeft": "向左滚动导航",
+        "scrollRight": "向右滚动导航",
+        "search": "搜索"
+    },
+    "search": {
+        "title": "搜索",
+        "close": "关闭搜索",
+        "placeholder": "输入关键词搜索...",
+        "inputLabel": "搜索输入",
+        "noResults": "未找到相关结果",
+        "typePost": "文章",
+        "typeAbout": "关于",
+        "typeWord": "一言"
+    },
+    "page404": {
+        "title": "404 - 页面未找到",
+        "description": "抱歉，您访问的页面不存在。",
+        "pageNotFound": "页面未找到",
+        "countdown": "{n} 秒后自动返回首页",
+        "backHome": "返回首页"
+    },
+    "post": {
+        "publishTime": "发布时间：",
+        "updateTime": "更新时间：",
+        "readingTime": "🕒 阅读时间：",
+        "wordCount": "📝 字数：",
+        "viewCount": "👀 阅读量：",
+        "prevPost": "上一篇",
+        "nextPost": "下一篇",
+        "noPrev": "没有更早的文章",
+        "noNext": "没有更新的文章",
+        "author": "作者：",
+        "articleLink": "本文链接：",
+        "licensedUnder": "本文采用",
+        "licenseSuffix": "进行许可。",
+        "viewSource": "查看 Markdown 原文"
+    },
+    "taxonomy": {
+        "tag": "标签",
+        "category": "分类",
+        "toc": "目录",
+        "noTags": "暂无标签",
+        "noCategories": "暂无分类",
+        "noToc": "暂无目录",
+        "backToList": "返回{type}列表",
+        "foundPosts": "共找到 {count} 篇相关文章",
+        "browseTag": "欢迎访问{title}中“{tag}”标签页面，共有{count}篇相关文章，涵盖该标签下的技术教程与编程实践内容，帮助你深入了解相关主题与技术领域",
+        "browseCategory": "欢迎访问{title}中“{category}”分类页面，这里汇集了{count}篇相关文章，涵盖该主题下的技术教程、编程笔记与开发实践等原创内容，帮助你深入了解这一领域"
+    },
+    "archives": {
+        "title": "文章归档",
+        "description": "欢迎访问{title}文章归档页面，按发布时间顺序整理了博客所有原创文章，涵盖技术教程、编程开发、Linux运维、开源项目等各个类别的历史内容，方便按时间线回顾与查阅",
+        "heading": "文章归档",
+        "desc": "时间轴上的所有文章（共 {n} 篇）",
+        "postCount": "{n} 篇文章",
+        "month": "{n}月",
+        "noPosts": "暂无文章",
+        "loadMore": "加载更多内容",
+        "allLoaded": "已加载全部内容",
+        "viewAll": "查看所有文章"
+    },
+    "footer": {
+        "visitors": "本站访客数：",
+        "visits": "人次",
+        "totalVisits": "本站总访问量：",
+        "times": "次",
+        "totalWords": "本站总字数：",
+        "chars": "字",
+        "runningTime": "本站已正常运行",
+        "runtimeFormat": "{days}天{hours}时{minutes}分{seconds}秒",
+        "rightsReserved": "保留权利.",
+        "securityIcon": "公安备案图标"
+    },
+    "comment": {
+        "title": "留言评论",
+        "disclaimer": "评论区内容由用户生成，不代表网站观点"
+    },
+    "randomPost": {
+        "title": "随机文章",
+        "refresh": "刷新随机文章",
+        "loading": "正在加载随机文章...",
+        "noPosts": "暂无文章",
+        "loadFailed": "加载失败，请重试",
+        "loadError": "加载失败"
+    },
+    "categories": {
+        "title": "文章分类",
+        "description": "浏览{title}所有文章分类，涵盖日常开发中积累的技术教程、编程笔记、开源项目与Linux运维等内容，按主题分类整理帮你快速定位感兴趣的技术文章与学习笔记",
+        "heading": "文章分类",
+        "browseByTopic": "按主题分类浏览",
+        "postCount": "{n} 篇文章"
+    },
+    "tags": {
+        "title": "标签云",
+        "description": "探索{title}全部标签云，通过关键词索引快速找到技术教程、编程开发、Linux运维、开源项目、AI人工智能等各个领域的精彩文章与实用教程资源，发现更多你感兴趣的内容",
+        "heading": "标签云",
+        "explore": "探索不同主题的文章标签",
+        "noTags": "暂无标签"
+    },
+    "words": {
+        "title": "一言",
+        "description": "收集的语录与短句",
+        "heading": "一言",
+        "desc": "只言片语，皆为心声（共 {n} 条）"
+    },
+    "links": {
+        "defaultTitle": "友链",
+        "iconAlt": "{name} 图标"
+    },
+    "rss": {
+        "copyright": "除非另有说明，各文章采用其自身标注的 Creative Commons 许可证"
+    },
+    "common": {
+        "uncategorized": "未分类",
+        "minute": "{n} 分钟",
+        "lessThanOneMinute": "小于 1 分钟",
+        "tenThousand": "{n}万",
+        "k": "{n}k",
+        "dateFormat": "yyyy年MM月dd日"
+    },
+    "cc": {
+        "format": "知识共享{elements} {version} 国际许可协议",
+        "zero": "CC0 1.0 通用",
+        "BY": "署名",
+        "NC": "非商业性使用",
+        "SA": "相同方式共享",
+        "ND": "禁止演绎"
+    },
+    "console": {
+        "name": "Stalux - 现代 Astro 博客主题 [简称:星博客]",
+        "author": "王兴家 (xingwangzhe)",
+        "copyright": "© 王兴家. All rights reserved.",
+        "certNumber": "软著登字第16914672号",
+        "certUrl": "https://stalux.needhelp.icu/软著证明.pdf",
+        "regDate": "2025年11月24日",
+        "labelVersion": "📦 版本：",
+        "labelAuthor": "👤 著作权人：",
+        "labelRepo": "🔗 仓库：",
+        "labelWebsite": "🌐 官网：",
+        "labelCert": "📜 软著证书：",
+        "labelCertNumber": "🎫 登记号：",
+        "labelRegDate": "📅 登记日期：",
+        "labelLicense": "⚖️  开源协议：",
+        "labelAuthNote": "✅ 授权说明：",
+        "labelTip": "💡 提示：",
+        "labelFeedback": "🐛 问题反馈：",
+        "authNote": "本软件遵循 MIT 开源协议。您可以自由地使用、修改和分发本软件，但请保留原始版权声明。",
+        "tip": "如果你喜欢这个主题，欢迎在 GitHub 上点个 ⭐️ 支持我们！",
+        "feedback": "https://github.com/xingwangzhe/stalux/issues"
+    },
+    "ai": {
+        "contact": "联系",
+        "author": "作者",
+        "email": "邮箱",
+        "socialMedia": "社交媒体",
+        "noContact": "暂无公开联系方式",
+        "posts": "文章",
+        "noPosts": "暂无文章",
+        "untitled": "无标题",
+        "pages": "页面",
+        "about": "关于",
+        "aboutDesc": "关于作者",
+        "archives": "归档",
+        "archivesDesc": "全部文章归档",
+        "tags": "标签",
+        "tagsDesc": "标签索引",
+        "categories": "分类",
+        "categoriesDesc": "分类索引",
+        "words": "语录",
+        "wordsDesc": "语录与片段",
+        "links": "友情链接",
+        "aiDiscoveryFiles": "AI 发现文件",
+        "llmsTxtDesc": "站点摘要与文章索引",
+        "llmsFullTxtDesc": "全部文章 Markdown 全文数据集",
+        "optional": "可选",
+        "morePosts": "查看更多文章",
+        "rss": "RSS Feed",
+        "atom": "Atom Feed",
+        "mdAvailable": "每篇文章均提供 Markdown 源码，链接已指向 .md 版本",
+        "siteLicense": "除非另有说明，本站内容采用 CC-BY-NC-SA-4.0 协议。",
+        "fullDataset": "LLM 全文数据集",
+        "fullDatasetDesc": "本站全部公开文章的 Markdown 全文集合，供大语言模型训练与引用使用。",
+        "license": "内容许可证",
+        "postCount": "文章数量",
+        "markdownSources": "Markdown 源文件",
+        "latestPosts": "最新文章",
+        "allCategories": "全部分类",
+        "allTags": "全部标签"
+    }
+}

package/src/index.ts

@@ -0,0 +1,215 @@
+/**
+ * Stalux — Astro 博客主题集成入口
+ *
+ * 可作为：
+ * 1. Astro Integration（插件模式）：`integrations: [stalux()]`
+ * 2. 源码模板（Template 模式）：额外提供 create-stalux CLI 脚手架
+ *
+ * 基于 Astro 7.1.3 Integration API（astro:config:setup / injectRoute / injectScript）
+ */
+
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+import type { AstroIntegration } from "astro";
+import type { StaluxOptions } from "./config";
+import { staluxComponentsAlias } from "./internal/components-plugin";
+
+// pagefind 是 ESM-only 包，需要在模块顶层导入
+// 因为 astro:build:done 钩子中 Vite module runner 已关闭，无法动态 import
+import { createIndex as pagefindCreateIndex } from "pagefind";
+
+// ---------------------------------------------------------------------------
+// 页面条目定义
+// ---------------------------------------------------------------------------
+
+interface RouteEntry {
+  pattern: string;
+  entrypoint: string;
+  prerender?: boolean;
+}
+
+/**
+ * 获取所有需要注入的路由列表
+ */
+function getRoutes(baseDir: URL): RouteEntry[] {
+  const resolvePage = (relPath: string): string =>
+    fileURLToPath(new URL(relPath, baseDir));
+
+  return [
+    // ---- 静态页面 ----
+    { pattern: "/", entrypoint: resolvePage("./pages/index.astro") },
+    { pattern: "/about/", entrypoint: resolvePage("./pages/about.astro") },
+    { pattern: "/archives/", entrypoint: resolvePage("./pages/archives.astro") },
+    { pattern: "/links/", entrypoint: resolvePage("./pages/links.astro") },
+    { pattern: "/words/", entrypoint: resolvePage("./pages/words.astro") },
+    { pattern: "/404", entrypoint: resolvePage("./pages/404.astro") },
+
+    // ---- 动态页面 ----
+    { pattern: "/posts/[post]", entrypoint: resolvePage("./pages/posts/[post].astro") },
+    { pattern: "/tags/", entrypoint: resolvePage("./pages/tags/index.astro") },
+    { pattern: "/tags/[tag]", entrypoint: resolvePage("./pages/tags/[tag].astro") },
+    { pattern: "/categories/", entrypoint: resolvePage("./pages/categories/index.astro") },
+    { pattern: "/categories/[category]", entrypoint: resolvePage("./pages/categories/[category].astro") },
+
+    // ---- API 端点 ----
+    { pattern: "/rss.xml", entrypoint: resolvePage("./pages/rss.xml.ts") },
+    { pattern: "/atom.xml", entrypoint: resolvePage("./pages/atom.xml.ts") },
+    { pattern: "/llms.txt", entrypoint: resolvePage("./pages/llms.txt.ts") },
+    { pattern: "/llms-full.txt", entrypoint: resolvePage("./pages/llms-full.txt.ts") },
+    { pattern: "/api/post.abbrlink.json", entrypoint: resolvePage("./pages/api/post.abbrlink.json.ts") },
+
+    // ---- Markdown 导出端点 ----
+    { pattern: "/index.md", entrypoint: resolvePage("./pages/index.md.ts") },
+    { pattern: "/about.md", entrypoint: resolvePage("./pages/about.md.ts") },
+    { pattern: "/archives.md", entrypoint: resolvePage("./pages/archives.md.ts") },
+    { pattern: "/links.md", entrypoint: resolvePage("./pages/links.md.ts") },
+    { pattern: "/words.md", entrypoint: resolvePage("./pages/words.md.ts") },
+    { pattern: "/tags/index.md", entrypoint: resolvePage("./pages/tags/index.md.ts") },
+    { pattern: "/tags/[tag].md", entrypoint: resolvePage("./pages/tags/[tag].md.ts") },
+    { pattern: "/categories/index.md", entrypoint: resolvePage("./pages/categories/index.md.ts") },
+    { pattern: "/categories/[category].md", entrypoint: resolvePage("./pages/categories/[category].md.ts") },
+    { pattern: "/posts/[post].md", entrypoint: resolvePage("./pages/posts/[post].md.ts") },
+  ];
+}
+
+// ---------------------------------------------------------------------------
+// Vite 别名配置（供页面使用 @components etc.）
+// ---------------------------------------------------------------------------
+
+function getViteAliases(srcDir: string) {
+  return {
+    "@components": path.resolve(srcDir, "components"),
+    "@assets": path.resolve(srcDir, "assets"),
+    "@layouts": path.resolve(srcDir, "layouts"),
+    "@scripts": path.resolve(srcDir, "scripts"),
+    "@styles": path.resolve(srcDir, "styles"),
+    "@utils": path.resolve(srcDir, "utils"),
+    "@i18n": path.resolve(srcDir, "i18n"),
+    "@plugins": path.resolve(srcDir, "plugins"),
+    "@schemas": path.resolve(srcDir, "schemas"),
+  };
+}
+
+// ---------------------------------------------------------------------------
+// 集成入口
+// ---------------------------------------------------------------------------
+
+/**
+ * Stalux 博客主题集成
+ *
+ * @example
+ * ```ts
+ * // astro.config.mjs
+ * import { defineConfig } from "astro/config";
+ * import stalux from "stalux";
+ *
+ * export default defineConfig({
+ *   integrations: [stalux({ contentDir: "./content" })]
+ * });
+ * ```
+ */
+export function stalux(options: StaluxOptions = {}): AstroIntegration {
+  const opt: StaluxOptions = {
+    contentDir: options.contentDir ?? "stalux",
+    pagefind: options.pagefind ?? true,
+    devToolbar: options.devToolbar ?? true,
+    ...options,
+  };
+
+  // 探测是否为插件模式（通过 npm 安装）vs 源码开发模式
+  // 安装在 node_modules 中时，页面的文件路由不可用，需要通过 injectRoute 注入
+  const isPluginMode = import.meta.url.includes("node_modules");
+
+  return {
+    name: "stalux",
+    hooks: {
+      "astro:config:setup": ({
+        injectRoute,
+        injectScript,
+        updateConfig,
+        addDevToolbarApp,
+        config,
+        logger,
+      }) => {
+        const srcDir = fileURLToPath(new URL(".", import.meta.url));
+
+        // 1. 注入 Vite 别名 + 组件覆盖插件 + Vue 特性标记（Waline 依赖）
+        updateConfig({
+          vite: {
+            resolve: {
+              alias: getViteAliases(srcDir),
+            },
+            plugins: [
+              staluxComponentsAlias(opt.components),
+            ],
+            define: {
+              __VUE_OPTIONS_API__: true,
+              __VUE_PROD_DEVTOOLS__: false,
+              __VUE_PROD_HYDRATION_MISMATCH_DETAILS__: false,
+            },
+          },
+        });
+
+        // 2. 注入全局 CSS
+        injectScript("page-ssr", `import "${srcDir}/styles/base/init.css";`);
+
+        // 3. 注入所有页面路由（仅插件模式，源码模式下使用文件路由）
+        if (isPluginMode) {
+          const routes = getRoutes(new URL(".", import.meta.url));
+          for (const route of routes) {
+            injectRoute(route);
+          }
+          logger.debug(`Stalux: injected ${routes.length} routes`);
+        } else {
+          logger.info("Stalux: running in source mode, file-based routing active");
+        }
+
+        // 4. 可选：添加 Dev Toolbar 应用
+        if (opt.devToolbar) {
+          addDevToolbarApp({
+            id: "stalux",
+            name: "Stalux",
+            icon: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 2L2 7l10 5 10-5-10-5z"/><path d="M2 17l10 5 10-5"/><path d="M2 12l10 5 10-5"/></svg>',
+            entrypoint: fileURLToPath(new URL("./internal/dev-toolbar.ts", import.meta.url)),
+          });
+        }
+
+        logger.info(`Stalux initialized (contentDir: ${opt.contentDir})`);
+      },
+
+      "astro:build:done": async ({ dir, logger }) => {
+        // 5. 后处理：Pagefind 搜索索引
+        if (opt.pagefind) {
+          const outDir = fileURLToPath(dir);
+          logger.info("Running Pagefind indexer...");
+
+	          try {
+	            const { index, errors } = await pagefindCreateIndex();
+
+            if (!index) {
+              logger.error("Pagefind failed to create index");
+              errors?.forEach((e) => logger.error(e));
+              return;
+            }
+
+            const { page_count } = await index.addDirectory({ path: outDir });
+            if (page_count === 0) {
+              logger.warn("Pagefind: no pages indexed");
+              return;
+            }
+
+            const { outputPath } = await index.writeFiles({
+              outputPath: path.join(outDir, "pagefind"),
+            });
+
+            logger.info(`Pagefind indexed ${page_count} pages → ${outputPath}`);
+          } catch (error) {
+            logger.error(`Pagefind indexing failed: ${String(error)}`);
+          }
+        }
+      },
+    },
+  };
+}
+
+export default stalux;

package/src/internal/components-plugin.ts

@@ -0,0 +1,54 @@
+/**
+ * 组件覆盖解析 Vite 插件
+ *
+ * 提供 Vite 别名 `@stalux/component/*`，实现可覆盖的组件导入。
+ *
+ * 页面中使用：
+ * ```astro
+ * import Navs from "@stalux/component/Navs";
+ * ```
+ *
+ * 用户在集成选项中覆盖：
+ * ```ts
+ * stalux({ components: { Navs: "./src/CustomNavs.astro" } })
+ * ```
+ *
+ * 插件自动将别名解析为用户提供的路径或包内默认路径。
+ */
+
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import type { Plugin } from "vite";
+import type { ComponentOverrideMap } from "../config";
+import { resolveComponentPath, type StaluxComponentKey } from "./override";
+
+const VIRTUAL_PREFIX = "@stalux/component/";
+
+/**
+ * 创建 Vite 别名插件，处理 `@stalux/component/*` → 实际组件路径
+ */
+export function staluxComponentsAlias(
+  overrides: ComponentOverrideMap = {},
+): Plugin {
+  // 包内 components 目录的绝对路径
+  const componentsDir = fileURLToPath(new URL("../components", import.meta.url));
+
+  return {
+    name: "stalux:components-alias",
+    resolveId(id: string, importer: string | undefined) {
+      if (!id.startsWith(VIRTUAL_PREFIX)) return null;
+
+      const componentName = id.slice(VIRTUAL_PREFIX.length) as StaluxComponentKey;
+
+      // 使用 resolveComponentPath 获取实际路径
+      const resolvedPath = resolveComponentPath(componentName, overrides, componentsDir);
+
+      // 如果是用户提供的相对路径，相对于项目根解析
+      if (overrides[componentName]) {
+        return this.resolve(resolvedPath, importer, { skipSelf: true });
+      }
+
+      return resolvedPath;
+    },
+  } satisfies Plugin;
+}

package/src/internal/dev-toolbar.ts

@@ -0,0 +1,33 @@
+/**
+ * Stalux Dev Toolbar 应用
+ *
+ * 在 Astro 开发工具栏中添加 Stalux 主题的便捷操作。
+ * 使用 Astro Dev Toolbar App API（astro@4.0.0+）。
+ */
+
+export default {
+  id: "stalux",
+  name: "Stalux",
+  icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 2L2 7l10 5 10-5-10-5z"/><path d="M2 17l10 5 10-5"/><path d="M2 12l10 5 10-5"/></svg>',
+
+  init(canvas: HTMLElement) {
+    const container = document.createElement("div");
+    container.innerHTML = `
+      <style>
+        .stalux-toolbar { padding: 16px; font-family: system-ui, sans-serif; }
+        .stalux-toolbar h3 { margin: 0 0 8px; font-size: 14px; font-weight: 600; }
+        .stalux-toolbar p { margin: 4px 0; font-size: 12px; color: #888; }
+        .stalux-toolbar a { color: #60a5fa; text-decoration: none; }
+        .stalux-toolbar a:hover { text-decoration: underline; }
+        .stalux-toolbar .version { font-size: 11px; color: #666; }
+      </style>
+      <div class="stalux-toolbar">
+        <h3>✨ Stalux Theme</h3>
+        <p class="version">v2.0.0</p>
+        <p><a href="https://stalux.needhelp.icu" target="_blank">📖 Documentation</a></p>
+        <p><a href="https://github.com/xingwangzhe/stalux" target="_blank">🐙 GitHub</a></p>
+      </div>
+    `;
+    canvas.appendChild(container);
+  },
+};

package/src/internal/override.ts

@@ -0,0 +1,99 @@
+/**
+ * 组件覆盖解析系统
+ *
+ * 借鉴 Starlight 的 components override 模式，
+ * 允许用户通过集成选项自定义任意主题组件。
+ *
+ * 所有默认路径相对于包内的 src/components/stalux/ 目录。
+ */
+
+import type { ComponentOverrideMap } from "../config";
+
+// ---------------------------------------------------------------------------
+// 可覆盖组件清单（相对于包内 src/ 目录）
+// ---------------------------------------------------------------------------
+
+export const STALUX_COMPONENTS = {
+  // Layout
+  Head: "layouts/head.astro",
+  Footer: "layouts/footer.astro",
+  Navs: "layouts/navs.astro",
+  ListPage: "layouts/listPage.astro",
+
+  // Common
+  Author: "common/author.astro",
+  Date: "common/date.astro",
+  Search: "common/search.astro",
+  TextType: "common/textType.astro",
+  VerCount: "common/verCount.astro",
+
+  // Home
+  SocialMedia: "links/socialMedia.astro",
+  ToArchive: "archives/toArchive.astro",
+
+  // Posts
+  PostLeft: "posts/postLeft.astro",
+  PostContent: "posts/postContent.astro",
+  PostRight: "posts/postRight.astro",
+  PostNavigation: "posts/postNavigation.astro",
+  PostCC: "posts/postCC.astro",
+  WalineComment: "posts/WalineComment.astro",
+  PostToc: "posts/postToc.astro",
+  PostAuthor: "posts/postAuthor.astro",
+  PostCard: "posts/postCard.astro",
+  PostList: "posts/postList.astro",
+  PostTaxonomy: "posts/PostTaxonomy.astro",
+  PhotoSwipeStyle: "posts/PhotoSwipeStyle.astro",
+  RandomPost: "posts/randomPost.astro",
+
+  // Archives
+  ArchivesList: "archives/archivesList.astro",
+
+  // Categories
+  CategoriesCard: "categories/categoriesCard.astro",
+  CategoriesList: "categories/categoriesList.astro",
+
+  // Tags
+  TagHeader: "tags/tagHeader.astro",
+  TagsCloud: "tags/tagsCloud.astro",
+
+  // Words
+  WordCard: "words/wordCard.astro",
+  WordList: "words/wordList.astro",
+
+  // Links
+  LinkCard: "links/linkCard.astro",
+  LinkList: "links/linkList.astro",
+
+  // Footer
+  FooterBadges: "footer/FooterBadges.astro",
+  FooterBeian: "footer/FooterBeian.astro",
+  FooterCopyright: "footer/FooterCopyright.astro",
+  FooterStats: "footer/FooterStats.astro",
+  FooterThemeInfo: "footer/FooterThemeInfo.astro",
+
+  // Analytics
+  Clarity: "analytics/clarity.astro",
+  Google: "analytics/google.astro",
+  Umami: "analytics/umami.astro",
+} as const;
+
+/** 组件键名联合类型 */
+export type StaluxComponentKey = keyof typeof STALUX_COMPONENTS;
+
+/**
+ * 获取组件的完整包内路径
+ *
+ * @param key 组件键名
+ * @param overrides 用户覆盖映射
+ * @param componentsDir 包内 components 目录的绝对路径
+ * @returns 组件的绝对路径
+ */
+export function resolveComponentPath(
+  key: StaluxComponentKey,
+  overrides: ComponentOverrideMap = {},
+  componentsDir: string,
+): string {
+  if (overrides[key]) return overrides[key]!;
+  return componentsDir + "/stalux/" + STALUX_COMPONENTS[key];
+}

package/src/internal/pagefind.ts

@@ -0,0 +1,40 @@
+/**
+ * Pagefind 搜索索引生成器
+ *
+ * 从原 src/integrations/pagefind.ts 迁移而来，
+ * 变为集成的一个内部模块，在构建完成时自动运行。
+ */
+
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import type { AstroIntegrationLogger } from "astro";
+
+export async function pagefind(dir: URL, logger: AstroIntegrationLogger): Promise<void> {
+  const outDir = fileURLToPath(dir);
+  logger.info("Running Pagefind indexer...");
+
+  try {
+    const { createIndex } = await import("pagefind");
+    const { index, errors } = await createIndex();
+
+    if (!index) {
+      logger.error("Pagefind failed to create index");
+      errors?.forEach((e) => logger.error(e));
+      return;
+    }
+
+    const { page_count } = await index.addDirectory({ path: outDir });
+    if (page_count === 0) {
+      logger.warn("Pagefind: no pages indexed");
+      return;
+    }
+
+    const { outputPath } = await index.writeFiles({
+      outputPath: path.join(outDir, "pagefind"),
+    });
+
+    logger.info(`Pagefind indexed ${page_count} pages → ${outputPath}`);
+  } catch (error) {
+    logger.error(`Pagefind indexing failed: ${error}`);
+  }
+}