Obsidian 知识库导航

解决什么问题

当 Obsidian 库中笔记数量增多后，人工维护索引往往需要手动罗列所有文件夹和标签，既费时又容易遗漏关键笔记，查找特定主题还需逐层翻阅目录，影响日常检索体验。

核心能力与工作流程

• 自动生成导航：运行后会在指定路径生成 总导航.md 文件，作为统一的入口索引，同时写入 .nav_version 用于版本追踪。
• 定时刷新索引：通过系统 cron 实现每天 22:30 自动执行，也能按需手动触发，保证导航与知识库内容同步。
• 多路径兼容：除主输出外，还会在根目录保留副本 总导航.md，适配历史笔记中的旧引用路径，避免链接失效。
• 依赖环境：需要 Python 3.8+ 环境，以及对 Obsidian 根目录的读写权限，运行一次即可完成索引更新。

适用边界与注意点

• 库规模适配：更适合中小到中等规模的 Obsidian 库，若笔记数量极多，可能需要关注生成后的导航文件体积。
• 环境依赖：依赖有效的 cron 配置和 Python 运行环境，环境缺失会导致定时任务无法正常执行。
• 路径一致性：需确保配置的 Obsidian 路径与实际使用路径完全一致，否则无法正确生成或更新导航文件。