Improve the outline panel

[Achuan-2]

实现标题大纲持久化、展开特定级别标题、添加保持当前标题展开按钮、支持大纲筛选、标题添加右键菜单

功能改进

1. 大纲持久化

   关联：持久化文档大纲状态 #12387

   • 在data/storage文件夹下创建outline.json文件，记录文档展开的标题ID，最多记录2000个文档
   • 每个文档的大纲折叠状态持久化保存，子标题折叠后，再折叠父标题，展开父标题后，依然能保持子标题折叠状态
   • 再次打开同一文档时，自动恢复上次的折叠状态
   • 新建标题、更新标题文字、拖拽标题时，不更改已折叠的标题状态

2. 支持alt click标题图标折叠/展开同级标题

3. 新增标题展开特定层级按钮

   关联：The outline panel supports expansion by the specified level #11533

   

4. 新增保持当前标题展开按钮，保持全部展开改为全部展开按钮

   • 为什么要改进

     • 保持全部展开这个功能我感觉用处不大，还很容易让用户以为就是普通的全部展开按钮，不知道是会一直持续起作用的，而且很多时候是不需要一直保持全部展开状态的，只是需要展开当前编辑的标题

       个人觉得把 保持全部展开改为普通的全部展开，然后新增一个 保持当前标题展开会更有用，就是当前我编辑这个标题，标题大纲定位到这个标题，就会自动展开到当前标题，把父标题都展开，不影响其他标题，这样就算一直起作用影响也小一点，不至于标题全部都展开了

   • 保持当前标题展开功能

     • 标题大纲定位到这个标题，就会自动展开到当前标题，把父标题都展开
     • 如果父节点是折叠状态，展开路径时会自动折叠兄弟节点，只展开当前节点路径，避免增加干扰，如果父节点是展开状态，则不影响兄弟节点折叠状态
   

   

5. 右键click点击折叠图标，会折叠/展开所有子标题

6. 大纲支持筛选功能

   

   • ✅如果标题命中筛选，这个标题的所有父标题展开，以显示出这个标题位置
   • ✅如果父标题命中筛选，子项都没有命中筛选，则折叠全部子项（依然可以展开显示）
   • ✅如果父标题命中筛选，子项也有命中筛选，则展开命中的子项，其他无关子项隐藏

7. 支持右键菜单

[github-actions]

Your PR was set to target master, PRs should be target dev
The base branch of this PR has been automatically changed to dev, please check that there are no merge conflicts

[TCOTC]

重启思源之后大纲能恢复吗？

[Achuan-2]

重启思源之后大纲能恢复吗？

可以的，重启后localstorage依然还在的

[Achuan-2]

实现了
alt click标题图标折叠/展开同级标题和标题展开特定层级按钮

[Achuan-2]

改为在data/storage文件夹下创建outline.json文件，只需要新建一个json来统一管理，不需要像方案二一样，新文档都新建json

---

• ❌方案一：localstorage

  localstorage 会多出 window.siyuan.storage["local-outline"].expand 字段，用来存储打开文档的标题 id

  随着打开文档数量增多，这个字段会越来越大

• ❌方案二：在data/storage文件夹下创建outline/${docID}.json文件

  • 在data/storage文件夹下创建outline/${docID}.json文件，记录文档展开的标题ID，需要修改kernel\model\storage.go、kernel\api\storage.go、kernel\api\router.go文件
  • 修改app\src\layout\dock\Outline.ts，不用window.siyuan.storage["local-outline"].expand，而用api来获取outline.json的数据

  好处

  • 每个文档都一个json，文件小，读取json文件会快一点

  缺点

  • 会新建很多json文件
  • 太多json文件对复制文件夹、同步文件而言是一种负担

• ✅方案三：在data/storage文件夹下创建outline.json文件

  • outline 标题展开信息改为保存在一个json文件里，在data/storage文件夹下创建outline.json文件，需要修改kernel\model\storage.go、kernel\api\storage.go

  • 好处

    • 只需要新建一个json来统一管理，不需要像方案二一样，新文档都新建json

  • 缺点

    • 会越累积越大，如果文档很多，可能写入比较慢（不过一般人文档顶多也就几千，其实也大不到哪里去）

      可以加一个机制，outline.json只存储最近打开的前1000个文档，或者文档超过一年都没打开，就删除折叠标题信息，其实也没必要记住所有文档的标题折叠信息，一个文档长期不打开，就没必要记录了（可以在清理数据

• 方案四：写入sy文件

  • 这个比较适合思源官方来做

  • 缺点

    • 需要持久化标题大纲的文档，文件一般比较大，读写json会比较慢，我觉得还是独立开比较好

[TCOTC]

outline.json 是不是会越来越大？参与同步吗？

[Achuan-2]

outline.json 是不是会越来越大？参与同步吗？

几百万行的json才算大，有1w文档都算超级多的了，没多少用户有这个量级

7w字的思源笔记sy文件，40w字符，才590k大小，倒是不必担心文件大小
2.
storage文件参与同步的

[Achuan-2]

可以加一个机制，outline.json只存储最近打开的前2000个文档，或者文档超过一年都没打开，就删除折叠标题信息，其实也没必要记住所有文档的标题折叠信息，一个文档长期不打开，就没必要记录了

[Achuan-2]

新增保持当前标题展开按钮，保持全部展开改为全部展开按钮

舒服多了

[88250]

@Achuan-2 我和 V 开始 review 了

[TCOTC]

备注：需要回顾原始需求

• 持久化文档大纲状态 #12387
• The outline panel supports expansion by the specified level #11533

[88250]

推迟到 v3.3.6

[Copilot]

Pull Request Overview

This PR significantly enhances the outline panel with persistent storage, search filtering, level expansion controls, and comprehensive context menu functionality.

• Persistent storage: Document outline fold states are now saved to data/storage/outline.json and restored when reopening documents
• Enhanced UI controls: Added search filtering, level-based expansion, and "keep current heading expanded" functionality
• Context menu integration: Right-click menus for heading operations like upgrade/downgrade, copy/cut with children, and insert operations

Reviewed Changes

Copilot reviewed 19 out of 19 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
kernel/model/storage.go	Implements backend storage for outline states with 2000 document limit
kernel/api/storage.go	Adds API endpoints for outline storage operations
kernel/api/router.go	Registers new outline storage API routes
app/src/util/Tree.ts	Enhances tree component with right-click expand/collapse and toggle callbacks
app/src/protyle/util/compatibility.ts	Updates default storage structure for outline
app/src/layout/dock/Outline.ts	Major overhaul adding filtering, context menus, level expansion, and persistence
app/appearance/langs/*.json	Adds localized strings for new outline features

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[TCOTC]

后续问题：#16121

[QYLexpired]

无敌了这个pr，感谢川佬