md2ui 1.0.18 → 1.0.20

package/src/composables/useDocManager.js

@@ -1,10 +1,12 @@
-import { ref, computed, nextTick } from 'vue'
-import { getDocsList } from '../api/docs.js'
+import { ref, computed, watch, nextTick } from 'vue'
+import * as docService from '../services/DocService.js'
 import { useMarkdown } from './useMarkdown.js'
 import { useSearch } from './useSearch.js'
 import { useScroll } from './useScroll.js'
 import { useMobile } from './useMobile.js'
-import { findDoc, findFirstDoc, findReadmeDoc, findDocByHash, expandParents, flattenDocsList, expandAll, collapseAll } from './useDocTree.js'
+import { findDoc, findFirstDoc, findReadmeDoc, findDocByHash, expandParents, flattenDocsList, expandAll, collapseAll, buildHashIndex } from './useDocTree.js'
+import { stripOrderPrefix } from './useDocHash.js'
+import { clearMermaidCache } from './useMermaidCache.js'
 
 // 等待内容区域图片加载完成
 async function waitForContentImages(timeoutMs = 3000) {
@@ -21,88 +23,121 @@ export function useDocManager() {
   // 文档状态
   const docsList = ref([])
   const currentDoc = ref('')
-  // 如果 URL 有路径，说明是刷新已有文档页面，初始不显示欢迎页，避免闪烁
   const hasInitialPath = window.location.pathname.replace(/^\//, '') !== ''
   const showWelcome = ref(!hasInitialPath)
+  const lastModified = ref('')
+
+  // 编辑模式（从 sessionStorage 恢复）
+  const editMode = ref(sessionStorage.getItem('editMode') === 'true')
+  const rawMarkdown = ref('')
+  const currentDocFilePath = ref('')
 
   // composables
-  const { htmlContent, tocItems, renderMarkdown, docHash } = useMarkdown()
+  const { htmlContent, tocItems, renderMarkdown, extractTOCFromMarkdown, docHash } = useMarkdown()
   const { buildIndex } = useSearch()
   const {
     scrollProgress, showBackToTop, activeHeading,
     handleScroll: _handleScroll,
     scrollToHeading: _scrollToHeading,
-    scrollToTop
+    scrollToTop,
+    setTocItems,
+    rebuildHeadingsCache,
+    clearActiveHeading,
+    isSuppressHashClear,
+    lockHeading
   } = useScroll()
   const { isMobile, mobileDrawerOpen } = useMobile()
 
-  // 获取当前滚动位置
+  setTocItems(tocItems)
+
+  // ===== 滚动 & 历史 =====
   function getScrollTop() {
     const el = document.querySelector('.content')
     return el ? el.scrollTop : 0
   }
 
-  // 构造 history state，保留滚动位置
   function makeState(scrollTop) {
     return { scrollTop: scrollTop ?? getScrollTop() }
   }
 
-  // 滚动处理，同步锚点到 URL（replaceState 保留滚动位置）
+  // URL 锚点同步：统一由 watch 驱动，scrollToHeading 不再直接操作 URL
+  // _pendingPush: 标记下一次 activeHeading 变化是否需要 pushState（点击目录项）
+  let _pendingPush = false
+  let _hashUpdateTimer = null
+
+  watch(activeHeading, (id, oldId) => {
+    if (!currentDoc.value) return
+
+    // 文档切换导致的清空，不动 URL
+    if (!id && isSuppressHashClear()) return
+
+    // 取出并重置 push 标记
+    const shouldPush = _pendingPush
+    _pendingPush = false
+
+    if (_hashUpdateTimer) clearTimeout(_hashUpdateTimer)
+    _hashUpdateTimer = setTimeout(() => {
+      _hashUpdateTimer = null
+      const base = `/${docHash(currentDoc.value)}`
+      const url = id ? `${base}#${id}` : base
+      const current = window.location.pathname + window.location.hash
+      if (current === url) return
+
+      if (shouldPush) {
+        // 先保存当前滚动位置到旧条目
+        history.replaceState(makeState(), '', current)
+        history.pushState(makeState(), '', url)
+      } else {
+        history.replaceState(makeState(), '', url)
+      }
+    }, 100)
+  })
+
   function handleScroll(e) {
     _handleScroll(e)
-    if (activeHeading.value && currentDoc.value) {
-      history.replaceState(makeState(), '', `/${docHash(currentDoc.value)}#${activeHeading.value}`)
-    }
   }
 
-  // push: true 表示用户主动点击锚点，产生可回退的历史条目
   function scrollToHeading(id, { push = false } = {}) {
-    if (push && currentDoc.value) {
-      // 先把当前滚动位置写入即将被覆盖的历史条目
-      history.replaceState(makeState(), '', window.location.href)
-    }
+    if (push) _pendingPush = true
     _scrollToHeading(id)
-    if (currentDoc.value) {
-      const url = `/${docHash(currentDoc.value)}#${id}`
-      if (push) {
-        history.pushState(makeState(), '', url)
-      } else {
-        history.replaceState(makeState(), '', url)
-      }
-    }
   }
 
-  // 加载文档列表
+  // ===== 文档列表加载 =====
   async function loadDocsList() {
-    docsList.value = await getDocsList()
+    docsList.value = await docService.fetchDocsList()
+    buildHashIndex(docsList.value, docHash)
+    restoreExpandedState()
     buildIndex(docsList.value)
   }
 
-  // 回到欢迎页（isPopstate: true 表示由浏览器回退触发，不操作 history）
+  // ===== 导航 =====
   function goHome({ isPopstate = false } = {}) {
     currentDoc.value = ''
     showWelcome.value = true
     htmlContent.value = ''
     tocItems.value = []
+    editMode.value = false
+    lastModified.value = ''
+    sessionStorage.setItem('editMode', 'false')
+    document.title = 'md2ui'
     if (!isPopstate) {
-      // 用户主动点击，保存旧条目滚动位置后 push
       history.replaceState(makeState(), '', window.location.href)
       history.pushState(makeState(0), '', '/')
     }
     if (isMobile.value) mobileDrawerOpen.value = false
   }
 
-  // 加载文档
   async function loadDoc(key, { replace = false, anchor = '', keepState = false } = {}) {
     currentDoc.value = key
     showWelcome.value = false
+    lastContentHash = ''
+    clearMermaidCache()
+    docService.resetContentEtag()
     const hash = docHash(key)
     const url = anchor ? `/${hash}#${anchor}` : `/${hash}`
     if (replace) {
-      // keepState: popstate 回退时保留浏览器已有的 state（含 scrollTop）
       if (!keepState) history.replaceState(makeState(0), '', url)
     } else {
-      // push 前先保存当前滚动位置到旧条目
       history.replaceState(makeState(), '', window.location.href)
       history.pushState(makeState(0), '', url)
     }
@@ -112,42 +147,155 @@ export function useDocManager() {
       const response = await fetch(doc.path)
       if (response.ok) {
         const content = await response.text()
-        await renderMarkdown(content, key, docsList.value)
+        rawMarkdown.value = content
+        // 捕获最后修改时间
+        const lm = response.headers.get('x-last-modified')
+        lastModified.value = lm || ''
+        // 提取文件路径供轮询使用
+        currentDocFilePath.value = doc.path.replace(/^\/@user-docs\//, '')
+        if (editMode.value) {
+          extractTOCFromMarkdown(content, tocItems)
+        } else {
+          await renderMarkdown(content, key, docsList.value)
+        }
+        // 渲染完成后重建标题缓存（编辑模式需等 tiptap 渲染完成）
+        await nextTick()
+        rebuildHeadingsCache()
+        // 切换文档时清空 activeHeading（标记为文档切换，不清 URL hash）
+        // 同时取消 pending 的 hash 同步 timer
+        if (_hashUpdateTimer) { clearTimeout(_hashUpdateTimer); _hashUpdateTimer = null }
+        // 如果有锚点参数，先锁定再清空，防止 scrollTop=0 触发的滚动检测覆盖锚点
+        if (anchor) {
+          lockHeading(anchor)
+        } else {
+          clearActiveHeading()
+        }
         const contentEl = document.querySelector('.content')
         if (contentEl) contentEl.scrollTop = 0
+        // 动态更新页面标题（SEO + 浏览器标签页）
+        const docTitle = findDoc(docsList.value, key)?.label || ''
+        document.title = docTitle ? `${docTitle} - md2ui` : 'md2ui'
       }
     } catch (error) {
       console.error('加载文档失败:', error)
     }
   }
 
-  // 加载第一篇文档
   function loadFirstDoc() {
     const first = findFirstDoc(docsList.value)
     if (first) loadDoc(first.key)
   }
 
-  // 选择文档（移动端自动关闭抽屉）
   function handleDocSelect(key) {
     loadDoc(key)
     if (isMobile.value) mobileDrawerOpen.value = false
   }
 
-  // 文件夹操作
-  function toggleFolder(item) { item.expanded = !item.expanded }
-  function onExpandAll() { expandAll(docsList.value) }
-  function onCollapseAll() { collapseAll(docsList.value) }
+  // ===== 文件夹操作 =====
+  function toggleFolder(item) { item.expanded = !item.expanded; saveExpandedState() }
+  function onExpandAll() { expandAll(docsList.value); saveExpandedState() }
+  function onCollapseAll() { collapseAll(docsList.value); saveExpandedState() }
+
+  function saveExpandedState() {
+    const expanded = []
+    function collect(items) {
+      for (const item of items) {
+        if (item.type === 'folder') {
+          if (item.expanded) expanded.push(item.key)
+          if (item.children) collect(item.children)
+        }
+      }
+    }
+    collect(docsList.value)
+    sessionStorage.setItem('expandedFolders', JSON.stringify(expanded))
+  }
+
+  function restoreExpandedState() {
+    const raw = sessionStorage.getItem('expandedFolders')
+    if (!raw) return
+    try {
+      const expanded = new Set(JSON.parse(raw))
+      function apply(items) {
+        for (const item of items) {
+          if (item.type === 'folder') {
+            if (expanded.has(item.key)) item.expanded = true
+            if (item.children) apply(item.children)
+          }
+        }
+      }
+      apply(docsList.value)
+    } catch { /* ignore */ }
+  }
+
+  // ===== 内容区点击处理 =====
+
+  // 复制锚点链接到剪贴板（通过 class 切换锚点旁提示文字）
+  async function copyAnchorLink(anchorId, anchorEl) {
+    const base = currentDoc.value ? `/${docHash(currentDoc.value)}` : window.location.pathname
+    const url = `${window.location.origin}${base}#${anchorId}`
+    try {
+      await navigator.clipboard.writeText(url)
+      anchorEl.classList.add('anchor-copied')
+      setTimeout(() => anchorEl.classList.remove('anchor-copied'), 1500)
+    } catch {
+      anchorEl.classList.add('anchor-copy-error')
+      setTimeout(() => anchorEl.classList.remove('anchor-copy-error'), 1500)
+    }
+  }
 
-  // 内容区点击处理（链接跳转 + 图片放大）
   function handleContentClick(event, { onZoom }) {
     const target = event.target
+
+    // 优先判断图片放大（即使图片在链接内，也走放大逻辑而非链接跳转）
+    const isImg = target.tagName === 'IMG' && target.classList.contains('zoomable-image')
+    const mermaidEl = target.closest('.mermaid') || target.closest('.mermaid-svg')
+    const isMermaid = mermaidEl && mermaidEl.classList.contains('zoomable-image')
+    if (isImg || isMermaid) {
+      event.preventDefault()
+      const container = document.querySelector('.markdown-content')
+      if (!container) return
+      const allZoomable = [...container.querySelectorAll('.zoomable-image')]
+      const images = allZoomable.map(el => {
+        if (el.tagName === 'IMG') {
+          return `<img src="${el.src}" alt="${el.alt || ''}" style="max-width: 100%; height: auto;" />`
+        }
+        const clone = el.cloneNode(true)
+        clone.querySelectorAll('.mermaid-copy-btn, .image-copy-btn').forEach(btn => btn.remove())
+        return clone.innerHTML
+      })
+      const clickedEl = isImg ? target : mermaidEl
+      const index = allZoomable.indexOf(clickedEl)
+      onZoom({ images, index: Math.max(index, 0) })
+      return
+    }
+
+    // 链接处理
     const link = target.closest('a')
     if (link) {
+      // 标题锚点点击：复制链接 + 跳转 + 高亮
+      if (link.classList.contains('heading-anchor')) {
+        event.preventDefault()
+        const anchorId = link.dataset.anchor
+        if (anchorId) {
+          copyAnchorLink(anchorId, link)
+          scrollToHeading(anchorId, { push: true })
+          // 触发高亮闪烁动画
+          const heading = document.getElementById(anchorId)
+          if (heading) {
+            heading.classList.remove('heading-flash')
+            void heading.offsetWidth // 强制 reflow 重置动画
+            heading.classList.add('heading-flash')
+            heading.addEventListener('animationend', () => heading.classList.remove('heading-flash'), { once: true })
+          }
+        }
+        return
+      }
       const docKey = link.dataset.docKey
       if (docKey) {
         event.preventDefault()
         const anchor = link.dataset.anchor || ''
         expandParents(docsList.value, docKey)
+        saveExpandedState()
         loadDoc(docKey).then(async () => {
           if (anchor) { await nextTick(); await waitForContentImages(); scrollToHeading(anchor) }
         })
@@ -160,69 +308,169 @@ export function useDocManager() {
       }
       return
     }
-    // 图片/Mermaid 放大（收集所有可放大元素，支持左右切换）
-    const isImg = target.tagName === 'IMG' && target.classList.contains('zoomable-image')
-    const mermaidEl = target.closest('.mermaid')
-    const isMermaid = mermaidEl && mermaidEl.classList.contains('zoomable-image')
-    if (isImg || isMermaid) {
-      const container = document.querySelector('.markdown-content')
-      if (!container) return
-      // 收集所有可放大元素
-      const allZoomable = [...container.querySelectorAll('.zoomable-image')]
-      const images = allZoomable.map(el => {
-        if (el.tagName === 'IMG') {
-          return `<img src="${el.src}" alt="${el.alt || ''}" style="max-width: 100%; height: auto;" />`
-        }
-        return el.innerHTML
-      })
-      const clickedEl = isImg ? target : mermaidEl
-      const index = allZoomable.indexOf(clickedEl)
-      onZoom({ images, index: Math.max(index, 0) })
-    }
   }
 
-  // 当前文档标题
+  // ===== 计算属性 =====
   const currentDocTitle = computed(() => {
     if (!currentDoc.value) return '文档'
     const doc = findDoc(docsList.value, currentDoc.value)
     return doc?.label || '文档'
   })
 
-  // 上一篇/下一篇
+  // 扁平化文档列表（缓存，供 prevDoc / nextDoc 共享）
+  const flatList = computed(() => flattenDocsList(docsList.value))
+
   const prevDoc = computed(() => {
     if (!currentDoc.value) return null
-    const flat = flattenDocsList(docsList.value)
-    const idx = flat.findIndex(d => d.key === currentDoc.value)
-    return idx > 0 ? flat[idx - 1] : null
+    const idx = flatList.value.findIndex(d => d.key === currentDoc.value)
+    return idx > 0 ? flatList.value[idx - 1] : null
   })
 
   const nextDoc = computed(() => {
     if (!currentDoc.value) return null
-    const flat = flattenDocsList(docsList.value)
-    const idx = flat.findIndex(d => d.key === currentDoc.value)
-    return idx >= 0 && idx < flat.length - 1 ? flat[idx + 1] : null
+    const idx = flatList.value.findIndex(d => d.key === currentDoc.value)
+    return idx >= 0 && idx < flatList.value.length - 1 ? flatList.value[idx + 1] : null
   })
 
-  // 搜索结果选中
   function handleSearchSelect(key) {
     expandParents(docsList.value, key)
+    saveExpandedState()
     loadDoc(key)
   }
 
-  // URL 路由（popstate / 初始加载）
+  // ===== 编辑模式 =====
+  function toggleEditMode() {
+    editMode.value = !editMode.value
+    sessionStorage.setItem('editMode', editMode.value)
+  }
+
+  watch(editMode, async (newVal, oldVal) => {
+    if (oldVal && !newVal && rawMarkdown.value && currentDoc.value) {
+      await renderMarkdown(rawMarkdown.value, currentDoc.value, docsList.value)
+      await nextTick()
+      rebuildHeadingsCache()
+    }
+    if (newVal && rawMarkdown.value) {
+      extractTOCFromMarkdown(rawMarkdown.value, tocItems)
+      await nextTick()
+      rebuildHeadingsCache()
+    }
+  })
+
+  watch(rawMarkdown, (md) => {
+    if (editMode.value && md) {
+      extractTOCFromMarkdown(md, tocItems)
+    }
+  })
+
+  // ===== 轮询回调（供 useFileWatcher 调用） =====
+
+  // 树结构指纹，快速判断是否有变化
+  function treeFingerprint(items) {
+    const parts = []
+    for (const item of items) {
+      parts.push(item.key)
+      if (item.type === 'folder' && item.children) {
+        parts.push('{', treeFingerprint(item.children), '}')
+      }
+    }
+    return parts.join(',')
+  }
+
+  function getExpandedKeys(items) {
+    const keys = new Set()
+    for (const item of items) {
+      if (item.type === 'folder') {
+        if (item.expanded) keys.add(item.key)
+        if (item.children) for (const k of getExpandedKeys(item.children)) keys.add(k)
+      }
+    }
+    return keys
+  }
+
+  function applyExpandedState(items, expandedKeys) {
+    for (const item of items) {
+      if (item.type === 'folder') {
+        if (expandedKeys.has(item.key)) item.expanded = true
+        if (item.children) applyExpandedState(item.children, expandedKeys)
+      }
+    }
+  }
+
+  // 刷新文档列表（轮询回调 或 手动调用）
+  async function reloadDocsList(newTree) {
+    if (!newTree) {
+      // 手动调用（创建/删除/重命名后），强制拉取最新
+      docService.resetListEtag()
+      newTree = await docService.fetchDocsList()
+    }
+    // 结构没变就跳过
+    if (docsList.value.length > 0 && treeFingerprint(docsList.value) === treeFingerprint(newTree)) {
+      return
+    }
+    // 保存展开状态 → 替换 → 恢复
+    const expandedKeys = getExpandedKeys(docsList.value)
+    docsList.value = newTree
+    buildHashIndex(docsList.value, docHash)
+    applyExpandedState(docsList.value, expandedKeys)
+    if (currentDoc.value) expandParents(docsList.value, currentDoc.value)
+    buildIndex(docsList.value)
+    saveExpandedState()
+  }
+
+  // 刷新当前文档内容（轮询回调）
+  let lastContentHash = ''
+  async function reloadCurrentDoc(content) {
+    if (!currentDoc.value) return
+    // 哈希比对，内容没变就跳过
+    let hash = 0
+    for (let i = 0; i < content.length; i++) {
+      hash = ((hash << 5) - hash + content.charCodeAt(i)) | 0
+    }
+    const hashStr = String(hash)
+    if (hashStr === lastContentHash) return
+    lastContentHash = hashStr
+    // 编辑模式下编辑器是内容权威来源，不回写 rawMarkdown 避免循环抖动
+    if (editMode.value) return
+    rawMarkdown.value = content
+    await renderMarkdown(content, currentDoc.value, docsList.value)
+    rebuildHeadingsCache()
+  }
+
+  // ===== 写操作 =====
+  async function saveDocContent({ path: filePath, content }) {
+    try {
+      const ok = await docService.saveDoc(filePath, content)
+      if (ok) {
+        rawMarkdown.value = content
+        if (!editMode.value) {
+          await renderMarkdown(content, currentDoc.value, docsList.value)
+        }
+        return true
+      }
+      return false
+    } catch (e) {
+      console.error('保存失败:', e)
+      return false
+    }
+  }
+
+  function getCurrentDocPath() {
+    return currentDocFilePath.value
+  }
+
+  // ===== URL 路由 =====
   async function loadFromUrl() {
     const pathname = window.location.pathname.replace(/^\//, '')
     const anchor = window.location.hash.replace('#', '')
     const savedScroll = history.state?.scrollTop
     if (!pathname) {
       if (currentDoc.value) {
-        // 浏览器回退到首页，不操作 history
         goHome({ isPopstate: true })
       } else if (docsList.value.length === 0) {
         showWelcome.value = false
         renderMarkdown('# 当前目录没有 Markdown 文档\n\n请在当前目录下添加 `.md` 文件，然后刷新页面。')
       } else {
-        // 优先定位到 README，没有则定位到第一篇文档
         const readme = findReadmeDoc(docsList.value)
         const target = readme || findFirstDoc(docsList.value)
         if (target) {
@@ -234,14 +482,13 @@ export function useDocManager() {
     }
     const doc = findDocByHash(docsList.value, pathname, docHash)
     if (!doc) return
-    // 同一文档内的锚点变化（含回退）
     if (doc.key === currentDoc.value) {
       await nextTick()
       if (savedScroll != null) {
-        // 有保存的滚动位置，直接恢复（回退场景）
         const contentEl = document.querySelector('.content')
         if (contentEl) contentEl.scrollTo({ top: savedScroll, behavior: 'smooth' })
       } else if (anchor) {
+        // popstate 同文档锚点跳转，_scrollToHeading 内部有锁
         _scrollToHeading(decodeURIComponent(anchor))
       } else {
         const contentEl = document.querySelector('.content')
@@ -250,48 +497,148 @@ export function useDocManager() {
       return
     }
     expandParents(docsList.value, doc.key)
+    saveExpandedState()
     await loadDoc(doc.key, { replace: true, keepState: savedScroll != null, anchor: anchor ? decodeURIComponent(anchor) : '' })
     if (savedScroll != null) {
       await nextTick()
+      await waitForContentImages()
       const contentEl = document.querySelector('.content')
       if (contentEl) contentEl.scrollTo({ top: savedScroll })
     } else if (anchor) {
-      await nextTick(); await waitForContentImages(); _scrollToHeading(decodeURIComponent(anchor))
+      const decodedAnchor = decodeURIComponent(anchor)
+      await nextTick(); await waitForContentImages()
+      // 复用 scrollToHeading，编辑模式下通过 _syncHeadingIds 注入的 id 或文本匹配均可定位
+      _scrollToHeading(decodedAnchor)
+    }
+  }
+
+  // ===== 文档管理操作 =====
+  async function createDoc({ parentKey, name, type }) {
+    const relativePath = parentKey ? `${parentKey}/${name}` : name
+    const apiPath = type === 'file' ? `${relativePath}.md` : relativePath
+    try {
+      await docService.createDoc(apiPath, type)
+      await reloadDocsList()
+      if (parentKey) expandParents(docsList.value, relativePath)
+      if (type === 'file') await loadDoc(relativePath)
+      return { ok: true }
+    } catch (e) {
+      return { ok: false, message: e.message }
+    }
+  }
+
+  async function renameDoc(item, newName) {
+    const parts = item.key.split('/')
+    parts[parts.length - 1] = newName
+    const newKey = parts.join('/')
+    const oldPath = item.type === 'file' ? `${item.key}.md` : item.key
+    const newPath = item.type === 'file' ? `${newKey}.md` : newKey
+    try {
+      await docService.renameDoc(oldPath, newPath)
+      const wasCurrentDoc = item.type === 'file' && item.key === currentDoc.value
+      const wasInFolder = item.type === 'folder' && currentDoc.value.startsWith(item.key + '/')
+      await reloadDocsList()
+      if (wasCurrentDoc) {
+        expandParents(docsList.value, newKey)
+        await loadDoc(newKey, { replace: true })
+      }
+      if (wasInFolder) {
+        const newDocKey = currentDoc.value.replace(item.key + '/', newKey + '/')
+        expandParents(docsList.value, newDocKey)
+        await loadDoc(newDocKey, { replace: true })
+      }
+      return { ok: true }
+    } catch (e) {
+      return { ok: false, message: e.message }
+    }
+  }
+
+  async function deleteDoc(item) {
+    const apiPath = item.type === 'file' ? `${item.key}.md` : item.key
+    try {
+      await docService.deleteDoc(apiPath)
+      if (item.type === 'file' && item.key === currentDoc.value) goHome()
+      if (item.type === 'folder' && currentDoc.value.startsWith(item.key + '/')) goHome()
+      await reloadDocsList()
+      return { ok: true }
+    } catch (e) {
+      return { ok: false, message: e.message }
+    }
+  }
+
+  // ===== 拖拽排序 =====
+  function calcPadWidth(count) { return count < 100 ? 2 : String(count - 1).length }
+  function orderPrefix(index, padWidth) { return String(index).padStart(padWidth, '0') }
+  function stripPrefix(name) { return name.replace(/^\d+-/, '') }
+
+  function collectReorderItems(items, parentPath = '') {
+    const result = []
+    const padWidth = calcPadWidth(items.length)
+    items.forEach((item, index) => {
+      const prefix = orderPrefix(index, padWidth)
+      const pureName = stripPrefix(item.label || item.key.split('/').pop())
+      const newName = `${prefix}-${pureName}`
+      const oldName = item.key.split('/').pop()
+      const oldFsName = item.type === 'file' ? `${oldName}.md` : oldName
+      const newFsName = item.type === 'file' ? `${newName}.md` : newName
+      const oldPath = parentPath ? `${parentPath}/${oldFsName}` : oldFsName
+      const newPath = parentPath ? `${parentPath}/${newFsName}` : newFsName
+      if (oldPath !== newPath) result.push({ oldPath, newPath })
+    })
+    return result
+  }
+
+  function collectAllReorderLevels(items, parentPath = '') {
+    const levels = []
+    items.forEach((item) => {
+      if (item.type === 'folder' && item.children) {
+        const folderPath = parentPath ? `${parentPath}/${item.key.split('/').pop()}` : item.key.split('/').pop()
+        levels.push(...collectAllReorderLevels(item.children, folderPath))
+      }
+    })
+    const currentLevelItems = collectReorderItems(items, parentPath)
+    if (currentLevelItems.length > 0) levels.push(currentLevelItems)
+    return levels
+  }
+
+  async function reorderDocs() {
+    const levels = collectAllReorderLevels(docsList.value)
+    if (levels.length === 0) return { ok: true }
+    const currentPureName = currentDoc.value ? stripOrderPrefix(currentDoc.value) : ''
+    try {
+      for (const levelItems of levels) {
+        if (levelItems.length === 0) continue
+        await docService.reorderDocs(levelItems)
+      }
+      await reloadDocsList()
+      if (currentPureName) {
+        const flat = flattenDocsList(docsList.value)
+        const match = flat.find(d => stripOrderPrefix(d.key) === currentPureName)
+        if (match) {
+          expandParents(docsList.value, match.key)
+          await loadDoc(match.key, { replace: true })
+        }
+      }
+      return { ok: true }
+    } catch (e) {
+      console.error('重编号失败:', e)
+      return { ok: false, message: e.message }
     }
   }
 
+  // ===== 导出 =====
   return {
-    // 状态
-    docsList,
-    currentDoc,
-    currentDocTitle,
-    showWelcome,
-    htmlContent,
-    tocItems,
-    // 滚动
-    scrollProgress,
-    showBackToTop,
-    activeHeading,
-    handleScroll,
-    scrollToHeading,
-    scrollToTop,
-    // 文档操作
-    loadDocsList,
-    loadFromUrl,
-    goHome,
-    loadDoc,
-    loadFirstDoc,
-    handleDocSelect,
-    handleContentClick,
-    handleSearchSelect,
-    // 文件夹操作
-    toggleFolder,
-    onExpandAll,
-    onCollapseAll,
-    // 导航
-    prevDoc,
-    nextDoc,
-    // 工具
+    docsList, currentDoc, currentDocTitle, showWelcome, htmlContent, tocItems,
+    editMode, rawMarkdown, currentDocFilePath, lastModified,
+    scrollProgress, showBackToTop, activeHeading,
+    handleScroll, scrollToHeading, scrollToTop,
+    loadDocsList, loadFromUrl, goHome, loadDoc, loadFirstDoc,
+    handleDocSelect, handleContentClick, handleSearchSelect,
+    toggleEditMode, reloadDocsList, reloadCurrentDoc,
+    saveDoc: saveDocContent, getCurrentDocPath,
+    toggleFolder, onExpandAll, onCollapseAll,
+    prevDoc, nextDoc,
+    createDoc, deleteDoc, renameDoc, reorderDocs,
     docHash
   }
 }