server-configs/siyuan/data/plugins/syplugin-hierarchyNavigate/CHANGELOG.md

## 更新日志

### v1.8.0 (2026年2月1日)

- 新增：上层文档内容区；
- 改进：移动端显示；
  - 文档信息行拆分显示；
  - 上一篇下一篇强制单列；
- 改进：支持设定与思源笔记-编辑器设置字号的相对倍数；

### v1.7.5 (2025年12月28日)

- 修复：移动端设置页面显示不全的问题；
- 修复：无任何内容区生效时仍插入空白（但不显示）的内容区的问题；

### v1.7.4 (2025年9月10日)

- 修复：快捷键插入listChildDocs挂件变为html块的问题；

### v1.7.3 (2025年8月20日)

- 修复：同时使用编辑器宽度插件、savor，有时在分屏后导航区显示错位的问题；
- 修复：“显示详细设置”设置项无效的问题；
- 改进：插件通知添加 “--层级导航插件”；

### v1.7.2 (2025年7月25日)

- 修复：多个分屏区具有相同文档时，其中一个不会在思源启动时显示的问题；
- 改进：(面包屑内容区)已有在显示的同级文档菜单时，点击`>`直接打开菜单；
- 调整：临时置顶内容区的功能逻辑；
  - 允许在编辑器区域内拖拽移动；
  - 记忆相对编辑器区域的位置；
  - 不再允许多个内容区同时置顶；
  - （设置项）在下一个聚焦文档继续置顶状态；

### v1.7.1 (2025年6月9日)

- 修复：在关闭“导航区不再插在文档标题所在的HTML元素”时，文档开头的内容区margin错误的问题； #94 #93
- 移除：“导航区不再插在文档标题所在的HTML元素”设置项，并强制启用；

### v1.7.0 (2025年6月7日)

- 新增：笔记本独立内容区设置；
  现在，可以为不同笔记本设定显示不同的内容区；

### v1.6.1 (2025年6月1日)

- 修复：笔记本下的第一层文档，上一篇下一篇、同级文档不显示的问题；
- 改进：样式调整；
  - 父文档、相邻文档均纳入“文档链接等宽分列数”控制范围，如要修改为原状，请使用
    ```css
    .og-hierachy-navigate-parent-doc-container docLinksWrapper, .og-hierachy-navigate-next-doc-container docLinksWrapper {
      width: unset;
    }
    ```
  - 预览方格内容区不再纳入`最大高度限制`控制范围，现在是单独控制的`max-height: 30vh`；对应有选择器调整，请使用`.og-hn-pb-container`选中预览方格内容区；
  - 宽度一致性：带预览的相邻文档，改为`overflow: scroll`；
- 移除：调整“所见即所得”编辑器padding-bottom的行为；

### v1.6.0 (2025年5月29日)

- 新增：🧪将内容区显示在文档末尾；
- 新增：🧪带预览的上一篇下一篇内容区；
- 新增：🧪预览方格内容区；
- 改进：在内容区数量不足时，不再显示”更多/更少“；
- 改进：性能模式开启时，文档信息行将不统计字符个数、所有下层文档个数；
- 调整：移动端内容最大高度改为固定25vh；

### v1.5.3 (2025年5月10日)

