Repository navigation
Releases
Releases · tmdt5217/external-vault
1.12.11
1.12.10
1.12.10
别名(同义词)与库内一致
[[补全里现在能用 frontmatteraliases搜到外库笔记:弹窗显示「别名 + 文件名」,选中插入[[文件名|别名]],与库内笔记完全一致。- 为此给
metadataCache.fileToLinktext打了补丁:库外文件直接返回相对名字,否则原生会把外库路径当库内路径算出一串垃圾链接。
轻量索引也能按别名搜索
- 超过 5 万篇的轻量索引不再跳过 frontmatter:每篇只读前 4 KB 取别名,正文仍不读(链接图与附件数照旧缺)。
- 建索引流程改为「先全部 stat → 再批量读」,读取并发 32。
- 旧索引里没有别名字段的条目会在下次扫描时自动回填一次,不需要手动删索引。
- 代价:首次建索引变慢(20 万 8–12 s、40 万 20–30 s),之后新增/修改只读那一篇,不会全库重扫。
修复
- 差量校准的深度口径与全量扫描不一致:深层附件被误判为已删除。
- 差量校准的收录口径不一致:同一批文件每次差量都被重复加入。
- 重命名后
[[补全仍显示旧名字。 - watcher 删除文件后,文件名/别名解析表仍保留该文件。
- watcher 增删后
[[补全缓存不失效。 - 外库目录临时不可用时会把索引清空(同步盘未挂载等):现在目录不存在直接跳过校准并返回失败。
- 60 秒短路忽略了待处理变更标记,可能跳过校准用到旧数据。
容量参考(更新后)
| 指标 | 20 万篇 | 40 万篇 |
|---|---|---|
| 首次建索引 | 8 – 12 s | 20 – 30 s |
| 全量校准(每会话首次) | 3.5 – 7 s | 13 – 14 s |
| 差量校准(之后每次) | 0.4 – 0.7 s | 1.0 – 1.2 s |
| 索引文件 | 42 MB | 84 MB |
| 内存 | 0.3 – 0.4 GB | 0.8 – 0.9 GB |
1.12.9
1.12.9
笔记上限(重点)
这一版把大库路径重新测了一遍,20 万是推荐上限,40 万可用但偏重,50 万以上不建议。
| 指标 | 20 万篇 | 40 万篇 |
|---|---|---|
| 首次建索引(一次性) | 3 – 5.5 s | 10 – 12 s |
| 全量校准(每会话首次 / 索引过期) | 3.5 – 7 s | 14 – 16 s |
| 差量校准(之后每次删除、清理前) | 0.4 – 0.7 s | 1.0 – 1.1 s |
| 索引文件 | 39 MB | 79 MB |
| 打开索引 | 0.09 s | 0.2 s |
[[ 补全首次构建 / 之后 |
32 ms / ≈0 | 82 ms / ≈0 |
| 搜索一次 | 5 – 6 ms | 10 – 13 ms |
| 内存 | 0.3 – 0.4 GB | 0.8 – 1.0 GB |
- ≤ 10 万:完全无感。
- 20 万:推荐上限,日常操作毫秒级。
- 40 万:首次/校准等 10–16 s,内存 0.8–1.0 GB,接近 Electron 渲染进程舒适上限。
- 50 万以上:不建议(外推内存 >1.2 GB)。
注意:附件也占索引条目,20 万 MD + 20 万图 = 40 万条,按右列看。
优化
- 删除 / 清理孤儿附件前的校准改为差量:本次会话第一次仍做全量 stat(20 万 3–7 s、40 万 14–16 s),之后只做
readdir路径比对,新增文件才 stat,删掉的文件直接移除;内容修改交给常驻文件监听。40 万从 14.5 s 降到 1.1 s(约 13×)。 [[补全取消 5 万条上限:现在所有外库笔记都能被搜到。条目按索引版本缓存,索引变化后第一次构建 32 ms(20 万)/ 82 ms(40 万),之后命中缓存 ≈0 ms。
修复
- 删除外库文件后,索引里只删了内存映射、没从条目数组移除,导致已删除的笔记一直留在面板和统计里,直到下次全量扫描。
1.12.8
1.12.8
新增
[[补全里能选到外库笔记:在内置的链接补全列表中追加 External Vault 里的 Markdown(按文件名和相对路径),选中后插入[[名字]],点击即可打开库外文件。没有替换 Obsidian 原生的补全,库内笔记 / 别名 / 标题补全照旧- 拖到正文时的插入提示:拖动外库笔记到笔记正文,会显示深色提示卡「文件名 / 在此处插入链接」以及闪烁插入光标(按落点坐标绘制),松开后在该位置插入相对链接
修复
- 拖到正文曾被误判为「落在标签页上」并替换标签:现在标签区域严格限定在标签头 / 标签栏,正文区域单独处理
- 拖动时多余的白色文件名残影已去除,只保留深色提示卡
[[子目录/笔记]]这种带目录的写法现在也能解析到外库文件(此前只认裸文件名)
1.12.7
1.12.7
新增
- 把外库笔记拖到标签页打开:
- 拖到某个标签的中间 → 在该标签里打开(替换内容),目标标签会高亮,提示卡显示「替换当前标签页」
- 拖到标签的左右边缘、标签之间的缝隙、或最后一个标签右侧空白 → 按位置插入新标签页,并显示绿色插入线
- 拖动时跟随光标的深色提示卡(文件图标 + 文件名 + 说明)
- 面板右键菜单新增「在新标签页中打开」,作为拖拽之外的等价入口
修复
- 面板内小幅拖动会误移入库内:面板列表复用了
nav-files-container这个 class,被误判成库内文件列表;现在会排除面板自身 - 拖到标签页时不再生成打不开的「×」标签页(此前 Obsidian 会把拖拽里的链接文本当文件打开)
- 拖进编辑器时仍会插入指向该文件的相对链接(库内、库外笔记都支持,由插件自行处理)
性能
- 拖动过程:标签几何量每次拖动只读一次、视觉更新限频 30ms、提示卡 DOM 只创建一次
- 拖动期间不再重建面板列表(避免被拖节点被销毁导致拖拽卡住)
- 提示卡在
drop/dragend丢失时(mouseup、Esc、窗口失焦、1.5 秒看门狗)自动清理
1.12.6
1.12.6
性能
- 「清理孤儿附件」在超过 5000 篇时改用反向索引判断:先做一次 stat 校准(20 万篇约 3 秒,只有变化的文件才读正文),再按「名字 → 笔记」反查,不再逐篇读全文(旧实现是分钟级)
修复
- 删除判断的新鲜度:用索引下结论前强制校准,避免索引过期漏掉一条引用而误删仍在使用的附件
- 查表键不匹配:删除路径按
a.png查,而 markdown 引用登记的是去掉扩展名的a,导致查不到 → 现在双键都查 - 索引维护:编辑/重命名/删除笔记时同步更新反向索引,不再只更新名字缓存
- 监听归属:目录监听改由插件常驻(侧栏关着也生效),切换外库时重建,修掉「切库后还在盯旧目录」
说明
- 小库(≤5000 篇)仍逐篇精确扫描;索引不可用或校准失败时自动回退扫描
- 破坏性操作前会弹「正在校准外库索引…」提示(仅大库)
1.12.5
1.12.5
修复
- 链接特殊字符:目标里的
%#?在所有风格下统一转义。a#b.png→a%23b.png、50%off.png→50%25off.png,不再生成坏链或被当成锚点 - 非 macOS 的撤销:
findTrashItem只实现了 macOS,Windows/Linux 即使开着废纸篓也无法恢复。现在非 macOS 一律先写.undo/move-*备份 - 孤儿附件误判:
![[图片]]这类按文件名引用的附件不再被当成孤儿,批量清理不会误删 - 删除卡顿:共享附件检测优先查反向索引(O(附件数));无索引时限 5000 篇,超限按「全部共享」保守处理,避免 20 万篇全读
1.12.4
1.12.3
1.12.3
新增
- 每个外部库显示 MD 篇数:右侧面板顶部、Ribbon 菜单、设置里「当前外部库 / 其他外部库」逐行显示。当前库直接读索引(零读盘),其他库遍历目录并缓存 5 分钟
- 多库时先选库:配置了多个外部库时,Ribbon 菜单里的「打开库外文件 / 打开面板 / 打开附件目录 / 新建笔记 / 管理库外文件 / 清理孤儿附件 / 复制路径」会先弹出二级菜单,列出各库及篇数,选完自动切过去执行;只有一个库时不打扰
修复
- 多库切换时索引文件互相覆盖:索引按库分开存放(默认库仍
index.json,其他库index-<id>.json),切换不再全量重建 - 切换外部库后会清空索引 / 名字 / 排序缓存并刷新面板,不再显示上一个库的内容
1.12.2
1.12.2
修复
- 删除库外笔记必崩:
deleteExternalNotes引用了不存在的变量direction,导致笔记删掉后附件变孤儿、撤销记录丢失 - 移出后侧栏索引不更新,面板看不到刚移出的笔记
- 重命名后
[[库外笔记名]]解析失效(名字缓存不重建) ![[图片|300]]的尺寸被当成 alt 文本丢掉,改为输出<img width>linkStyle = plain时,含空格 / 括号的路径会生成坏链接- 共享附件检测只看源笔记所在目录,改为「反向索引优先 + 递归兜底」,覆盖子目录引用
- 关闭废纸篓时移动无法撤销,改为先在
.undo/move-<时间戳>/留备份 - 两个目录之外的附件(如
../Pictures/a.jpg)只复制、保留原件,不再删除
新增
- 「接管富文本粘贴里的图片」设置:网页 / Word 图文一起复制时,文字按纯文本插入、图片仍存库外;关闭则交回 Obsidian