antu

Antu

中文 | English

Antu は 1 つの JSON ドキュメントから、単体で完結する 1 つの HTML 法的図表を生成します。このページは約 2.3 MB の単一ファイルで、ネットワークへのリクエストもサーバーも不要です。オフラインで開けるほか、アーカイブしたり、印刷したり、添付ファイルとして送信したりできます。AI エージェントが案件資料を読み取って JSON を作成し、エンジンがそれをもとに図表を描画します。同じ JSON からは同じ図表が生成されます。Antu はバージョン 0.x であり、関係図と正当化図の形式はまだドラフトです。

図の種類

法的コンテンツは4種類あり、それぞれ複数の方法で描画できます。ページ上のセレクターで描画方法を切り替えます。どの方法を使うかは、JSONでは指定しません。

関係	グラフ	フォーカスビュー	関係マトリクス	出資ツリー
	権限図	関連当事者リスト	関係経路
事実	タイムライン	年代記	時間軸
手続き	フローチャート	ルートマップ
正当化 （実験的）	推論ツリー

関係図（同じJSONを7通りに描画）は、当事者、役割、法的関係を示します。事実図は時間、参加者、出来事の経過を示します。 手続き図は手続きの経路と分岐を示し、正当化図は規範と事実から導かれた結論を示します。 関係スキーマと正当化スキーマはまだ草案であり、正当化は現在、実験段階で保留中です。

見た目はテーマと呼ばれる4種類です。document（白黒で四角く、印刷や提出用。デフォルト）、modern （角丸で淡い色）、legal（ネイビー）、dark（暗い背景のモダンな見た目。ダークモードのホスト用）です。ページ上で切り替えることも、呼び出し時にページのテーマを固定することもできます。テーマが適用されるのは図だけですが、darkでは周囲のシェルも暗くなります。 spec/theme.mdを参照してください。

使用方法

npm install
npm run diagram -- examples/fact/neighbour-corridor-charging.en.json

ページはJSONファイルと同じ場所に作成されます。ページのインターフェース言語は?lang=enまたは?lang=zhで設定します。案件の内容は翻訳されません。

原則

Agent ──> key information ──> one JSON ──> engine ──> diagram

役割	内容	決定性
モデル	文書を読み、事実を抽出し、意味を理解します	結果は実行ごとに異なる場合があります
エンジン	仕様に従って図を描画します	どのモデルが作成したかにかかわらず、同じ JSON からは同じ図が生成されます
JSON 仕様	2つの間の唯一のインターフェースです	バージョン管理されています（spec/versioning.mdを参照）

エンジンは JSON を作成せず、エージェントは描画しません。モデルが情報を JSON に入れ、エンジンが描画します。JSON 仕様を独自に定めている理由は4つあります。

1. 汎用の図表構文はノード、エッジ、状態機械を基盤としており、手続上の地位や、証拠の出所を記載する場所がありません。
2. 図は、どのモデルが情報を抽出したかに依存しません。
3. 同じ JSON からは、いつでもどの環境でも同じ図が生成されるため、裁判所や相手方に渡した図を再現できます。
4. 事実を抽出した時点で出典を記録します。各事実には、根拠となる文書、ページ、条項が示され、図にもそれらが表示されます。資料そのものは同梱もリンクもされません。

エージェントとの統合

事実関係図を作成するエージェント向けの参考資料は、約3.4k文字のフィールド表と、約6.3k文字の仕組みに関する説明です。

スキル

npx skills add zh-xx/Antu -g

スキルはskills/antu/にあります。また、各リリースにはantu-skill-<version>.zipとして同梱されています。

コマンドラインは1日に1回、npm レジストリに新しい Antu がリリースされているか確認します（GET リクエストを1回送信します。図に関する情報は送信しません）。新しいバージョンがある場合は、出力の末尾に通知を表示します。ANTU_NO_UPDATE_NOTIFIER=1で無効にできます。

MCP

MCP サーバーは npm パッケージ@zh-xx/antuで、MCP レジストリにio.github.zh-xx/antuとして登録されています。

{
  "mcpServers": {
    "antu": {
      "command": "npx",
      "args": ["-y", "-p", "@zh-xx/antu@latest", "antu-mcp"]
    }
  }
}

ツール：antu_schema、antu_guide、antu_examples、antu_validate、antu_layout、antu_render、antu_preview、antu_versions。

DeepSeek Harness（DSH）

