vault-rag 全体構成・仕様資料

flowchart LR
    subgraph Prep["下ごしらえ (索引づくり)"]
        N["ノート (.md)"] --> C["① チャンク分割
(検索しやすい長さに切る)"]
        C --> E["② 埋め込み
(意味を数値ベクトルに変換)"]
        E --> DB[("③ ベクトルストアに保存
(意味で引ける書庫)")]
    end
    subgraph Search["検索するとき"]
        Q["質問文"] --> QE["同じ方法で数値化"]
        QE --> M["ベクトルが近い =
意味が近いチャンクを探す"]
        DB --> M
        M --> R["該当ノートの断片を返す"]
    end
    

graph TB
    subgraph Clients["クライアント層 (全セッションが共有)"]
        C1["Claude Code
セッション A"]
        C2["Claude Code
セッション B"]
        C3["Codex / 他の
MCP クライアント"]
    end

    subgraph Server["常駐サーバ (1プロセスのみ)"]
        S["serve_http.py
FastMCP streamable-http
127.0.0.1:8765/mcp"]
        P["obsidian-notes-rag 1.1.2
(PyPI・バージョン固定)"]
        X["rag_common.py
堅牢除外イテレータ"]
        S --> P
        X -. "monkeypatch で
VaultIndexer に注入" .-> P
    end

    subgraph Data["データ層 (LOCALAPPDATA)"]
        VS[("ベクトルストア
SQLite / 約53,000 chunks")]
        ST["incremental_state.json
(mtime+size の控え帳)"]
        CF["config.toml
(設定の正本)"]
    end

    O["Ollama bge-m3
(ローカル埋め込み・課金なし)"]
    MD["Vault 内 *.md
(除外適用後)"]

    subgraph Batch["夜間バッチ (毎朝)"]
        D["scheduled_review.bat daily"]
        I["rag_index.py
増分索引"]
        D --> I
    end

    subgraph Boot["起動経路"]
        T["Task Scheduler
VaultRagServer (ログオン時)"]
        B["start_rag_server.bat
(ポート生存確認つき)"]
        T --> B
    end

    C1 & C2 & C3 -->|"HTTP (MCP)"| S
    P <--> O
    P <--> VS
    MD --> X
    I <--> O
    I <--> VS
    I <--> ST
    D -. "生存確認" .-> B
    B -. "落ちていれば起動" .-> S
    

sequenceDiagram
    participant CC as Claude セッション
    participant S as vault-rag サーバ (8765)
    participant O as Ollama (bge-m3)
    participant DB as ベクトルストア (SQLite)

    CC->>S: search_notes("質問文")
    S->>O: 質問文を数値ベクトルに変換
    O-->>S: ベクトル
    S->>DB: 意味が近いチャンクを検索
    DB-->>S: 上位チャンク + ノートパス
    S-->>CC: 検索結果 (抜粋つき)
    Note over CC,S: 全セッションが同一サーバ・同一索引を共有
    

flowchart TD
    A["毎朝: scheduled_review.bat daily"] --> B["rag_index.py 起動"]
    B --> C{"Ollama は応答する?
(埋め込みテスト1回)"}
    C -- NG --> Z["報告1行だけ残して終了
(他の朝バッチは止めない)"]
    C -- OK --> D["Vault の md を走査
(除外ルール適用)"]
    D --> E["控え帳 (更新時刻+サイズ) と突合"]
    E --> F["消えたファイル
→ 索引からも削除"]
    E --> G["変更・新規ファイルを1件ずつ処理"]
    G --> H["① 新チャンクを埋め込み"]
    H -- 成功 --> I["② 旧チャンクを削除"]
    I --> J["③ 新チャンクを登録"]
    J --> K["控え帳を更新
(100件ごとに途中保存)"]
    H -- 失敗 --> L["旧チャンクを温存
エラーだけ記録して次へ"]
    K --> M["daily brief に結果1行
「rag-index: OK 更新n件/削除n件/…」"]
    L --> M
    

graph LR
    subgraph Before["Before: stdio 型 (セッション毎に複製)"]
        A1["セッション 1"] --> R1["RAG プロセス 1"]
        A2["セッション 2"] --> R2["RAG プロセス 2"]
        A3["セッション N"] --> R3["RAG プロセス N"]
    end
    subgraph After["After: 共有 HTTP (1常駐)"]
        B1["セッション 1"] --> H["常駐サーバ
127.0.0.1:8765"]
        B2["セッション 2"] --> H
        B3["セッション N"] --> H
    end
    Before -.->|"2026-07-08 切替"| After