- 调整：“移动端返回键触发更新”设置项即使开启，也会在思源v3.1.25及之后版本不生效；[相关issue](https://github.com/siyuan-note/siyuan/issues/14296)
  
  该设置项将在插件下次更新时移除。
  如仍遇到移动端返回上一篇文档导航未刷新的问题，请更新至思源v3.1.25及以上版本。
- 改进：新增设置项“性能模式”；
  
  子文档或同级文档数量大于512后，将不再显示部分内容区；
- 改进：性能调整，对于文档树列表结果，由Printer获取并存储在公共区域，以避免在未启用内容区时仍然获取相应信息；
- 新增：用于控制文档名是否居中的设置项；

### v1.5.2 (2025年2月1日)

- 修复：“往年今日”等内容区，单击链接可能重复打开文档的问题；

### v1.5.1 (2025年1月5日)

- 修复：设置“文档链接等宽分列数”、“隐藏导航区提示词”后，部分情况下右侧出现较大空白、并没有完成分列的问题；修复了另一个相关问题；

### v1.5.0 (2024年12月31日)

- 修复：尝试修复发布模式下，插件导致反复进行Basic认证的问题；
- 改进：增加设置项 及时更新；（在文档重命名、移动等操作后更新导航区）；
- 改进：临时置顶内容区（测试结束）；
- 其他：前缀为空情况处理、`.og-hn-ref-link-simulate`class识别插件ref、无笔记本图标bug；

### v1.4.3 (2024年11月19日)

- 修复：尝试修复MacOS下快捷键问题；
- 改进：兼容思源v3.1.12中动态文档图标的更改；
- 修复：相关文档面板排除重复文档；
- 新增：临时置顶内容区（测试）；

### v1.4.2 (2024年11月7日)

- 修复：文档排序不是文档名升序时，错误补充日记上一篇下一篇的问题；
  涉及设置项变动：“相邻文档对于日记（dailynote）按日记对应日期升序获取”；
- 修复：“文档上级为笔记本时，父文档区域显示同级文档”设置项无效的问题；
- 修复：“父文档”/“上层文档”图标错误的问题；
- 修复：无法一次获取图标时，显示文档图标错误的问题；
  涉及设置项变动：“尽可能地显示文档图标”；

### v1.4.1 （2024年11月2日）

- 修复：当编辑器中存在选区时，无法通过层级导航打开文档的问题；（重构）
- 新增：`Ctrl+点击`在后台标签页中打开；
  alt、shift在分屏打开原本就支持；
- 新增：🧪打开文档后关闭上一个文档（设置项）；
- 新增：🧪连续打开文档则关闭之前的文档（设置项）；
- 改进：文档信息内容区加入所有下方文档计数（括号中表示，依赖数据库，部分情况下需要重建索引才准确）；
- 移除：禁用移动端面板入口；

### v1.4.0-rc1 (2024年10月21日)

- 修复：“自第x个启用的内容区起，隐藏内容区”启用时，不参与刷新的内容区刷新后不显示的问题；
- 新增：相邻文档跳转对话框；默认快捷键Ctrl+Alt+E
  - 支持通过快捷键创建文档；
  - 如果没有找到想要的结果，支持跳转到“基于文档搜索”插件继续搜索；
- 改进：调整与`listChlidDocs`的兼容性；
- 修复：启动思源但保留之前文档页签时，分屏后新出现的页签没有刷新的问题；
- 移除：移除设置项：icon调节、其他情况下显示、同级文档忽略隐藏文档；

### v1.3.1 (2024年8月25日)

- 修复：“编辑器宽度”插件启用时无法与标题对齐的问题；

### v1.3.0（2024年8月18日）

- 修复：“导航区不再插在文档标题所在HTML元素”开启且“文档自适应宽度”关闭，插件没有处理宽度变化的问题；
- 改进：使用思源的悬停样式替换部分悬停效果；
- 新增：反向链接排除和指定正则匹配设置；
- 新增：反链链接排序方式；
- 改进：设置页；
  
  设置项移除提示将在新版本安装后提示一次：
  部分在“试验田”结束测试的设置已经移动到“内容展示逻辑”或“通用”选项卡；

### v1.3.0-beta1 （2024年8月16日）

- 修复：开启“导航区不再插在文档标题所在HTML元素”且“文档自适应”宽度关闭，插件没有处理宽度变化的问题；
- 改进：使用思源的悬停样式替换部分悬停效果；
- 新增：反向链接排除和指定正则匹配设置；
- 新增：反链链接排序方式；

### v1.2.0 (2024年7月22日)

- 新增：（设置项）自第x个内容区起，隐藏内容区；
- 新增：（设置项）在面包屑前加入当前笔记本层级；
- 回滚：撤销v1.1.0中“修复：安卓端导航区被文档图标遮挡的问题”的更改；
- 修复：面包屑部分鼠标悬停时显示undefined的问题；
- 修复：设置面板关闭后未销毁的问题（感谢 Frostime https://ld246.com/article/1721278971170 ）；

相较于 beta1：
- 调整：面包屑中笔记本层级的背景色；
- 调整：隐藏内容区功能改为各个内容区独立隐藏；

### v1.2.0-beta1 (2024年7月19日)

- 新增：（设置项）自第x个内容区起，隐藏内容区；
- 新增：（设置项）在面包屑前加入当前笔记本层级；
- 回滚：撤销v1.1.0中“修复：安卓端导航区被文档图标遮挡的问题”的更改；
- 修复：面包屑部分鼠标悬停时显示undefined的问题；
- 修复：设置面板关闭后未销毁的问题（感谢 Frostime https://ld246.com/article/1721278971170 ）；

### v1.1.0 (2024年6月16日)

- 新增：正向链接内容区；
- 修复：安卓端导航区被文档图标遮挡的问题；
- 新增：（设置项）显示详细日志，帮助定位问题；
- 调整：禁用读取设置后立即保存，尝试避免潜在的设置覆盖；
- 改进：鼠标悬停在内容区空白位置，将通过title显示内容区名称；

### v1.0.6 (2024年5月31日)

- 改进：增大内容区间距；
- 新增：（设置项-外观）悬停显示内容区边框；
- 改进：右键内容区，将临时展开内容区高度；
- 调整：升级至此版本，将默认开启“导航区不再插在文档标题所在的HTML元素”、默认禁用“调整文档图标位置”；
  （原：内容区插入在“标题”元素内部下方；调整为：内容区插在“标题”元素外部下方）

### v1.0.5 (2024年5月15日)
- 修复：“不存在文档时隐藏”对挂件、上一篇下一篇、往年今日内容区无效的问题；
- 新增：（设置项）🧪导航区不再插在文档标题所在的HTML元素；
- 修复：非https、localhost环境下，无法打开插件设置页的问题；
- 调整：等宽分列数的生效范围；
  
    增加生效范围：反链、往年今日内容区；

### v1.0.4 (2024年4月25日)

- 修复：“往年今日”在亿些情况下无法显示的问题；
- 新增：（设置项）🧪移动端侧滑返回时更新；
- 新增：（设置项）🧪移动端更新时移除全部内容区；
  - 此项在v1.0.2、v1.0.3是默认启用的，但自此版本起默认禁用；


### v1.0.3 (2024年4月2日)

- 修复：移动端闪卡面包屑未能显示的问题；

### v1.0.2 (2024年4月2日)
- 改进：调整部分代码逻辑，加快响应速度；
- 修复：没有相邻文档时，区域未显示“无”的问题；
- 设置项：
  > 本次调整了样式CSS的实现，请自定义CSS的用户注意修改代码片段或插件外观设置；

  - 调整：文档名最大长度的实现，现在此设置仅对子文档菜单生效，对页面内容不生效；
  - 调整：`sameWidth`文档链接相同宽度的实现更改为`min-width`，用于等宽分列下控制最小列宽；
  - 新增：子文档、同级文档区域等宽分列显示控制；
  - 新增：🧪上一篇、下一篇支持跟随日记跳转（内容区可选项，文档/块较多时，将导致显示延迟）；
- 改进：上一篇下一篇快捷键在识别为日记且文档树上下一篇获取失败时，跟随日记属性`custom-dailynote-yyyyMMdd`跳转；
- 修复：移动端内容区重复显示（切换时未清空内容区）；
- 修复：移动端插件冲突导致导航区显示错误的问题；（关于侧滑返回不更新的问题，请升级到思源v3.0.6或更高版本）
- 新增：🧪往年今日内容区；

### v1.0.1 (2024年3月14日)
- 修复：一些情况下设置项回滚为默认设置的问题；
- 新增：“间隔复习”界面新增“块面包屑”内容区；
- 改进：部分内容区获取改为异步进行，提升响应速度；
- 改进：对隐藏文档的处理，详见试验田中设置项；
- 修复：对一些常见的字符实体进行转义；
- 移除：出错重试；
- 改进：跟随fdb更新：面包屑子文档菜单加入图标；

### v1.0.0 (2024年3月4日)
- 重构：使用`vite-vue-ts`重构项目，**这带来了一些尚未被发现的bugs（缺陷），导致原本能够使用的功能未被迁移或出错**；
- 新增：
  - 内容区显示控制，支持自定义排序；
  - 支持在“间隔复习”界面显示文档导航，内容独立控制（在全屏下点击将在后台打开文档！）；
  - 支持文档自定义显示顺序和显示内容（原有的og文档导航忽略参数优先生效）（设置方法：文档上增加属性`og-hn-content`，属性值为数组，例`["parent", "child", "info"]`）；
- 改进：
  - 一定程度上加快显示速度，现在使用`loaded-protyle`事件调起；
  - 跟随文档面包屑变更，在不存在子文档时不显示最后一个`>`；
- 修复：
  - `listChildDocs`部分不能正常显示的问题；
  - 有时安卓端不能显示的问题；
  - 部分分屏情况下不显示的问题；
  - 分屏情况下，点击导航打开的文档不在所在分屏区的问题；
- UI：
  - 新的设置项页面，希望能够使得设置项更好找；
- 移除：
  - 设置项：立即更新（由`ws-main`触发无protyle信息，重构后不兼容使用`id`定位）；


### v0.2.12 (2024年2月4日)
- 修复：“文档最大数量”设置为0时，子文档、同级文档不显示的问题;

### v0.2.11 (2024年2月1日)
- 修复：“文档最大数量”设置较小时，导致思源提示，并可能导致无法显示、相邻文档跳转失败的问题；
- 新增：快捷键打开第一个子文档；

### v0.2.10 (2023年11月28日)
- 修复：禁用“隐藏导航区提示词”时，导航区域宽度溢出的问题；
- 修复：移动端lcd挂件不能在文档切换后刷新的问题；
- 新增：🧪支持显示反链区域；

### v0.2.9 (2023年11月14日)

- 界面：
  - 设置页面高度增加；
  - 上下文档加入提示词“邻”；
  - 设置最大最小值判定（同步面包屑插件更改）；
  - 在显示提示词时，第二行起与提示词结尾对齐缩进；
- 改进：尽快响应新分屏中的页签；
- 改进：🧪（设置项）出错重试次数，默认为5，减少不显示的概率；
- 修复：反复按下“返回父文档”快捷键后，有概率不能连续响应的问题；（快捷键绑定换用callback实现）；
- 新增：快捷键：打开同层级上一篇、下一篇文档；
- 新增：🧪（设置项）文档包含数据库时，不显示子文档区域；
- 新增：🧪（设置项）空白文档判定阈值（用于控制lcd挂件的显示）；

### v0.2.8 (2023年10月18日)
- 新增：引入思源编辑器内快捷键，用于在当前位置（当前块下方）插入listChildDocs挂件；
  （为防止用户误触，默认不绑定组合键，需要在`设置`-`快捷键`-`插件`-`文档层级导航`-`插入lcd挂件`处自行设置对应的组合键）
- 新增：设置项“始终显示同级文档”；
- 改进：同级文档中，当前文档对应的链接样式调整（对应css类`og-hn-docLinksWrapper-hl`）；

### v0.2.7 (2023年9月11日)
- 修复：同层级上一篇、下一篇样式问题；
- 改进：容器样式，缩短与正文的间距；
- 新增：思源内快捷键`Ctrl + Alt + ←`打开父文档；
### v0.2.6 (2023年9月3日)
- 新增：🧪（设置项）显示同级文档的上一篇、下一篇；
- 新增：🧪对于空白父文档，支持使用listChildDocs替代子文档部分；
- 修复：（设置项：使用文档面包屑替代父文档部分）尝试兼容Tsundoku主题；
- 改进：缓解快速切换页签导致短暂显示错误的问题；
- 移除：出错重试；改用`onLayoutReady`尝试一次；
- 改进：关闭插件后移除已经插入的文档导航容器；

### v0.2.6-beta3 (2023年8月29日)
- 修复：上一篇下一篇中未处理`.sy`后缀的问题；
- 修复：尝试与Tsundoku主题兼容；

### v0.2.6-beta2 (2023年8月28日)
- 新增：🧪同级文档的上一篇、下一篇；

### v0.2.6-beta1 (2023年8月24日)
- 新增：🧪对于空白父文档，支持使用listChildDocs替代子文档部分；
- 改进：缓解快速切换页签导致短暂显示错误的问题；
- 移除：出错重试；改用`onLayoutReady`尝试一次；
- 改进：关闭插件后移除已经插入的文档导航容器；

### v0.2.5 (2023年7月10日)
- 修复：部分情况下，提示词和链接没有对齐的问题；
- 改进：“无”的样式；
- 改进：没有子文档时，不显示子文档字符总数；
- 修复：子文档总字符数重复统计的问题；

### v0.2.4 (2023年7月9日)
- 新增：在首行显示当前文档的相关信息；
- 修复：对于刚创建的文档，文档导航显示错误的问题（现在最差的情况是不显示）；
- 新增：🧪使用文档面包屑替代父文档部分；

### v0.2.3 (2023年6月20日)
- 改进：新增设置项以在无文档时不显示“无”；

### v0.2.2（2023年6月9日）
- 改进：切换页签后更新文档导航；
- 改进：检查文档变化并立即更新文档导航；

### v0.2.1（2023年5月31日）

- 修复：在v2.8.10-dev5出现错误的问题；
- 改进：默认调整图标位置；

### v0.2.0 (2023年5月26日)

- 重构：迁移至官方插件系统；
- 改进：支持设定最大高度，控制占用的空间；
- 改进：带有`og-hn-ignore`或`og文档导航忽略`属性或属性值的文档将被忽略；

### v0.1.1 (2023年4月26日)

- 新增：设置项配置；
- 改进：默认样式；
- 修复：快速切换标签页插入错误的问题；
- 修复：导致选项`转移引用`无法显示；
- 修复：安卓端问题；

### v0.1.0

首次发布。