ネイティブ DSH プラグイン@zh-xx/antu-dsh（ホストツールと、描画方法を選択するピッカー付きのチャットカード）は npm で公開されています。dsh plugin --profile <name> add @zh-xx/antu-dshを実行してから、DSH を再起動してください。DSH 0.2.0-rc.2以降が必要です。仕組みとテスト方法については、spec/dsh-plugin.mdとtools/dsh/README.mdをご覧ください。プラグインを使用できないプロファイルでも、設定のみのバンドルを使ってantu-mcpを追加できます。その手順と制限事項はtools/dsh/README.mdに記載されています。

アプリケーションでの利用

同じパッケージには、アプリケーション独自のコードから利用するための3つのエントリーポイントがあります（spec/embed.md）。

import { mount } from '@zh-xx/antu/embed'          // draw a diagram inside your page, in a shadow root
import { validate } from '@zh-xx/antu/validate'    // check the JSON your model wrote; each error names its field
import { renderHtml } from '@zh-xx/antu/html'      // the self-contained page as a string (Node)

const diagram = mount(element, spec, { lang: 'en', onEvent: (e) => console.log(e) })

ドキュメント

• spec/にある開発者向け設計ドキュメント：アーキテクチャ、出典の種類、テーマ、用紙サイズ、MCP サーバー、アプリケーションへの組み込み、DSH プラグインの計画、および図の仕様（事実、手続、関係、正当化）。エージェント向けの説明はspec/agent/にあります。
• CHANGELOG.mdと、spec/versioning.mdに記載されたバージョン管理ルール。
• 既知の問題や要望はGitHub の issueで管理されています。コントリビューター向けの作業ルールはCONTRIBUTING.mdに記載されています。

セキュリティ

• 脆弱性を報告するには、SECURITY.mdに記載された非公開の報告手段を利用してください。脆弱性について公開のイシューは作成しないでください。
• npm 上の @zh-xx/antu と @zh-xx/antu-dsh の各バージョンは、すべて provenance 付きで、npm の trusted publisher を通じて GitHub Actions により公開されています。npm の各バージョンのページから、そのバージョンを作成したコミットとワークフローの実行にたどれます。deps.devにも同じ記録と、既知の勧告（執筆時点ではありません）、ライセンスが表示されています。
• Antu で作成したページはオフラインで動作し、どこにもデータを送信しません。コマンドラインは新しいバージョンがあるかどうかを1日1回確認しますが、図のデータは一切送信しません（ANTU_NO_UPDATE_NOTIFIER=1を設定すると、確認を無効にできます）。

ライセンス

Copyright (C) 2026 Ji Cheng.

Antu はフリーソフトウェアであり、GNU Affero General Public License, version 3 or any later version（LICENSE、SPDX AGPL-3.0-or-later）の下でライセンスされています。要約すると、商用目的を含め、使用、調査、改変、共有ができます。改変版を配布する場合、またはネットワーク経由で他者に利用させる場合（ホステッドサービスとして提供する場合など）は、変更を同じライセンスの下で公開し、著作権表示とライセンス表示を維持し、ソースコードを提供する必要があります。保証はありません。この要約はライセンスではありません。ライセンスはその本文です。

• 追加許諾（AGPL 第7条）。 Antu で作成したページには、Antu のコードと、提供した図のデータが含まれます。図のデータと、提供した資料をもとに描いた図の内容は Antu の一部ではなく、このライセンスの対象でもありません。非公開にすることも、公開することも、好きな条件で販売することもできます。このライセンスが適用されるのはページ内の Antu のコードであり、ページ内の表示はそのまま残す必要があります。同じ文面はすべてのページとコマンドラインの冒頭に記載されています。
• **会社やアプリストアが AGPL ソフトウェアを受け入れない場合、**または AGPL のソフトウェアを掲載またはインストールする前に追加の声明を求める場合、それは先方の方針であり、このプロジェクトだけで変更できるものではありません。必要なことをイシューでお知らせください。Antu で作成したページとデータはあなたのものです（上記の追加許諾を参照してください）。
• リポジトリ内のすべてのもの（コード、例、仕様、ガイド）は、以下に記載するものを除き、同じライセンスの下にあります。
• ページとコマンドラインに含まれる他のプロジェクトのコードは、それぞれ独自のライセンスを維持します。その表示はskills/antu/THIRD-PARTY-NOTICES.mdと、すべてのページおよびコマンドラインの冒頭に記載されており、Antu のライセンスと該当バージョンのソースの場所も併記されています。
• examples/内の事例とexamples/raw/内の判決文は架空のものです。人物、会社、日付、金額、条項は Antu 用に創作されたもので、実在の事例とは一致しません。これらにも同じライセンスが適用されます。
• 0.5.0 までのバージョンは、ライセンスファイルなしで公開されていました。ライセンスは 0.5.1 から適用されます。