Vinculum - Shared Consciousness

核心用法

Vinculum 为 Clawdbot 提供多实例间的共享意识系统，通过 Gun.js 实现去中心化 P2P 数据同步。部署流程分为三步：启动 Relay 中继服务（默认端口 8765）、创建集体并生成配对码、其他实例通过配对码加入。支持自动局域网发现和手动指定对等节点两种组网方式。

共享数据范围包括活动摘要、习得知识、集体决策和无人机状态，而完整对话记录、用户身份文件、SOUL.md 人格定义及凭据均保持本地隔离。每个实例保留独立身份，仅选择性广播元信息。

显著优点

1. 实时同步：Gun.js 的实时图数据库特性使变更毫秒级传播
2. 零服务器依赖：纯 P2P 架构，无需中心化服务
3. 隐私分层设计：敏感数据明确排除在共享范围外
4. 轻量部署：仅依赖 Node.js 运行时，配置即 YAML 文件

潜在缺点与局限性

• 网络拓扑限制：依赖局域网连通性或手动配置对等地址，跨 NAT 场景需额外处理
• Gun.js 成熟度：作为相对小众的数据库，长期维护风险高于主流方案
• 无冲突解决说明：多机并发写入同一数据的最终一致性策略文档未详述
• 加密细节模糊："加密传输"未明确指向前向保密或认证机制

适合人群

多设备运行 Clawdbot 的高级用户、追求数据主权的自托管爱好者、需要分布式 Bot 协作的实验性项目团队。

常规风险

• 网络暴露：Relay 端口若暴露于公网可能成为攻击面
• 配对码泄露：获得配对码即可加入集体读取共享数据
• 依赖供应链：npm 依赖树的潜在漏洞需自行审计
• 数据残留：离开集体后，其他节点可能保留历史同步记录

核心用法

Vinculum 是一款为 Clawdbot 设计的多实例同步工具，利用 Gun.js 的 P2P 数据库实现"共享意识"功能。核心工作流分为三步：首先在一个实例上启动中继服务 /link relay start 并初始化集体 /link init 获取配对码，其他实例通过 /link join <code> 加入，即可实现活动摘要、学习知识、决策共识和节点状态的实时同步。

显著优点

• 真正的去中心化架构：基于 Gun.js 的 P2P 同步，不依赖中央服务器，数据在本地网络节点间直接传播
• 细粒度隐私控制：明确区分共享边界——活动/记忆/决策可同步，而完整对话、USER.md、SOUL.md、凭证永久本地保留
• 低门槛局域网协作：自动组播发现 + 配对码机制，无需复杂网络配置即可跨设备组网
• 模块化设计：每个实例保持独立身份（SOUL.md），集体作为可选叠加层存在

潜在缺点与局限性

• 网络绑定风险：默认监听 0.0.0.0:8765，虽为功能所需，但局域网内其他设备理论上可访问
• 进程管理依赖：使用 child_process.spawn 启动守护进程，虽用途合理但增加了系统复杂度
• 无内置持久化备份：P2N 网络的可靠性取决于在线节点数量，离线数据可能暂时不可达
• 有限的冲突解决：文档未明确说明多节点并发修改时的合并策略

适合人群

• 多设备 Clawdbot 用户：需要在台式机、笔记本、服务器间保持 bot 状态同步
• 小团队协作场景：研究团队、开发小组希望共享 AI 助手的知识积累
• 本地优先隐私倡导者：拒绝云服务、坚持数据完全本地化的用户

常规风险

• 局域网暴露：绑定所有接口意味着需信任本地网络环境，公共 Wi-Fi 场景需谨慎
• 数据残留：卸载 Skill 时 Gun 数据文件可能残留于 ~/.local/share/clawdbot/vinculum/
• 版本兼容性：多实例需保持 Skill 版本一致，否则可能出现同步协议不兼容

---

安全等级：A 级（70 分）—— 标准安全级别，代码结构清晰，本地网络服务用途合理且受控，依赖审计通过，无高危行为模式。