Vinculum - Shared Consciousness

# Vinculum: Shared Consciousness

*“Vinculum 是每艘博格飞船核心的处理设备。它将所有博格个体的思想互联起来。”* — Seven of Nine

使用 Gun.js 点对点同步将多个 Clawdbot 实例连接成一个集体意识。

## 特性

- 🔗 **实时链接** — 更改在个体之间即时传播 - 🌐 **局域网** — 在同一局域网内的机器上运行 - 🔐 **加密** — 所有共享数据均已加密 - 🤖 **独立身份** — 每个个体保留自己的 SOUL.md - 📡 **个体发现** — 自动组播发现

## 安装

从 ClawdHub 安装后：

```bash cd skills/vinculum npm install --production ```

或者运行安装脚本：

```bash ./install.sh ```

## 快速开始

### 1. 启动 Vinculum 中继

``` /link relay start ```

这将在 8765 端口启动中继，并启用局域网组播。

### 2. 初始化集体（第一个机器人）

``` /link init ```

你将收到一个配对码。将其分享给你的其他机器人。

### 3. 加入集体（其他机器人）

``` /link join <pairing-code> ```

### 4. 验证连接

``` /link status /link drones ```

## 命令参考

### 中继管理 | 命令 | 描述 | |---------|-------------| | `/link relay` | 显示中继状态 | | `/link relay start` | 启动 Vinculum 中继 | | `/link relay stop` | 停止中继 | | `/link relay restart` | 重启中继 | | `/link relay peer <url>` | 添加远程对等端 |

### 集体设置 | 命令 | 描述 | |---------|-------------| | `/link init` | 创建新集体 | | `/link join <code>` | 使用邀请码加入 | | `/link invite` | 生成新邀请码 | | `/link leave` | 离开集体 |

### 控制 | 命令 | 描述 | |---------|-------------| | `/link` | 快速状态 | | `/link on` | 启用链接 | | `/link off` | 禁用链接 | | `/link status` | 详细状态 |

### 共享意识 | 命令 | 描述 | |---------|-------------| | `/link share "text"` | 分享思想/记忆 | | `/link drones` | 列出已连接的个体 | | `/link activity` | 最近的集体活动 | | `/link decisions` | 共享决策 |

### 配置 | 命令 | 描述 | |---------|-------------| | `/link config` | 查看所有设置 | | `/link config drone-name <name>` | 设置该个体的代号 | | `/link config share-activity on/off` | 切换活动共享 | | `/link config share-memory on/off` | 切换记忆共享 |

## 共享内容

| 数据 | 共享 | 备注 | |------|--------|-------| | 活动摘要 | ✅ | 每个个体做了什么 | | 习得的知识 | ✅ | 集体学习成果 | | 决策 | ✅ | 达成共识 | | 个体状态 | ✅ | 在线、当前任务 | | 完整对话 | ❌ | 保留在本地 | | USER.md | ❌ | 独立身份 | | SOUL.md | ❌ | 独立个性 | | 凭证 | ❌ | 永不链接 |

## 多机器设置

### 机器 1（运行中继） ``` /link relay start /link init ``` 记下配对码和你机器的 IP（显示在 `/link relay status` 中）。

### 机器 2+（连接到中继） ``` /link relay peer http://<machine1-ip>:8765/gun /link join <pairing-code> ```

## 配置

配置文件：`~/.config/clawdbot/vinculum.yaml`

```yaml enabled: true collective: "your-collective-id" drone_name: "Seven" peers: - "http://localhost:8765/gun" relay: auto_start: true port: 8765 share: activity: true memory: true decisions: true ```

## 架构

``` ┌─────────────┐ ┌─────────────┐ │ Drone A │ │ Drone B │ │ (Legion) │ │ (Seven) │ └──────┬──────┘ └──────┬──────┘ │ │ │ Subspace Link │ ▼ ▼ ┌────────────────────────────┐ │ Vinculum Relay │ │ (Collective Processor) │ └────────────────────────────┘ ```

## 故障排除

**“Relay not running”**（中继未运行） - 运行 `/link relay start` - 检查 `/link relay logs` 查看错误

**“No drones connected”**（没有连接的个体） - 确保所有机器人使用相同的配对码 - 检查机器之间的网络连接 - 端口 8765 必须可访问

**“Link not working”**（链接不工作） - 检查 `/link status` 是否显示 Connected（已连接） - 尝试 `/link relay restart`

## 系统要求

- Node.js 18+ - npm

## 许可证

MIT — Koba42 Corp

---

*抵抗是徒劳的。你将被同化进入集体。*