docnest 0.1.23 → 0.1.25

package/README.md

@@ -58,6 +58,8 @@ export default defineConfig({
 
 ### 文档搜索
 
+整理目录时可以把文档移动到原目录下的分类文件夹。旧地址会在原目录子树中按完全相同的文件名查找，只有唯一匹配时才跳转；重名、目录不存在或读取失败时保留 404，避免打开错误的文档。直接访问现有路径始终优先。
+
 普通阅读模式下，页面顶部提供文档搜索入口，也可以使用 `⌘K`（macOS）或
 `Ctrl K`（Windows/Linux）打开。搜索索引在首次打开搜索时才加载，覆盖文档标题、目录路径、标题层级、正文和代码块；中文按连续字符匹配，英文和带空格的查询按多个词匹配。结果按标题、目录和正文命中位置综合排序，并显示安全的文本摘要。
 
@@ -147,6 +149,7 @@ startServer(3000)
 Markdown 或 HTML 中明确引用的本地附件，不按文件扩展名设置业务白名单；外链、文档链接、隐藏路径、路径穿越和代码块中的伪引用会被忽略，缺失的附件默认会让构建失败。
 常见凭据文件（如 `.env`、私钥和证书容器）属于公共安全阻断项，即使被误写进文档链接也不会进入静态产物。
 静态生成 HTML 时，可再调用 `rewriteDocumentAttachmentUrls`，将正文中的附件链接统一改写到 `/doc-asset/` 端点。
+正文中的附件链接使用浏览器完整导航；独立 HTML 页面保持自己的样式和脚本，不进入 Markdown 局部刷新流程，挂载在子路径时也遵循这一规则。
 
 ## 开发
 

package/dist/server.js

@@ -719,7 +719,10 @@ async function resolveDocPath(requestedPath) {
         if (await storageFileExists(resolvedPath)) {
             return { resolvedPath };
         }
-        return null;
+        // A document may have moved into a subdirectory during catalog cleanup.
+        // Resolve only an unambiguous filename inside its original directory.
+        const movedPath = await findFileInTree(resolvedDirPath, fileName);
+        return movedPath ? { resolvedPath: movedPath } : null;
     }
     // 如果只是文件名，尝试在整个文档目录中查找
     try {
@@ -733,29 +736,32 @@ async function resolveDocPath(requestedPath) {
     }
     return null;
 }
-// 在目录树中查找文件
-async function findFileInTree(dir, fileName, basePath = '') {
-    try {
-        const effectiveBasePath = basePath || dir || '';
-        const entries = await storageReadDir(effectiveBasePath);
+// Find one exact filename; ambiguity or an unreadable subtree must not redirect.
+async function findFileInTree(dir, fileName) {
+    const matches = [];
+    async function visit(basePath) {
+        const entries = await storageReadDir(basePath);
         for (const entry of entries) {
             if (entry.name.startsWith('.'))
                 continue;
-            const relativePath = joinDocPath(effectiveBasePath, entry.name);
+            const relativePath = joinDocPath(basePath, entry.name);
             if (entry.isDirectory) {
-                const found = await findFileInTree('', fileName, relativePath);
-                if (found)
-                    return found;
+                await visit(relativePath);
             }
             else if (entry.isFile && entry.name === fileName && entry.name.endsWith('.md')) {
-                return relativePath;
+                matches.push(relativePath);
             }
+            if (matches.length > 1)
+                return;
         }
     }
+    try {
+        await visit(dir || '');
+    }
     catch (e) {
-        // 忽略错误
+        return null;
     }
-    return null;
+    return matches.length === 1 ? matches[0] : null;
 }
 // 构建面包屑：基于文档路径
 async function buildBreadcrumbs(docPath) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docnest",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "description": "可复用的本地 Markdown 文档中心",
   "repository": {
     "type": "git",

package/server/views/doc.ejs

@@ -294,6 +294,15 @@
           // 检查是否是文档系统内的链接
           const href = link.getAttribute('href');
           if (!href) return;
+
+          // Assets, including standalone HTML pages, need full browser navigation;
+          // they do not contain the Markdown article expected by navigateToDoc.
+          try {
+            const linkUrl = new URL(href, document.baseURI || window.location.href);
+            if (/(^|\/)doc-asset\//.test(linkUrl.pathname)) return;
+          } catch (_) {
+            return;
+          }
           
           // 判断是否是文档系统内的链接（排除外部链接、锚点、目录页链接）
           const isDocLink = (href.startsWith('/doc?') ||