Ar9av/obsidian-wiki

解决的问题

它防止了 AI 代理在交互过程中获得的知识流失。与其让宝贵的见解消失在零散的聊天记录中，或反复执行昂贵的 RAG 流程，此工具允许 AI 代理编译并维护一个持久、互联的“数字大脑”，由用户拥有并可独立阅读的 Markdown 文件组成。

运作方式

该系统将一个 Markdown 文件文件夹（Obsidian vault）转变为 AI 代理的长期记忆。它使用一组“技能”（斜线指令），代理可以执行这些指令来从各种来源（如 PDF、URL 和聊天导出文件）获取数据，并将这些信息提炼成结构化的维基。

关键机制包括：

• 知识编译：新信息会合并到现有页面中，而不是单纯堆叠，并会标记矛盾之处并删除重复内容。
• 会话生命周期：它会在会话开始时自动注入相关上下文（用户配置文件、开启的线程），并在会话结束前捕获可重复使用的知识。
• 本地优先存储：所有内容都以纯 Markdown 格式存储在磁盘上，核心 vault 功能无需 API 密钥、嵌入模型或向量数据库。
• 图谱感知查询：它为代理提供了查询笔记之间结构关系的工具，使复杂的架构问题比标准的 grep 搜索更快、更准确。

目标受众

使用 AI 代理（如 Claude Code、Cursor 或 Windsurf）并希望拥有一个能随项目发展、持久、可移植且人类可读的知识库的开发者与进阶用户。

特色亮点

• 代理无关性：兼容于多种代理，包括 Claude Code、Cursor、Codex 和 Gemini CLI。
• 本地所有权：数据存储为纯 Markdown，使其可被 grep、可进行 diff，且不依赖任何厂商锁定。
• 综合工具集：包含 39 种用于获取、查询、检查和去重知识的技能。
• 会话持久性：通过追踪用户身份与当前活动，在不同的 AI 会话之间保持连续性。
• Python API：允许开发者将 vault 记忆直接整合到 Python 应用程序中。