Network 命令

Network 命令管理点对点基因发现层。在 v0.5 中，这些命令是基础阶段的桩实现——它们管理本地配置并显示占位符输出，但不会发生真正的 libp2p 网络通信。基因发现目前通过 Cloud 注册表进行。

rotifer network status

显示当前 P2P 节点配置和状态。

rotifer network status

示例：

$ rotifer network status

  ── P2P Network Status ──

  Node ID:          a1b2c3d4-e5f6-7890-abcd-ef1234567890
  Status:           ○ Inactive
  Listen Port:      9878
  Bootstrap Peers:  1

  Start the node: rotifer network start

rotifer network start

初始化 P2P 节点配置并标记为活跃。

rotifer network start [--port <port>]

选项：

选项	默认值	描述
`-p, --port <port>`	`9878`	P2P 连接的监听端口

示例：

$ rotifer network start --port 9900

  ── Starting P2P Node ──

  Node ID:   a1b2c3d4-e5f6-7890-abcd-ef1234567890
  Listen:    /ip4/0.0.0.0/tcp/9900
  Protocol:  rotifer/gene-discovery/1.0.0

  Connecting to bootstrap peers...
    → /dns4/bootstrap.rotifer.dev/tcp/9878

  ⚠ P2P networking is in foundation stage (v0.5).
    Gene metadata discovery is available; binary transfer uses Cloud CDN.

  ✓ P2P node initialized

配置保存在 ~/.rotifer/network.json。

rotifer network stop

停用 P2P 节点。

rotifer network stop

rotifer network peers

列出已知节点。需要节点处于活跃状态。

rotifer network peers

示例：

$ rotifer network peers

  ── Known Peers ──

  #     Address                                     Status
  ────────────────────────────────────────────────────────────
  1     /dns4/bootstrap.rotifer.dev/tcp/9878        bootstrap

  1 peer(s) known

rotifer network search <query>

通过 P2P 网络搜索基因。目前回退到 Cloud 搜索。

rotifer network search <query>

示例：

$ rotifer network search "code formatter"

  ── P2P Gene Search ──

  Searching P2P network for: "code formatter"
  Querying DHT for gene metadata...

  ⚠ P2P gene search is in foundation stage (stub).
    Currently, all gene discovery goes through the Cloud Registry.

  Use 'rotifer search' for Cloud-based gene discovery.

rotifer network announce <gene-name>

向 P2P 网络广播基因元数据。需要节点处于活跃状态。

rotifer network announce <gene-name>

示例：

$ rotifer network announce grammar-checker

  ── Gene Announcement ──

  Announcing gene 'grammar-checker' to P2P network...
  Broadcasting gene metadata via GossipSub...

  ⚠ P2P gene announcement is in foundation stage (stub).
    Gene metadata propagation to connected peers is planned for a future release.
    For now, use 'rotifer publish' to share via Cloud Registry.

配置

所有网络配置存储在 ~/.rotifer/network.json：

{
  "node_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "listen_port": 9878,
  "bootstrap_peers": [
    "/dns4/bootstrap.rotifer.dev/tcp/9878"
  ],
  "enabled": false
}

计划功能

功能	描述
libp2p 集成	通过 rust-libp2p 实现真正的点对点网络
Kademlia DHT	分布式节点发现
GossipSub 传播	基因元数据广播到连接的节点
QUIC + TCP 传输	NAT 穿越和回退
IPFS CID 存储	内容寻址的基因包