fix(plugin-git): support submodule

plugins/development/plugin-git/src/client/composables/useChangelog.ts

@@ -42,7 +42,7 @@ export const useChangelog =
         >()
 
         const { pattern = {}, provider } = gitOptions
-        const repo = resolveRepoLink(gitOptions.repo, provider)
+        const mainRepo = resolveRepoLink(gitOptions.repo, provider)
 
         return computed(() => {
           if (frontmatter.value.changelog === false || !toValue(enabled))
@@ -58,6 +58,8 @@ export const useChangelog =
               item,
             )
 
+            const repo = item.submodule?.repoUrl ?? mainRepo
+
             if (pattern.issue && repo) {
               res.message = res.message.replace(
                 RE_ISSUE,

plugins/development/plugin-git/src/node/gitPlugin.ts

@@ -15,6 +15,7 @@ import { resolveContributors } from './resolveContributors.js'
 import {
   PLUGIN_NAME,
   checkGitRepo,
+  clearGitRepoRootCache,
   getCommits,
   inferGitProvider,
   injectGitOptions,
@@ -145,6 +146,10 @@ export const gitPlugin =
         })
       },
 
+      onPrepared: () => {
+        clearGitRepoRootCache()
+      },
+
       clientConfigFile: () =>
         prepareClientConfigFile(app, { changelog, contributors }),
     }

plugins/development/plugin-git/src/node/resolveChangelog.ts

