@tnotesjs/core 0.1.0

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

@@ -0,0 +1,121 @@
+import { ref, computed, watch } from 'vue'
+import type { Ref } from 'vue'
+import { useData } from 'vitepress'
+import type { NoteConfig } from '../../../../types'
+
+/**
+ * 管理笔记配置状态
+ * 包括可编辑字段、原始值、变更检测等
+ */
+export function useNoteConfig(
+  currentNoteId: Ref<string>,
+  currentNoteConfig: Ref<NoteConfig | null>,
+  currentNoteTitle: Ref<string>,
+  timeModalOpen: Ref<boolean>
+) {
+  const vpData = useData()
+
+  // 可编辑的配置项
+  const editableNoteStatus = ref(false)
+  const editableDiscussionsEnabled = ref(false)
+  const editableNoteTitle = ref('')
+  const editableDescription = ref('')
+
+  // 原始配置（用于检测是否有变更）
+  const originalNoteStatus = ref(false)
+  const originalDiscussionsEnabled = ref(false)
+  const originalNoteTitle = ref('')
+  const originalDescription = ref('')
+
+  // 标题验证错误信息
+  const titleError = ref('')
+
+  // 检测是否有配置变更
+  const hasConfigChanges = computed(() => {
+    return (
+      editableNoteStatus.value !== originalNoteStatus.value ||
+      editableDiscussionsEnabled.value !== originalDiscussionsEnabled.value ||
+      editableDescription.value.trim() !== originalDescription.value ||
+      (editableNoteTitle.value.trim() !== originalNoteTitle.value &&
+        !titleError.value)
+    )
+  })
+
+  // 初始化可编辑字段
+  function initEditableFields() {
+    if (!currentNoteConfig.value) return
+
+    editableNoteStatus.value = currentNoteConfig.value.done || false
+    editableDiscussionsEnabled.value =
+      currentNoteConfig.value.enableDiscussions || false
+    editableNoteTitle.value = currentNoteTitle.value || ''
+    editableDescription.value = currentNoteConfig.value.description || ''
+
+    // 保存原始值
+    originalNoteStatus.value = editableNoteStatus.value
+    originalDiscussionsEnabled.value = editableDiscussionsEnabled.value
+    originalNoteTitle.value = editableNoteTitle.value
+    originalDescription.value = editableDescription.value
+
+    // 清除错误信息
+    titleError.value = ''
+  }
+
+  // 重置笔记配置
+  function resetNoteConfig() {
+    editableNoteStatus.value = originalNoteStatus.value
+    editableDiscussionsEnabled.value = originalDiscussionsEnabled.value
+    editableNoteTitle.value = originalNoteTitle.value
+    editableDescription.value = originalDescription.value
+    titleError.value = ''
+  }
+
+  // 更新原始值（保存成功后调用）
+  function updateOriginalValues() {
+    originalNoteStatus.value = editableNoteStatus.value
+    originalDiscussionsEnabled.value = editableDiscussionsEnabled.value
+    originalNoteTitle.value = editableNoteTitle.value.trim()
+    originalDescription.value = editableDescription.value.trim()
+  }
+
+  // 监听笔记配置变化，重新初始化字段
+  watch(
+    () => currentNoteConfig.value,
+    () => {
+      initEditableFields()
+    },
+    { immediate: true }
+  )
+
+  // modal 打开时重新初始化（确保数据最新）
+  watch(timeModalOpen, (isOpen) => {
+    if (isOpen) {
+      initEditableFields()
+    }
+  })
+
+  return {
+    // 可编辑字段
+    editableNoteStatus,
+    editableDiscussionsEnabled,
+    editableNoteTitle,
+    editableDescription,
+
+    // 原始值
+    originalNoteStatus,
+    originalDiscussionsEnabled,
+    originalNoteTitle,
+    originalDescription,
+
+    // 验证
+    titleError,
+
+    // 计算属性
+    hasConfigChanges,
+
+    // 方法
+    initEditableFields,
+    resetNoteConfig,
+    updateOriginalValues,
+  }
+}

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

