SuperAPI AI 工具集

vault-stubs

办公与效率

查看项目

更新于 10-15 23:49

技能介绍

用途:管理 LakuVault 中 FVH/z/ 工作命名空间的重定向存根。该目录以极小的重定向存根镜像部分 Zettelkasten 笔记,正文存放在 Zettelkasten/,FVH/z/ 仅指向它,使工作场景查询仍能找到主题。

规范存根格式:frontmatter 含 tags: [redirect] 与 context: fvh,正文为单个带别名的 wikilink,例如 See [[Zettelkasten/Docker|Docker]] in the main knowledge base.;大小不超过 200 字节(不含空白)。

分类与动作:clean_redirect(≤200B、有 redirect 标签、Zettelkasten 有对应)保持原样;broken_redirect(有标签但超 200B 或目标缺失)重写为规范单行;stale_duplicate(完整文章且 Zettelkasten 存在同名)先合并内容再转为 clean_redirect;fvh_original(完整文章且 Zettelkasten 无对应)属合法内容,保持不动。

合并启发式:按章节比较,FVH/z 中某标题下的文字若未出现在 Zettelkasten 对应笔记中则需迁移;使用词级比较,措辞微差不算独有内容。存疑时标记给用户复核,错误合并比保留重复更糟。转换时替换整个 FVH/z 文件正文为规范存根,提交信息如 refactor(stubs): convert FVH/z/Foo.md to redirect (content merged into Zettelkasten)。

提升 fvh_original:若内容无 FVH 专属引用且具通用价值,可移动到 Zettelkasten/Foo.md,原位置建重定向存根,并从提升笔记 frontmatter 移除 context: fvh,提交为 refactor(stubs): promote Foo from FVH/z to Zettelkasten;不要激进提升。

检测命令:fd -e md . FVH/z -x wc -c {} | sort -n;rg -l '^tags:.\bredirect\b' FVH/z/ --glob '.md';rg -L -l '^tags:.\bredirect\b' FVH/z/ --glob '.md'。vault-agent 的 analyze_stubs 提供完整分类。

安全:删除内容前必须确认其存在于别处,合并时在目标笔记中 grep 源笔记的规范短语;存根保留 context: fvh;不要为未在 FVH 场景使用的 Zettelkasten 笔记创建存根。相关技能:vault-frontmatter、vault-wikilinks、vault-tags。