@tnotesjs/core 0.0.8 → 0.1.14

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.14",
   "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/components/Layout/Layout.vue

@@ -156,6 +156,7 @@
         @toggle-expand="toggleSidebarSections"
         @toggle-note-id="toggleNoteId"
         @focus-current="focusCurrentNote"
+        @open-settings="openSettings"
       />
     </template>
 
@@ -180,6 +181,16 @@
     <!-- <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 +200,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";
@@ -208,6 +221,8 @@ import ImagePreview from "./ImagePreview.vue";
 import NoteStatus from "./NoteStatus.vue";
 import SidebarNavBefore from "./SidebarNavBefore.vue";
 import Swiper from "./Swiper.vue";
+import { useSettingsDialog } from "../Settings/composables/useSettingsDialog";
+import SettingsDialog from "../Settings/SettingsDialog.vue";
 
 const { Layout } = DefaultTheme;
 const vpData = useData();
@@ -217,6 +232,12 @@ const route = useRoute();
 // 启用代码块全屏功能
 useCodeBlockFullscreen();
 
+// 全局重命名遮罩状态（由 useRenameRedirect 控制 show/hide）
+const { state: renameOverlayState } = useRenameOverlay();
+
+// 全局设置 Dialog 控制
+const { open: openSettings } = useSettingsDialog();
+
 // 自定义侧边栏引用
 const customSidebarRef = ref(null);
 const showNoteId = ref(false);

package/vitepress/components/Layout/SidebarNavBefore.vue

@@ -30,6 +30,16 @@
     >
       <img :src="icon__focus" class="toggle-icon" alt="聚焦当前笔记" />
     </button>
+
+    <!-- 设置按钮 -->
+    <button
+      class="toggle-btn settings-btn"
+      @click="$emit('open-settings')"
+      title="打开设置"
+      aria-label="打开设置"
+    >
+      <span class="settings-icon" aria-hidden="true">⚙️</span>
+    </button>
   </div>
 </template>
 
@@ -45,6 +55,7 @@ defineEmits<{
   'toggle-expand': []
   'toggle-note-id': []
   'focus-current': []
+  'open-settings': []
 }>()
 </script>
 
@@ -89,4 +100,15 @@ defineEmits<{
 .toggle-btn:hover .toggle-icon {
   transform: scale(1.1);
 }
+
+.settings-icon {
+  font-size: 18px;
+  line-height: 1;
+  display: inline-block;
+  transition: transform 0.2s ease;
+}
+
+.toggle-btn:hover .settings-icon {
+  transform: scale(1.1);
+}
 </style>

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 }
+}

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

@@ -0,0 +1,59 @@
+/**
+ * 重命名后跳转工具：显示遮罩 → 等 Vite HMR 重建路由 → 整页跳到新 URL。
+ *
+ * 关于面板保存与文件系统直接重命名两条入口共用此函数，确保行为一致。
+ */
+import { useRenameOverlay } from './useRenameOverlay'
+
+export interface RedirectAfterRenameOptions {
+  /** 主标题，默认「正在跳转到新地址...」 */
+  message?: string
+  /** 副提示，默认「请稍候」 */
+  tip?: string
+  /** 等待 HMR 的毫秒数，默认 200ms（经验值，给 Vite 重算路由表留时间） */
+  delayMs?: number
+  /** 站点 base，例如 `/TNotes.introduction/`；不传则使用 `import.meta.env.BASE_URL` 或 `/` */
+  base?: string
+}
+
+/**
+ * 根据后端返回的 `newUrl`（形如 `/notes/xxx/README`）跳转到最终地址。
+ *
+ * 注意：使用 `window.location.replace` 整页跳，避免 SPA 路由表滞后导致 404。
+ */
+export async function redirectAfterRename(
+  newUrl: string,
+  opts: RedirectAfterRenameOptions = {},
+): Promise<void> {
+  const { show } = useRenameOverlay()
+
+  show({
+    message: opts.message ?? '正在跳转到新地址...',
+    tip: opts.tip ?? '请稍候',
+  })
+
+  const base =
+    opts.base ??
+    (typeof import.meta !== 'undefined' ? import.meta.env?.BASE_URL : '/') ??
+    '/'
+
+  const normalizedBase = base.endsWith('/') ? base : `${base}/`
+  const normalizedPath = newUrl.replace(/^\/+/, '')
+  const finalUrl = normalizedBase + normalizedPath
+
+  // 关键：先用 replaceState 把地址栏同步切到新 URL。
+  // 文件系统重命名场景下，Vite chokidar 会几乎同时触发 full-reload，
+  // 如果只用 setTimeout + location.replace，会被 full-reload 抢先以旧 URL 重载页面。
+  // 先 replaceState 后，无论谁先重载，浏览器都从新 URL 拉页面。
+  try {
+    window.history.replaceState(null, '', finalUrl)
+  } catch {
+    // 跨域等异常下退回 location.replace
+  }
+
+  await new Promise((resolve) => setTimeout(resolve, opts.delayMs ?? 200))
+
+  // 再做一次显式跳转，确保 SPA 状态完全重置。
+  // 此时 location.href 已是 finalUrl，等价于 reload。
+  window.location.replace(finalUrl)
+}