anki-media-guardian

Anki Media Guardian

Anki Media Guardian 是一个安全、智能的 Anki 媒体管理工具，帮助你扫描、整理和删除未使用的媒体文件（音频、图片、视频等）。该插件还提供 API 支持，可供其他插件调用，实现稳定文件名生成和使用记录管理。

---

🔹 功能特点

• 扫描媒体库
  自动扫描 Anki 媒体文件夹，检测哪些文件正在使用，哪些未被使用。

• 安全删除
  支持批量删除未使用文件，同时可选择备份以防误删。

• 文件管理
  • 按文件类型筛选
  • 支持搜索文件名
  • 显示文件大小、修改时间及使用状态
• 预览和操作
  • 直接预览音频或图片
  • 快速在文件夹中定位文件
  • 复制文件名到剪贴板

• 重复文件检测
  基于 MD5 哈希检测重复文件，方便整理冗余媒体。

• 引用详情查看
  支持查看文件被哪些笔记引用，双击可快速在浏览器中定位笔记。

• 统计分析
  统计媒体库总文件数、使用中与未使用文件比例、总大小等信息。

• API 支持
  提供稳定文件名生成、文件使用注册和媒体目录查询接口，方便其他插件调用。

---

🔹 安装

1. 下载插件源码并本地安装。
2. 重启 Anki。
3. 在 Anki 顶部菜单 工具 中找到 Media Guardian。

---

🔹 使用方法

打开插件

• 主界面：工具 → Media Guardian → 打开媒体管理器

扫描媒体库

1. 点击 🔍 扫描媒体库 按钮。
2. 可选择 仅显示未使用文件 进行过滤。
3. 可通过搜索框快速查找特定文件。

批量删除

1. 勾选未使用文件，或者点击 全选 / 全不选。
2. 点击 🗑️ 删除选中文件。
3. 根据提示确认删除操作，支持备份未使用文件。

右键操作

• 👁️ 预览文件：快速播放音频或查看图片
• 📋 查看引用详情：查看哪些笔记使用该文件
• 📁 在文件夹中显示：定位文件所在目录
• 📝 复制文件名：将文件名复制到剪贴板

统计分析

点击 📊 统计 按钮，查看媒体库详细信息，包括使用比例和未使用文件大小。

---

🔹 API 使用示例

在插件启用 API 后，其他插件可通过以下方式调用：

```python if hasattr(mw, ‘media_guardian_api’): api = mw.media_guardian_api

# 生成稳定文件名
filename = api.generate_stable_filename(content="文本+语音", prefix="edge_tts")

# 查询媒体文件夹路径
media_dir = api.get_media_dir()

# 注册文件使用（可选）
api.register_usage(filename, note_id=12345, field_idx=0)