内容
# CruxHive
**您团队 AI 环境的 hive mind — 已批准、版本控制、值得信赖。**
> 您的编码 AI 在每次会话之间都会忘记所有内容。您的团队成员的 AI 也会忘记所有内容。CruxHive 解决了这个问题 — 通过人工审批门户、混合语义搜索和一个随时间累积的知识库。
```bash
npx cruxhive init
```
一个由人工策划的知识库。所有 AI 工具都从中读取 — Claude Code、OpenCode、Cursor、Windsurf、Gemini CLI。本地 SQLite，MIT 许可，零云依赖。
---
## 安装
```bash
# 一条命令 — 安装 MCP 服务器（通过 uv）并连接您的项目
npx cruxhive init
```
或直接安装引擎：
```bash
uv tool install cruxhive-mcp # Python 3.11+
```
连接到任何 MCP 客户端 — 添加到 `.mcp.json`：
```json
{
"mcpServers": {
"cruxhive": { "command": "uvx", "args": ["cruxhive-mcp"], "type": "stdio" }
}
}
```
## 工作原理
AI 工具 **从不直接写入您的知识库**。它们提出建议；由人工审批。
1. 您的 AI 调用 `context_propose` → 条目进入 `.llm/pending/`。
2. 您运行 `cruxhive review` → 审批或拒绝，带有完整的 git 历史记录。
3. 批准的条目被索引并可供每个 AI 工具、每个会话搜索。
solo 开发人员？`cruxhive solo` 自动审批您自己的建议。
## 命令行界面
```
init 在当前项目中引导 CruxHive
index 将 .llm/ markdown 文件索引到本地知识库
propose 提出一个新的知识条目供人工审查
review 交互式地批准或拒绝待处理的建议
sync 从配置的远程同步组织层上下文
health 知识库健康状况总结
stats 使用情况可观察性 — 搜索、命中率、间隙，按 AI 工具
digest 每周 markdown 摘要 — 间隙、衰减条目、队列健康状况
status 单行健康状况摘要（使用 --quiet 表示钩子）
doctor 诊断设置 — 符号链接、钩子、斜杠命令
workspace 跨项目汇总 — 聚合所有项目的 KPI
direnv 编写一个 .envrc，自动记录 Cursor/Windsurf/Gemini 的会话
solo 启用/禁用 solo 模式 — 自动批准您自己的建议
ui 打开审批队列仪表板（localhost:3847）
```
## MCP 工具
| 工具 | 功能 |
|------|--------------|
| `context_search` | 混合搜索（FTS5 BM25 + 可选 sqlite-vec、RRF 融合、实体增强） |
| `context_workspace_search` | 相同，跨所有配置的项目 |
| `context_propose` | 提交一个知识条目供人工审查 |
| `context_review` / `context_approve` / `context_reject` | 审批门户 |
| `context_index` | （重新）索引 `.llm/` markdown 到本地存储 |
| `context_check_faithfulness` | 基于 NLI 的捕获上下文的矛盾检测 |
| `context_radar` | 扫描最近的提交，映射到计划区域，显示未覆盖的工作 |
| `context_next_slice` · `context_write_plan` · `context_sync_memory` | 规划 + 组织层同步 |
## 状态
**已发布。** `cruxhive-mcp` 在 [PyPI](https://pypi.org/project/cruxhive-mcp/) · `@cruxhive/cli` 在 [npm](https://www.npmjs.com/package/@cruxhive/cli)。MIT，0 云依赖。
- [x] 第一阶段 — 内部试用 + MCP 技能层
- [x] 第二阶段 — 多工具支持 + 引导脚本
- [x] 第三阶段 — 开源提取 + 公开发布
- [x] 第四阶段 — 跨项目组织层 + 混合语义搜索
## 为什么
工程工作有 7 个阶段。每个 AI 工具都涵盖第 1-6 阶段。第 7 阶段 — **捕获** — 没有工具支持。那就是价值流失的地方：辛苦获得的上下文在每次会话结束时都会丢失。
CruxHive 是第 7 阶段的基础设施。
## 什么使它与众不同
| | AGENTS.md | Grov | Kiro | CruxHive |
|---|---|---|---|---|
| 人工审批工作流 | ✗ | ✗ | ✗ | ✓ |
| Git 版本控制 + 审计追踪 | 部分 | ✗ | ✗ | ✓ |
| 语义搜索（混合，本地） | ✗ | ✓ （API） | ✗ | ✓ |
| 组织层（跨项目） | ✗ | ✗ | ✗ | ✓ |
| 可信度检测 | ✗ | ✗ | ✗ | ✓ |
| 通过 MCP 实现工具无关 | 部分 | 部分 | 仅限 Kiro | ✓ |
## 链接
- 网站：https://cruxhive.github.io/cruxhive/
- PyPI：https://pypi.org/project/cruxhive-mcp/
- npm： https://www.npmjs.com/package/@cruxhive/cli
## 许可证
MIT
