ドキュメント
ドキュメントは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
カーネルができることとできないこと、結果、クイックスタート、名前の由来(英語)。
- クイックスタート
Linux、macOS、Windows向けのリリース、Pythonクライアント、最小の例(英語)。
- コーパスでの監査サーバー
sbgk audit-serveを、オープンなコーパス、または--docsでお手元の文書に対して起動する方法(英語)。 - 簡体字中国語のREADME
READMEの簡体字中国語版。
リファレンス
- LIMITATIONS.md
カーネルができないこと、示さないこと、コストをかけて行うこと(英語)。
- BENCHMARKS.md
何を、何に対して、誰が測定したか、そしてどんな注意点があるか(英語)。
- SECURITY.md
監査サーバーの信頼モデルと、脆弱性の報告方法(英語)。
- CHANGELOG.md
各リリースでの変更点(英語)。
- 監査レイヤー
カーネルの監査レイヤーについての詳細(英語)。
例
- examples/revoke-and-replay
1分間のデモと、オフラインで使えるインスペクターのページ。
- examples/quickstart
エンジンの最小の例:2つの引用、2つの事実、1つの導出。
- examples/findings-gate
セキュリティレビューの、コードファイルに対する指摘を、カーネルに通す例。
- examples/live-journal
YuCe Live:ジャーナルから作る1枚のHTMLページ。フレームごとに再生します(英語)。
- examples/prov-export
ジャーナルをW3C PROV-Oとして書き出します。サンプル付き(英語)。
インストール
- リリース
Linux、macOS、Windows向けのバイナリ(SHA-256チェックサム付き)。
sbgk --helpまたはyuce --helpを実行してください。同じコマンドです。 - PyPIのPythonクライアント
pip install organetic-yuceでインストールし、yuceとしてインポートします。サーバーのツールの薄いクライアントです。 - clients/python
Pythonクライアントのソースと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つ)。各記録を誰が書いたか、文書のどの版のどのバイトに立っているか、何を根拠にしているか、いつ成立し、いつ成立しなくなったか。どちらも、ジャーナルからいつでも作り直せます。
