# Image Stripper（Obsidian 插件）

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

## 功能说明

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

## 安装（本地）

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

```powershell
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+