Obsidian Cleaner 是一款专为 Obsidian 笔记应用设计的自动化整理工具，旨在解决用户在长期使用过程中因图片、文档等附件散落在知识库根目录而导致的文件混乱问题。该工具通过智能扫描和自动迁移机制，帮助用户将分散在根目录下的各类附件文件统一归整至指定文件夹中，从而保持知识库的整洁与高效管理。用户只需简单触发指令，即可实现一键清理，极大提升了数字笔记的组织性和可维护性。 该工具支持多种常见文件格式的识别与处理，包括 PNG、JPG、GIF、JPEG、WEBP 图像文件以及 PDF 和 DOCX 文档。其核心逻辑是自动检测 Obsidian 知识库根目录下未被引用的“松散”文件，并将它们移动到一个名为 Attachments（或自定义名称）的子文件夹内。整个过程无需手动干预，且具备高度的安全性保障，避免误删或覆盖重要内容。此外，工具还提供预览模式（dry run），允许用户在执行前查看将要被移动的文件列表，确保操作透明可控。 除了基础的文件迁移功能外，Obsidian Cleaner 还提供了详细的运行报告，清晰展示每项操作的结果——哪些文件被成功转移、是否存在冲突或错误信息。这使得用户不仅能快速完成清理任务，还能对知识库状态进行持续监控。无论是日常维护还是定期归档，该工具都能显著减轻用户的认知负担，让 Obsidian 真正成为一款高效、有序的个人知识管理系统。
核心功能特点
- 自动发现并整理 Obsidian 根目录下的松散图片和附件文件
- 支持 PNG、JPG、GIF、PDF、DOCX 等多种常用文件格式
- 安全移动文件至 Attachments 文件夹，避免数据丢失
- 提供干运行（Dry Run）模式，支持预览即将移动的文件
- 生成详细操作报告，明确显示文件转移结果与潜在错误
适用场景
在日常使用 Obsidian 记录学习笔记、项目资料或生活灵感时，用户常常会直接将截图、照片或下载的文档拖入知识库根目录，久而久之便积累了大量未分类的附件文件。这些零散资源不仅影响视觉整洁，还可能干扰后续的内容检索与版本控制。此时，运行 ‘Clean Obsidian’ 或类似指令即可启动自动整理流程，瞬间将杂乱无章的图片和文档统一收纳进专用文件夹，恢复知识库的清爽结构。 对于需要频繁更新多媒体内容的创作者而言，例如设计师、程序员或教育工作者，Obsidian Cleaner 能显著提升工作效率。每当完成一次内容创作或会议记录后，只需一句语音或文本指令即可触发清理动作，无需打开文件管理器逐个查找。这种无缝集成的自动化体验，使得用户能够专注于内容本身，而非繁琐的文件管理工作。尤其适合那些习惯于语音助手或快捷命令操作的技术型用户群体。 此外，在多设备同步或团队协作场景下，保持 Obsidian 知识库的一致性尤为重要。通过定期执行附件整理，可以避免因文件路径混乱导致链接失效或协作成员无法正常访问资源的问题。无论是个人知识库的日常维护，还是企业级知识平台的标准化管理，Obsidian Cleaner 都提供了一种轻量级但高效的解决方案，确保数字资产始终处于最佳组织状态。