obsidian-cleaner

核心用法

Obsidian Attachment Cleaner 专为知识库整理场景设计，通过自然语言指令（如"Clean Obsidian"或"整理附件"）或命令行调用，自动扫描指定 Vault 根目录中散落的附件文件。Skill 支持 PNG、JPG、GIF、WebP 等主流图片格式及 PDF、DOCX 等文档格式，将其安全迁移至专用的 Attachments 文件夹，并可自动创建目标文件夹。用户可通过 --vault 参数指定自定义仓库路径，通过 --attachments 参数设定个性化附件目录名称，适配多样化的知识库结构。

显著优点

安全性方面表现卓越，获得 BSS A 级安全认证，代码仅依赖 Python 标准库（os、shutil、pathlib、argparse），无任何第三方依赖包，杜绝了供应链攻击风险。功能设计上充分考虑用户安全感，提供 --dry-run 预览模式，允许在实际执行前查看将被移动的文件清单。具备完善的防覆盖机制，当目标位置存在同名文件时自动添加时间戳重命名，避免数据丢失。操作全程无删除行为，仅执行移动操作，且通过文件扩展名白名单机制严格限定处理范围，防止误操作系统文件。

潜在缺点

作为 T3 级社区来源工具，虽经自动化安全扫描，但仍建议技术敏感型用户在首次使用前进行人工代码审查。功能维度相对单一，专注于本地文件整理，不支持远程同步附件管理、多用户协作场景或复杂的文件去重策略。默认配置假设 Vault 位于 ~/Documents/Obsidian Vault，若用户使用非标准路径或跨平台同步方案，需手动配置路径参数。此外，移动文件后会改变其在文件系统中的绝对路径，可能影响 Obsidian 笔记中已有的相对链接引用，需要用户后续维护链接完整性。

适合目标群体

主要面向 Obsidian 知识库重度用户，特别是频繁通过拖拽、截图等方式向笔记中添加附件的学生、研究人员、内容创作者和知识管理爱好者。适合追求数据隐私、偏好本地优先（Local-first）软件理念，希望保持知识库根目录整洁的用户。对于从其他笔记软件迁移至 Obsidian 且遗留大量散落附件的迁移用户，以及需要定期归档整理项目资料的职场人士同样适用。

使用风险

尽管设计安全性高，仍需注意操作风险：首次使用务必运行 --dry-run 确认影响范围，避免因路径配置错误导致文件被移至非预期位置；执行前需确保目标 Attachments 文件夹具备写入权限且磁盘空间充足，否则可能导致移动失败；由于文件被物理移动，Obsidian 笔记中的 ![[filename]] 或 ![](path) 格式链接可能失效，建议在执行后使用 Obsidian 的链接更新功能检查断链；虽然 Skill 会跳过符号链接防止意外遍历，但用户仍应确保指定的 Vault 路径正确，避免误处理其他重要目录。