aa0101181514/tw-legal-rag

TL;DR

Taiwan Legal RAG は、約 2200 万件の台湾の裁判所判決、法令、行政裁決を含む公開サーバーホスト型セマンティック検索サービスを照会できるコマンドラインツールです。一致するドキュメントを bundle として返し、任意の LLM（ChatGPT、Claude、Gemini、ローカルモデルなど）に供給できます。また、LLM の回答がバンドル内に実際に存在する資料のみを引用していることを検証する、軽量で決定論的な引用チェックも提供します。

---

これは何か

• タイプ: オープンソースの Python CLI（pip install twlegalrag でインストール可能）。
• 目的: 自然言語クエリを介して台湾の法文書（裁判所判決、法令、行政解釈）を取得し、下流の AI 利用のために結果をパッケージ化します。
• 範囲: 法的検索 + 引用検証。いかなる言語モデルも実行またはホストせず、法的アドバイスも提供しません。

---

主な機能

機能	説明	重要性
セマンティック（あいまい）検索	サーバー側のベクトルベースのインデックスを使用して、クエリと概念的に類似した判決を検索します。キーワード一致だけではありません。	異なる表現を使用しても、関連するケースを発見できます。
正確なケース検索	正確なケース番号検索と、自動の「ケースが見つかりません」処理。	正しい判決を参照していることを保証します。
ケース履歴リンク	各判決バンドルには case_history が含まれ、上訴関係と判決が覆されたかどうかが表示されます。	もはや有効でない判決を引用することを防ぎます。
法条検索	法令の現行条文を、改正日と有効性フラグ付きで取得します。	引用する正確な法定文言を提供します。
行政規則検索	規則と解釈令の正確な番号検索とセマンティック検索の両方。	台湾法の完全な階層をカバーします。
バンドル作成（twlegalrag pack）	クエリ、一致する判決、抜粋、URL、引用ホワイトリスト、検証手順を JSON ファイルにパッケージ化します。	任意の LLM が安全に消費できる自己完結型の成果物を提供します。
引用チェック（twlegalrag check）	決定論的な文字列一致チェックで、(1) 引用されたケース番号がバンドル内にあること、(2) 引用されたテキストが実際にバンドル内のどこかに存在すること、(3) バンドル外の引用がないことを検証します。	回答が提示される前に「幻覚」引用を捕捉するのに役立ちます。
ヘルスエンドポイント	リモートサービスが到達可能かどうかを確認する簡単な twlegalrag health ping。	スクリプトの簡単な健全性チェック。
ゼロ LLM 依存	httpx、typer、rich のみが必要です。パブリックエンドポイントに API キーは不要です。	任意の環境で簡単にインストールして実行できます。

---

仕組み（高レベルフロー）

1. 検索 – CLI は自然言語クエリをホストされた TLR REST エンドポイント（https://tlr.dr-legal.com.tw）に送信します。サーバーは result_token 付きの一致する判決のリストを返します。
2. 全文取得 – トークンを使用して、CLI は各判決の抜粋（およびオプションで全文）を取得します。
3. パック – 取得したすべてのデータが bundle.json にまとめられ、以下が含まれます。
   • query
   • citation_id/citation_text/citation_url
   • case_history
   • allowed_citations ホワイトリスト
   • verification_instructions（下流モデルが従うべきルール）。
4. 消費 – バンドルを LLM プロンプトに貼り付け、提供された引用のみを使用して回答するように依頼します。
5. チェック – LLM が応答した後、twlegalrag check bundle.json answer.txt を実行して、モデルが使用したすべての引用が存在し、引用されたスニペットがバンドル内に存在することを検証します。

---

誰が使うか

• 法務テック開発者：台湾法のチャットボットや RAG パイプラインを構築する人。
• 弁護士または研究者：判例法を LLM に供給する再現可能で引用安全な方法を求める人。
• コンプライアンスチーム：AI 生成のアドバイスが検証済みの法令/判決のみを参照するようにする必要がある人。
• 教育者/学生：ローカルで大規模なデータセットを扱わずに AI 支援の法務調査を探求する人。

---

制限と注意事項

• CLI は単なるクライアントです。重い処理（ベクトル埋め込み、インデックス、検索）はリモートの TLR サーバーにあります。
• 引用チェックは文字列ベースです。引用された箇所が正しい判決からのものであるか、法的推論が正確であるかを確認することはできません。
• 個人データや機密文書が TLR サービスに送信されることはありません。送信されるのはプレーンなクエリ文字列のみです。
• サービスは無料でオープンですが、バックエンドは品質分析のためにクエリをログに記録する場合があります。機密情報を送信しないでください。
• リポジトリは Elastic License 2.0（商用利用に友好的）であり、外部からの pull request は受け付けていません。

---

クイックスタート例

# インストール
pip install twlegalrag

# 残業代に関する最近のケースを検索
twlegalrag search "勞資 加班費" -n 5 --read

# AI プロンプト用のバンドルを作成
twlegalrag pack "車禍對方全責,我可以求償什麼?" -o bundle.json

# LLM から回答を得た後、引用を検証
twlegalrag check bundle.json answer.txt

---

ライセンスとガバナンス

• CLI コード: Elastic License 2.0（商用および内部使用は無料ですが、2 つの制限があります – ソフトウェアをサービスとして再ホストしないこと、ライセンス通知を保持すること）。
• データと API: コードライセンスの対象外。使用は別の TERMS.md および TRADEMARK.md ファイルによって管理されます。
• プロジェクトは単一の著者（Aaron Huang、Legal Detective / Dr.Legal の創設者）によって維持されており、外部からの pull request は受け付けていません。

---

結論

twlegalrag は、大規模で最新の台湾法コーパスと任意の LLM の間の実用的な橋渡しを提供し、捏造された引用に対する決定的でオープンソースの防御を提供します。これはデモやキュレーションされたリストではなく、法務 RAG ワークフローのための本格的で本番グレードのツールです。