diff --git a/src/components/BookmarkButton/index.jsx b/src/components/BookmarkButton/index.jsx
new file mode 100644
index 0000000..e32fe28
--- /dev/null
+++ b/src/components/BookmarkButton/index.jsx
@@ -0,0 +1,104 @@
+import React, { useState, useEffect, useCallback } from 'react';
+import { useLocation } from '@docusaurus/router';
+import { useAllDocsData } from '@docusaurus/plugin-content-docs/client';
+import styles from './styles.module.css';
+
+const STORAGE_KEY = 'gitlink_bookmarks';
+
+function getBookmarks() {
+ try {
+ return JSON.parse(localStorage.getItem(STORAGE_KEY) || '[]');
+ } catch {
+ return [];
+ }
+}
+
+function deriveTitle(id) {
+ if (!id) return '';
+ const segments = id.split('/');
+ return segments[segments.length - 1];
+}
+
+export default function BookmarkButton() {
+ const location = useLocation();
+ const allDocsData = useAllDocsData();
+ const [bookmarked, setBookmarked] = useState(false);
+ const [toast, setToast] = useState(null);
+
+ // Check if current doc is bookmarked
+ useEffect(() => {
+ const stored = getBookmarks();
+ setBookmarked(stored.some((d) => d.path === location.pathname));
+ }, [location.pathname]);
+
+ const showToast = useCallback((msg) => {
+ setToast(msg);
+ setTimeout(() => setToast(null), 2000);
+ }, []);
+
+ const toggleBookmark = useCallback(() => {
+ if (!allDocsData) return;
+
+ const pluginIds = Object.keys(allDocsData);
+ if (pluginIds.length === 0) return;
+ const plugin = allDocsData[pluginIds[0]];
+
+ let activeVersion = null;
+ for (const version of plugin.versions) {
+ if (!version.docs) continue;
+ const docs = Object.values(version.docs);
+ if (docs.find((doc) => doc.path && location.pathname.endsWith(doc.path))) {
+ activeVersion = version;
+ break;
+ }
+ }
+ if (!activeVersion || !activeVersion.docs) return;
+
+ const allDocs = Object.values(activeVersion.docs);
+ const currentDoc = allDocs.find(
+ (doc) => doc.path && location.pathname.endsWith(doc.path)
+ );
+ if (!currentDoc) return;
+
+ const stored = getBookmarks();
+ const existing = stored.findIndex((d) => d.path === currentDoc.path);
+
+ if (existing >= 0) {
+ // Remove bookmark
+ stored.splice(existing, 1);
+ localStorage.setItem(STORAGE_KEY, JSON.stringify(stored));
+ setBookmarked(false);
+ showToast('已取消收藏');
+ } else {
+ // Add bookmark
+ stored.unshift({
+ path: currentDoc.path,
+ id: currentDoc.id,
+ title: deriveTitle(currentDoc.id),
+ timestamp: Date.now(),
+ });
+ localStorage.setItem(STORAGE_KEY, JSON.stringify(stored));
+ setBookmarked(true);
+ showToast('已收藏，可在侧边栏查看');
+ }
+
+ // Dispatch custom event so BookmarkList updates
+ window.dispatchEvent(new Event('bookmark-change'));
+ }, [location.pathname, allDocsData, showToast]);
+
+ return (
+ <>
+
+ {toast && {toast}
}
+
+ );
+}
diff --git a/src/components/BookmarkButton/styles.module.css b/src/components/BookmarkButton/styles.module.css
new file mode 100644
index 0000000..78f5d13
--- /dev/null
+++ b/src/components/BookmarkButton/styles.module.css
@@ -0,0 +1,49 @@
+.btn {
+ display: inline-flex;
+ align-items: center;
+ gap: 0.35rem;
+ padding: 0.35rem 0.75rem;
+ border: 1px solid var(--ifm-color-emphasis-300);
+ border-radius: 6px;
+ background: var(--ifm-background-color);
+ color: var(--ifm-color-emphasis-700);
+ font-size: 0.8rem;
+ cursor: pointer;
+ transition: all 0.15s ease;
+ line-height: 1.4;
+}
+
+.btn:hover {
+ border-color: var(--ifm-color-primary);
+ color: var(--ifm-color-primary);
+ background: var(--ifm-color-primary-contrast-background);
+}
+
+.btn.active {
+ border-color: var(--ifm-color-primary);
+ color: var(--ifm-color-primary);
+ background: var(--ifm-color-primary-contrast-background);
+}
+
+.toast {
+ position: fixed;
+ bottom: 2rem;
+ left: 50%;
+ transform: translateX(-50%);
+ padding: 0.5rem 1.2rem;
+ border-radius: 6px;
+ background: var(--ifm-color-emphasis-700);
+ color: var(--ifm-color-emphasis-100);
+ font-size: 0.85rem;
+ z-index: var(--ifm-z-index-fixed);
+ box-shadow: 0 2px 8px rgba(0,0,0,0.15);
+ animation: fadeInOut 2s ease forwards;
+ pointer-events: none;
+}
+
+@keyframes fadeInOut {
+ 0% { opacity: 0; transform: translateX(-50%) translateY(8px); }
+ 15% { opacity: 1; transform: translateX(-50%) translateY(0); }
+ 85% { opacity: 1; transform: translateX(-50%) translateY(0); }
+ 100% { opacity: 0; transform: translateX(-50%) translateY(-8px); }
+}
diff --git a/src/components/BookmarkList/index.jsx b/src/components/BookmarkList/index.jsx
new file mode 100644
index 0000000..95c6332
--- /dev/null
+++ b/src/components/BookmarkList/index.jsx
@@ -0,0 +1,45 @@
+import React, { useState, useEffect } from 'react';
+import Link from '@docusaurus/Link';
+import styles from './styles.module.css';
+
+const STORAGE_KEY = 'gitlink_bookmarks';
+
+function getBookmarks() {
+ try {
+ return JSON.parse(localStorage.getItem(STORAGE_KEY) || '[]');
+ } catch {
+ return [];
+ }
+}
+
+export default function BookmarkList() {
+ const [bookmarks, setBookmarks] = useState([]);
+
+ useEffect(() => {
+ setBookmarks(getBookmarks());
+
+ const handler = () => setBookmarks(getBookmarks());
+ window.addEventListener('bookmark-change', handler);
+ return () => window.removeEventListener('bookmark-change', handler);
+ }, []);
+
+ if (bookmarks.length === 0) return null;
+
+ return (
+
+
收藏
+
+ {bookmarks.slice(0, 10).map((bm) => (
+ -
+
+
+ {bm.title}
+
+
+ ))}
+
+
-
-
- {toast &&
{toast}
}
-
+
+
);
diff --git a/src/theme/DocSidebar/Desktop/index.tsx b/src/theme/DocSidebar/Desktop/index.tsx
index 6c411fb..69b3ffb 100644
--- a/src/theme/DocSidebar/Desktop/index.tsx
+++ b/src/theme/DocSidebar/Desktop/index.tsx
@@ -6,6 +6,7 @@ import CollapseButton from '@theme/DocSidebar/Desktop/CollapseButton';
import Content from '@theme/DocSidebar/Desktop/Content';
import type {Props} from '@theme/DocSidebar/Desktop';
import RecentDocs from '../../../components/RecentDocs';
+import BookmarkList from '../../../components/BookmarkList';
import styles from './styles.module.css';
@@ -27,6 +28,7 @@ function DocSidebarDesktop({path, sidebar, onCollapse, isHidden}: Props) {
{hideOnScroll && }
+
{hideable && }