@tnotesjs/core 0.0.8 → 0.1.15

package/dist/{chunk-JUMVJKWV.js → chunk-FVKQPBPP.js}

@@ -1,7 +1,7 @@
 import {
   ConfigManager,
   getConfigManager
-} from "./chunk-NASIL5FY.js";
+} from "./chunk-SQVHJR2Z.js";
 
 // utils/errorHandler.ts
 var TNotesError = class _TNotesError extends Error {
@@ -2053,6 +2053,9 @@ var ProcessManager = class {
   }
 };
 
+// services/file-watcher/service.ts
+import { request as httpRequest } from "http";
+
 // services/file-watcher/configChangeHandler.ts
 var ConfigChangeHandler = class {
   constructor(config2) {
@@ -2227,6 +2230,13 @@ async function safeExecute(label, fn, logger2) {
   }
 }
 
+// config/templates.ts
+function generateNoteTitle(noteIndex, title, repoUrl) {
+  const dirName = `${noteIndex}. ${title}`;
+  const encodedDirName = encodeURIComponent(dirName);
+  return `# [${dirName}](${repoUrl}/${encodedDirName})`;
+}
+
 // services/file-watcher/folderChangeHandler.ts
 var RENAME_REVERT_DELAY_MS = 2e3;
 var DELETE_REINIT_DELAY_MS = 1e3;
@@ -2305,6 +2315,11 @@ var FolderChangeHandler = class {
           logger2
         );
       }
