SuperAPI AI 工具集

vault-wikilinks

写作与研究

查看项目

更新于 10-15 23:49

技能介绍

用途:修复 Obsidian 库中失效的 [[Target]] 维基链接,包括笔记重命名或移动后的引用重写、跨命名空间(Zettelkasten/ 与 work/z/)的歧义解析,以及把带路径前缀的 [[Kanban/X]] 链接改为裸基名。

主要能力:识别失效与歧义链接。Obsidian 按基名解析 [[Target]],笔记重命名、移动或从未创建时链接会静默失效;两个笔记共享基名时产生歧义。支持解析 [[Note Name]]、[[Note Name|Alias]]、[[Note Name#Section heading]]、[[folder/Note Name]] 和 ![[Image.png]] 嵌入。

检测方式:可用 fd -e md -x basename {} .md 构建基名集合,用 rg -o '[[([^]|#]+)' --no-filename --glob '*.md' 提取链接,再经 comm(1) 比对。更准确的方式是使用 vault-agent 的 links.analyze_links 分析器。Obsidian 关闭时可离线解析 .md 语料:读取 frontmatter 的 YAML 块,按基名→相对路径→别名(均不区分大小写)级联解析,嵌入还需对照附件,附件目录从 .obsidian/app.json 的 attachmentFolderPath 读取。

重写策略:对引用多的失效目标一次性重写,例如 fix(links): rewrite 44 × [[OldTopic]] → [[Topic]],使用 Edit 的 replace_all=True,不要用 shell sed。引用少的目标报告给用户决定。歧义链接绝不自动重写,需列出候选让用户选择。

限制与安全:不得重写代码块或 YAML frontmatter 内的链接;不得自动创建缺失的目标笔记;保留别名形式。相关技能包括 vault-orphans、vault-mocs、search-discovery。