Skip to content

Latest commit

 

History

History
82 lines (54 loc) · 7.27 KB

File metadata and controls

82 lines (54 loc) · 7.27 KB

访达(Finder)

思源笔记的分栏文件浏览器:以列视图方式浏览、整理笔记本与文档,右端附当前文档的预览面板。

功能

  • 两种常驻方式:展开模式默认仅让笔记本常驻;也可让笔记本与全部一级笔记共同常驻。
  • 两种浏览模式:展开与聚焦在设置中并排选择;切换模式会保留当前文档和层级位置。展开模式保留层级上下文,聚焦模式把同级文档与当前项子树收束在一个栏位中。
  • 两种宽度策略:默认把全部栏位与预览收纳在面板内;也可关闭「整面板显示全部栏位」,让左侧导航保持栏宽并横向滚动,右侧预览始终固定。拖动时仅改变分界线两侧,栏宽自动记忆;双击可恢复默认比例。
  • 逐级浏览:单击选中并预览,双击在编辑器中打开;叶子文档只切换预览,不建立空栏。所有正文均跟随预览面板自适应宽度。
  • 文档标题搜索:点击右上角搜索按钮或在面板导航区按 F,只检索设置中显示的笔记本与文档标题,不混入正文内容块;选择结果后自动恢复文档的真实层级位置。
  • 思源原生文档标签:只聚合设置中所显示笔记本的文档根块标签,不混入正文里的行级 #标签#。文档右键菜单可用访达式勾选列表分配标签;已有标签的重命名、删除与分配均使用思源原生接口,插件只补充显示颜色。
  • 标签浏览模式:点击右上角标签按钮或在面板导航区按 T,第一栏显示文档标签,第二栏汇集该标签下跨笔记本的文档,后续继续使用当前的展开或聚焦模式。两栏底部均可排序,标签栏还可新增和删除标签;思源不支持脱离块存在的空标签,因此新建后先作为待用标签显示,首次分配给文档即成为原生标签。面包屑以彩色标签开头,同时保留文档的真实祖先路径。
  • 可选标题大纲:在预览正文左侧严格按正文顺序显示标题树,并按真实父子关系缩进、折叠;标题树与正文使用相同背景,默认按预览宽度自动分配协调比例,也可拖动并记忆。选择标题后只显示其控制的可编辑正文。此功能默认关闭。
  • 正文与信息预览:可直接编辑当前文档正文;编辑期间不会被后台列表更新打断。下方显示创建与更新时间、子文档数、提及、原生文档标签、书签、命名、别名和备注;没有内容的项目自动隐藏。信息少时贴底收缩,信息多时在区内滚动,不挤压正文;分界线中央的独立按钮或面板内 I 可平滑收起、恢复信息区,状态自动记忆。
  • 协调的预览字号:默认以编辑器字号为基准,随预览正文宽度在 72%–85% 间平滑调整;也可在设置中固定为编辑器字号的 70%–100%。
  • 反向链接与关系图:反链沿用来源文档图标并可点击打开;当前文档关系图沿用思源数据与过滤配置,支持缩放、平移、拖动再平衡、悬停聚焦和单击打开,并按节点数量自动调整布局。
  • 自动刷新与状态保持:监听思源文档事件自动更新,同时保留选中链和各栏滚动位置。
  • 可记忆栏宽:保持默认栏宽时无需配置;可拖动任意分栏线调整宽度,双击分栏线恢复默认。导航栏按角色记忆,预览面板按浏览方式、可见层级数与标题栏状态分别记忆,重新进入相同布局时自动恢复。

排序与管理

  • 各栏底部左侧的图标表示当前排序方式,点击后可选择跟随文档树、名称、创建时间、更新时间或自定义拖拽;当前项会被勾选。
  • 一级笔记在整栏内统一排序,更深层级分别记忆;笔记本支持文档树顺序、名称和自定义拖拽。自定义顺序只影响访达面板,不修改思源原生文档树顺序。
  • 底部右侧的 + 用于新建笔记本或文档。文档右键菜单支持新建子级或同级、就地重命名、移动和删除;笔记本右键菜单支持新建、重命名、关闭和删除。
  • 拖动文档到条目中央可移入其内,拖到上下边缘可排序或落位,拖到列表空白或笔记本可移到该层;删除文档使用思源正式接口,可在「数据历史」中恢复。
  • 点击笔记本或文档自身的图标,可调用思源原生图标面板进行更换。

使用

插件默认在每次启动思源时自动打开一次访达;如果本次使用中手动关闭,不会再次自动打开。也可点击思源顶栏的访达图标,或在命令面板中执行「打开访达」。所有入口只会保留一个访达页签;页签已打开或固定时会直接切换过去。插件初始使用展开模式,并默认开启「整面板显示全部栏位」。设置中的两项展开模式选项始终可见;切到聚焦模式时会自动变灰并停止响应。

展开模式沿用所选的常驻栏位方式,并只在最右侧当前栏预展直接子文档;聚焦模式使用 OneNote 式同栏树状浏览。两种模式都只有在所选文档仍有子文档时才继续进入下一层,叶子文档始终留在父级列表中并只切换预览。两种模式都可通过面包屑返回任意祖先层级。标题大纲启用后融合在预览面板上部,不占用文档分栏数量。

访达页签可见时可按 S 打开设置、按 F 搜索文档标题、按 T 切换标签浏览、按 I 收起或恢复信息区;正文编辑、表单输入或对话框中不会触发。面板获得焦点后还可使用方向键:

  • / :在当前栏移动选择
  • :返回上一层
  • :进入子级
  • macOS ⌘↑ / ⌘↓,Windows/Linux Ctrl+↑ / Ctrl+↓:跳到当前栏第一项或最后一项

数据

设置、排序偏好、栏宽、信息区折叠状态、标签显示颜色、尚未分配的待用标签和上次定位状态保存在插件数据 finder.json 中。分配标签时写入思源原生文档标签;其他浏览状态不修改文档内容。首次启用时会自动继承旧版「展卷 / 分栏导航」的设置。

构建

pnpm install
pnpm build
pnpm make-install

许可证

MIT


支持开发——Buy me a token

本插件完全通过 vibe coding 开发:

  • Claude Code(Fable 5):约 40% 任务量
  • Codex(GPT 5.6 Sol):约 60% 任务量

(以上为插件初版发布时的预估,后续不断更新,始终选用了更新时刻所能用到的顶尖模型)

顶尖模型价格昂贵,个人学业时间安排紧张,创作不易,如果您喜欢或受益于本插件,欢迎您支持插件的开发。我会持续更新,让体验越来越好。

请备注您的链滴账户名或其他任何社交账户,我会将您列入插件赞助名单,以表感激。您的支持是我创作的最大动力!

微信支付 支付宝

赞助者

讨论

思源访达插件:从文档树到文档面板,实现笔记子文档的自定义排序 - 链滴