create-lumfall 1.0.1 → 1.1.1

package/templates/document/app/pages/docs/styles/vars.less

@@ -1,87 +0,0 @@
-// 文档站设计变量：所有颜色走 CSS 变量，暗色模式通过 body[arco-theme="dark"]
-// 覆盖变量实现（Arco 组件的暗色也由同一属性驱动，两边自动同步）。
-
-:root {
-  // 基础色板
-  --doc-bg: #ffffff;
-  --doc-bg-soft: #f7f8fa;
-  --doc-navbar-bg: rgba(255, 255, 255, 0.86);
-  --doc-sidebar-bg: #ffffff;
-  --doc-text-1: #1d2129;
-  --doc-text-2: #4e5969;
-  --doc-text-3: #86909c;
-  --doc-border: #e5e6eb;
-  --doc-brand: #165dff;
-  --doc-brand-soft: rgba(22, 93, 255, 0.08);
-  --doc-mark-bg: rgba(22, 93, 255, 0.16);
-
-  // 代码块
-  --doc-code-bg: #f7f8fa;
-  --doc-code-bar-bg: #f0f1f3;
-  --doc-code-border: #e5e6eb;
-  --doc-code-text: #24292f;
-  --doc-inline-code-bg: rgba(22, 93, 255, 0.06);
-  --doc-inline-code-text: #165dff;
-
-  // highlight.js 语法高亮（亮色：接近 GitHub Light）
-  --doc-hl-keyword: #cf222e;
-  --doc-hl-built-in: #0550ae;
-  --doc-hl-type: #953800;
-  --doc-hl-literal: #0550ae;
-  --doc-hl-number: #0550ae;
-  --doc-hl-string: #0a3069;
-  --doc-hl-comment: #6e7781;
-  --doc-hl-function: #8250df;
-  --doc-hl-tag: #116329;
-  --doc-hl-attr: #0550ae;
-  --doc-hl-variable: #953800;
-  --doc-hl-meta: #6e7781;
-  --doc-hl-section: #0550ae;
-  --doc-hl-selector: #6639ba;
-  --doc-hl-addition-bg: #dafbe1;
-  --doc-hl-deletion-bg: #ffebe9;
-
-  // 阴影
-  --doc-shadow: 0 4px 10px rgba(0, 0, 0, 0.06);
-}
-
-body[arco-theme="dark"] {
-  --doc-bg: #0d0e10;
-  --doc-bg-soft: #17181a;
-  --doc-navbar-bg: rgba(23, 24, 26, 0.86);
-  --doc-sidebar-bg: #0d0e10;
-  --doc-text-1: #f2f3f5;
-  --doc-text-2: #c2c7cc;
-  --doc-text-3: #8a9099;
-  --doc-border: #333335;
-  --doc-brand: #3c7eff;
-  --doc-brand-soft: rgba(60, 126, 255, 0.16);
-  --doc-mark-bg: rgba(60, 126, 255, 0.32);
-
-  --doc-code-bg: #17181a;
-  --doc-code-bar-bg: #1f2022;
-  --doc-code-border: #333335;
-  --doc-code-text: #e6e8eb;
-  --doc-inline-code-bg: rgba(60, 126, 255, 0.14);
-  --doc-inline-code-text: #84a8ff;
-
-  // 暗色语法高亮（接近 GitHub Dark）
-  --doc-hl-keyword: #ff7b72;
-  --doc-hl-built-in: #79c0ff;
-  --doc-hl-type: #ffa657;
-  --doc-hl-literal: #79c0ff;
-  --doc-hl-number: #79c0ff;
-  --doc-hl-string: #a5d6ff;
-  --doc-hl-comment: #8b949e;
-  --doc-hl-function: #d2a8ff;
-  --doc-hl-tag: #7ee787;
-  --doc-hl-attr: #79c0ff;
-  --doc-hl-variable: #ffa657;
-  --doc-hl-meta: #8b949e;
-  --doc-hl-section: #79c0ff;
-  --doc-hl-selector: #d2a8ff;
-  --doc-hl-addition-bg: rgba(46, 160, 67, 0.28);
-  --doc-hl-deletion-bg: rgba(248, 81, 73, 0.24);
-
-  --doc-shadow: 0 4px 10px rgba(0, 0, 0, 0.4);
-}

