Obsidian-agent-bridge – 让AI代理读写并深化Obsidian知识库

obsidian-agent-bridge 是一个轻量级开源工具，旨在将AI代理连接到真实的Obsidian知识库，使其能够像操作一个动态知识图谱一样进行读写和深化。该项目由 samuraisguilt-jpg 开发，托管在GitHub上，采用MIT许可协议。

与大多数基于数据库的AI记忆系统不同，obsidian-agent-bridge 直接作用于你本地的Obsidian库。它通过Local REST API插件（默认端口27124）建立通信，提供了深度整合的能力。其核心功能是 deepenNode——该方法能够读取已有的知识节点，将新内容折叠到指定章节中，自动去重，并确保[[wikilinks]]的准确性，从而保持图谱视图的整洁。

除了 deepenNode 外，工具还提供了 appendObservation（快速添加带时间戳的观察）、readNode（读取节点）、ensureNode（创建节点）和 listLinks（列出维基链接）等便捷方法。此外，底层的 ObsidianClient 类提供了原始的读写追加操作，适合更灵活的场景。

安装非常简单：通过npm运行 npm install obsidian-agent-bridge，前提是已安装Obsidian并启用Local REST API插件。使用时，你只需实例化 ObsidianGraph 并传入API密钥，即可在各种AI代理工具链中集成。例如，你可以在LLM工具处理程序中调用 deepenNode，让代理根据经验不断扩展知识库。

该库的设计强调零依赖性和兼容性，适用于任何LLM框架。其去重机制允许代理自由调用而无需担心产生碎片信息。对于希望构建可持续成长、连接型知识系统的AI开发者来说，obsidian-agent-bridge 提供了一个简洁而强大的解决方案。