ドキュメント

ドキュメントはYuCeのリポジトリにあり、情報源は一つです。次のところから始められます。

お手元のフォルダで:エージェント1つ

UTF-8のテキストファイルのフォルダ、1つの問い、1つのエージェント。MCPクライアントの設定に1項目を加えます(Claude Codeの.mcp.json、Claude Desktop、Cursor、またはstdioでサーバーを起動するクライアントなら何でも)。フォルダのパスを入れます。

  • リリースページのyuceバイナリ(SHA-256チェックサムを確認してください)。sbgkは同じプログラムです。
  • UTF-8のテキストファイルのフォルダ(PDFとWordは先にテキストに変換します)。
  • 問い。--askの後ろに書きます。

クライアントが自分で実行するコマンド:

yuce mcp --docs /path/to/my-docs --ask "これらの文書は返金について何と言っていますか?" --about "返金,返品"

またはMCPクライアントの設定の1項目として:

{"mcpServers": {"yuce": {"command": "yuce", "args": ["mcp", "--docs", "/path/to/my-docs", "--ask", "これらの文書は返金について何と言っていますか?", "--about", "返金,返品"]}}}

クライアントが自分でサーバーを起動します。ほかに実行するものはなく、トークンをコピーする必要もありません。最初の起動でフォルダを読み込み、ジャーナルをmy-docs/.yuce/run.walに保存します。以後の起動は同じ実行を再開します。エージェントには、読み取りエージェントのツールと、オーナーとしてのあなたの読み取りツールが渡されます。その1つであるaudit_withdraw_previewは、撤回によって何が根拠を失うかを、何も書き込まずに示します。書き込むツール(テキストの撤回、実行を閉じること)は、--owner-tools allでサーバーを起動しない限り、モデルには閉じたままです。長いツールの結果は、MCPクライアントが1つの結果の大きさを制限するため、分割して返されます。残りはaudit_moreで得られます。トピックの語は問いから取られます。--about "返金,返品"で自分で指定することもでき、中国語や日本語の問いでは必要になります。

オーナーがテキストを撤回したあと、次のコマンドで、何が根拠を失ったかが分かります。

sbgk audit-read fallen --wal my-docs/.yuce/run.wal

サーバーを自分で動かし、さらに多くのエージェントが参加できるようにする場合:

cat > questions.json <<'EOF' [{"id": "q1", "text": "What do these documents say about refunds?", "about": ["refund"]}] EOF sbgk audit-serve --profile solo --docs ./my-docs --questions questions.json --run-id mine --wal mine.wal --listen 127.0.0.1:8787

--profile soloは、グラフビルダーなしで、読み取りエージェントを1つ動かします。--subjectsを指定しない場合、サーバーはジャーナルの隣にmine.wal.subjects.jsonを書き出します。中には2つのトークンがあり、agentはエージェント用、ownerはご自身用で、サーバーがそれらを表示することはありません。クライアントは--agent-id agentでagentとして接続し、そのトークンをSBGK_MCP_TOKENに入れます。ブリッジの設定はREADMEにあります。実行は、開始時にファイルを固定します。ファイルが変わった場合は、新しい実行になります。

READMEとブリッジの設定

ここから始める

リファレンス

例

インストール

PyPIのyuceという名前は、無関係なプロジェクトのものです。organetic-yuceをインストールしてください。

0.2で加わったもの

0.2系列の新機能(0.2.0:2026年11月12日、0.2.1:2026年11月14日、0.2.2:2026年11月15日):

エージェント1つ、設定は1行

yuce mcp --docs <フォルダ> --ask <問い>は、MCPクライアントがstdioで自分から起動する、1つのMCPサーバーです。実行を開始または再開し、ジャーナルを<フォルダ>/.yuce/run.walに保存し、実行の2つのトークンは自分の中に保ちます。長い結果は分割して返されます。

何が根拠を失ったか、そしてその理由

sbgk audit-read fallen --wal run.walは、根拠を失った各記録、取り除かれた引用(テキストではなく、バイトで示されます)とその理由、その下でまだ成立している引用、他の出典にある似た内容の主張、そして読み直しの対象を示します。撤回の前にも同じレポートが得られます。audit_withdraw_previewは、撤回によって何が根拠を失うかを、何も書き込まずに示します。

一つの結論に対する証憑

sbgk audit-proofは、一つの記録と、その根拠のすべて(引用まで)を一つのファイルに切り出し、署名付きチェックポイントの下に置きます。対照実行では7〜24KBでした。sbgk audit-proof-verifyは、ジャーナルもモデルもなしに、そのファイル単体を検証します。

誰でも検証できるジャーナル

署名鍵を指定して起動したサーバーは、ジャーナルのチェックポイントに署名します(C2SP signed note、Ed25519)。sbgk audit-verifyは、別の場所に保管された受領証またはチェックポイントと照らして、ジャーナルを検証します。検証は常に無料です。署名が証明するのは、鍵の持ち主がそう述べたことだけです。チェックポイントは、ジャーナルの書き手が変更できない場所に保管してください。

黙って飛ばされるものはない

sbgk audit-read coverageは、ジャーナルから、モデルなしで、文書の各リスト項目、段落、表の行がどうなったかを示します。引用された(どの記録によるかも分かります)、読み取り予算の都合で残された、撤回された、または未読のいずれかです。ギャップパス(--gap-pass、既定では無効)は、どの引用にも覆われていない部分を、範囲の狭いタスクとしてエージェントに戻せます。

ジャーナルの隣のインデックスと来歴

sbgk audit-indexは、どのツールでも読めるSQLiteファイルを作ります。sbgk audit-provは、ジャーナルをW3C PROV-Oとして書き出します(どのRDFツールでも読めるJSON-LDファイル1つ)。各記録を誰が書いたか、文書のどの版のどのバイトに立っているか、何を根拠にしているか、いつ成立し、いつ成立しなくなったか。どちらも、ジャーナルからいつでも作り直せます。

変更点の全一覧