package/templates/document/app/pages/docs/theme.js

@@ -1,47 +0,0 @@
-// 主题（亮 / 暗）管理。Arco Design 通过 body 上的 arco-theme 属性切换暗色，
-// 文档站自己的样式全部走 CSS 变量（见 styles/vars.less），跟随该属性变化。
-const STORAGE_KEY = "lumfall-docs-theme";
-
-function apply(mode) {
-  if (mode === "dark") {
-    document.body.setAttribute("arco-theme", "dark");
-  } else {
-    document.body.removeAttribute("arco-theme");
-  }
-}
-
-export function isDark() {
-  return document.body.getAttribute("arco-theme") === "dark";
-}
-
-/** 进站时调用：优先用户上次选择，否则跟随系统偏好 */
-export function initTheme() {
-  let saved = null;
-  try {
-    saved = localStorage.getItem(STORAGE_KEY);
-  } catch (e) {
-    // localStorage 不可用（如隐私模式）时只跟随系统
-  }
-  if (saved === "dark" || saved === "light") {
-    apply(saved);
-    return;
-  }
-  if (
-    window.matchMedia &&
-    window.matchMedia("(prefers-color-scheme: dark)").matches
-  ) {
-    apply("dark");
-  }
-}
-
-/** 切换主题并持久化，返回切换后的模式 */
-export function toggleTheme() {
-  const next = isDark() ? "light" : "dark";
-  apply(next);
-  try {
-    localStorage.setItem(STORAGE_KEY, next);
-  } catch (e) {
-    // 忽略持久化失败
-  }
-  return next;
-}

package/templates/document/app/pages/docs/utils.js

