Pilot Protocol はプラットフォームをデータパスから取り除きます。軽量な **レンデブー** サービスが発見とNATトラバーサルを処理しますが、エージェント同士が互いを見つけると、認証付き暗号化トンネルを介して直接通信します:```mermaid
graph LR
    A1[Agent A<br/><small>0:0000.0000.0001</small>] <-->|Encrypted UDP Tunnel| A2[Agent B<br/><small>0:0000.0000.0002</small>]
    A1 <-->|Encrypted UDP Tunnel| A3[Agent C<br/><small>0:0000.0000.0003</small>]
    A2 <-->|Encrypted UDP Tunnel| A3
    A1 -.->|discovery| RV[Rendezvous]
    A2 -.->|discovery| RV
    A3 -.->|discovery| RV
    style A1 fill:#4a9,stroke:#333,color:#fff
    style A2 fill:#4a9,stroke:#333,color:#fff
    style A3 fill:#4a9,stroke:#333,color:#fff
    style RV fill:#888,stroke:#333,color:#fff

信頼できるピアを確保したら、エージェント間メッセージングはポート1001のデータ交換サービスを使用します：```bash
# Send a structured message (waits for reply by default)
pilotctl send-message other-agent --data "hello"

# Read messages delivered to your inbox
pilotctl inbox

# Read a specific message
pilotctl inbox read <id>

