内容
# HiveMind
**人工智能代理的对等共享内存**。当一个代理学习到某些东西时，所有其他机器上的所有其他代理也可以使用它。本地优先，无云，无中心服务器。
[](LICENSE)
官网： **[hivemind.projectmentor.org](https://hivemind.projectmentor.org)** ·
文档： [`docs/`](docs/) · 开发者： [hivemind.projectmentor.org/dev](https://hivemind.projectmentor.org/dev/)
HiveMind 是一个共享的、仅追加的内存，供 AI 代理读写。事实、决策和结果随着时间的推移而积累，并通过 **独立验证** 获得信任，而不是由某个代理断言。每个机器都持有完整的内存，并通过私有 Tailscale 网络直接与其对等节点同步。无需操作服务器，无需数据离开您的硬件。
它不是一个向量数据库或 RAG 框架。它是您的代理共享的内存和信任层，以便它们可以协同工作，而不是每个代理都从空白开始。这就是它与 Pinecone、Weaviate、LlamaIndex、LangGraph 等不同的地方。
---
## 您将获得
- **自动同步** — 当一个代理学习到某些东西时，所有其他机器上的所有其他代理都会通过 Tailscale 获取，仅传输差异（Merkle delta）。
- **信任通过验证获得** — 对某个事实的信心仅在 *不同的、独立的* 代理同意时增加。单个代理无法提高其自身的信誉，一台机器上的代理的权重小于多台机器上的代理，只有您允许的设备才计入权重，因此无法通过创建大量密钥来伪造同意。冲突会被暴露，而不是被静默覆盖。
- **无需协调员的协调** — 无领导者，无 Raft，无锁服务器。基于追加日志的无冲突集合（G-Set CRDT），因此每个设备都是平等的并且可以收敛。
- **离线工作** — 代理在无连接的情况下继续工作；重新连接时，条目会干净地合并。
- **快速本地搜索** — 全文搜索在您的机器上运行，毫秒级完成，按验证结果排序。无需往返，无数据离开您的网络。
- **无需运维** — 无需配置服务器，无需管理数据库，无需云账户。任何单个设备的日志都是完整的内存；备份只是文件。
- **可审计** — 每个事实都记录了谁写入了它以及何时写入；不会静默覆盖任何内容。
- **与您的代理一起工作** — Claude Code、Hermes、Claude Desktop（通过 MCP）以及任何可以运行 shell 命令的代理。
---
## 安装
在 Linux（或 Windows 11 上的 WSL 终端）上运行：
```bash
curl -fsSL https://raw.githubusercontent.com/projectmentor/hive-mind/main/scripts/installer/install.sh | bash
hive-mind install
```
安装程序将：
1. 安装 Tailscale（用于机器之间的同步）并对其进行身份验证
2. 安装 Python 依赖项
3. 将此存储库克隆到 `~/projects/hive-mind`
4. 请求一个输入：您的对等节点的 Tailscale IP。如果 **第一个机器还没有对等节点？只需按 Enter** — 您可以在以后通过编辑 `.peers.json` 添加对等节点。
5. 初始化本地数据库
6. 安装并启动同步守护进程作为 systemd 服务
7. 连接 Hermes 内存插件（如果已安装 Hermes）
### 要求
- **Linux**（原生）或 **带有 WSL2 的 Windows 11**，并启用 systemd（Mac 和 Android 支持正在进行中）
- **互联网访问**（用于安装和 git 克隆）
- **Tailscale** *仅在您希望多个机器同步时需要。* 安装程序为您设置（在 Windows 上的 WSL 中；**在 Windows 主机上不需要**）。单机设置根本不需要 Tailscale — 没有对等节点可达。
<details>
<summary>在 WSL 中启用 systemd（如果它尚未启用）</summary>
```bash
sudo bash -c 'echo -e "[boot]\nsystemd=true" >> /etc/wsl.conf'
# 然后，从 Windows 终端：
wsl --shutdown
# 重新打开 WSL 并继续
```
</details>
---
## 用法
```bash
./hv remember "支付 API 每秒限制 100 个请求" --tags api,payments
./hv search "payments"
./hv decide "使用 AGPL 作为核心" --rationale "保留双重许可选项"
./hv stats
./hv doctor # 健康检查：完整性、DB、同步、卫生
./hv sync now # 手动同步到所有对等节点
```
大多数时候，您的代理会为您调用 `hv`。完整参考： [`docs/CLI_REFERENCE.md`](docs/CLI_REFERENCE.md)。
### `hive-mind` 命令
| 命令 | 描述 |
|---|---|
| `hive-mind install` | 从头开始完整设置设备 |
| `hive-mind status` | 显示设备健康状况和对等节点同步状态 |
| `hive-mind uninstall` | 从此设备删除 HiveMind（ `--keep-hive` 保留您的日志 + 密钥； `--yes` 跳过确认提示） |
| `hive-mind update` | 拉取最新版本并重启守护进程 |
---
## 工作原理
- **日志** (`journal/YYYY-MM-DD.jsonl`) — 仅追加的事件日志。 **这是事实的来源。** 每个条目都带有设备 ID、节点序列、类型、有效载荷、哈希链和签名。节点通过 Ed25519 **设备密钥**（不是主机名）进行标识，条目在同步时签名和验证，因此对等节点无法伪造另一个节点的身份来提高置信度。
- **SQLite** (`store.db`) — 从日志中重建的派生索引（WAL + FTS5）。
- **Merkle 索引** — 节点高效增量同步的哈希值：只有缺失的条目会移动。
- **同步守护进程** — 一个在 `:9876` 上的标准库 HTTP 服务器，与对等节点同步（每 5 分钟或按需）。无领导者，无中心代理。
- **置信模型** — 某个事实的置信度源自 **独立验证**，而非由写入它的代理声明。它是一个受控的投影：不同 **设备** 之间的同意权重最高，同一设备上的多个代理权重较低，只有所有者 **允许的设备** 才会计入权重，同一主体下的多个机器之间的同意权重有限。治理（所有者、允许的设备、可调参数）存在于所有者签名的日志条目中，因此每个设备都会计算相同的置信度。所有者使用 `hv group` 运行成员生命周期（允许、撤销、拒绝、更改、清除、列出）。所有者密钥可恢复，不是一条死胡同：备份离线或在 hive 中托管（`hv owner export`/`escrow`），并通过提名或转让将密钥移交给新密钥（`hv owner nominate`/`claim`/`transfer`）。如果所有者完全丢失且没有备份，允许的设备可以在所有者断开连接后通过法定人数选举继任者（`hv config quorum set`，然后 `hv owner propose-election`/`vote`）；活动所有者永远不会被取代，因为任何所有者操作（包括 `hv owner heartbeat`）都会重置死亡计时器。参见 `hv owner` 和 `docs/INTERNALS.md`。
深入阅读： [`docs/P2P_DESIGN.md`](docs/P2P_DESIGN.md)、 [`docs/SYNC_API.md`](docs/SYNC_API.md)、 [`docs/INTERNALS.md`](docs/INTERNALS.md)。
**集成代理？** 参见 [`docs/AGENT_INTEGRATION.md`](docs/AGENT_INTEGRATION.md) — 每个代理都使用的运行时无关规范，用于将 *自身* 连接到 hive（并保持自身更新）。一个大脑（`hv`），一个规范，无需手动维护每个代理的适配器。
---
## 与您的代理一起工作
- **Claude Code** — 一个技能（`integrations/claude-code/`）允许 Claude Code 直接读写 hive。
- **Hermes** — 如果已安装 [Hermes Agent](https://hermes-agent.nousresearch.com)，安装程序会连接内存插件，以便每个 `memory()` 调用都镜像到 hive 并同步。手动设置：`hermes config set memory.provider hive-mind`。
- **Claude Desktop (MCP)** — 本地 stdio MCP 服务器（`integrations/mcp/`）将 hive 暴露给 Claude Desktop，因此它可以读写您的共享内存而无需复制粘贴。
- **任何 CLI 代理** — 如果它可以运行 shell 命令，它就可以使用 `hv`。
---
## 多节点同步
在每台机器上运行安装程序。当提示输入对等节点 IP 时，输入 **其他机器的 WSL Tailscale IP**（在该机器的 WSL 上运行 `tailscale ip -4`）。每个 WSL 实例都是尾网上的独立机器，因此使用该 IP 而不是 Windows 主机 IP。
```bash
cd ~/projects/hive-mind
./hv sync now # 从所有对等节点拉取
./hv stats # 确认日志收敛
```
---
## 路线图
- **联合 hive（一个群落）** — 单独的 hive（个人、团队、项目）有选择地共享重要的内容，以便群组汇集知识而不合并到一个池中。多个 hive 形成一个群落。
- **更多平台** — Mac 和 Android。
- **托管中继** — 为无法直接相互连接的节点提供可选的托管层。
---
## 贡献
源代码开放，可供阅读、审计、分支和自托管。贡献在尽力而为的基础上欢迎，单人维护。贡献代码需要一次性 [CLA](CLA.md)，在您的拉取请求上自动完成。
有问题或想法？开始一个 [讨论](https://github.com/projectmentor/hive-mind/discussions)。
## 许可证
HiveMind 在 **GNU Affero General Public License v3.0** 下许可（参见 [LICENSE](LICENSE)）。您可以免费使用、修改和自托管；如果您作为网络服务运行修改后的版本，则必须在相同条款下提供源代码。版权持有人（Certified Project Management, LLC，d/b/a ProjectMentor）还保留提供单独商业许可的权利。
## 支持项目
HiveMind 免费且开源。如果它对您有帮助，您可以帮助它继续存在：
- ❤️ [GitHub 赞助](https://github.com/sponsors/projectmentor)
- ☕ [Ko-fi](https://ko-fi.com/projectmentor)
- 🥤 [Buy Me a Coffee](https://www.buymeacoffee.com/projectmentor)
## 项目
由 [ProjectMentor](https://projectmentor.org) 构建。HiveMind 由 ProjectMentor 构建，是 Certified Project Management, LLC 的一个项目。需要多代理系统的定制开发或咨询？请联系 [hello@projectmentor.org](mailto:hello@projectmentor.org)。
MCP 市场