@@ -0,0 +1,173 @@
+import { ref, computed } from 'vue'
+import type { Ref, ComputedRef } from 'vue'
+import { useData } from 'vitepress'
+import type { NoteConfig } from '../../../../types'
+
+/**
+ * 处理笔记配置的保存和重置逻辑
+ */
+export function useNoteSave(
+  currentNoteId: Ref<string>,
+  isDev: Ref<boolean> | ComputedRef<boolean>,
+  hasConfigChanges: ComputedRef<boolean>,
+  titleError: Ref<string>,
+  editableNoteTitle: Ref<string>,
+  originalNoteTitle: Ref<string>,
+  editableNoteStatus: Ref<boolean>,
+  originalNoteStatus: Ref<boolean>,
+  editableDiscussionsEnabled: Ref<boolean>,
+  originalDiscussionsEnabled: Ref<boolean>,
+  editableDescription: Ref<string>,
+  originalDescription: Ref<string>,
+  allNotesConfig: Record<string, NoteConfig & { redirect?: string }>,
+  updateOriginalValues: () => void
+) {
+  const vpData = useData()
+
+  // 保存状态
+  const isSaving = ref(false)
+  const showSuccessToast = ref(false)
+  const savingMessage = ref('') // 保存进度提示
+
+  // 保存按钮文本
+  const saveButtonText = computed(() => {
+    if (isSaving.value) return '保存中...'
+    if (!hasConfigChanges.value) return '无更改'
+    return '保存配置'
+  })
+
+  // 保存笔记配置
+  async function saveNoteConfig() {
+    if (!currentNoteId.value || !isDev.value || !hasConfigChanges.value) return
+
+    // 验证标题
+    if (titleError.value) {
+      alert('❌ 请修正标题错误后再保存')
+      return
+    }
+
+    const titleChanged =
+      editableNoteTitle.value.trim() !== originalNoteTitle.value &&
+      editableNoteTitle.value.trim()
+
+    isSaving.value = true
+    savingMessage.value = '正在保存配置...'
+
+    try {
+      // 如果标题有变化,先重命名文件夹
+      if (titleChanged) {
+        savingMessage.value = '正在重命名文件夹...'
+
+        const renameResponse = await fetch('/__tnotes_rename_note', {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+          },
+          body: JSON.stringify({
+            noteIndex: currentNoteId.value,
+            newTitle: editableNoteTitle.value.trim(),
+          }),
+        })
+
+        if (!renameResponse.ok) {
+          const error = await renameResponse.text()
+          throw new Error(`重命名失败: ${error}`)
+        }
+
+        // 后端已经完成所有更新,包括文件系统同步
+        const result = await renameResponse.json()
+        console.log('重命名完成:', result)
+
+        savingMessage.value = '文件已同步,准备跳转...'
+      }
+
+      // 检查是否需要更新配置（无论标题是否改变）
+      const needConfigUpdate =
+        editableNoteStatus.value !== originalNoteStatus.value ||
+        editableDiscussionsEnabled.value !== originalDiscussionsEnabled.value ||
+        editableDescription.value.trim() !== originalDescription.value
+
+      if (needConfigUpdate) {
+        savingMessage.value = '正在更新笔记配置...'
+
+        const response = await fetch('/__tnotes_update_config', {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+          },
+          body: JSON.stringify({
+            noteIndex: currentNoteId.value,
+            config: {
+              done: editableNoteStatus.value,
+              enableDiscussions: editableDiscussionsEnabled.value,
+              description: editableDescription.value.trim(),
+            },
+          }),
+        })
+
+        if (!response.ok) {
+          const error = await response.text()
+          throw new Error(error || '保存失败')
+        }
+      }
+
+      // 更新原始值
+      updateOriginalValues()
+
+      // 更新本地配置（立即反映在页面上）
+      if (allNotesConfig[currentNoteId.value]) {
+        allNotesConfig[currentNoteId.value].done = editableNoteStatus.value
+        allNotesConfig[currentNoteId.value].enableDiscussions =
+          editableDiscussionsEnabled.value
+        allNotesConfig[currentNoteId.value].description =
+          editableDescription.value.trim()
+      }
+
+      savingMessage.value = '保存成功！'
+
+      // 显示成功提示
+      showSuccessToast.value = true
+      setTimeout(() => {
+        showSuccessToast.value = false
+      }, 3000)
+
+      // 如果标题改变了,先跳转到loading页,再由loading页根据configId查询目标URL
+      if (titleChanged) {
+        // 获取当前笔记的 configId (UUID)
+        const configId = allNotesConfig[currentNoteId.value]?.id
+
+        if (!configId) {
+          throw new Error('无法获取笔记的 configId')
+        }
+
+        // 跳转到loading页,传递 configId 参数
+        const base = vpData.site.value.base || '/'
+        const loadingUrl = `${base}loading?configId=${encodeURIComponent(
+          configId
+        )}`
+        window.location.href = loadingUrl
+      }
+    } catch (error) {
+      console.error('保存配置失败:', error)
+      savingMessage.value = ''
+
+      alert(
+        '❌ 保存失败: ' +
+          (error instanceof Error ? error.message : String(error))
+      )
+    } finally {
+      if (!titleChanged) {
+        isSaving.value = false
+        savingMessage.value = ''
+      }
+    }
+  }
+
+  return {
+    isSaving,
+    showSuccessToast,
+    savingMessage,
+    saveButtonText,
+    saveNoteConfig,
+  }
+}

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

