github.com/YunyueLi/LoreGraph
根拠のない関係は、一つも残さない。
I. 表紙図版 Design for a theater set、メトロポリタン美術館 001 / 007
フィクションのための、根拠に紐づく知識グラフ

知識グラフの一文ごとに、原文の一節残る

LoreGraph は小説・戯曲・脚本・台本を、検索できるグラフに変換します。人物・物・出来事・概念、そしてそれらを結ぶ型付きの関係です。どの主張にも evidence_span が付くので、関係をクリックすればその出典の一文に着きます。

85 作品参照コーパス
11 言語原文から画面まで
08 パスうち 1 つは関門
↳   uv sync   →   loregraph extract
Israel Silvestre、1654 The Met, CC0 文字列一致  95% 以上 図版:Design for a theater set created by Giacomo Torelli da Fano for the ballet 'Les Noces de Thétis'.
01分割 02抽出 03検証 04ノート
II. docs/8-pass-pipeline.md 002 / 007
原則

関係をでっち上げるグラフは、無いほうがましだ。

テキストから知識グラフを作る多くのツールは、三つ組を抽出して「信じてください」と言う。フィクションではそれが致命的になる。LoreGraph が守るのは一つだけ。抽出したすべての主張に evidence_spanつまり原文そのままの部分文字列を持たせ、検証パスが一致率 95% に届かない主張を落とす。

パイプライン仕様を読む
図版:Sphaera Mundi(メトロポリタン美術館、CC0、コラージュとして加工)
モデルが使えるのは
目の前の本文だけ。
知っている孫悟空は
忘れるよう、
明示的に指示される。
閉世界での抽出:どの主張も本文の一文に戻れる。 (Sphaera Mundi、1485。メトロポリタン美術館、CC0)

エンジニアリングは以下のプロジェクトを参照した。コーパスは公開されている出典から取っている。

参考文献を見る
III. src/loregraph 003 / 007
図版:New Inventions of Modern Times [Nova Reperta], The Invention of Book Printing, plate 4(メトロポリタン美術館、CC0、コラージュとして加工)
LOREGRAPH     8-PASS PIPELINE
エンジニアリング

根拠には厳しく、モデルにはゆるく

Splink・ComEM・GraphRAG を読んで、四つのことが決まった。文字列一致の関門、文字体系をまたぐ実体解決、パス単位のコミットと冪等な再実行、そして特定ベンダーに縛られないクライアント。

01根拠

すべての主張に
出典の一文

抽出しながら evidence_span を書き込み、検証パスが一致率 95% 未満を破棄する。

02閉世界

読むのは
目の前の本文だけ

既に知っているエリザベス・ベネットや孫悟空は忘れ、この本が述べていることだけを報告するよう指示される。

03多言語

文字体系を
またいで統合

実体解決は multilingual-e5-large 上で動くので、林黛玉と颦儿は文字が一致しなくても一つのノードに統合される。

04任意のバックエンド

鍵ひとつで
どのモデルでも

既定は OpenRouter 経由の DeepSeek V4 Pro で、15 以上のバックエンドに差し替えられる。Anthropic は直接呼び出し、プロンプトのキャッシュを再利用する。

IV. src/loregraph/web 004 / 007
リーディングルーム

一冊の本、五つのビュー、土台は同じグラフ

05
五つのビュー、すべて実装済み Reader・Graph・Timeline・
Index・Ask は同じ
グラフを読んでいる。
図版:Manuscript Leaf with text in Bolorgir(メトロポリタン美術館、CC0、コラージュとして加工)
01

Reader 原文

原文そのまま。実体への言及はすべてハイライトされ、クリックできる。

図版:The Celestial Map- Northern Hemisphere(メトロポリタン美術館、CC0、コラージュとして加工)
02

Graph 関係網

人物・物・出来事・概念の力学配置ネットワーク。辺にカーソルを合わせると出典の行が出る。

図版:Bamboo and the Thousand-Character Classic(メトロポリタン美術館、CC0、コラージュとして加工)
03

Timeline 出来事

物語の出来事を読む順に並べる。グラフは事実ごとに物語内の時間を持つ。

図版:Alphabet Letters (5 Vowels)(メトロポリタン美術館、CC0、コラージュとして加工)
04

Index 実体目録

検索できる実体の目録。実体ごとに一枚のカードで、事実と推論を分けて示す。

図版:Terracotta bell-krater (bowl for mixing wine and water)(メトロポリタン美術館、CC0、コラージュとして加工)
05

Ask グラフ質問

グラフに基づく質問応答。どの回答も根拠を示す。

五つのビューはすべて src/loregraph/web にある     ソースを読む →
V. 全 8 パス 005 / 007
パイプライン

八つのパスで、生の本文から確かめられる主張へ。

+

第 1・4 パスは決定的。第 2・3・5・6・8 パスはモデルを呼ぶ。第 7 パスは提案ではなく関門だ。各パスが個別にコミットするので、失敗した実行は --from N で再開でき、二重書き込みは起きない。

01

分割

章を意識した決定的な分割。英語の見出しも「第N回」も同じように読む。各チャンクに物語全体での時間位置を付ける。

図版:Manuscript Leaf from a Royal Psalter(メトロポリタン美術館、CC0、コラージュとして加工)
02

抽出

型付きの言及を取り、実体解決(語形と埋め込み kNN によるブロッキング、続いて一括照合)、共参照、五種類の関係、そしてそれらが含意する常識的事実まで進む。

図版:Neu inventiert genealogischer Stamm-Baum der Griechisch Kayser.
03

検証

chain-of-verification。根拠の範囲が原文と文字どおり一致しない主張はここで落ちる。関門は 95%。

図版:Fragmentary marble inscription(メトロポリタン美術館、CC0、コラージュとして加工)
04

ノート

実体ごとに Hybrid Note を一枚。事実と推論を別の欄に分け、推論には確信度を、実体には下位種別と重要度を付ける。

図版:Bookbinding (Jild-i kitab)(メトロポリタン美術館、CC0、コラージュとして加工)
本文に無いものは、グラフに入れない。
VII. Apache-2.0 007 / 007
はじめに

三つのコマンドで、手元の一冊にグラフが生まれる。

まず uv syncpgvector を入れた Postgres 16+ に alembic upgrade head を当て、あとは loregraph ingestloregraph extractOpenRouter の鍵が一つあれば足りる。中くらいの長編なら時間ではなく分で終わり、1 冊あたり 20 ドルの上限がパスの合間に効く。

● Live v0.1.0-dev / Apache-2.0
図版:Parte di ampio magnifico Porto all'uso degli antichi Romani, ove si scuopre l'interno della gran Piazza pel Comercio.
VII
LOREGRAPH     APACHE-2.0