测试

Hello World again!

Installation

npm i fumadocs-core fumadocs-ui

用于测试中文内容搜索

前言

这是一段用于目录（TOC）测试的扩展示例内容。 你可以通过这篇文档观察：

• 标题层级是否完整收集
• 中英文混排标题是否正确显示
• 同级标题数量较多时的滚动高亮效果
• 锚点跳转后的位置是否准确

测试目标

本页的目标并不是讲解具体技术，而是提供足够长、足够复杂的文档结构。

适用场景

如果你的页面支持侧边目录、悬浮目录或移动端折叠目录，这份文本可以直接复用。

第一章：基础内容区

先从最常见的正文结构开始，逐步增加层级深度。

1.1 标题识别

测试系统是否会把 ##、###、#### 统一纳入目录。

1.1.1 标题中的数字

很多文档会写成“1.1.1”这种格式，目录是否会保留原样。

1.1.2 标题中的符号

例如：括号（测试）、连字符-测试、冒号：测试。

1.2 段落长度

这一节故意写得稍微长一些，用于模拟真实文章。 当段落变长时，阅读位置会在页面中持续变化，目录高亮逻辑（active heading）应该稳定，不应频繁抖动。 如果你有滚动监听和节流逻辑，也可以借此检查边界行为。

1.3 列表与代码块

下面放一个列表和代码块，观察它们是否影响锚点偏移。

1.3.1 列表示例

1. 第一项
2. 第二项
3. 第三项

1.3.2 代码块示例

type TocItem = {
  title: string;
  depth: number;
  slug: string;
};

const example: TocItem[] = [
  { title: "前言", depth: 2, slug: "前言" },
  { title: "测试目标", depth: 3, slug: "测试目标" },
];

第二章：中英文混合标题

本章主要测试 slug 生成策略和显示兼容性。

2.1 English Heading Example

This paragraph is intentionally simple, mainly for mixed-language TOC behavior checks.

2.2 API 与 SDK 说明

包含英文缩写与中文，观察目录项是否过长、是否自动换行。

2.2.1 API Reference Quick Note

短段落用于测试同层级切换。

2.2.2 SDK Integration（示例）

标题中带全角括号时，也应能正常生成链接。

2.3 特殊字符与空格

例如标题中出现多个空格、斜杠、下划线等情况。

2.3.1 path/to/file 风格标题

用于确认斜杠不会导致解析异常。

2.3.2 snake_case 与 kebab-case

用于确认下划线和连字符都能被稳定处理。

第三章：更深层级测试

这一章增加到四级标题，观察 TOC 的缩进和样式。

3.1 一级子主题

常规说明文本。

3.1.1 二级子主题

继续向下。

3.1.2 二级子主题（补充）

再补一节，确保同级数量足够。

3.2 另一条主线

这部分用于测试目录中“跨分组”跳转。

3.2.1 边界行为

例如滚动到章节交界处时，目录高亮应落在合理的项上。

3.2.2 页面回到顶部

从深层标题跳回顶部时，目录状态应同步更新。

第四章：长文滚动体验

这里加入更多普通文本，模拟真实阅读场景。

4.1 内容占位段落 A

在真实项目中，文章会包含背景、目标、方案、实现、验证与总结。 为了让 TOC 测试更接近生产环境，这里用占位文字构建出类似长度。

4.2 内容占位段落 B

当文档足够长时，用户通常通过目录快速定位。 因此，目录项文案可读性、激活逻辑、锚点偏移和移动端展开体验都很关键。

4.3 内容占位段落 C

如果页面有固定顶部导航，需要检查跳转后标题是否被遮挡。 必要时可通过 CSS 的滚动边距来优化体验。

第五章：结语与检查清单

最后提供一个检查清单，便于你逐项验证。

5.1 TOC 检查清单

• 是否完整显示所有 ## 标题
• 是否按需显示 ### 和 ####
• 点击目录项是否正确跳转
• 滚动时高亮是否稳定
• 中英文标题是否都能正常处理

5.2 建议的人工测试步骤

1. 从页面顶部缓慢下滚，观察高亮变化。
2. 随机点击中间层级标题，检查定位精度。
3. 在移动端宽度下验证目录展开与收起。
4. 刷新页面后确认锚点链接仍可复现。

5.3 备注

如果你还需要，我可以再补一版“超长目录压力测试”文本，包含更多重复节和更深层结构，用来测试性能与交互细节。