Obsidian多库管理GUI工作台复盘

我一开始没想着做什么插件，就是单纯想用 Obsidian 管好自己的知识。

但用着用着，两件事越来越不对劲。第一，我的知识天然分了好几摊——笔记、AI 素材、公开要发出去的内容，它们不该搅在一起，所以我开了好几个库。第二，Obsidian 一个窗口只能开一个库，想翻一眼别的库，就得切窗口、等加载、再切回来。库越多，不能在一个界面查看预览，就显得有些繁琐。

于是我动了个念头：能不能在 Obsidian 上，自己动手做一块图形化的工作台界面？一个能同时把多个库都管起来的 GUI，让我不切窗口就能浏览、预览、编辑所有库的东西。

这个念头最后落地成了 Vault Workbench——一个把「浏览、预览、编辑所有库」塞进一块面板的插件。它最近刚通过社区插件目录的自动化审核，正式上架。这篇文章就是一次完整复盘，从我为什么要做它讲起，到上架，中间踩过的坑我尽量都摊开讲。

这是篇复盘，不是教程。想装的话，插件市场搜「Vault Workbench」就有，源码在 GitHub：Bevis23/vault-hub。

一、先把痛点拆成四件事

动手之前，我先想清楚这块工作台到底要什么。四件事，一件不能少：

第四件事其实最难，也最容易被技术人忽略。我一开始没当回事，后来被主题兼容教育了好几次。

Obsidian 的 API 是有边界的。app.vault 看得到、摸得着的，只有当前打开的那个库。你想读写另一个库的文件，官方 API 帮不上忙，得自己想办法。

我最后走的是「自己直接读文件系统」这条路：

用 Node 的 fs 去读写别的库的 .md，原子写，改到一半出错不会写坏文件。
但移动、重命名、删除，一律交回给库自己的 fileManager——因为自己 fs 挪文件，[[双链]] 不会跟着更新，回收站策略也会失效。

这里有个特别容易翻车的细节，我记一下：删除别的库的文件，不能真删，得先挪进那个库自己的 .trash/，还要在 .trash/.vwb-trash.json 里记一条「回收站名字 → 原路径」的映射，原路径必须落盘。不然 Obsidian 一重启，回收站里那个文件就还原不回去了。

一句话总结：读和写正文，自己来；动结构，交给库自己。边界划清楚，后面才不出岔子。

隔离这件事，本质不是「加密」那种隔离，而是别在库之间搞破坏。我的红线很早就定死了：不自动合并库、不帮用户同步、不做跨库双链、不做跨库移动。这四条，全是拿「笔记完整性」换「一时方便」的买卖，不划算。

这个能力算是我觉得最拿得出手的：右键一个库 → 「切换到此库」，插件会先把自己装进那个库，再跳过去。切过去照样有工作台，而不是一个裸库。

但「装自己」这套逻辑，踩的坑全在细节里：

还有一条躲不掉的：每个库第一次进，用户得手动关一次「受限模式」。这是 Obsidian 的安全设计，插件没法预置，只能在提示里写清楚。

工作台的布局是左中右三段：左库导航、中文件区、右预览面板。文件区有网格/列表双视图，支持多选批量操作、框选、空白处右键；预览面板能看图、看 PDF、看音视频。

但真正磨人的是 CSS。我踩得最疼的坑，是层叠上下文：

filter、backdrop-filter、transform、will-change，这四样东西都会偷偷生成一个层叠上下文，里面的 z-index 写得再大也出不去。
更坑的是，被盖住的元素，同时也收不到点击。弹层点了没反应，第一反应是去改业务逻辑，其实往往是层没压住。

这类问题我前后踩了四次，症状清一色「弹层被盖住 / 点了没反应」。最后总结成一句铁律记进项目文档：先怀疑层没压住，别急着改逻辑。

样式兼容这块，我的选择是用 Obsidian 的原生 CSS 变量，不硬编码颜色。这样用户换主题，界面跟着换肤，不用我维护一套独立皮肤。

版本管理我用语义化版本，manifest.json 的 version → CHANGELOG → versions.json 三处必须同步，漏一处就出乱子。提交社区插件目录要 PR 到 obsidian-releases 仓库，然后等自动化安全审核。

审核比我以为的严，也逼我学了不少「隐性规范」：

manifest 的 id 只能是小写字母加连字符，不能含 obsidian；name 不能含 Obsidian；description 不能以插件名开头，还必须以 ./!/? 结尾。
描述里不能写「this plugin / the plugin」这种自我指代——会被判 Warning，得直接描述功能。
README 得有足够比例的英文，否则被判 “no English text”。我最后把 README 拆成了英文门面 + 中文完整文档。