// project.info
Vault Keeper
Vault Keeper 是什么
Vault Keeper 是一款 Obsidian vault 自动运维插件（开源，MIT），定位「你的 Obsidian vault 自动运维员」：定时后台扫描，检测断链（wikilink + markdown link 指向不存在笔记）、孤儿笔记（无入链且不在入口目录）、空笔记（只有标题没有内容），生成综合健康报告（健康分 0-100 + 分项明细表，写入 reports/YYYY-MM-DD.md）。
核心原则是「只读扫描，绝不自动修改你的笔记」——零风险，只写报告目录。默认 60 分钟后台跑一次（可配置，0=关闭）。项目理由：库越大断链和孤儿越多，现有工具（Smart Connections/Copilot 等）都是对话式 AI，没有做自动后台运维的品类空白。开发层面核心逻辑全部为纯函数，17 个测试覆盖，与 Obsidian API 解耦。
主要功能
01断链检测：wikilink + markdown link 指向不存在笔记的链接全部找出
02孤儿检测：无入链且不在入口目录（journal/templates 等，可配置）的笔记
03空笔记检测：只有标题没有内容的笔记
04健康报告：综合健康分 0-100 + 分项明细表，写入 reports/YYYY-MM-DD.md
05定时扫描：默认 60 分钟后台跑一次（可配置，0=关闭）
06零风险设计：纯只读扫描 + 只写报告目录，绝不自动修改笔记
07MIT 开源：核心逻辑纯函数可测试，17 个测试覆盖
如何使用 Vault Keeper
1手动安装：进入 <vault>/.obsidian/plugins/，新建 vault-keeper 目录
2下载 release 的 main.js、manifest.json、styles.css 放入该目录
3在 Obsidian 设置 → 第三方插件 → 启用 Vault Keeper
4命令面板运行「Vault Keeper: 立即扫描并生成健康报告」
5或等待自动扫描（默认 60 分钟），运行「Vault Keeper: 打开最近报告」查看
使用示例
素材未提及
核心优势
✓品类空白：对话式 AI 之外唯一的自动后台运维插件
✓零风险：纯只读扫描+只写报告目录，绝不改笔记
✓报告直观：健康分 0-100 + 分项明细，一眼看出库的健康度
✓自动化：默认 60 分钟定时扫描，无需手动维护
✓开源可靠：核心逻辑纯函数、17 测试，与 Obsidian API 解耦
与同类工具对比
| 维度 | 分身宝 | Image Translate AI | 法脉 LawPulse |
|---|---|---|---|
| 定位 | Android 应用多开 | AI 图片翻译 | 律师法律研究工具 |
| 核心功能 | 主流应用多开 | 130+ 语言图片翻译 | 412 部法律检索+笔记成链 |
| 价格 | 免费 | 素材未提及 | 公测免费 |
| 开源/部署 | 否 | 否 | 部分 |
| 适合谁 | 多账号管理 | 图片翻译 | 法律研究 |
结论：同属效率办公但场景不同：Vault Keeper 是 Obsidian 笔记库的「自动运维体检」，市面上几乎没有同类自动后台运维插件；分身宝/翻译/法律工具与笔记库维护无关——用 Obsidian 且库越大越需要它。
使用方式与技巧
使用方式
- Obsidian 插件（手动安装，市场审核中）
功能模式
- 断链检测
- 孤儿检测
- 空笔记检测
- 定时扫描
使用技巧
- 入口目录（journal/templates）可配置避免误报孤儿
- 频率按库规模调整，0 可关闭自动扫描
进阶玩法
01路线图：v0.2 报告内一键修复建议（仍需手动确认）；v0.3 重复笔记检测
常见问题
会修改我的笔记吗？
不会，纯只读扫描，只写 reports 报告目录。
多久扫描一次？
默认 60 分钟，可配置，0 表示关闭自动扫描。
是开源的吗？
是，MIT 协议，GitHub 托管。
现在能直接安装吗？
市场审核中，需手动下载 release 文件放入插件目录。
// more.info
项目信息
Obsidian vault 自动运维插件：定时后台扫描，检测断链/孤儿笔记/空笔记，生成健康报告，只读绝不自动改笔记
Obsidian vault 自动运维插件：定时检测断链、孤儿笔记、空笔记并生成健康报告，只读不改库
// 商业项目:在数据 affiliate 字段填入 CPS 推广链接后,按钮自动改跳你的推广链接
← 返回开源宝库