NotePic 1.2.0 发布：Obsidian 图片上传后，本地残留也能清理了

很多 Obsidian 用户都会遇到这个情况：

1. 写作时把截图、配图、附件正常放进 Vault
2. 发布前用 NotePic 把图片上传到 OSS
3. Markdown 里的图片引用已经变成线上链接
4. 但原来的本地图片文件还留在附件目录里

如果只写几篇笔记，这不是大问题。

但如果你长期用 Obsidian 写文章、整理知识库，或者把整个 Vault 放进 Git 仓库同步，图片残留就会慢慢变成真实成本。

Markdown 文件通常只有几 KB，真正让仓库变重的往往是截图、封面图、演示图和各种已经不再被笔记引用的附件。

Git 仓库越重，clone、pull、push、备份和多端同步都会受到影响。尤其是 Obsidian Vault 里图片越来越多时，你可能已经不记得哪些图片还在被引用，哪些只是上传后留下来的历史包袱。

所以最新版本做的事情不是再增加一个上传按钮，而是让这些本地图片重新变得可见、可判断、可清理。

NotePic 最新版本新增了什么

NotePic 最新版本新增本地图片资产清理能力。

这次更新后，你可以在 Obsidian 里扫描 Vault 中的本地图片，并查看这些图片的引用状态。

它主要覆盖这些动作：

• 扫描 Vault 里的本地图片文件
• 区分已被笔记引用和未被引用的图片
• 统计图片数量和占用大小
• 按目录结构查看图片分布
• 选择不再需要的本地图片
• 删除前进行确认

这个功能是为了解决一个问题：我已经把文章里的图片上传到 OSS，笔记里的引用也已经变成线上链接，现在想安全地找出那些不再被任何笔记引用的本地残留图片。

为什么这个功能对 Git 用户特别有用

如果你的 Obsidian Vault 只是本地使用，本地图片多一点可能只是占硬盘。

但如果你用 Git 管理 Vault，图片就会进入另一个问题域。

Git 很适合管理 Markdown 笔记。文字文件小、差异清晰、历史可追踪，多端同步也足够透明。

但 Git 并不适合无限堆图片。

一张截图可能比几十篇笔记还大。更麻烦的是，你删掉笔记里的图片引用以后，附件文件不一定会自动消失。时间久了，仓库里就会留下很多你已经不用、但仍然被 Git 跟踪的文件。

NotePic 最新版本的价值就在这里：它把“上传到 OSS”之后的清理动作接了起来。

一个更轻的流程可以变成：

1. 在 Obsidian 里正常写作
2. 图片先保留本地，不打断写作
3. 发布前用 NotePic 上传到 OSS
4. 确认笔记里的图片引用变成线上链接
5. 扫描 Vault 里的本地图片
6. 清理不再被引用的图片
7. 再提交 Git

这样 Git 仓库里留下的主要是笔记内容和仍然需要保留的资产，而不是一堆上传后已经失去引用关系的本地图片。

清理图片时，安全比激进更重要

图片清理这件事，我不建议做得太激进。

因为“未引用”并不永远等于“可以马上删”。

有些图片可能暂时没有被当前 Markdown 引用，但你可能还想作为素材保留；有些图片可能被特殊插件、Canvas、HTML 片段或其他工作流使用；有些历史文章可能还没完成迁移。

所以 NotePic 最新版本的目标不是鼓励你一键盲删所有图片。图片清理不是为了追求“Vault 里没有本地图片”，而是为了让你知道哪些图片真的还需要留在本地。

写在最后

如果你只在本地看笔记，从不发布，也不用 Git 同步，可能暂时不需要这个功能。

但如果你已经在用 NotePic 上传图片，或者正在被 Obsidian 附件目录和 Git 仓库体积困扰，最新版本值得升级。

官网：luhuidev.com/NotePic-OSS/

这次功能来自真实使用场景和 GitHub Issue 反馈。如果你在清理本地图片时遇到特殊引用、误判场景、插件兼容问题，欢迎继续提 Issue。