🚀 Obsidian索引服务

Obsidian索引服务可监控Obsidian保险库目录，将Markdown文件的元数据与全文内容索引至SQLite数据库。该服务最初为mcp-server项目构建，后转向使用Obsidian插件API实现。不过，它作为通用的无主见索引工具或同步工具仍颇具价值，因此在此发布。

✨ 主要特性

此服务会跟踪Obsidian保险库中的文件更改（创建、修改、删除），并将所有内容存储在SQLite中，可通过Docker卷进行访问。它能捕获以下信息：

• 路径：文件路径（唯一标识符）
• 标题：来自文件名
• 父文件夹：相对于保险库根目录
• 标签：从YAML前端元数据获取
• 创建日期：文件系统时间戳
• 修改日期：文件系统时间戳
• 内容：笔记的全文
• 状态：处理结果（成功/错误）
• 错误信息：处理失败时的详细信息

📦 安装指南

先决条件

• Python 3.12或更高版本
• Docker和Docker Compose（用于容器化使用）
• uv（可选，但推荐）

安装步骤

1. 克隆仓库：

   git clone https://github.com/pmmvr/obsidian-index-service.git
   cd obsidian-index-service
   

2. 设置虚拟环境：

   • 使用uv（推荐）：

     uv venv
     source .venv/bin/activate # Linux/macOS
     .venv\Scripts\activate # Windows
     

   • 使用python（标准方法）：

     python -m venv .venv
     source .venv/bin/activate  # Linux/macOS
     .venv\Scripts\activate     # Windows
     

3. 安装依赖项：

   • 使用uv（推荐）：

     uv sync  # 从uv.lock安装
     uv pip install pytest pytest-bdd pytest-mock  # 用于测试
     

   • 使用pip：

     pip install -e .
     pip install pytest pytest-bdd pytest-mock  # 用于测试
     

💻 使用示例

基础用法

在本地运行测试：

pytest

📚 详细文档

项目状态

• 已完成：核心索引（元数据+内容）、Docker设置、文件监视、数据库CRUD。
• 下一步计划：原本计划创建API，但转而采用插件方法。

未来步骤（作为同步工具的潜力）

通过一些重构，该服务可作为同步工具使用，具体如下：

• 远程后端：添加对云存储（例如Dropbox）或服务器的支持。
• 同步逻辑：推送本地更改（内容+元数据）到远程，拉取远程更新，处理冲突（例如最后写入者获胜）。
• 数据库调整：添加sync_status和remote_id列。
• 文件监视器更新：排队更改以进行同步，而不仅仅是索引。
• CLI选项：添加--sync以手动触发或持续运行。
• 错误处理：重试网络失败，记录问题。