braless · pull · Apr 6, 2026 · Apr 7, 2026 · Apr 8, 2026 · Apr 8, 2026
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
@@ -0,0 +1,30 @@
+name: Docs Test
+
+on:
+  - push
+  - pull_request
+
+jobs:
+  test-docs:
+    name: Test docs
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@fc06bc1257f339d1d5d8b3a19a8cae5388b55320 # v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 22
+          cache: pnpm
+
+      - name: Install deps
+        run: pnpm install --frozen-lockfile
+
+      - name: Build test
+        env:
+          NODE_OPTIONS: --max_old_space_size=4096
+        run: pnpm docs:build
diff --git a/.gitignore b/.gitignore
@@ -1,17 +1,29 @@
-/node_modules
-/package-lock.json
+node_modules/
 # *.drawio
 *.drawio.bkp
 .DS_Store
 # VS Code Config file
 .vscode/
-# Vuepress Cache
-.cache/
-# Vuepress Temp
-.temp/
-# Vuepress Output
+# VuePress Cache
+**/.vuepress/.cache/
+# VuePress Temp
+**/.vuepress/.temp/
+# VuePress Output
 dist/
-# Build files
-packages/*/lib/
 traversal-folder-replace-string.py
 format-markdown.py
+
+.npmrc
+package-lock.json
+lintmd-config.json
+.claude/settings.local.json
+/.obsidian
+docs/ai/claude.md
+scripts/docsearch-index.mjs
+PERFORMANCE_NOTES.md
+docs/cs-basics/network/TODO.md
+PERFORMANCE_NOTES.md
+dist.zip
+/TODO
+docs/ai/MATERIALS.md
+/.agents
diff --git a/.husky/pre-commit b/.husky/pre-commit
@@ -0,0 +1 @@
+pnpm nano-staged
diff --git a/.markdownlint-cli2.mjs b/.markdownlint-cli2.mjs
@@ -0,0 +1,28 @@
+export default {
+  config: {
+    default: true,
+    MD003: {
+      style: "atx",
+    },
+    MD004: {
+      style: "dash",
+    },
+    MD010: false,
+    MD013: false,
+    MD024: {
+      allow_different_nesting: true,
+    },
+    MD035: {
+      style: "---",
+    },
+    MD036: false,
+    MD040: false,
+    MD045: false,
+    MD046: false,
+  },
+  ignores: [
+    "**/node_modules/**",
+    // markdown import demo
+    "**/*.snippet.md",
+  ],
+};
diff --git a/.prettierignore b/.prettierignore
@@ -0,0 +1,15 @@
+# Vuepress Cache
+**/.vuepress/.cache/**
+# Vuepress Temp
+**/.vuepress/.temp/**
+# Vuepress Output
+dist/
+
+# Node modules
+node_modules/
+
+# pnpm lock file
+pnpm-lock.yaml
+
+index.html
+sw.js
diff --git a/README.en.md b/README.en.md
diff --git a/README.md b/README.md
diff --git a/README_EN.md b/README_EN.md
diff --git a/README_JA.md b/README_JA.md
diff --git a/docs/.vuepress/client.ts b/docs/.vuepress/client.ts
@@ -0,0 +1,48 @@
+import { defineClientConfig } from "vuepress/client";
+import { defineAsyncComponent, h } from "vue";
+import DeferredLayoutToggle from "./components/DeferredLayoutToggle.vue";
+import ClickImagePreview from "./components/ClickImagePreview.vue";
+import LazyMermaid from "./components/LazyMermaid.vue";
+import GlobalUnlock from "./components/unlock/GlobalUnlock.vue";
+
+const UnlockContent = defineAsyncComponent(
+  () => import("./components/unlock/UnlockContent.vue"),
+);
+
+const CHUNK_LOAD_ERROR_PATTERN =
+  /Failed to fetch dynamically imported module|Importing a module script failed|error loading dynamically imported module|Unable to preload CSS/i;
+
+const getCurrentLocation = (): string =>
+  `${window.location.pathname}${window.location.search}${window.location.hash}`;
+
+export default defineClientConfig({
+  enhance({ app, router }) {
+    app.component("Mermaid", LazyMermaid);
+    app.component("UnlockContent", UnlockContent);
+
+    router.onError((error, to) => {
+      if (typeof window === "undefined") return;
+
+      const message = error instanceof Error ? error.message : String(error);
+      if (!CHUNK_LOAD_ERROR_PATTERN.test(message)) return;
+
+      const target = to?.fullPath || getCurrentLocation();
+      const reloadKey = `javaguide:chunk-reload:${target}`;
+
+      if (window.sessionStorage.getItem(reloadKey) === "1") return;
+
+      window.sessionStorage.setItem(reloadKey, "1");
+      window.location.assign(target);
+    });
+
+    router.afterEach((to) => {
+      if (typeof window === "undefined") return;
+      window.sessionStorage.removeItem(`javaguide:chunk-reload:${to.fullPath}`);
+    });
+  },
+  rootComponents: [
+    () => h(DeferredLayoutToggle),
+    () => h(GlobalUnlock),
+    () => h(ClickImagePreview),
+  ],
+});
diff --git a/docs/.vuepress/components/ClickImagePreview.vue b/docs/.vuepress/components/ClickImagePreview.vue
@@ -0,0 +1,173 @@
+<template>
+  <Teleport v-if="isMounted" to="body">
+    <transition name="image-preview-fade">
+      <div
+        v-if="previewImage"
+        class="image-preview-mask"
+        role="dialog"
+        aria-modal="true"
+        @click.self="closePreview"
+      >
+        <button
+          class="image-preview-close"
+          type="button"
+          aria-label="关闭图片预览"
+          @click="closePreview"
+        >
+          ×
+        </button>
+        <img
+          class="image-preview-img"
+          :src="previewImage.src"
+          :alt="previewImage.alt"
+          @click.stop
+        />
+      </div>
+    </transition>
+  </Teleport>
+</template>
+
+<script setup lang="ts">
+import { onMounted, onUnmounted, ref, watch } from "vue";
+
+interface PreviewImage {
+  src: string;
+  alt: string;
+}
+
+const CONTENT_SELECTOR =
+  "#markdown-content, .theme-hope-content, .vp-page-content, .vp-content";
+const IMAGE_SELECTOR = "img:not([no-view])";
+
+const isMounted = ref(false);
+const previewImage = ref<PreviewImage | null>(null);
+
+const getPreviewableImage = (
+  target: EventTarget | null,
+): HTMLImageElement | null => {
+  if (!(target instanceof Element)) return null;
+
+  const img = target.closest(IMAGE_SELECTOR);
+  if (!(img instanceof HTMLImageElement)) return null;
+  if (!img.closest(CONTENT_SELECTOR)) return null;
+  if (img.closest("a")) return null;
+
+  return img;
+};
+
+const closePreview = () => {
+  previewImage.value = null;
+};
+
+const handleClick = (event: MouseEvent) => {
+  const img = getPreviewableImage(event.target);
+  if (!img) return;
+
+  const src = img.currentSrc || img.src;
+  if (!src) return;
+
+  event.preventDefault();
+  previewImage.value = {
+    src,
+    alt: img.alt || "图片预览",
+  };
+};
+
+const handleKeydown = (event: KeyboardEvent) => {
+  if (event.key === "Escape") closePreview();
+};
+
+watch(previewImage, (image) => {
+  if (typeof document === "undefined") return;
+
+  document.documentElement.classList.toggle(
+    "image-preview-open",
+    Boolean(image),
+  );
+});
+
+onMounted(() => {
+  isMounted.value = true;
+
+  document.addEventListener("click", handleClick);
+  document.addEventListener("keydown", handleKeydown);
+});
+
+onUnmounted(() => {
+  document.removeEventListener("click", handleClick);
+  document.removeEventListener("keydown", handleKeydown);
+  document.documentElement.classList.remove("image-preview-open");
+});
+</script>
+
+<style scoped lang="scss">
+:global(
+  #markdown-content :not(a) > img:not([no-view]),
+  .theme-hope-content :not(a) > img:not([no-view]),
+  .vp-page-content :not(a) > img:not([no-view]),
+  .vp-content :not(a) > img:not([no-view])
+) {
+  cursor: zoom-in;
+}
+
+:global(.image-preview-open) {
+  overflow: hidden;
+}
+
+.image-preview-mask {
+  position: fixed;
+  inset: 0;
+  z-index: 9999;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 32px;
+  background: rgb(0 0 0 / 82%);
+  cursor: zoom-out;
+}
+
+.image-preview-img {
+  display: block;
+  max-width: min(100%, 1280px);
+  max-height: 100%;
+  object-fit: contain;
+  border-radius: 6px;
+  box-shadow: 0 18px 48px rgb(0 0 0 / 35%);
+  cursor: default;
+}
+
+.image-preview-close {
+  position: fixed;
+  top: 16px;
+  right: 16px;
+  width: 40px;
+  height: 40px;
+  border: 0;
+  border-radius: 50%;
+  color: #fff;
+  background: rgb(255 255 255 / 16%);
+  font-size: 30px;
+  line-height: 38px;
+  cursor: pointer;
+}
+
+.image-preview-close:hover {
+  background: rgb(255 255 255 / 24%);
+}
+
+.image-preview-fade-enter-active,
+.image-preview-fade-leave-active {
+  transition: opacity 0.16s ease;
+}
+
+.image-preview-fade-enter-from,
+.image-preview-fade-leave-to {
+  opacity: 0;
+}
+
+@media (max-width: 719px) {
+  .image-preview-mask {
+    padding: 16px;
+  }
+}
+</style>
diff --git a/docs/.vuepress/components/DeferredLayoutToggle.vue b/docs/.vuepress/components/DeferredLayoutToggle.vue
@@ -0,0 +1,23 @@
+<template>
+  <LayoutToggle v-if="shouldShow" />
+</template>
+
+<script setup lang="ts">
+import { defineAsyncComponent, onMounted, ref } from "vue";
+
+const LayoutToggle = defineAsyncComponent(() => import("./LayoutToggle.vue"));
+const shouldShow = ref(false);
+
+onMounted(() => {
+  const show = () => {
+    shouldShow.value = true;
+  };
+
+  if ("requestIdleCallback" in window) {
+    window.requestIdleCallback(show, { timeout: 2000 });
+    return;
+  }
+
+  window.setTimeout(show, 1200);
+});
+</script>