@@ -46,7 +46,8 @@ export const resolveChangelog = (
     : commits
 
   for (const commit of sliceCommits) {
-    const { hash, message, time, author, email, refs, coAuthors } = commit
+    const { hash, message, time, author, email, refs, coAuthors, submodule } =
+      commit
     const tag = parseTagName(refs)
     const contributor = getContributorInfo(
       { name: getUserNameWithNoreplyEmail(email) ?? author, email },
@@ -64,6 +65,8 @@ export const resolveChangelog = (
 
     if (tag) resolved.tag = tag
 
+    if (submodule) resolved.submodule = submodule
+
     result.push(resolved)
   }
 

plugins/development/plugin-git/src/node/typings.ts

@@ -1,4 +1,4 @@
-import type { CoAuthorInfo } from '../shared/index.js'
+import type { CoAuthorInfo, SubmoduleInfo } from '../shared/index.js'
 
 export interface RawCommit {
   /** File path */
@@ -20,6 +20,8 @@ export interface RawCommit {
 
   /** The co-authors of the commit */
   coAuthors: CoAuthorInfo[]
+
+  submodule: SubmoduleInfo | null
 }
 
 export interface MergedRawCommit extends Omit<RawCommit, 'filepath'> {

plugins/development/plugin-git/src/node/utils/getCommits.ts

@@ -1,14 +1,20 @@
 import { spawn } from 'node:child_process'
 
-import type { GitContributorInfo } from '../../shared/index.js'
+import { path } from 'vuepress/utils'
+
+import type { GitContributorInfo, SubmoduleInfo } from '../../shared/index.js'
 import type { GitPluginOptions } from '../options.js'
 import type { MergedRawCommit, RawCommit } from '../typings.js'
+import { getRemoteUrl, normalizeRepoUrl } from './inferGitProvider.js'
 import { logger } from './logger.js'
 
 const INFO_SPLITTER = '[|]'
 const COMMIT_SPLITTER = String.raw`\|/`
 const RE_CO_AUTHOR = /^ *Co-authored-by: ?([^<]*)<([^>]*)> */gimu
 
+const gitRepoRootResultCache = new Map<string, string | null>()
+const gitRepoRootTaskCache = new Map<string, Promise<string | null>>()
+
 const getCoAuthorsFromCommitBody = (
   body: string,
 ): Pick<GitContributorInfo, 'email' | 'name'>[] =>
@@ -78,6 +84,77 @@ const runGitLog = (args: string[], cwd: string): Promise<string> =>
     })
   })
 
+/**
+ * Get git repository root directory for a given file path.
+ *
+ * This function runs `git rev-parse --show-toplevel` in the directory of the
+ * target file to determine the top-level directory of the git repository.
+ *
+ * @param filePath - File path (relative or absolute) whose repository root is requested
+ * @param cwd - Current working directory
+ * @returns Promise that resolves to normalized git root path, or null if not in a git repository
+ */
+const getGitRepoRoot = (
+  filePath: string,
+  cwd: string,
+): Promise<string | null> => {
+  const absFilePath = path.isAbsolute(filePath)
+    ? filePath
+    : path.resolve(cwd, filePath)
+
+  const dir = path.normalize(path.dirname(absFilePath))
+  const cachedResult = gitRepoRootResultCache.get(dir)
+
+  if (cachedResult !== undefined || gitRepoRootResultCache.has(dir))
+    return Promise.resolve(cachedResult ?? null)
+
+  const cachedTask = gitRepoRootTaskCache.get(dir)
+  if (cachedTask) return cachedTask
+
+  const task = new Promise<string | null>((resolve) => {
+    const gitProcess = spawn('git', ['rev-parse', '--show-toplevel'], {
+      cwd: dir,
+      stdio: ['ignore', 'pipe', 'pipe'],
+    })
+
+    let stdoutData = ''
+    let stderrData = ''
+
+    gitProcess.stdout.on('data', (chunk: Buffer) => {
+      stdoutData += chunk.toString('utf-8')
+    })
+
+    gitProcess.stderr.on('data', (chunk: Buffer) => {
+      stderrData += chunk.toString('utf-8')
+    })
+
+    gitProcess.on('error', (error) => {
+      logger.error(`Failed to spawn git rev-parse: ${error.message}`)
+      resolve(null)
+    })
+
+    gitProcess.on('close', (code) => {
+      if (code === 0) {
+        resolve(path.normalize(stdoutData.trim()))
+      } else {
+        logger.error(
+          `git rev-parse failed (code=${code}): ${stderrData.trim()}`,
+        )
+        resolve(null)
+      }
+    })
+  })
+
+  const cached = task.then((gitRoot) => {
+    gitRepoRootResultCache.set(dir, gitRoot)
+    gitRepoRootTaskCache.delete(dir)
+    return gitRoot
+  })
+  gitRepoRootTaskCache.set(dir, cached)
+
+  return cached
+}
+
 /**
  * Get raw commits for a specific file
  *
@@ -96,18 +173,39 @@ export const getRawCommits = async (
   options: GitPluginOptions,
 ): Promise<RawCommit[]> => {
   const format = getGitLogFormat(options)
+  const gitRoot = await getGitRepoRoot(filepath, cwd)
 
   try {
+    const absFilePath = path.isAbsolute(filepath)
+      ? filepath
+      : path.resolve(cwd, filepath)
+
+    let repoRelativeFilePath = filepath
+    let submodule: SubmoduleInfo | null = null
+
+    if (gitRoot) {
+      repoRelativeFilePath = path.relative(gitRoot, absFilePath)
+
+      const isSubmodule =
+        gitRoot !== cwd && gitRoot.startsWith(`${cwd}${path.sep}`)
+
+      if (isSubmodule) {
+        submodule = {
+          repoUrl: normalizeRepoUrl(getRemoteUrl(gitRoot) || ''),
+        }
+      }
+    }
+
     const stdout = await runGitLog(
       [
         '--max-count=-1',
         `--format=${format}${COMMIT_SPLITTER}`,
         '--date=unix',
         '--follow',
         '--',
-        filepath,
+        repoRelativeFilePath,
       ],
-      cwd,
+      gitRoot || cwd,
     )
 
     return stdout
@@ -135,6 +233,7 @@ export const getRawCommits = async (
           author,
           email,
           coAuthors: getCoAuthorsFromCommitBody(body),
+          submodule,
         }
       })
   } catch (err) {
@@ -188,3 +287,8 @@ export const getCommits = async (
 
   return mergeRawCommits(rawCommits).sort((a, b) => b.time - a.time)
 }
+
+export const clearGitRepoRootCache = (): void => {
+  gitRepoRootResultCache.clear()
+  gitRepoRootTaskCache.clear()
+}

plugins/development/plugin-git/src/node/utils/inferGitProvider.ts

@@ -47,6 +47,32 @@ export const getRemoteUrl = (cwd: string): string | null => {
   }
 }
 
+/**
+ * Normalize git remote URL to clean HTTPS format
+ *
+ * 将 Git 远程 URL 规范化为干净的 HTTPS 格式
+ *
+ * @param url - The git remote URL / Git 远程 URL
+ * @returns Normalized HTTPS URL / 规范化后的 HTTPS URL
+ *
+ * @example
+ * normalizeRepoUrl('https://github.com/user/repo.git') // 'https://github.com/user/repo'
+ * normalizeRepoUrl('git@github.com:user/repo.git') // 'https://github.com/user/repo'
+ * normalizeRepoUrl('ssh://git@github.com/user/repo.git') // 'https://github.com/user/repo'
+ */
+export const normalizeRepoUrl = (url: string): string => {
+  const normalized = url.replace(/\.git$/, '')
+
+  const sshMatch = /^git@([^:]+):(.+)$/.exec(normalized)
+  if (sshMatch) return `https://${sshMatch[1]}/${sshMatch[2]}`
+
+  const sshProtocolMatch = /^ssh:\/\/git@([^/]+)\/(.+)$/.exec(normalized)
+  if (sshProtocolMatch)
+    return `https://${sshProtocolMatch[1]}/${sshProtocolMatch[2]}`
+
+  return normalized
+}
+
 /**
  * Infer git provider from remote URL
  *

plugins/development/plugin-git/src/shared/index.ts

@@ -72,6 +72,29 @@ export interface GitContributorInfo {
   url?: string
 }
 
+/**
+ * Submodule information
+ *
+ * 子模块信息
+ */
+export interface SubmoduleInfo {
+  /**
+   * Submodule repository URL
+   *
+   * 子模块仓库地址
+   */
+  repoUrl?: string
+
+  /**
+   * Git provider
+   *
+   * Git 提供商
+   */
+  provider?: KnownGitProvider | null
+
+  pattern?: GitUrlPattern
+}
+
 /**
  * Git changelog information
  *
@@ -133,6 +156,8 @@ export interface GitChangelogInfo {
    * 提交协同作者列表
    */
   coAuthors?: CoAuthorInfo[]
+
+  submodule?: SubmoduleInfo
 }
 
 /**