+      this.config.onRenameSuccess?.({
+        oldFolder: oldName,
+        newFolder: newName,
+        noteIndex: newNoteIndex
+      });
     } finally {
       this.scheduleTimer(() => {
         scheduler.setUpdating(false);
@@ -2333,9 +2348,14 @@ var FolderChangeHandler = class {
     return { oldNoteIndex, newNoteIndex };
   }
   async handleTitleOnlyRename(noteIndex, newName) {
-    const { noteIndexCache, readmeService, logger: logger2 } = this.config;
+    const { noteIndexCache, readmeService, logger: logger2, notesDir } = this.config;
     logger2.info(`\u7B14\u8BB0\u7D22\u5F15\u672A\u53D8 (${noteIndex})\uFF0C\u53EA\u66F4\u65B0\u6807\u9898`);
     noteIndexCache.updateFolderName(noteIndex, newName);
+    await safeExecute(
+      `\u66F4\u65B0 README \u4E00\u7EA7\u6807\u9898 ${noteIndex}`,
+      () => this.rewriteNoteReadmeH1(notesDir, newName, noteIndex),
+      logger2
+    );
     const item = noteIndexCache.getByNoteIndex(noteIndex);
     if (item) {
       await readmeService.updateNoteInReadme(noteIndex, item.noteConfig);
@@ -2343,6 +2363,37 @@ var FolderChangeHandler = class {
     await readmeService.regenerateSidebar();
     logger2.success(`\u6807\u9898\u66F4\u65B0\u5B8C\u6210`);
   }
+  /**
+   * 重写指定笔记目录下 README.md 的一级标题。
+   *
+   * 输入的 `folderName` 形如 `0003. 评论功能的技术实现`，
+   * 据此推导出新标题文本（去掉 `${noteIndex}. ` 前缀）。
+   */
+  async rewriteNoteReadmeH1(notesDir, folderName, noteIndex) {
+    const readmePath = join3(notesDir, folderName, "README.md");
+    if (!existsSync3(readmePath)) return;
+    const newTitle = folderName.replace(/^\d{4}\.\s*/, "").trim();
+    if (!newTitle) return;
+    const content = await fsPromises.readFile(readmePath, "utf-8");
+    const lines = content.split("\n");
+    let h1Index = -1;
+    for (let i = 0; i < lines.length; i++) {
+      if (lines[i].trim().startsWith("# ")) {
+        h1Index = i;
+        break;
+      }
+    }
+    if (h1Index === -1) {
+      this.config.logger.warn(
+        `\u672A\u5728 ${readmePath} \u627E\u5230\u4E00\u7EA7\u6807\u9898\uFF0C\u8DF3\u8FC7 README H1 \u66F4\u65B0`
+      );
+      return;
+    }
+    const newH1 = generateNoteTitle(noteIndex, newTitle, REPO_NOTES_URL);
+    if (lines[h1Index] === newH1) return;
+    lines[h1Index] = newH1;
+    await fsPromises.writeFile(readmePath, lines.join("\n"), "utf-8");
+  }
   async handleIndexChangedRename(oldNoteIndex, newNoteIndex) {
     const { noteService, noteIndexCache, readmeService, logger: logger2 } = this.config;
     logger2.info(`\u7B14\u8BB0\u7D22\u5F15\u53D8\u66F4: ${oldNoteIndex} \u2192 ${newNoteIndex}`);
@@ -2741,13 +2792,6 @@ import { writeFileSync as writeFileSync4, readFileSync as readFileSync5 } from "
 import { join as join7 } from "path";
 import { v4 as uuidv4 } from "uuid";
 
-// config/templates.ts
-function generateNoteTitle(noteIndex, title, repoUrl) {
-  const dirName = `${noteIndex}. ${title}`;
-  const encodedDirName = encodeURIComponent(dirName);
-  return `# [${dirName}](${repoUrl}/${encodedDirName})`;
-}
-
 // services/readme/service.ts
 import {
   existsSync as existsSync6,
@@ -3321,6 +3365,7 @@ var NoteService = class _NoteService {
 // services/file-watcher/service.ts
 var NOTES_DIR_NOT_SET_ERROR = "NOTES_DIR_PATH \u672A\u8BBE\u7F6E\uFF0C\u65E0\u6CD5\u542F\u52A8\u6587\u4EF6\u76D1\u542C";
 var UPDATE_UNLOCK_DELAY_MS2 = 500;
+var RENAME_BROADCAST_PATH = "/__tnotes_broadcast_rename";
 var FileWatcherService = class _FileWatcherService {
   constructor(notesDir = NOTES_DIR_PATH) {
     this.notesDir = notesDir;
@@ -3380,7 +3425,58 @@ var FileWatcherService = class _FileWatcherService {
       noteService: this.noteService,
       readmeService: this.readmeService,
       noteIndexCache: this.noteIndexCache,
-      logger
+      logger,
+      onRenameSuccess: (payload) => {
+        void this.broadcastRename(payload);
+      }
+    });
+  }
+  async broadcastRename(payload) {
+    const path2 = `/${repoName}${RENAME_BROADCAST_PATH}`;
+    const body = JSON.stringify(payload);
+    const hosts = ["127.0.0.1", "::1"];
+    let lastError = null;
+    for (const host of hosts) {
+      try {
+        await this.postOnce(host, path2, body);
+        return;
+      } catch (error) {
+        lastError = error;
+      }
+    }
+    logger.warn(
+      `\u5E7F\u64AD\u91CD\u547D\u540D\u4E8B\u4EF6\u5931\u8D25 (POST http://[127.0.0.1|::1]:${port}${path2}): ${String(lastError)}`
+    );
+  }
+  postOnce(host, path2, body) {
+    return new Promise((resolve2, reject) => {
+      const req = httpRequest(
+        {
+          host,
+          port,
+          path: path2,
+          method: "POST",
+          family: host.includes(":") ? 6 : 4,
+          headers: {
+            "Content-Type": "application/json",
+            "Content-Length": Buffer.byteLength(body)
+          }
+        },
+        (res) => {
+          res.on("data", () => {
+          });
+          res.on("end", () => {
+            if (res.statusCode && res.statusCode >= 400) {
+              reject(new Error(`HTTP ${res.statusCode}`));
+              return;
+            }
+            resolve2();
+          });
+        }
+      );
+      req.on("error", reject);
+      req.write(body);
+      req.end();
     });
   }
   initRenameDetector() {

package/dist/{chunk-NASIL5FY.js → chunk-SQVHJR2Z.js}

@@ -45,10 +45,6 @@ function getDefaultConfig(repoName) {
         text: "\u{1F3E0} Home",
         link: "/"
       },
-      {
-        text: "\u2699\uFE0F Settings",
-        link: "/Settings"
-      },
       {
         text: "\u{1F4D2} TNotes",
         link: "https://tnotesjs.github.io/notes"

package/dist/cli/index.js

@@ -22,10 +22,10 @@ import {
   parseArgs,
   parseReadmeCompletedNotes,
   runCommand
-} from "../chunk-JUMVJKWV.js";
+} from "../chunk-FVKQPBPP.js";
 import {
   ConfigManager
-} from "../chunk-NASIL5FY.js";
+} from "../chunk-SQVHJR2Z.js";
 
 // commands/update/UpdateCommand.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   ConfigManager,
   getConfigManager
-} from "./chunk-NASIL5FY.js";
+} from "./chunk-SQVHJR2Z.js";
 export {
   ConfigManager,
   getConfigManager

package/dist/vitepress/config/index.js

@@ -4,8 +4,8 @@ import {
   UpdateNoteConfigCommand,
   generateAnchor,
   logger
-} from "../../chunk-JUMVJKWV.js";
-import "../../chunk-NASIL5FY.js";
+} from "../../chunk-FVKQPBPP.js";
+import "../../chunk-SQVHJR2Z.js";
 
 // vitepress/config/index.ts
 import fs2 from "fs";
@@ -639,6 +639,42 @@ function buildProgressPlugin(options = {}) {
   };
 }
 
+// vitepress/plugins/fileWatcherBridgePlugin.ts
+var RENAME_EVENT = "tnotes:note-renamed";
+var BROADCAST_PATH = "/__tnotes_broadcast_rename";
+function fileWatcherBridgePlugin() {
+  return {
+    name: "tnotes-file-watcher-bridge",
+    apply: "serve",
+    configureServer(server) {
+      server.middlewares.use((req, res, next) => {
+        const url = req.url ?? "";
+        const isBroadcast = url === BROADCAST_PATH || url.endsWith(BROADCAST_PATH);
+        if (!isBroadcast || req.method !== "POST") {
+          return next();
+        }
+        let body = "";
+        req.on("data", (chunk) => {
+          body += chunk.toString();
+        });
+        req.on("end", () => {
+          try {
+            const data = JSON.parse(body || "{}");
+            server.ws.send({ type: "custom", event: RENAME_EVENT, data });
+            res.statusCode = 204;
+            res.end();
+          } catch (error) {
+            res.statusCode = 400;
+            res.end(
+              error instanceof Error ? error.message : "Bad rename payload"
+            );
+          }
+        });
+      });
+    }
+  };
+}
+
 // vitepress/plugins/getNoteByConfigIdPlugin.ts
 function getNoteByConfigIdPlugin() {
   return {
@@ -746,6 +782,10 @@ function renameNotePlugin() {
               const startTime = Date.now();
               await renameCommand.renameNote({ noteIndex, newTitle });
               const duration = Date.now() - startTime;
+              const newFolderName = `${noteIndex}. ${newTitle.trim()}`;
+              const newUrl = `/notes/${encodeURIComponent(
+                newFolderName
+              )}/README`;
               res.statusCode = 200;
               res.setHeader("Content-Type", "application/json");
               res.end(
@@ -753,6 +793,8 @@ function renameNotePlugin() {
                   success: true,
                   duration,
                   newTitle,
+                  newFolderName,
+                  newUrl,
                   message: "\u91CD\u547D\u540D\u5B8C\u6210"
                 })
               );
@@ -856,9 +898,13 @@ function defineNotesConfig(overrides = {}) {
         updateConfigPlugin(),
         renameNotePlugin(),
         getNoteByConfigIdPlugin(),
+        fileWatcherBridgePlugin(),
         ...overrideVite?.plugins || []
       ],
       server: {
+        // 显式同时监听 IPv4 / IPv6，避免 Node 18+ 在 Windows 下偶发只绑定 ::1
+        // 导致 Chrome 解析 localhost → 127.0.0.1 时连接被拒、页面一直 pending。
+        // host: true,
         watch: {
           ignored: IGNORE_LIST
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tnotesjs/core",
-  "version": "0.0.8",
+  "version": "0.1.15",
   "description": "TNotes 知识库核心框架 —— 基于 VitePress 的笔记管理系统",
   "type": "module",
   "packageManager": "pnpm@10.17.1",
@@ -29,6 +29,7 @@
   "scripts": {
     "build": "tsup",
     "build:check": "tsc --noEmit -p tsconfig.build.json",
+    "typecheck": "vue-tsc --noEmit -p tsconfig.build.json",
     "dev": "tsup --watch",
     "release": "node scripts/release.mjs",
     "lint": "eslint . --max-warnings=0",

package/vitepress/assets/icons/icon__setting.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path fill="#67676c" d="M19.9 12.66a1 1 0 0 1 0-1.32l1.28-1.44a1 1 0 0 0 .12-1.17l-2-3.46a1 1 0 0 0-1.07-.48l-1.88.38a1 1 0 0 1-1.15-.66l-.61-1.83a1 1 0 0 0-.95-.68h-4a1 1 0 0 0-1 .68l-.56 1.83a1 1 0 0 1-1.15.66L5 4.79a1 1 0 0 0-1 .48L2 8.73a1 1 0 0 0 .1 1.17l1.27 1.44a1 1 0 0 1 0 1.32L2.1 14.1a1 1 0 0 0-.1 1.17l2 3.46a1 1 0 0 0 1.07.48l1.88-.38a1 1 0 0 1 1.15.66l.61 1.83a1 1 0 0 0 1 .68h4a1 1 0 0 0 .95-.68l.61-1.83a1 1 0 0 1 1.15-.66l1.88.38a1 1 0 0 0 1.07-.48l2-3.46a1 1 0 0 0-.12-1.17ZM18.41 14l.8.9l-1.28 2.22l-1.18-.24a3 3 0 0 0-3.45 2L12.92 20h-2.56L10 18.86a3 3 0 0 0-3.45-2l-1.18.24l-1.3-2.21l.8-.9a3 3 0 0 0 0-4l-.8-.9l1.28-2.2l1.18.24a3 3 0 0 0 3.45-2L10.36 4h2.56l.38 1.14a3 3 0 0 0 3.45 2l1.18-.24l1.28 2.22l-.8.9a3 3 0 0 0 0 3.98m-6.77-6a4 4 0 1 0 4 4a4 4 0 0 0-4-4m0 6a2 2 0 1 1 2-2a2 2 0 0 1-2 2"/></svg>

package/vitepress/assets/icons/index.ts

@@ -28,6 +28,7 @@ export { default as icon__prev } from './icon__prev.svg'
 export { default as icon__restore } from './icon__restore.svg'
 export { default as icon__rotate } from './icon__rotate.svg'
 export { default as icon__search } from './icon__search.svg'
+export { default as icon__setting } from './icon__setting.svg'
 export { default as icon__sidebar_collapsed } from './icon__sidebar_collapsed.svg'
 export { default as icon__sidebar_opened } from './icon__sidebar_opened.svg'
 export { default as icon__totop } from './icon__totop.svg'

package/vitepress/components/Layout/Layout.vue

@@ -174,12 +174,25 @@
     <!-- <template #nav-bar-title-before>nav-bar-title-before</template> -->
     <!-- <template #nav-bar-title-after>nav-bar-title-after</template> -->
     <!-- <template #nav-bar-content-before>nav-bar-content-before</template> -->
-    <!-- <template #nav-bar-content-after>nav-bar-content-after</template> -->
+    <!-- 设置入口：固定在 VPNav 右侧（social-links / appearance 之后，extra 之前） -->
+    <template #nav-bar-content-after>
+      <NavBarSettingsTrigger />
+    </template>
 
     <!-- !NOTE 不清楚下面的插槽所对应的位置 -->
     <!-- <template #nav-screen-content-before>nav-screen-content-before</template> -->
     <!-- <template #nav-screen-content-after>nav-screen-content-after</template> -->
   </Layout>
+
+  <!-- 全局重命名遮罩：关于面板保存或文件系统重命名时由 useRenameOverlay 控制 -->
+  <LoadingPage
+    :visible="renameOverlayState.visible"
+    :message="renameOverlayState.message"
+    :tip="renameOverlayState.tip"
+  />
+
+  <!-- 全局设置 Dialog：由 useSettingsDialog 控制显隐 -->
+  <SettingsDialog />
 </template>
 
 <script setup>
@@ -189,15 +202,17 @@ import { computed, onMounted, ref, watch } from "vue";
 
 import { useCodeBlockFullscreen } from "../CodeBlockFullscreen";
 import { SIDEBAR_SHOW_NOTE_ID_KEY } from "../constants";
-import Discussions from "../Discussions/Discussions.vue";
 import { data as allNotesConfig } from "../notesConfig.data.ts";
 import AboutModal from "./AboutModal.vue";
 import AboutPanel from "./AboutPanel.vue";
+import Discussions from "../Discussions/Discussions.vue";
+import LoadingPage from "../LoadingPage/LoadingPage.vue";
 import { useCollapseControl } from "./composables/useCollapseControl";
 import { useNoteConfig } from "./composables/useNoteConfig";
 import { useNoteSave } from "./composables/useNoteSave";
 import { useNoteValidation } from "./composables/useNoteValidation";
 import { useRedirect } from "./composables/useRedirect";
+import { useRenameOverlay } from "./composables/useRenameOverlay";
 import { useVSCodeIntegration } from "./composables/useVSCodeIntegration";
 import ContentCollapse from "./ContentCollapse.vue";
 import CustomSidebar from "./CustomSidebar.vue";
@@ -205,9 +220,11 @@ import DocBeforeControls from "./DocBeforeControls.vue";
 import DocFooter from "./DocFooter.vue";
 import { data as readmeData } from "./homeReadme.data.ts";
 import ImagePreview from "./ImagePreview.vue";
+import NavBarSettingsTrigger from "./NavBarSettingsTrigger.vue";
 import NoteStatus from "./NoteStatus.vue";
 import SidebarNavBefore from "./SidebarNavBefore.vue";
 import Swiper from "./Swiper.vue";
+import SettingsDialog from "../Settings/SettingsDialog.vue";
 
 const { Layout } = DefaultTheme;
 const vpData = useData();
@@ -217,6 +234,9 @@ const route = useRoute();
 // 启用代码块全屏功能
 useCodeBlockFullscreen();
 
+// 全局重命名遮罩状态（由 useRenameRedirect 控制 show/hide）
+const { state: renameOverlayState } = useRenameOverlay();
+
 // 自定义侧边栏引用
 const customSidebarRef = ref(null);
 const showNoteId = ref(false);

package/vitepress/components/Layout/NavBarSettingsTrigger.vue

@@ -0,0 +1,59 @@
+<template>
+  <button
+    type="button"
+    class="tnotes-nav-settings-trigger"
+    title="打开设置"
+    aria-label="打开设置"
+    @click="open"
+  >
+    <img
+      :src="icon__setting"
+      class="tnotes-nav-settings-icon"
+      alt=""
+      aria-hidden="true"
+    />
+  </button>
+</template>
+
+<script setup lang="ts">
+import { icon__setting } from '../../assets/icons'
+import { useSettingsDialog } from '../Settings/composables/useSettingsDialog'
+
+const { open } = useSettingsDialog()
+</script>
+
+<style scoped>
+.tnotes-nav-settings-trigger {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 36px;
+  height: 36px;
+  margin: 0 4px;
+  padding: 0;
+  background: transparent;
+  border: none;
+  border-radius: 6px;
+  color: var(--vp-c-text-2);
+  cursor: pointer;
+  transition:
+    background 0.15s ease,
+    color 0.15s ease;
+}
+
+.tnotes-nav-settings-trigger:hover {
+  background: var(--vp-c-default-soft);
+  color: var(--vp-c-text-1);
+}
+
+.tnotes-nav-settings-icon {
+  width: 20px;
+  height: 20px;
+  display: block;
+  transition: transform 0.2s ease;
+}
+
+.tnotes-nav-settings-trigger:hover .tnotes-nav-settings-icon {
+  transform: scale(1.1);
+}
+</style>

package/vitepress/components/Layout/SidebarNavBefore.vue

@@ -1,35 +1,40 @@
 <template>
   <div class="sidebar-toggle-wrapper">
-    <!-- 笔记编号显示切换按钮 -->
-    <button
-      class="toggle-btn"
-      @click="$emit('toggle-note-id')"
-      :title="showNoteId ? '隐藏笔记编号' : '显示笔记编号'"
-    >
-      <img
-        :src="showNoteId ? icon__number_purple : icon__number_gray"
-        class="toggle-icon"
-        alt="切换笔记编号"
-      />
-    </button>
+    <div class="group group-left">
+      <!-- 展开/折叠全部按钮 -->
+      <button
+        class="toggle-btn"
+        @click="$emit('toggle-expand')"
+        :title="isExpanded ? '全部折叠' : '全部展开'"
+      >
+        <img :src="icon__fold" class="toggle-icon" alt="切换展开折叠" />
+      </button>
+      <span class="group-label">目录</span>
+    </div>
 
-    <!-- 展开/折叠全部按钮 -->
-    <button
-      class="toggle-btn"
-      @click="$emit('toggle-expand')"
-      :title="isExpanded ? '全部折叠' : '全部展开'"
-    >
-      <img :src="icon__fold" class="toggle-icon" alt="切换展开折叠" />
-    </button>
+    <div class="group group-right">
+      <!-- 聚焦到当前笔记按钮 -->
+      <button
+        class="toggle-btn"
+        @click="$emit('focus-current')"
+        title="聚焦到当前笔记（点击切换多个位置）"
+      >
+        <img :src="icon__focus" class="toggle-icon" alt="聚焦当前笔记" />
+      </button>
 
-    <!-- 聚焦到当前笔记按钮 -->
-    <button
-      class="toggle-btn"
-      @click="$emit('focus-current')"
-      title="聚焦到当前笔记（点击切换多个位置）"
-    >
-      <img :src="icon__focus" class="toggle-icon" alt="聚焦当前笔记" />
-    </button>
+      <!-- 笔记编号显示切换按钮 -->
+      <button
+        class="toggle-btn"
+        @click="$emit('toggle-note-id')"
+        :title="showNoteId ? '隐藏笔记编号' : '显示笔记编号'"
+      >
+        <img
+          :src="showNoteId ? icon__number_purple : icon__number_gray"
+          class="toggle-icon"
+          alt="切换笔记编号"
+        />
+      </button>
+    </div>
   </div>
 </template>
 
@@ -52,13 +57,24 @@ defineEmits<{
 .sidebar-toggle-wrapper {
   display: flex;
   align-items: center;
-  justify-content: center;
-  gap: 8px;
-  padding: 12px 0 16px 0;
+  justify-content: space-between;
+  padding: 12px 8px 16px;
   border-bottom: 1px solid var(--vp-c-divider);
   margin-bottom: 16px;
 }
 
+.group {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+}
+
+.group-label {
+  font-size: 13px;
+  color: var(--vp-c-text-2);
+  user-select: none;
+}
+
 .toggle-btn {
   display: inline-flex;
   align-items: center;

package/vitepress/components/Layout/composables/useNoteSave.ts

@@ -1,5 +1,7 @@
 import { useData } from 'vitepress'
-import { ref, computed } from 'vue'
+import { ref, computed } from 'vue'
+
+import { redirectAfterRename } from './useRenameRedirect'
 
 import type { NoteConfig } from '../../../../types'
 import type { Ref, ComputedRef } from 'vue'
@@ -54,6 +56,8 @@ export function useNoteSave(
     isSaving.value = true
     savingMessage.value = '正在保存配置...'
 
+    let renameNewUrl: string | null = null
+
     try {
       // 如果标题有变化,先重命名文件夹
       if (titleChanged) {
@@ -75,10 +79,17 @@ export function useNoteSave(
           throw new Error(`重命名失败: ${error}`)
         }
 
-        // 后端已经完成所有更新,包括文件系统同步
-        const result = await renameResponse.json()
-        console.log('重命名完成:', result)
+        // 后端已经完成所有更新（含文件系统、根 README、sidebar）
+        const result = (await renameResponse.json()) as {
+          success: boolean
+          newUrl?: string
+        }
+
+        if (!result?.newUrl) {
+          throw new Error('重命名响应缺少 newUrl 字段')
+        }
 
+        renameNewUrl = result.newUrl
         savingMessage.value = '文件已同步,准备跳转...'
       }
 
@@ -132,21 +143,14 @@ export function useNoteSave(
         showSuccessToast.value = false
       }, 3000)
 
-      // 如果标题改变了,先跳转到loading页,再由loading页根据configId查询目标URL
-      if (titleChanged) {
-        // 获取当前笔记的 configId (UUID)
-        const configId = allNotesConfig[currentNoteId.value]?.id
-
-        if (!configId) {
-          throw new Error('无法获取笔记的 configId')
-        }
+      // 如果标题改变了, 显示遮罩并整页跳到新 URL
+      if (titleChanged && renameNewUrl) {
+        // 提前结束「保存中」状态，避免遮罩退出后按钮文案残留
+        isSaving.value = false
+        savingMessage.value = ''
 
-        // 跳转到loading页,传递 configId 参数
         const base = vpData.site.value.base || '/'
-        const loadingUrl = `${base}loading?configId=${encodeURIComponent(
-          configId
-        )}`
-        window.location.href = loadingUrl
+        await redirectAfterRename(renameNewUrl, { base })
       }
     } catch (error) {
       console.error('保存配置失败:', error)

package/vitepress/components/Layout/composables/useRenameOverlay.ts

@@ -0,0 +1,33 @@
+/**
+ * 全局「重命名遮罩」状态。
+ *
+ * Layout 顶层渲染 `<LoadingPage />`，由本 store 控制 visible/message/tip，
+ * `useRenameRedirect` 调用 show/hide 即可。
+ */
+import { reactive } from 'vue'
+
+export interface RenameOverlayState {
+  visible: boolean
+  message: string
+  tip: string
+}
+
+const state = reactive<RenameOverlayState>({
+  visible: false,
+  message: '正在处理...',
+  tip: '',
+})
+
+export function useRenameOverlay() {
+  function show(payload: { message?: string; tip?: string } = {}) {
+    state.message = payload.message ?? '正在处理...'
+    state.tip = payload.tip ?? ''
+    state.visible = true
+  }
+
+  function hide() {
+    state.visible = false
+  }
+
+  return { state, show, hide }
+}