安装文档多个目录锚点无法正确跳转到对应小节

[NX-lite]

问题描述

官方安装文档页面中，多个目录项或锚点链接点击后容易表现为无法打开或无法正确跳转到对应小节。正文内容本身存在，但目录跳转异常会让新用户误以为这些章节没有内容。

受影响条目包括：

• 使用系统包管理器安装
• Arch Linux
• Gentoo Linux
• 使用 Python 包管理器安装
• 使用 pipx 全局安装
• 在虚拟环境中安装

复现环境

页面: https://ruyisdk.org/docs/Package-Manager/installation
浏览器: Chrome
系统: macOS
发现日期: 2026-06-29

复现步骤

1. 打开官方安装文档：

https://ruyisdk.org/docs/Package-Manager/installation

2. 点击页面目录中的相关条目。
3. 或直接访问锚点链接：

https://ruyisdk.org/docs/Package-Manager/installation#arch-linux
https://ruyisdk.org/docs/Package-Manager/installation#gentoo-linux

实际结果

目录项点击后没有反应，或没有跳转到对应小节。

预期结果

点击目录或锚点链接后，应稳定跳转到对应小节，并且标题位置不应被顶部导航遮挡。

临时绕行办法

在页面内手动滚动定位正文内容。

改进建议

• 检查文档站点生成的 heading id 与目录锚点是否一致。
• 对中文标题、空格、大小写和重复标题生成规则做一次自动化校验。
• 确认固定顶部导航不会遮挡锚点跳转后的标题。