用途:清理和整理 Obsidian 库中的 Attachments 文件夹,包含两项工作:查找并删除未被引用的附件;把被引用的附件重命名为一致、可搜索的名称。
命名规则:YYYY-MM-DD description.ext。日期前缀取自引用该附件的笔记文件名,只提取 YYYY-MM-DD 部分,忽略时间(如 2026-03-09 1230 中的 1230)。描述为基于笔记中嵌入上下文的简短英文 kebab-case 短语,不超过 5 个词。扩展名保留原样。同一笔记嵌入多个附件时,按各自内容区分,而不是用序号。若附件自身时间戳清晰可辨且与笔记日期不同,可用附件日期,存疑时优先用笔记日期。
工作流程:1) 建立引用映射:列出 Attachments/ 下所有文件,搜索所有 .md 中的 ![[filename]] 嵌入,排除 .agents/skills/ 中的文档示例,去掉参数(如 ![[file.png|300]] 与 ![[file.png|alt text]] 都还原为 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) 验证:快速扫描确认未引入损坏的嵌入引用,并报告删除、重命名、跳过的数量。
限制:执行前必须获得用户明确确认;无日期前缀的引用笔记不重命名;资料未提供安装方式、收费与平台信息。