image-stripper

Image Stripper（Obsidian 插件）

一个简单的 Obsidian 插件：清理当前笔记中的所有图片引用，并且仅在图片在整个 Vault 中没有其他引用时才删除该图片附件文件（更安全）。

功能说明

• 支持清理的图片引用形式：
  • Markdown 图片：![](...)
  • Obsidian 内嵌：![[xxx.png]]、![[xxx.png|100]]
• 删除策略：
  • 总是先从当前笔记中移除图片引用
  • 仅当该图片文件在全 Vault 没有其他反链引用时才删除图片文件
  • 外链图片（如 https://...）只会移除引用，不会删除任何文件

安装（本地）

1. 构建插件（生成 main.js）：

   npm run build
   

2. 将以下文件复制到你的 Vault 插件目录：

   • 目标目录：你的Vault/.obsidian/plugins/image-stripper/
   • 需要的文件：
     • manifest.json
     • main.js

3. 在 Obsidian 中启用插件：

   • 设置 → 第三方插件 → 允许第三方插件
   • 设置 → 第三方插件 → 找到 Image Stripper → 启用

使用方法

在任意笔记中打开该笔记，然后：

• 打开命令面板（默认 Ctrl+P）
• 执行命令：清理当前笔记图片

执行后会弹出通知，包含：移除的图片引用数量、删除的无人引用图片附件数量。

排障与注意事项

• 建议先在测试 Vault 验证，再在重要 Vault 中使用（必要时先备份）。\n+- 反链判断依赖 Obsidian 的元数据缓存；如果你刚批量导入/修改了大量文件，建议等索引稳定后再执行。\n+- 如果某些图片引用无法解析到 Vault 内的真实文件（例如路径不标准），插件仍会移除引用，但会跳过“删除附件”。\n+- 调试日志：打开开发者工具 Console，可搜索前缀 "[image-stripper]"。\n+\n+## 开发\n+\n+powershell\n+npm run dev\n+\n+\n+dev 会开启 esbuild watch，源码变更会自动重建生成 main.js。\n+