为什么 MindXMap 使用文件夹存储

MindXMap 的主题阅读工具会逐步积累 Topic、书目、摘录、卡片、框架节点和图片附件。这些内容不是临时缓存，而是用户的长期知识资产。

所以我们选择 Vault-first：优先把数据写入你挑选的本地文件夹。

文件夹比数据库更可解释

很多工具把数据放进浏览器数据库或远端数据库。这样做对开发者很方便，但用户很难理解「我的东西在哪里」。

Vault 的好处是直观：你能看到一个文件夹，里面有 vault.json、topics/、attachments/。即使不打开 MindXMap，也知道数据没有被锁进一个看不见的地方。

和 Obsidian 的使用习惯对齐

MindXMap 不是 Obsidian 替代品。它更像一个思考工作台：把主题阅读、知识框架、因果回路和复习卡片串起来。

但 Obsidian 用户已经熟悉 Vault 这个心智模型：知识库就是一个本地文件夹。MindXMap 采用相似的结构，是为了让导入、备份和迁移都更自然。

本地优先，不等于没有兜底

如果浏览器支持 File System Access API，MindXMap 可以写入你选择的文件夹。

如果浏览器不支持，MindXMap 会自动进入 Browser-Storage Mode：数据仍在本机浏览器里，并持续写 OPFS 后备快照。等你需要迁移或备份时，可以导出一个和 Vault 结构同构的 ZIP。

这个设计遵守一个原则：用户什么都不做，也应该处在安全的默认路径上。

图片附件也跟着走

主题阅读里的图片不会上传到云端。粘贴或拖入图片时，MindXMap 会把它保存为本地 asset，并在正文里使用 asset://... 引用。

导出 ZIP 时，attachments/manifest.json 和附件文件会一起打包。导入 ZIP 后，正文里的图片引用仍能解析。

云同步是镜像，不是前提

未来如果加入云同步，Vault-first 仍然成立：云端同步的是本地 Vault 的镜像，而不是把本地数据迁移到一个全新的、不透明的云 schema。

这让 Phase 2 的云能力更像增强项，而不是使用产品的前置条件。

结论

MindXMap 使用文件夹存储，是为了让知识资产更接近用户，而不是更接近平台。

你可以从浏览器本地存储开始，也可以选择一个 Vault 文件夹。两条路径都会工作；当你积累了足够多的内容，再决定怎样备份和迁移也不晚。