feat(文档大纲): 优化标题块和编号逻辑，增强标题唯一性和层级处理

src/components/Editor/DocumentOutline.tsx

@@ -107,15 +107,41 @@ function addHeadingNumbers(node: OutlineNode, numberMap: Map<string, string>): O
  */
 export const DocumentOutline: React.FC<DocumentOutlineProps> = ({ visible = true }) => {
   const headings = useEditorStore(
-    useShallow((state) =>
-      state.blocks
-        .filter((block): block is HeadingBlock => block.type === 'heading')
+    useShallow((state) => {
+      const seenIds = new Set<string>();
+      return state.blocks
+        .filter(
+          (block): block is HeadingBlock =>
+            block.type === 'heading' &&
+            typeof block.id === 'string' &&
+            block.id.length > 0 &&
+            Number.isInteger(block.level) &&
+            block.level >= 1 &&
+            block.level <= 6
+        )
         .sort((left, right) => left.block_order - right.block_order)
-    )
+        .filter((heading) => {
+          if (seenIds.has(heading.id)) return false;
+          seenIds.add(heading.id);
+          return true;
+        });
+    })
   );
   const selectedBlockId = useEditorStore((state) => state.selectedBlockId);
+  const selectBlock = useEditorStore((state) => state.selectBlock);
   const [expandedKeys, setExpandedKeys] = useState<React.Key[]>([]);
   const [autoExpandParent, setAutoExpandParent] = useState(true);
+  const highlightTimerRef = React.useRef<ReturnType<typeof setTimeout> | null>(null);
+  const highlightedElementRef = React.useRef<HTMLElement | null>(null);
+
+  React.useEffect(() => {
+    return () => {
+      if (highlightTimerRef.current) {
+        clearTimeout(highlightTimerRef.current);
+      }
+      highlightedElementRef.current?.classList.remove('block-highlight');
+    };
+  }, []);
 
   // 构建树结构
   const treeData = useMemo(() => {
@@ -139,21 +165,42 @@ export const DocumentOutline: React.FC<DocumentOutlineProps> = ({ visible = true
   }, [treeData]);
 
   // 处理节点点击
-  const handleSelect = useCallback((selectedKeys: React.Key[]) => {
-    if (selectedKeys.length === 0) return;
+  const handleSelect = useCallback(
+    (selectedKeys: React.Key[]) => {
+      if (selectedKeys.length === 0) {
+        selectBlock(null);
+        return;
+      }
+
+      const blockId = selectedKeys[0];
+      if (typeof blockId !== 'string') return;
 
-    const blockId = selectedKeys[0] as string;
-    const element = document.querySelector(`[data-block-id="${blockId}"]`);
+      const element = Array.from(document.querySelectorAll<HTMLElement>('[data-block-id]')).find(
+        (candidate) => candidate.dataset.blockId === blockId
+      );
 
-    if (element) {
+      if (!element) {
+        selectBlock(null);
+        return;
+      }
+
+      selectBlock(blockId);
       element.scrollIntoView({ behavior: 'smooth', block: 'center' });
-      // 可以添加高亮效果
+      highlightedElementRef.current?.classList.remove('block-highlight');
+      if (highlightTimerRef.current) {
+        clearTimeout(highlightTimerRef.current);
+      }
       element.classList.add('block-highlight');
-      setTimeout(() => {
+      highlightedElementRef.current = element;
+      highlightTimerRef.current = setTimeout(() => {
         element.classList.remove('block-highlight');
+        if (highlightedElementRef.current === element) {
+          highlightedElementRef.current = null;
+        }
       }, 2000);
-    }
-  }, []);
+    },
+    [selectBlock]
+  );
 
   // 处理展开/折叠
   const handleExpand = useCallback((expandedKeys: React.Key[]) => {

src/components/Editor/blocks/HeadingBlock.tsx

@@ -356,7 +356,8 @@ export const HeadingBlock: React.FC<HeadingBlockProps> = ({
     );
   }, [block.id, block.style, addBlock]);
 
-  const Tag = `h${block.level}` as keyof JSX.IntrinsicElements;
+  const headingLevel = Math.min(6, Math.max(1, Math.trunc(Number(block.level) || 1)));
+  const Tag = `h${headingLevel}` as keyof JSX.IntrinsicElements;
   const isEmpty =
     typeof block.content === 'string'
       ? block.content.trim().length === 0

src/utils/headingNumbering.ts

@@ -3,10 +3,24 @@ import type { DocumentBlock, HeadingBlock } from '../types/editor';
 export function getHeadingNumberMap(blocks: DocumentBlock[]): Map<string, string> {
   const counters: number[] = [];
   const numbers = new Map<string, string>();
+  const seenIds = new Set<string>();
 
   blocks
-    .filter((block): block is HeadingBlock => block.type === 'heading')
+    .filter(
+      (block): block is HeadingBlock =>
+        block.type === 'heading' &&
+        typeof block.id === 'string' &&
+        block.id.length > 0 &&
+        Number.isInteger(block.level) &&
+        block.level >= 1 &&
+        block.level <= 6
+    )
     .sort((a, b) => a.block_order - b.block_order)
+    .filter((heading) => {
+      if (seenIds.has(heading.id)) return false;
+      seenIds.add(heading.id);
+      return true;
+    })
     .forEach((heading) => {
       const levelIndex = heading.level - 1;
       counters.length = heading.level;