@@ -1,58 +0,0 @@
-/**
- * 标题 → url slug。保留中文等 unicode 字母数字，空格转 -，
- * 与 markdown 渲染器的标题 id 规则保持一致（搜索跳转锚点也用它）。
- */
-export function slugify(text) {
-  return String(text)
-    .trim()
-    .toLowerCase()
-    .replace(/[^\p{L}\p{N}\s-]/gu, "")
-    .replace(/\s+/g, "-");
-}
-
-/** "/view/docs/guide/intro" → "guide/intro" */
-export function pathOfDoc(viewPath) {
-  return String(viewPath || "")
-    .replace(/^\/view\/docs\/?/, "")
-    .replace(/\/+$/, "");
-}
-
-/**
- * 解析文档内相对链接（xxx.md / ./xxx.md / ../xxx.md，可带 #锚点）。
- * 返回 { path, hash }；不是 .md 链接时返回 null（外链、页内锚点走默认规则）。
- * @param {string} currentDocPath 当前文档路径，如 "guide/getting-started"
- * @param {string} href markdown 里的 href
- */
-export function resolveDocHref(currentDocPath, href) {
-  const [raw = "", hash = ""] = String(href).split("#");
-  if (!/\.md$/.test(raw)) {
-    return null;
-  }
-
-  const baseParts = String(currentDocPath).split("/").slice(0, -1);
-  raw
-    .replace(/^\.\//, "")
-    .split("/")
-    .forEach((seg) => {
-      if (seg === "..") {
-        baseParts.pop();
-      } else if (seg && seg !== ".") {
-        baseParts.push(seg);
-      }
-    });
-
-  const resolved = baseParts.join("/").replace(/\.md$/, "");
-  return {
-    path: `/view/docs/${resolved}`,
-    hash: hash ? `#${hash}` : "",
-  };
-}
-
-/** HTML 转义（搜索高亮等场景） */
-export function escapeHtml(text) {
-  return String(text)
-    .replace(/&/g, "&")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;")
-    .replace(/"/g, "&quot;");
-}

package/templates/document/app/pages/docs/views/doc-home.vue

@@ -1,56 +0,0 @@
-<template>
-  <DocLayout :sidebar="false">
-    <div class="doc-home">
-      <section class="doc-hero">
-        <h1 class="doc-hero-name">{{ hero.name }}</h1>
-        <p class="doc-hero-tagline">{{ hero.tagline }}</p>
-        <p class="doc-hero-text">{{ hero.text }}</p>
-        <div class="doc-hero-actions">
-          <template v-for="action in hero.actions" :key="action.text">
-            <router-link
-              v-if="action.path"
-              :to="action.path"
-              class="doc-hero-btn"
-              :class="action.theme || ''"
-            >
-              {{ action.text }}
-            </router-link>
-            <a
-              v-else
-              :href="action.link"
-              target="_blank"
-              rel="noopener noreferrer"
-              class="doc-hero-btn"
-              :class="action.theme || ''"
-            >
-              {{ action.text }}
-            </a>
-          </template>
-        </div>
-      </section>
-
-      <section class="doc-features">
-        <div v-for="feature in hero.features" :key="feature.title" class="doc-feature-card">
-          <div class="doc-feature-icon">{{ feature.icon }}</div>
-          <h3 class="doc-feature-title">{{ feature.title }}</h3>
-          <p class="doc-feature-details">{{ feature.details }}</p>
-        </div>
-      </section>
-
-      <footer v-if="footerText" class="doc-home-footer">{{ footerText }}</footer>
-    </div>
-  </DocLayout>
-</template>
-
-<script setup>
-import { computed } from "vue";
-import DocLayout from "../components/doc-layout.vue";
-import docsConfig from "../docs-config";
-
-const hero = docsConfig.hero;
-const footerText = computed(
-  () => docsConfig.footer.text || docsConfig.footer.copyright || ""
-);
-
-document.title = docsConfig.site.description;
-</script>

package/templates/document/app/pages/docs/views/doc-page.vue

@@ -1,147 +0,0 @@
-<template>
-  <DocLayout :sidebar="true">
-    <template v-if="source !== undefined">
-      <div class="doc-content-wrap">
-        <article class="doc-markdown" v-html="rendered.html"></article>
-
-        <div class="doc-pager">
-          <router-link v-if="prev" :to="prev.path" class="doc-pager-item prev">
-            <span class="doc-pager-label">上一篇</span>
-            <span class="doc-pager-title"><icon-left /> {{ prev.text }}</span>
-          </router-link>
-          <span v-else class="doc-pager-item placeholder"></span>
-
-          <router-link v-if="next" :to="next.path" class="doc-pager-item next">
-            <span class="doc-pager-label">下一篇</span>
-            <span class="doc-pager-title">{{ next.text }} <icon-right /></span>
-          </router-link>
-        </div>
-
-        <div v-if="footer.text" class="doc-content-footer">{{ footer.text }}</div>
-      </div>
-
-      <DocToc class="doc-toc-rail" :items="rendered.toc" :active-id="activeHeadingId" />
-    </template>
-
-    <div v-else class="doc-content-wrap">
-      <div class="doc-not-found">
-        <h1>404</h1>
-        <p>没有找到文档：<code>/{{ docPath }}</code></p>
-        <p>
-          检查 docs/ 目录下是否存在对应的 markdown 文件，以及
-          docs-config.js 的侧边栏路径是否正确。
-        </p>
-        <router-link to="/view/docs" class="doc-not-found-home">返回首页</router-link>
-      </div>
-    </div>
-  </DocLayout>
-</template>
-
-<script setup>
-import { computed, onBeforeUnmount, onMounted, ref, watch, nextTick } from "vue";
-import { useRoute } from "vue-router";
-import DocLayout from "../components/doc-layout.vue";
-import DocToc from "../components/doc-toc.vue";
-import { renderMarkdown } from "../markdown/index";
-import { getDocSource } from "../content";
-import docsConfig from "../docs-config";
-import { pathOfDoc } from "../utils";
-
-const route = useRoute();
-
-const docPath = computed(() => pathOfDoc(decodeURIComponent(route.params.path || "")));
-const source = computed(() => getDocSource(docPath.value));
-const rendered = computed(() =>
-  source.value === undefined
-    ? { html: "", toc: [] }
-    : renderMarkdown(source.value, docPath.value)
-);
-const footer = docsConfig.footer;
-
-const activeHeadingId = ref("");
-
-// ---- 上一篇 / 下一篇：按侧边栏顺序 ----
-const flatItems = docsConfig.sidebar.flatMap((group) =>
-  (group.items || []).map((item) => ({
-    text: item.text,
-    path: item.path,
-    docPath: pathOfDoc(item.path),
-  }))
-);
-
-const currentIndex = computed(() =>
-  flatItems.findIndex((item) => item.docPath === docPath.value)
-);
-const prev = computed(() =>
-  currentIndex.value > 0 ? flatItems[currentIndex.value - 1] : null
-);
-const next = computed(() =>
-  currentIndex.value >= 0 && currentIndex.value < flatItems.length - 1
-    ? flatItems[currentIndex.value + 1]
-    : null
-);
-
-// ---- 标题与描述 ----
-watch(
-  docPath,
-  (path) => {
-    const sidebarItem = flatItems.find((item) => item.docPath === path);
-    document.title = sidebarItem
-      ? `${sidebarItem.text} · ${docsConfig.site.title}`
-      : docsConfig.site.description;
-  },
-  { immediate: true }
-);
-
-// ---- 路由变化：滚动到锚点或页首 ----
-watch(
-  docPath,
-  () => {
-    activeHeadingId.value = "";
-    nextTick(() => {
-      if (route.hash) {
-        const el = document.getElementById(decodeURIComponent(route.hash.slice(1)));
-        if (el) {
-          el.scrollIntoView();
-          return;
-        }
-      }
-      window.scrollTo(0, 0);
-    });
-  },
-  { immediate: true }
-);
-
-// ---- TOC 滚动联动（滚动监听当前所在小节）----
-let ticking = false;
-
-const updateActiveHeading = () => {
-  ticking = false;
-  const headings = document.querySelectorAll(
-    ".doc-markdown h2[id], .doc-markdown h3[id]"
-  );
-  let current = "";
-  headings.forEach((el) => {
-    if (el.getBoundingClientRect().top <= 96) {
-      current = el.id;
-    }
-  });
-  activeHeadingId.value = current;
-};
-
-const onScroll = () => {
-  if (!ticking) {
-    ticking = true;
-    window.requestAnimationFrame(updateActiveHeading);
-  }
-};
-
-onMounted(() => {
-  window.addEventListener("scroll", onScroll, { passive: true });
-  updateActiveHeading();
-});
-
-onBeforeUnmount(() => {
-  window.removeEventListener("scroll", onScroll);
-});
-</script>

package/templates/document/app/webpack.config.js

@@ -1,15 +0,0 @@
-// 业务 Webpack 扩展配置：与框架基础配置 webpack-merge.merge.smart 合并。
-//
-// 文档站把项目根目录 docs/ 下的 markdown 按原始文本打进产物
-// （页面里通过 require.context 读取），因此在这里声明 asset/source 规则。
-module.exports = {
-  module: {
-    rules: [
-      {
-        test: /\.md$/,
-        // webpack 5 内置资源模块：把文件内容作为字符串导出（default export）
-        type: "asset/source",
-      },
-    ],
-  },
-};

package/templates/document/build.js

@@ -1,6 +0,0 @@
-const { frontendBuild } = require("lumfall");
-
-// 环境由 _ENV 决定（不是 NODE_ENV）：
-//   _ENV=local  启动 Webpack dev server（HMR 热更新，默认 127.0.0.1:9002）
-//   _ENV=prod   产物构建到 app/public/dist/prod/，同时产出各页面 .tpl 模板
-frontendBuild(process.env._ENV);

package/templates/document/config/config.beta.js

@@ -1,2 +0,0 @@
-// _ENV=beta 时加载，覆盖 config.default.js 的同名键（浅合并）
-module.exports = {};

package/templates/document/config/config.default.js

@@ -1,9 +0,0 @@
-// 所有环境共享的基础配置。合并顺序（后者覆盖前者同名键）：
-//   框架 config.default -> 业务 config.default -> 框架 config.<env> -> 业务 config.<env>
-module.exports = {
-  name: "lumfall-document",
-  apiBasePath: "/api",
-
-  // 文档站是纯静态站点，默认不暴露 /api 路由；security 的默认值
-  // （签名关闭 + projectKey 开启）保持框架默认即可，见框架文档「安全策略」
-};

package/templates/document/config/config.local.js

@@ -1,2 +0,0 @@
-// _ENV=local 时加载，覆盖 config.default.js 的同名键（浅合并）
-module.exports = {};

package/templates/document/config/config.prod.js

@@ -1,2 +0,0 @@
-// _ENV=prod 时加载，覆盖 config.default.js 的同名键（浅合并）
-module.exports = {};

package/templates/document/docs/guide/example.md

@@ -1,41 +0,0 @@
-# 示例页面
-
-这个页面演示文档站支持的 markdown 能力，确认效果后可以删除本文件
-（记得同步删掉 `docs-config.js` 侧栏里的对应条目）。
-
-## 提示块
-
-::: tip 提示
-这是一个 tip 提示块，用于展示正向提示。
-:::
-
-::: warning 注意
-这是一个 warning 提示块，用于展示需要注意的内容。
-:::
-
-## 代码高亮
-
-标注语言即可高亮，右上角有一键复制：
-
-```js
-const { serviceStart } = require("lumfall");
-
-const app = serviceStart({
-  name: "my-docs",
-  homePath: "/view/docs",
-});
-```
-
-## 表格
-
-| 能力 | 说明 |
-| --- | --- |
-| 页面目录（TOC） | 正文 h2/h3 自动生成，滚动联动高亮 |
-| 站内搜索 | `Ctrl/Cmd + K` 或 `/` 唤起，标题与正文加权匹配，无需后端 |
-| 相对链接 | `[返回介绍](./introduction.md)` 自动转站内路由，支持锚点 |
-| 亮暗主题 | 跟随系统 + 手动切换，主题色由 CSS 变量驱动 |
-
-## 锚点
-
-每个标题悬停会出现 `#` 锚点链接，可以被其他文档引用：
-[跳到代码高亮](./example.md#代码高亮)。

package/templates/document/docs/guide/introduction.md

@@ -1,31 +0,0 @@
-# 开始使用
-
-这是由 create-lumfall 生成的**空文档站模板**——站点框架（导航、侧栏、目录、搜索、
-代码高亮、亮暗主题）已全部就绪，你只需要写内容。
-
-## 放入你的内容
-
-1. 把 `docs/` 目录下的 markdown 换成你的文档（目录结构随意，两级以内体验最佳）
-2. 修改 `app/pages/docs/docs-config.js`：站点名、导航、侧栏、首页 hero、页脚
-3. 本地预览：`pnpm start:dev`，访问 <http://localhost:3000/view/docs>
-
-## 侧边栏与文件对应
-
-侧边栏条目的 `path` 对应 `docs/` 下的 markdown 文件：
-
-| 配置项 | 对应文件 |
-| --- | --- |
-| `doc("guide/introduction")` | `docs/guide/introduction.md` |
-| `doc("guide/example")` | `docs/guide/example.md` |
-
-## 发布
-
-```sh
-pnpm build:static              # 产出 dist-static/（含 vercel.json）
-cd dist-static && vercel --prod
-```
-
-## 下一步
-
-- 看 [示例页面](./example.md) 了解文档站支持的 markdown 能力，确认后可删除
-- 完整功能说明见 lumfall-document 项目 README

package/templates/document/package.json

@@ -1,36 +0,0 @@
-{
-  "name": "lumfall-document",
-  "version": "1.0.0",
-  "description": "基于 lumfall 的技术文档站模板：导航、侧栏、目录、搜索、暗色模式，对标 VitePress 的使用体验",
-  "main": "server.js",
-  "scripts": {
-    "dev": "_ENV='local' nodemon --exitcrash server.js",
-    "beta": "_ENV='beta' nodemon --exitcrash server.js",
-    "prod": "_ENV='prod' node server.js",
-    "build:dev": "_ENV='local' node --max_old_space_size=4096 ./build.js",
-    "build:prod": "_ENV='prod' node ./build.js",
-    "start:dev": "concurrently --kill-others-on-fail -n webpack,server -c cyan,green \"pnpm build:dev\" \"pnpm dev\"",
-    "start:prod": "pnpm build:prod && pnpm prod",
-    "build:static": "node ./scripts/build-static.js"
-  },
-  "dependencies": {
-    "lumfall": "^1.2.1",
-    "highlight.js": "^11.9.0",
-    "markdown-it": "^14.0.0",
-    "markdown-it-container": "^4.0.0"
-  },
-  "devDependencies": {
-    "concurrently": "^10.0.5",
-    "nodemon": "^3.1.14"
-  },
-  "packageManager": "pnpm@10.30.0",
-  "keywords": [
-    "lumfall",
-    "docs",
-    "documentation",
-    "vitepress",
-    "koa",
-    "vue"
-  ],
-  "license": "ISC"
-}

package/templates/document/scripts/build-static.js

@@ -1,129 +0,0 @@
-/**
- * 静态站点构建脚本：产出可直接托管在 Vercel / Netlify / Nginx 的纯静态目录。
- *
- * 用法：pnpm build:static （等价于 _ENV=prod node build.js + 组装 dist-static/）
- *
- * 文档站是纯前端 SPA：markdown 在构建期打进 bundle，运行时不调用任何接口、
- * 不读取服务端注入的 window.__LUMFALL__，因此可以脱离 Koa 以静态文件部署。
- *
- * 产物结构（dist-static/）：
- *   index.html     "/" 的重定向页 → /view/docs
- *   app.html       应用外壳（由 entry.docs.tpl 转换，占位符替换为静态值）
- *   vercel.json    SPA rewrite（/view/docs/* → app.html）+ 长缓存头
- *   dist/prod/...  构建产物（保持 /dist/prod/ 绝对路径可解析）
- */
-const { spawnSync } = require("child_process");
-const fs = require("fs");
-const path = require("path");
-
-const rootDir = process.cwd();
-const distDir = path.join(rootDir, "app", "public", "dist");
-const outDir = path.join(rootDir, "dist-static");
-
-// 1. 复用生产构建：子进程执行 build.js（_ENV=prod），进程退出即构建完成
-console.log("[static] running production build (build.js) ...\n");
-const build = spawnSync("node", ["build.js"], {
-  stdio: "inherit",
-  env: { ...process.env, _ENV: "prod" },
-});
-if (build.status !== 0) {
-  process.exitCode = build.status || 1;
-  return;
-}
-
-// 2. 组装输出目录（保留 .vercel/ 项目链接目录，否则 vercel link 需要重做。
-//    注意必须在 rmSync 之前把文件内容读进内存——rm 后同名路径会被重建，按路径保存无效）
-const linkDir = path.join(outDir, ".vercel");
-const savedLinkFiles = fs.existsSync(linkDir)
-  ? fs.readdirSync(linkDir).map((name) => ({
-      name,
-      content: fs.readFileSync(path.join(linkDir, name)),
-    }))
-  : null;
-fs.rmSync(outDir, { recursive: true, force: true });
-fs.mkdirSync(path.join(outDir, "dist"), { recursive: true });
-if (savedLinkFiles) {
-  fs.mkdirSync(linkDir, { recursive: true });
-  for (const { name, content } of savedLinkFiles) {
-    fs.writeFileSync(path.join(linkDir, name), content);
-  }
-}
-fs.cpSync(path.join(distDir, "prod"), path.join(outDir, "dist", "prod"), {
-  recursive: true,
-});
-
-// 3. entry.docs.tpl → app.html：把服务端渲染的 __LUMFALL__ 占位换成静态值。
-//    文档站前端不读这些值，保留空对象是为了模板使用方将来加 curl 调接口时行为一致。
-//    同时剥掉 {# ... #} nunjucks 注释——Koa 渲染时会剥离，静态导出不剥会变成
-//    页面顶部的可见文本（浏览器会把 head 里的游离文本挪进 body 渲染）。
-//    lumfall >= 1.2.0 起页面模板按模式分目录，prod 构建产物在 dist/prod/ 下。
-const tplPath = path.join(distDir, "prod", "entry.docs.tpl");
-const tpl = fs
-  .readFileSync(tplPath, "utf8")
-  .replace(/\{#[\s\S]*?#\}/g, "");
-const marker = "window.__LUMFALL__";
-const start = tpl.indexOf(marker);
-if (start < 0) {
-  throw new Error(`[static] ${marker} not found in entry.docs.tpl`);
-}
-const scriptEnd = tpl.indexOf("</script>", start);
-if (scriptEnd < 0) {
-  throw new Error("[static] </script> not found after __LUMFALL__ block");
-}
-
-const staticGlobals = `window.__LUMFALL__ = {
-        name: "lumfall-document",
-        env: "static",
-        options: {},
-        projectKey: "",
-      };`;
-const appHtml = tpl.slice(0, start) + staticGlobals + tpl.slice(scriptEnd);
-fs.writeFileSync(path.join(outDir, "app.html"), appHtml);
-
-// 4. "/" 重定向页：静态托管下没有 302 兜底路由，用 meta refresh + JS 跳到 /view/docs
-fs.writeFileSync(
-  path.join(outDir, "index.html"),
-  `<!DOCTYPE html>
-<html lang="zh-CN">
-  <head>
-    <meta charset="UTF-8" />
-    <title>Lumfall 文档</title>
-    <meta http-equiv="refresh" content="0; url=/view/docs" />
-    <script>location.replace("/view/docs");</script>
-  </head>
-  <body></body>
-</html>
-`
-);
-
-// 5. SPA 路由规则：/view/docs/* 深链接重写到 app.html（文件优先，静态资源不受影响）
-fs.writeFileSync(
-  path.join(outDir, "vercel.json"),
-  JSON.stringify(
-    {
-      rewrites: [
-        { source: "/view/docs", destination: "/app.html" },
-        { source: "/view/docs/:path*", destination: "/app.html" },
-      ],
-      headers: [
-        {
-          // 构建产物带内容 hash，可永久缓存；app.html 不缓存保证发版即生效
-          source: "/dist/prod/(.*)",
-          headers: [
-            { key: "Cache-Control", value: "public, max-age=31536000, immutable" },
-          ],
-        },
-        {
-          source: "/app.html",
-          headers: [{ key: "Cache-Control", value: "no-cache" }],
-        },
-      ],
-    },
-    null,
-    2
-  )
-);
-
-console.log(`\n[static] done → ${path.relative(rootDir, outDir)}`);
-console.log("[static] deploy: cd dist-static && vercel --prod");
-console.log("[static] （或 Vercel 项目设置 Build Command: pnpm build:static, Output Directory: dist-static）");