Repository navigation
Releases
0.2.3 - 挂载跟随改名与移动,索引自动找回
挂载现在会跟着改名和移动走
重命名或移动源文件夹之后,虚拟挂载不会再「指向一个已经不存在的路径」。插件运行期间的改动会立即跟随;插件没运行时的改动,会在下次启动时按内容指纹自动找回。
更新内容
- 修复:挂载跟随改名 / 移动。插件运行期间重命名、移动源文件夹或挂载点时,路径、自动推导的显示名和排序位置一起更新;你自己填写的显示名保持不动。
- 新增挂载索引
mounts.index.json(与data.json同目录):记录每个挂载最后一次的路径和内容指纹。插件没运行时发生的改名 / 移动会在启动时自动重新关联;data.json丢失时也能用索引恢复挂载。 - 安全策略:只有唯一匹配才重新绑定;同一项目的多份副本同时存在时放弃,不改动配置。挂载点永远不会被找回进它自己的源目录内部。
- 修复:与真实目录混排后挂载行会乱闪。核心重绘时改为在同一个任务内、浏览器绘制之前同步补注入,并复用被清掉的同一个节点(已展开的子目录不会回到折叠态);只有内容签名变化时才重建节点。
- 设置页:源路径失效的挂载会标出「路径不存在」,并新增「重建挂载索引」按钮。
安装
- 社区插件商店:设置 → 第三方插件 → 浏览 → 搜索 Virtual Mount(商店同步可能有延迟)。
- 手动安装:下载下方的
main.js、manifest.json、styles.css,放进<你的仓库>/.obsidian/plugins/virtual-mount/,重启 Obsidian 后在「设置 → 第三方插件」里启用。 - BRAT:添加
ko-Ani/obsidian-virtual-mount即可跟进后续版本。
完整更新日志见 CHANGELOG.md。
English
Mounts now follow renames. Renaming or moving the source folder (or the mount point) while the plugin is running updates the path, the automatically derived display name and the sort position together; a display name you typed yourself is left alone.
A new mount index mounts.index.json records each mount's last known paths and a content fingerprint, so renames and moves that happen while the plugin is not running are re-linked at startup — and the index can restore the mounts if data.json is lost. Only a unique fingerprint match is accepted, so two identical copies of a folder leave the configuration untouched.
Also fixed: no more flicker when mounts are sorted together with real entries. A core repaint is now repaired synchronously in the same task, before the browser paints, by re-inserting the very same node, so expanded subfolders keep their state. The settings tab flags broken paths as "Path missing" and adds a "Rebuild mount index" button.
Install from Settings → Community plugins → Browse → search “Virtual Mount”, by copying main.js, manifest.json and styles.css into <vault>/.obsidian/plugins/virtual-mount/, or with BRAT (ko-Ani/obsidian-virtual-mount).
0.2.1 - 虚拟子目录按需加载
虚拟子目录现在和原生文件夹一致
打开一个挂载不会再一次性展开整棵嵌套目录,大文件夹点开更快、更稳。
更新内容
- 默认折叠:虚拟子目录一开始都是收起的,点开时才渲染内容。
- 记住展开状态:折叠再展开父目录、或核心重建文件树之后,之前展开的子目录仍然保持展开。
- 新建挂载也默认折叠:和原生文件夹的体验一致。
安装
- 社区插件商店:设置 → 第三方插件 → 浏览 → 搜索 Virtual Mount(商店同步可能有延迟)。
- 手动安装:下载下方的
main.js、manifest.json、styles.css,放进<你的仓库>/.obsidian/plugins/virtual-mount/,重启 Obsidian 后在「设置 → 第三方插件」里启用。 - BRAT:添加
ko-Ani/obsidian-virtual-mount即可跟进后续版本。
完整更新日志见 CHANGELOG.md。
English
Virtual subfolders now start collapsed and render lazily, so opening a mount no longer expands the whole nested tree. Their open/closed state is remembered for the session, and new mounts start collapsed as well.
Install from Settings → Community plugins → Browse → search “Virtual Mount”, by copying main.js, manifest.json and styles.css into <vault>/.obsidian/plugins/virtual-mount/, or with BRAT (ko-Ani/obsidian-virtual-mount).
0.2.0 - native source menu
0.2.0 — native source menu
Right-clicking (or long-pressing) a virtual entry now behaves like right-clicking the real folder or note, instead of a tiny plugin-only menu.
Added
- Native source context menu — a virtual row hands its real
TAbstractFileback to the file explorer'sonFileContextMenu(), so core builds the menu it always builds:New note,New folder,Rename,Move,Make a copy,Deleteall operate on the source, not on the virtual row. - Plugin items
Reveal real location,Copy real pathand (on a mount root)Remove this mountare appended to that native menu. If the internal view method is unavailable, a built-in fallback menu is used.
Fixed
- On Obsidian 1.14+ the context menu could close itself after ~500 ms: core anchors the menu to the real (often off-screen) tree row and auto-dismisses it when that row is not visible. The row association is now hidden while the menu is built and restored immediately afterwards.
Compatibility
- Obsidian 1.6.0+, desktop and mobile. Verified against 1.14.5 and earlier 1.8.x.
Install
Download main.js, manifest.json and styles.css below into <vault>/.obsidian/plugins/virtual-mount/, then reload Obsidian.
0.1.0
First release.
Features
- Folder mirror: mount a real folder anywhere in the file explorer; files stay in one place and both locations update together.
- Single-note mounts: the same note can appear in several folders.
- Right-click entry: right-click (long-press on mobile) a folder, choose Mount as virtual folder..., pick the target folder and edit the display name.
- Native look: reuses the core tree classes, so themes, hover and active states apply.
- Live updates: create / delete / rename in the source folder is reflected immediately; renaming the source folder remaps the mount automatically.
- Bilingual UI: English or Chinese, following the Obsidian interface language.
- Desktop and mobile: isDesktopOnly false, with a clipboard fallback for mobile webviews.
Install
Copy main.js, manifest.json and styles.css into /.obsidian/plugins/virtual-mount/, then enable Virtual Mount.
Notes
- Tested on Obsidian 1.8.9 (desktop). Requires 1.6.0+.
- Virtual entries are navigation only: they cannot be dragged or renamed, and virtual paths are not linkable; links keep pointing at the real path.