Attachment Butler | 附件管家

高效管理 Obsidian 附件，告别文件混乱与引用追踪难题
Efficiently manage Obsidian attachments, say goodbye to file clutter and reference tracking issues.

---

✨ 核心功能 / Core Features

🔴 未引用附件标识 / Unreferenced Attachment Indicator

自动标记未被任何笔记引用的附件，红色圆点一目了然，轻松识别并清理冗余文件。

Automatically marks attachments not referenced by any note with a red dot, helping you quickly identify and clean up redundant files.

📍 快速定位笔记 / Quick Note Locator

右键附件一键跳转到引用该附件的所有笔记，轻松追踪附件来源，不再迷失在文件海洋中。

Right-click an attachment to instantly jump to all notes that reference it, making source tracking effortless.

🏷️ 附件笔记名前缀 / Note Name Prefix

被引用的附件名称前端显示笔记名前缀，鼠标悬停可查看全部引用来源，附件归属一目了然。

Referenced attachments display the note name as a prefix. Hover to see all referencing notes, clarifying attachment ownership at a glance.

---

📥 安装方式 / Installation

方式1：从社区插件库安装（审核中）/ Method 1: Community Plugins (Under review)

1. 打开 Obsidian 设置 → 第三方插件 → 关闭安全模式
   Open Obsidian Settings → Community plugins → Turn off safe mode

2. 点击"浏览"社区插件
   Click "Browse" community plugins

3. 搜索 Attachment Butler
   Search for Attachment Butler

4. 点击"安装"并启用 Click "Install" and enable

方式2：手动安装 / Method 2: Manual Installation

1. 从 GitHub Release 下载最新版的 3 个文件
   Download the latest 3 files from GitHub Release

2. 打开你的 Vault 文件夹，进入 .obsidian/plugins/
   Open your Vault folder → .obsidian/plugins/

3. 新建文件夹 attachment-butler，将 3 个文件放入
   Create a folder named attachment-butler and place the 3 files inside

4. 在 Obsidian 设置中刷新插件列表并启用
   Refresh plugin list in Obsidian Settings and enable

---

🚀 使用指南 / Usage

查看未引用附件 / View Unreferenced Attachments

在文件浏览器中，未引用附件左侧显示红色圆点，快速识别可清理的文件。

Unreferenced attachments show a red dot in the file explorer for quick identification.

定位到笔记 / Locate to Note

1. 右键点击附件
   Right-click an attachment

2. 选择 定位到笔记
   Select Locate to Note

3. 在二级菜单中点击目标笔记即可跳转
   Click the target note in the submenu to jump

   

查看引用来源 / View Reference Sources

悬停在附件名称上，查看笔记名前缀，了解该附件被哪些笔记引用。

Hover over the attachment name to see the note name prefix and understand which notes reference it.

独立开关/Independent switch

---

⚙️ 配置说明 / Configuration

插件跟随 Obsidian 原生设置，无需额外配置。附件存放路径遵循 Obsidian 默认规则：

The plugin follows Obsidian's native settings with no additional configuration required. Attachment storage paths follow Obsidian's default rules:

• 附件存放位置：由 Obsidian 的"文件与链接"设置决定
  Attachment location: Determined by Obsidian's "Files & Links" settings

---

📋 技术信息 / Technical Info

项目 / Item	详情 / Details
最低 Obsidian 版本 Min App Version	1.0.0+
支持平台 Platforms	✅ Windows（已验证） 🔜 macOS, Linux, Mobile（理论兼容，欢迎测试） ✅ Windows (Tested) 🔜 macOS, Linux, Mobile (Theoretically compatible)
开源协议 License	MIT
作者 Author	加点幻想就有了@FantsGa
仓库 Repository	GitHub

---

🐛 已知问题 / Known Issues

• 首次安装后可能需要重启 Obsidian 才能正常显示红点标识
  May require Obsidian restart after first installation to display red dots

• 大量附件时（1000+）引用检测可能有轻微延迟
  Slight delay possible with large attachment libraries (1000+)

---

🤝 贡献 / Contributing

欢迎通过以下方式参与改进：

Contributions are welcome in the following ways:

• 🐞 提交 Issue：反馈 Bug 或提出新功能建议
  Submit Issues: Report bugs or suggest new features

• 🔧 Pull Request：贡献代码修复或改进
  Pull Requests: Contribute code fixes or improvements

• 📝 翻译：帮助完善多语言支持
  Translations: Help improve multilingual support

• ⭐ Star & Share：给个 Star 或分享给朋友
  Star & Share: Give a star or share with friends

---

📄 许可证 / License

本项目遵循 MIT 开源协议。详见 LICENSE 文件。

This project is licensed under the MIT License. See the LICENSE file for details.

---

💬 反馈与支持 / Feedback & Support

• 📧 问题反馈：GitHub Issues
  Report Issues: GitHub Issues

• 🌟 如果喜欢这个插件，请考虑给个 Star！
  If you like this plugin, please give it a Star!

---