feat(settings): 后台可配置 Markdown 代码块自动折叠与阈值行数

支持开关与 0–100 行阈值（0 为无预览），经站点设置与 WS 热更新；短代码在视口内收起时不再回滚浏览位置。

Co-authored-by: Cursor <cursoragent@cursor.com>

frontend/components/markdown/CodeFoldProvider.tsx

@@ -0,0 +1,78 @@
+"use client";
+
+import {
+  createContext,
+  useContext,
+  useEffect,
+  useState,
+  type ReactNode,
+} from "react";
+import { realtime, RT_SETTINGS_CHANGED, type RtSettingsData } from "@/lib/realtime";
+
+export type CodeFoldConfig = {
+  /** 是否启用自动折叠 */
+  enabled: boolean;
+  /** 超过该行数则折叠（预览高度约同；0=无预览） */
+  foldLines: number;
+};
+
+const DEFAULT_CONFIG: CodeFoldConfig = { enabled: true, foldLines: 5 };
+
+const CodeFoldContext = createContext<CodeFoldConfig>(DEFAULT_CONFIG);
+
+/** 代码块自动折叠配置（站点设置） */
+export function useCodeFoldConfig(): CodeFoldConfig {
+  return useContext(CodeFoldContext);
+}
+
+function clampFoldLines(n: unknown): number {
+  if (typeof n !== "number" || !Number.isFinite(n)) return DEFAULT_CONFIG.foldLines;
+  const r = Math.round(n);
+  if (r < 0 || r > 100) return DEFAULT_CONFIG.foldLines;
+  return r;
+}
+
+/**
+ * 根布局注入：SSR 初值 + settings:changed 热更新。
+ */
+export default function CodeFoldProvider({
+  initialEnabled = true,
+  initialFoldLines = 5,
+  children,
+}: {
+  initialEnabled?: boolean;
+  initialFoldLines?: number;
+  children: ReactNode;
+}) {
+  const [config, setConfig] = useState<CodeFoldConfig>(() => ({
+    enabled: initialEnabled !== false,
+    foldLines: clampFoldLines(initialFoldLines),
+  }));
+
+  useEffect(() => {
+    setConfig({
+      enabled: initialEnabled !== false,
+      foldLines: clampFoldLines(initialFoldLines),
+    });
+  }, [initialEnabled, initialFoldLines]);
+
+  useEffect(() => {
+    return realtime.on<RtSettingsData>(RT_SETTINGS_CHANGED, (data) => {
+      if (!data) return;
+      setConfig((prev) => ({
+        enabled:
+          typeof data.code_block_auto_fold === "boolean"
+            ? data.code_block_auto_fold
+            : prev.enabled,
+        foldLines:
+          typeof data.code_block_fold_lines === "number"
+            ? clampFoldLines(data.code_block_fold_lines)
+            : prev.foldLines,
+      }));
+    });
+  }, []);
+
+  return (
+    <CodeFoldContext.Provider value={config}>{children}</CodeFoldContext.Provider>
+  );
+}

frontend/components/markdown/MdCodeBlock.tsx

@@ -11,11 +11,13 @@ import {
 } from "react";
 import { Check, Copy, ChevronDown, ChevronUp } from "lucide-react";
 import { toast } from "@/lib/toast";
+import { useCodeFoldConfig } from "./CodeFoldProvider";
 
-const COLLAPSE_LINE_THRESHOLD = 5;
-/** 约 5 行代码高度（含行高） */
-const COLLAPSED_MAX_HEIGHT = "7.75rem";
-
+/** 折叠预览高度：0=无预览；否则上下 padding ≈1.7rem + 每行 ≈1.21em */
+function collapsedMaxHeight(foldLines: number): string {
+  if (foldLines <= 0) return "0px";
+  return `calc(1.7rem + ${foldLines} * 1.21em)`;
+}
 type MdCodeBlockProps = HTMLAttributes<HTMLPreElement> & {
   children?: ReactNode;
 };
@@ -125,10 +127,11 @@ function hasShikiTokens(node: ReactNode): boolean {
   return hasShikiTokens(props.children as ReactNode);
 }
 
-/** Markdown 代码块：语言标签、复制、>5 行默认折叠；客户端仅在未真正着色时补色 */
+/** Markdown 代码块：语言标签、复制、超阈值行数默认折叠；客户端仅在未真正着色时补色 */
 export default function MdCodeBlock({ children, className, ...rest }: MdCodeBlockProps) {
   const rootRef = useRef<HTMLDivElement>(null);
   const hostRef = useRef<HTMLDivElement>(null);
+  const { enabled: autoFold, foldLines } = useCodeFoldConfig();
 
   const restMap = rest as Record<string, unknown>;
   const dataLanguage = readProp(restMap, "data-language");
@@ -176,7 +179,7 @@ export default function MdCodeBlock({ children, className, ...rest }: MdCodeBloc
   }, [plainText, className, dataLanguage, serverHighlighted]);
 
   const effectiveLines = lineCount > 0 ? lineCount : approxLines;
-  const canCollapse = foldReady && effectiveLines > COLLAPSE_LINE_THRESHOLD;
+  const canCollapse = autoFold && foldReady && effectiveLines > foldLines;
   const collapsed = canCollapse && !expanded;
 
   const onCopy = async () => {
@@ -195,11 +198,21 @@ export default function MdCodeBlock({ children, className, ...rest }: MdCodeBloc
 
   const toggleFold = () => {
     if (expanded) {
+      const el = rootRef.current;
+      // 仅当代码块顶部已滚出可视区（长代码展开后往下读）才回顶；
+      // 短代码全程在视口内时保持浏览位置不变
+      let shouldScrollBack = false;
+      if (el) {
+        const top = el.getBoundingClientRect().top;
+        const headerPad = 88; // 与 scroll-margin-top: 5.5rem 对齐
+        shouldScrollBack = top < headerPad;
+      }
       setExpanded(false);
-      // 收起后滚到该代码块顶部（含工具栏），便于继续往下读
-      requestAnimationFrame(() => {
-        rootRef.current?.scrollIntoView({ block: "start", behavior: "smooth" });
-      });
+      if (shouldScrollBack) {
+        requestAnimationFrame(() => {
+          rootRef.current?.scrollIntoView({ block: "start", behavior: "smooth" });
+        });
+      }
     } else {
       setExpanded(true);
     }
@@ -224,7 +237,7 @@ export default function MdCodeBlock({ children, className, ...rest }: MdCodeBloc
       <div
         ref={hostRef}
         className={`md-code-body${collapsed ? " md-code-collapsed" : ""}`}
-        style={collapsed ? { maxHeight: COLLAPSED_MAX_HEIGHT } : undefined}
+        style={collapsed ? { maxHeight: collapsedMaxHeight(foldLines) } : undefined}
       >
         {clientHtml ? (
           <div