From a528e24bde2267504ad5f16960d8cf0fa845e888 Mon Sep 17 00:00:00 2001
From: Meow <197331664+Meo597@users.noreply.github.com>
Date: Wed, 17 Dec 2025 16:27:35 +0800
Subject: [PATCH] =?UTF-8?q?=E5=9B=9E=E5=88=B0=E9=A1=B6=E9=83=A8=E6=8C=89?=
 =?UTF-8?q?=E9=92=AE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .vitepress/theme/components/BackToTop.vue | 62 +++++++++++++++++++++++
 .vitepress/theme/index.mts                |  2 +
 2 files changed, 64 insertions(+)
 create mode 100644 .vitepress/theme/components/BackToTop.vue

diff --git a/.vitepress/theme/components/BackToTop.vue b/.vitepress/theme/components/BackToTop.vue
new file mode 100644
index 00000000..73fc0c2f
--- /dev/null
+++ b/.vitepress/theme/components/BackToTop.vue
@@ -0,0 +1,62 @@
+<script setup lang="ts">
+import { ref, onMounted, onUnmounted } from "vue";
+
+const visible = ref(false);
+const THRESHOLD = 300;
+
+function onScroll() {
+  visible.value = window.scrollY > THRESHOLD;
+}
+
+function backToTop() {
+  window.scrollTo({ top: 0, behavior: "smooth" });
+}
+
+onMounted(() => {
+  onScroll();
+  window.addEventListener("scroll", onScroll, { passive: true });
+});
+
+onUnmounted(() => {
+  window.removeEventListener("scroll", onScroll);
+});
+</script>
+
+<template>
+  <button
+    v-show="visible"
+    class="vp-back-to-top"
+    aria-label="Back to top"
+    @click="backToTop"
+  >
+    ↑
+  </button>
+</template>
+
+<style scoped>
+.vp-back-to-top {
+  position: fixed;
+  right: 24px;
+  bottom: 24px;
+  z-index: 100;
+  width: 36px;
+  height: 36px;
+  border-radius: 999px;
+
+  border: 1px solid var(--vp-c-divider);
+  background: var(--vp-c-bg-soft);
+  color: var(--vp-c-text-1);
+
+  cursor: pointer;
+  font-size: 16px;
+  line-height: 1;
+
+  opacity: 0.8;
+  transition: opacity 0.2s, transform 0.2s;
+}
+
+.vp-back-to-top:hover {
+  opacity: 1;
+  transform: translateY(-2px);
+}
+</style>
diff --git a/.vitepress/theme/index.mts b/.vitepress/theme/index.mts
index d844a91f..48345e91 100644
--- a/.vitepress/theme/index.mts
+++ b/.vitepress/theme/index.mts
@@ -11,6 +11,7 @@ import { useRoute } from "vitepress";
 import { h } from "vue";
 import TranslationNotice from "./components/TranslationNotice.vue";
 import PageContributors from "./components/PageContributors.vue";
+import BackToTop from "./components/BackToTop.vue";
 
 export default {
   extends: DefaultTheme,
@@ -34,6 +35,7 @@ export default {
     return h(DefaultTheme.Layout, null, {
       "doc-before": () => h(TranslationNotice),
       "doc-after": () => h(PageContributors),
+      "layout-bottom": () => h(BackToTop),
     });
   },
 };