用途:清理和整理 Obsidian 库中的 Attachments 文件夹,包含两项工作——找出并删除未被引用的附件;把被引用的附件重命名为统一、可搜索的名称。
命名规则:YYYY-MM-DD description.ext。日期前缀取自引用该附件的笔记文件名中的 YYYY-MM-DD 部分(忽略时间,如 2026-03-09 1230 中只取 2026-03-09);描述为基于笔记中嵌入上下文的简短英文 kebab-case 短语,不超过 5 个词;扩展名保留原样。同一笔记嵌入多个附件时,按各自内容区分,而非用序号。若附件自身时间戳与笔记日期不同且可明确识别,可用附件时间戳日期,存疑时优先用笔记日期。
工作流程:1)建立引用映射:列出 Attachments/ 下所有文件,在所有 .md 文件中搜索 ![[filename]] 嵌入,排除 .agents/skills/(文档示例非真实引用),剥离参数(![[file.png|300]] → file.png),得到附件到引用笔记的映射。2)分类:无引用为删除候选;被引用且笔记文件名含 YYYY-MM-DD 为重命名候选;被引用但笔记无日期前缀(如 Private/Career/Portfolio/ 笔记)跳过重命名。3)生成重命名计划:读取引用笔记理解上下文,提取日期,生成描述性英文 kebab-case 名称,检查命名冲突(冲突时细化描述而非加序号),已符合规则的跳过。4)向用户展示删除、重命名、跳过三类清单,等待明确确认后再执行。5)执行:使用 Obsidian CLI,删除用 obsidian delete path="Attachments/filename.png" permanent,重命名用 obsidian rename path="Attachments/old-name.png" name="new-name.png";始终用 path= 而非 file=,因为 file= 按 wikilink 解析,遇到空格、@、下划线、井号等特殊字符会失败。6)验证:快速扫描确认未引入损坏的嵌入引用,并报告删除、重命名、跳过的数量。
限制:执行任何操作前必须获得用户明确确认;无日期前缀的引用笔记不重命名;资料未提供其他平台支持、收费或价格信息。