@@ -0,0 +1,85 @@
+import type { Ref } from 'vue'
+
+/**
+ * 笔记标题验证
+ */
+export function useNoteValidation() {
+  // 标题验证函数
+  function validateTitle(title: string): string | null {
+    // 非法字符正则
+    const invalidChars = /[<>:"/\\|?*\x00-\x1F]/
+    const windowsReservedNames = new Set([
+      'CON',
+      'PRN',
+      'AUX',
+      'NUL',
+      'COM1',
+      'COM2',
+      'COM3',
+      'COM4',
+      'COM5',
+      'COM6',
+      'COM7',
+      'COM8',
+      'COM9',
+      'LPT1',
+      'LPT2',
+      'LPT3',
+      'LPT4',
+      'LPT5',
+      'LPT6',
+      'LPT7',
+      'LPT8',
+      'LPT9',
+    ])
+
+    if (!title || title.trim().length === 0) {
+      return '标题不能为空'
+    }
+
+    const trimmedTitle = title.trim()
+
+    if (trimmedTitle.length > 200) {
+      return '标题过长(最多200个字符)'
+    }
+
+    if (invalidChars.test(trimmedTitle)) {
+      return '标题包含非法字符(不允许: < > : " / \\ | ? *)'
+    }
+
+    if (/^[.\s]|[.\s]$/.test(trimmedTitle)) {
+      return '标题不能以点或空格开头/结尾'
+    }
+
+    const upperTitle = trimmedTitle.toUpperCase()
+    if (windowsReservedNames.has(upperTitle)) {
+      return `"${trimmedTitle}" 是 Windows 系统保留名称`
+    }
+
+    const baseName = trimmedTitle.split('.')[0].toUpperCase()
+    if (windowsReservedNames.has(baseName)) {
+      return `"${trimmedTitle}" 包含 Windows 系统保留名称`
+    }
+
+    return null
+  }
+
+  // 标题输入事件处理器
+  function onTitleInput(editableNoteTitle: Ref<string>, titleError: Ref<string>) {
+    const error = validateTitle(editableNoteTitle.value)
+    titleError.value = error || ''
+  }
+
+  // 标题失焦事件处理器
+  function onTitleBlur(editableNoteTitle: Ref<string>, titleError: Ref<string>) {
+    // 去除首尾空格
+    editableNoteTitle.value = editableNoteTitle.value.trim()
+    onTitleInput(editableNoteTitle, titleError)
+  }
+
+  return {
+    validateTitle,
+    onTitleInput,
+    onTitleBlur,
+  }
+}

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

@@ -0,0 +1,110 @@
+import { ref, watch } from 'vue'
+import { useRoute, useData } from 'vitepress'
+
+import type { NoteConfig } from '../../../../types'
+
+/**
+ * 处理 404 重定向逻辑
+ * 当用户访问旧的笔记 URL 时,自动重定向到新的 URL
+ */
+export function useRedirect(allNotesConfig: Record<string, NoteConfig & { redirect?: string }>) {
+  const route = useRoute()
+  const vpData = useData()
+
+  // 控制是否显示 404 内容
+  const showNotFound = ref(false)
+  const currentPath = ref('')
+  const matchedId = ref('')
+  const redirectPath = ref('')
+
+  // 解码后的当前路径(用于调试)
+  const decodedCurrentPath = ref('')
+
+  // 重定向检查函数
+  function checkRedirect() {
+    if (typeof window === 'undefined') return false
+
+    currentPath.value = window.location.pathname
+
+    // 匹配路径格式：/TNotes.*/notes/四个数字{任意内容}/README
+    const match = currentPath.value.match(
+      /\/TNotes[^/]+\/notes\/(\d{4})[^/]*(?:\/.*)?$/
+    )
+
+    if (match) {
+      matchedId.value = match[1]
+      const targetNote = allNotesConfig[matchedId.value]
+      redirectPath.value = targetNote ? targetNote.redirect : ''
+
+      if (targetNote && targetNote.redirect) {
+        const base = vpData.site.value.base
+        // 构建目标路径（包含基础路径）
+        const targetPath = `${base}${targetNote.redirect}`
+
+        // 避免重定向死循环
+        if (currentPath.value !== targetPath) {
+          console.log(`Redirecting from ${currentPath.value} to ${targetPath}`)
+
+          // 使用完整的页面跳转（强制刷新）
+          window.location.href = targetPath
+          return true
+        }
+      }
+    }
+    return false
+  }
+
+  // 更新解码后的路径
+  function updateDecodedPath() {
+    try {
+      decodedCurrentPath.value = decodeURIComponent(currentPath.value)
+    } catch (e) {
+      console.error('Failed to decode URI:', e)
+      decodedCurrentPath.value = currentPath.value
+    }
+  }
+
+  // 初始化检查(在组件挂载后调用)
+  function initRedirectCheck() {
+    // 延迟执行以确保路由状态稳定
+    setTimeout(() => {
+      // 如果是 404 页面,尝试重定向
+      if (vpData.page.value.isNotFound) {
+        const redirected = checkRedirect()
+
+        // 如果重定向失败,显示原始 404 内容
+        if (!redirected) {
+          showNotFound.value = true
+        }
+      }
+    }, 1000)
+  }
+
+  // 监听路由变化
+  watch(
+    () => route.path,
+    () => {
+      // 延迟检查以确保路由更新完成
+      setTimeout(() => {
+        if (vpData.page.value.isNotFound) {
+          const redirected = checkRedirect()
+          if (!redirected) {
+            showNotFound.value = true
+          }
+        }
+      }, 1000)
+    }
+  )
+
+  // 监听 currentPath 变化,更新解码后的路径
+  watch(currentPath, updateDecodedPath, { immediate: true })
+
+  return {
+    showNotFound,
+    currentPath,
+    matchedId,
+    redirectPath,
+    decodedCurrentPath,
+    initRedirectCheck,
+  }
+}

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

@@ -0,0 +1,85 @@
+import { ref } from 'vue'
+import type { Ref, ComputedRef } from 'vue'
+import { useData } from 'vitepress'
+import type { Router } from 'vitepress'
+import { NOTES_DIR_KEY } from '../../constants'
+
+/**
+ * VSCode 集成和 GitHub 链接拦截
+ */
+export function useVSCodeIntegration() {
+  const vpData = useData()
+  const vscodeNotesDir = ref('')
+
+  // 更新 VSCode 笔记目录
+  const updateVscodeNoteDir = () => {
+    if (typeof window !== 'undefined') {
+      const notesDir = localStorage.getItem(NOTES_DIR_KEY)
+      vscodeNotesDir.value = notesDir
+        ? `vscode://file/${notesDir}/${vpData.page.value.relativePath}`
+        : ''
+    }
+  }
+
+  // 拦截 home README 中的笔记链接，将 GitHub 链接转换为站点内跳转
+  const interceptHomeReadmeLinks = (
+    isHomeReadme: Ref<boolean> | ComputedRef<boolean>,
+    router: Router,
+  ) => {
+    if (typeof window === 'undefined') return
+
+    // 只在 home README 页面执行
+    if (!isHomeReadme.value) return
+
+    // 延迟执行，确保 DOM 已渲染
+    setTimeout(() => {
+      const content = document.querySelector('.vp-doc')
+      if (!content) return
+
+      // 查找所有指向 GitHub 的笔记链接
+      const links = content.querySelectorAll(
+        'a[href*="github.com"][href*="/notes/"]',
+      )
+
+      links.forEach((link) => {
+        const href = link.getAttribute('href')
+        if (!href) return
+
+        // 匹配 GitHub 链接格式：https://github.com/{owner}/{repo}/tree/main/notes/{noteDir}/README.md
+        const match = href.match(
+          /github\.com\/[^/]+\/[^/]+\/tree\/main\/notes\/([^/]+)\/README\.md/,
+        )
+
+        if (match) {
+          const encodedNoteDir = match[1]
+          const noteDir = decodeURIComponent(encodedNoteDir)
+
+          // 构建站点内的相对路径
+          const base = vpData.site.value.base || '/'
+          const internalPath = `${base}notes/${noteDir}/README`
+
+          // 移除原有的点击事件监听器（如果有）
+          const newLink = link.cloneNode(true) as HTMLElement
+
+          // 添加点击事件拦截
+          newLink.addEventListener('click', (e) => {
+            e.preventDefault()
+            router.go(internalPath)
+          })
+
+          // 更新 href 属性（用于悬停显示和右键菜单）
+          newLink.setAttribute('href', internalPath)
+
+          // 替换原链接
+          link.parentNode?.replaceChild(newLink, link)
+        }
+      })
+    }, 100)
+  }
+
+  return {
+    vscodeNotesDir,
+    updateVscodeNoteDir,
+    interceptHomeReadmeLinks,
+  }
+}

package/vitepress/components/Layout/homeReadme.data.ts

@@ -0,0 +1,124 @@
+// .vitepress/components/Layout/homeReadme.data.ts
+import fs from 'node:fs'
+import { execSync } from 'node:child_process'
+import path from 'node:path'
+
+const rootPath = process.cwd()
+
+interface ReadmeData {
+  fileContent: string
+  doneNotesID: string[]
+  doneNotesLen: number
+  totalNotesLen: number
+  created_at?: number
+  updated_at?: number
+}
+
+export default {
+  watch: [path.resolve(rootPath, 'README.md'), path.resolve(rootPath, 'notes')],
+  load(watchedFiles: string[]): ReadmeData {
+    let readmeData: ReadmeData = {
+      fileContent: '',
+      doneNotesID: [],
+      doneNotesLen: 0,
+      totalNotesLen: 0,
+    }
+
+    watchedFiles.forEach((file) => {
+      if (file.endsWith('README.md')) {
+        // console.log('file:', file) // => file: README.md
+
+        const fileContent = fs.readFileSync(file, 'utf-8')
+        const doneNotesID = getDoneNotesID(fileContent)
+        const doneNotesLen = doneNotesID.length
+
+        // 获取 git 仓库的时间戳
+        const timestamps = getGitTimestamps()
+
+        // 计算总笔记数
+        const notesDir = path.join(path.dirname(file), 'notes')
+        const totalNotesLen = getTotalNotesCount(notesDir)
+
+        readmeData = {
+          fileContent,
+          doneNotesID,
+          doneNotesLen,
+          totalNotesLen,
+          ...timestamps,
+        }
+      }
+    })
+    return readmeData
+  },
+}
+
+/**
+ * 获取 notes 目录下的笔记总数
+ * @param notesDir notes 目录路径
+ * @returns 笔记总数
+ */
+function getTotalNotesCount(notesDir: string): number {
+  try {
+    if (!fs.existsSync(notesDir)) return 0
+
+    const dirs = fs.readdirSync(notesDir, { withFileTypes: true })
+    // 统计符合格式 "0001. xxx" 的目录
+    return dirs.filter(
+      (dirent) => dirent.isDirectory() && /^\d{4}\./.test(dirent.name),
+    ).length
+  } catch (error) {
+    console.error(`获取笔记总数失败:`, error)
+    return 0
+  }
+}
+
+/**
+ * 获取 git 仓库的时间戳
+ * @returns 包含 created_at 和 updated_at 的对象
+ */
+function getGitTimestamps(): {
+  created_at?: number
+  updated_at?: number
+} {
+  const now = Date.now()
+  let created_at = now
+  let updated_at = now
+
+  try {
+    // 仓库的首次提交时间（最早的提交）
+    // 先获取所有提交，然后取第一行
+    const createdStdout = execSync(`git log --reverse --format=%ct`, {
+      encoding: 'utf-8',
+    })
+    const createdTs = createdStdout.toString().trim().split('\n')[0]
+    if (createdTs) {
+      created_at = parseInt(createdTs, 10) * 1000
+    }
+
+    // 仓库的最近一次提交时间
+    const updatedStdout = execSync(`git log -1 --format=%ct`, {
+      encoding: 'utf-8',
+    })
+    const updatedTs = updatedStdout.toString().trim()
+    if (updatedTs) {
+      updated_at = parseInt(updatedTs, 10) * 1000
+    }
+
+    return { created_at, updated_at }
+  } catch (error) {
+    console.error(`获取 git 仓库时间戳失败:`, error)
+    return { created_at, updated_at }
+  }
+}
+
+/**
+ * 返回已完成的笔记的 ID 列表
+ * @param fileContent 文件内容
+ * @returns 已完成的笔记的 ID 列表
+ */
+function getDoneNotesID(fileContent: string): string[] {
+  const matches = fileContent.match(/- \[x\]\s\[(\d{4})\./g)
+  return matches
+    ? [...new Set(matches.map((match) => match.slice(-5, -1)))]
+    : []
+}