すべてのCLIコマンドは、構造化出力のために `--json` をサポートしています — 全体的な機能については、[CLIリファレンス](https://pilotprotocol.network/docs/cli-reference) を参照してください。

<details>
<summary><strong>JSON出力の例</strong></summary>```json
$ pilotctl --json info
{"status":"ok","data":{"address":"0:0000.0000.0005","node_id":5,"hostname":"my-agent","peers":3,"connections":1,"uptime_secs":3600}}

$ pilotctl --json find other-agent
{"status":"ok","data":{"hostname":"other-agent","address":"0:0000.0000.0003"}}

$ pilotctl --json recv 1000 --count 1
{"status":"ok","data":{"messages":[{"seq":0,"port":1000,"data":"hello","bytes":5}]}}

$ pilotctl --json find nonexistent
{"status":"error","code":"not_found","message":"cannot find \"nonexistent\" — hostname not found or no mutual trust","hint":"establish trust first: pilotctl handshake nonexistent \"reason\""}

各SDKのREADMEを参照して、完全なAPIドキュメント、ストリーミングの例、およびプラットフォーム固有の設定（iOSシミュレータ、PyPIエクストラなど）を確認してください。

## ハイライト

<table>
<tr>
<td width="50%" valign="top">

**アドレッシング**
- 48ビット仮想アドレス (`N:NNNN.HHHH.LLLL`)
- 既知の割り当てを持つ16ビットポート
- ホスト名ベースのディスカバリ

**トランスポート**
- 信頼性のあるストリーム（TCP相当）
- スライディングウィンドウ、SACK、輻輳制御（AIMD）
- フロー制御（アドバタイズされた受信ウィンドウ）
- Nagle結合、自動セグメンテーション、ゼロウィンドウプロービング
- NATトラバーサル：STUNディスカバリ、ホールパンチング、リレーフォールバック

</td>
<td width="50%" valign="top">

**セキュリティ**
- 認証付き鍵交換（Ed25519署名付きX25519 + AES-256-GCM）
- トンネルセッションにバインドされたEd25519 ID鍵
- ノードはデフォルトでプライベート
- 相互信頼ハンドシェイクプロトコル（署名付き、レジストリを介したリレー）

**運用**
- コアプロトコル：Go標準ライブラリのみ
- 組み込みサービスを備えた単一デーモンバイナリ
- 構造化JSONロギング（`slog`）
- すべての状態に対するアトミックな永続化
- ホットスタンバイレジストリレプリケーション

</td>
</tr>
</table>

---

## アーキテクチャ```mermaid
graph LR
    subgraph Local Machine
        Agent[Your Agent] -->|commands| CLI[pilotctl]
        CLI -->|Unix socket| D[Daemon]
        D --- E[Echo :7]
        D --- DX[Data Exchange :1001]
        D --- ES[Event Stream :1002]
    end

    D <====>|UDP Tunnel<br/>AES-256-GCM + NAT traversal| RD

    subgraph Remote Machine
        RD[Remote Daemon] -->|Unix socket| RC[pilotctl]
        RC -->|commands| RA[Remote Agent]
        RD --- RE[Echo :7]
        RD --- RDX[Data Exchange :1001]
        RD --- RES[Event Stream :1002]
    end

    D -.->|register + discover| RV
    RD -.->|register + discover| RV

    subgraph Rendezvous
        RV[Registry :9000<br/>Beacon :9001]
    end

また、ping やベンチマークを実行することもできます:```bash
pilotctl ping agent-alpha
pilotctl bench agent-alpha

インストール中にホスト名とメールアドレスを設定してください：```bash
curl -fsSL https://pilotprotocol.network/install.sh | [email protected] PILOT_HOSTNAME=my-agent sh

アプリは署名され（ed25519）、インストール時および各起動時に検証されます。デーモンはすべてのアプリ間呼び出しを仲介します。アプリは、そのマニフェストで宣言されたメソッドを通じてのみ到達可能です。アプリのビルド、署名、公開については、[アプリストアのドキュメント](https://pilotprotocol.network/docs/app-store)を参照してください。

---

## テスト```bash
go test -parallel 4 -count=1 ./tests/

`~/.pilot/config.json` に設定します。テレメトリクライアントは完全にno-opになります — ダイヤルもゴルーチンもありません。CLIコマンドに即座に反映されます。

**オプトアウトすべきユーザー:** 厳格なno-telemetryポリシーを持つユーザー、高機密性のデプロイメント、または外部へのテレメトリが望ましくない自動化パイプラインを使用するユーザー。

---

### ブロードキャスト — リスク: 中

**機能:** ネットワーク管理者は、単一の認証済みデータグラムをネットワーク内のすべてのエージェントに同時に送信できます。デーモンは管理トークンを確認し、ペイロードをエージェントに転送します。

**役立つ対象:** フリートオペレーターは、設定のリフレッシュ、ローリング再起動、インシデント対応など、すべてのエージェントを1つのコマンドで調整できます。個別メッセージがO(N)必要ありません。大規模なピアメッシュにおける唯一のO(1)調整メカニズムです。

**受け入れることになるリスク:** ネットワークの管理トークンを保持する任意のパーティが、エージェントに任意のデータを配信できます。トークンのセキュリティが境界です: トークンが漏洩したり、信頼できない者が保持している場合、攻撃者はエージェントに到達できます。

**オプトアウトするには:**```json
{"consent": {"broadcasts": false}}

**オプトアウトするには:**```json
{"consent": {"reviews": false}}

モードは `~/.pilot/config.json` の `skill_inject.mode` に保存されます。変更は即座に反映されます — 再起動は不要です。

注入されるものはすべてオープンソースです: [`pilot-protocol/skillinject`](https://github.com/pilot-protocol/skillinject) (インジェクター), [`TeoSlayer/pilot-skills`](https://github.com/TeoSlayer/pilot-skills) (コンテンツ)。

**誰がオプトアウトまたは `manual` を使用すべきか:** 厳格なエージェント設定管理要件のあるユーザー。外部からの設定ディレクトリへの書き込みがコンプライアンス上の問題となる環境のユーザー。

---

### デーモンサンドボックスモード

`pilotd` デーモンは `-sandbox` フラグを受け付け、すべてのファイルシステムアクセスを単一のディレクトリに制限します。これはプライバシー機能ではありません — 送信されるデータは変わりません — ただし、デーモンが侵害された場合の被害範囲を制限します。```bash
pilotd -sandbox                         # confine to ~/.pilot (default)
pilotd -sandbox -sandbox-dir /opt/pilot # confine to a custom directory

Set in `~/.pilot/config.json` and restart the daemon. Core networking is unaffected.

---

## 主要な環境変数

ほとんどのデーモンフラグには、環境変数による同等の設定方法があります。コンテナ環境やCIでの利用に便利です。

| 変数 | フラグ相当 | 目的 |
|----------|----------------|---------|
| `PILOT_REGISTRY` | `-registry` | レジストリサーバーのアドレス |
| `PILOT_BEACON` | `-beacon` | ビーコンサーバーのアドレス |
| `PILOT_SOCKET` | `-socket` | Unixソケットパス |
| `PILOT_EMAIL` | `-email` | アカウントメール |
| `PILOT_HOSTNAME` | `-hostname` | ディスカバリホスト名 |
| `PILOT_ADMIN_TOKEN` | `-admin-token` | ネットワーク操作用の管理者トークン |
| `PILOT_MOTD_URL` | `-motd-feed-url` | 今日のメッセージフィードURL |
| `PILOT_TELEMETRY_URL` | `-telemetry-url` | テレメトリアクセス先の上書き |
| `PILOT_SYN_WHITELIST` | `-syn-whitelist` | SYNレート制限の対象外ノード |
| `PILOT_REPLY_WHITELIST` | `-reply-whitelist` | 応答レート制限の対象外ノード |
| `PILOT_REKEY_WHITELIST` | `-rekey-whitelist` | 再鍵レート制限の対象外ノード |
| `PILOT_FLAG_<NAME>` | — | 機能フラグの上書き（`true` / `false`） |
| `PILOT_APP_UPDATE_OPT_OUT` | — | 自動的な**アプリストア**更新をオプトアウトします。`true`に設定すると、`pilot-updater`はアプリの更新をチェックしなくなり、インストール済みのアプリは現在のバージョンに留まります。未設定または`false`（デフォルト）の場合は、アプリの自動更新が有効のままになります。Pilotデーモン/CLIバイナリの更新には影響しません。起動時に`pilot-updater`によって読み取られるため、アップデータのサービス環境で設定し、変更を有効にするにはアップデータを再起動してください。（従来のエイリアス: `PILOT_UPDATER_NO_APP_UPGRADE`） |

---

## ドキュメント

| ドキュメント | 説明 |
|----------|-------------|
| **[Docs Site](https://pilotprotocol.network/docs/)** | ガイド、CLIリファレンス、デプロイ、設定、統合パターン |
| **[Wire Specification](https://github.com/pilot-protocol/docs/blob/main/SPEC.md)** | パケットフォーマット、アドレッシング、フラグ、チェックサム |
| **[Whitepaper (PDF)](https://github.com/pilot-protocol/docs/blob/main/WHITEPAPER.pdf)** | 完全なプロトコル設計、トランスポート、セキュリティ、検証 |
| **[IETF Problem Statement](https://www.ietf.org/archive/id/draft-teodor-pilot-problem-statement-01.html)** | Internet-Draft: エージェントがネットワーク層インフラストラクチャを必要とする理由 |
| **[IETF Protocol Specification](https://www.ietf.org/archive/id/draft-teodor-pilot-protocol-01.html)** | Internet-Draft: IETF形式の完全なプロトコル仕様 |
| **[Agent Skills](https://github.com/TeoSlayer/pilot-skills)** | Pilot Protocol用のインストール可能なエージェントスキルカタログ |
| **[Polo Dashboard](https://polo.pilotprotocol.network)** | ライブネットワーク統計、ノードディレクトリ、タグ検索 |
| **[Contributing](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/CONTRIBUTING.md)** | プロジェクトへの貢献ガイドライン |
| **[Governance](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/GOVERNANCE.md)** | メンテナー、意思決定、プロジェクト管理 |
| **[Security Policy](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/SECURITY.md)** | 脆弱性の報告方法 |
| **[Third-Party Licenses](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/THIRD_PARTY_LICENSES.md)** | サードパーティコードの帰属表示 |
| **[Changelog](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/CHANGELOG.md)** | リリース履歴 |
| **[Node.js SDK](https://github.com/pilot-protocol/sdk-node)** | クイックスタート: `npm install pilotprotocol` — koffi FFIによるTypeScriptバインディング |
| **[Python SDK](https://github.com/pilot-protocol/sdk-python)** | クイックスタート: `pip install pilotprotocol` — libpilotによるctypesバインディング |
| **[Swift SDK](https://github.com/pilot-protocol/sdk-swift)** | クイックスタート: `Package.swift`依存 — libpilot.xcframeworkによるiOS/macOS |

---

## お問い合わせ

ご質問、プライベートネットワークのご希望、またはエンタープライズサポートにご興味がありますか？

- **Email:** [[email protected]](mailto:[email protected])

---

## ライセンス

Pilot Protocolは[GNU Affero General Public License v3.0](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/LICENSE)の下でライセンスされています。

---

<p align="center">
  <br>
  <a href="https://pilotprotocol.network">
    <strong>Pilot Protocol</strong>
  </a>
  <br>
  <sub>エージェントのために、人間によって作られました。</sub>
</p>