Fumadocs 静态中文搜索

问题复制锚点链接

中文阅读站能否沿用 Fumadocs 的默认静态搜索？ 这项判断需要同时确认索引可以离线导出，以及短中文词和混排术语的召回能力。

当前结论复制锚点链接

适用条件复制锚点链接

原测试与 2026-10-05 复跑均使用 Fumadocs Core 16.15.18 与锁定的 ZBSearch 4.0.1。 运行环境为 Node 24.12.0，样本为单语言中文文档。 小规模样本的结果不能直接推广到大型文档集。

依据复制锚点链接

静态索引复制锚点链接

服务端的 staticGET 导出索引，调用时点由框架路由配置决定。 与 Next.js 静态导出配合时，需将索引路由配置为静态缓存或预渲染。 浏览器中的 staticClient 加载该索引并执行查询。¹

默认引擎复制锚点链接

2026-10-05 读取本仓库安装的客户端源码，确认其从 ZBSearch 导入建库和加载函数。 模块路径仍保留历史上的 orama-static 名称。² 判断实际行为时，应核对安装版本的源码。

开放问题复制锚点链接

• 真实文档集中的排序质量如何？需要更有代表性的样本。
• 浏览器中索引加载、键盘选择和跳转是否正常？等待交互验收。

验证记录复制锚点链接

原独立样例 fumadocs-static-search 于 2026-10-02 执行通过；当前仓库中的 apps/search-check 于 2026-10-05 重新通过类型检查与同口径代码测试。 三篇受控文档的索引导出后，由官方静态客户端重新加载并查询。 十个查询中至少九个的前三条返回项含目标页面，微调与量化均命中。 判定时去掉 URL 锚点，不先按页面去重。 样本、查询和判定方法见时点报告。 浏览器加载与实际站点交互仍待验收。