feat(navigation): add about page link in footer

主要变更：

- 在 shared links 注册表中添加 about 页面入口

- 在站点页脚添加"关于 HagiCode"链接

- 新增测试验证链接注册和页脚展示

Co-Authored-By: Hagicode <noreply@hagicode.com>
Signed-off-by: newbe36524 <newbe36524@qq.com>

Author: newbe36524

Screenshot_20260331_113831.png

@@ -125,6 +125,13 @@ export const SITE_LINKS = {
         external: false,
     } as LinkConfig,
 
+    /** 官方 About 页面 */
+    about: {
+        dev: 'https://hagicode.com/about/',
+        prod: 'https://hagicode.com/about/',
+        external: false,
+    } as LinkConfig,
+
     /** 博客 RSS 订阅（相对于文档站点） */
     rss: {
         dev: 'http://localhost:31265/blog/rss.xml',

shared/src/links.ts

@@ -23,6 +23,7 @@ const qqGroupLink = getLink('qqGroup');
 const discordLink = getLink('discord');
 const blogLink = getLink('blog');
 const productOverviewLink = getLink('productOverview');
+const aboutLink = getLink('about');
 const rssLink = getLink('rss');
 const costCalculatorLink = getLink('costCalculator');
 
@@ -82,6 +83,7 @@ const discordRel = getLinkRel('discord');
 					<h3 class="unified-footer-section-title">快速链接</h3>
 					<nav class="unified-footer-section-links" aria-label="快速链接">
 						<a href={desktopLink} class="unified-footer-link">下载客户端</a>
+						<a href={aboutLink} class="unified-footer-link">关于 HagiCode</a>
 						<a href="/installation/docker-compose" class="unified-footer-link">Docker Compose 安装</a>
 						<a href={productOverviewLink} class="unified-footer-link">产品文档</a>
 						<a href={blogLink} class="unified-footer-link">博客文章</a>

src/components/StarlightFooter.astro

@@ -0,0 +1,31 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const testDir = path.dirname(fileURLToPath(import.meta.url));
+const docsRoot = path.resolve(testDir, '..');
+
+function resolveDocsPath(relativePath) {
+  return path.join(docsRoot, relativePath);
+}
+
+test('docs link registry keeps a canonical about entry that points to the site-owned page', async () => {
+  const linksSource = await readFile(resolveDocsPath('shared/src/links.ts'), 'utf8');
+
+  assert.match(
+    linksSource,
+    /about:\s*\{\s*dev:\s*'https:\/\/hagicode\.com\/about\/',\s*prod:\s*'https:\/\/hagicode\.com\/about\/'/s,
+  );
+  assert.equal(linksSource.includes('repos/site'), false);
+});
+
+test('docs footer exposes the local about link entry without importing the site footer', async () => {
+  const footerSource = await readFile(resolveDocsPath('src/components/StarlightFooter.astro'), 'utf8');
+
+  assert.match(footerSource, /const aboutLink = getLink\('about'\);/);
+  assert.match(footerSource, /<a href=\{aboutLink\} class="unified-footer-link">关于 HagiCode<\/a>/);
+  assert.equal(footerSource.includes('@/components/home/Footer'), false);
+  assert.equal(footerSource.includes('repos/site'), false);
+});