deepbrain

<div align="center">

# 🧠 DeepBrain

**你的个人 AI 知识大脑 | Your Personal AI Knowledge Brain**

存储、搜索、关联、生长你的全部知识 —— 本地优先，AI 驱动。

[![npm version](https://img.shields.io/npm/v/deepbrain?color=blue)](https://www.npmjs.com/package/deepbrain)
[![License](https://img.shields.io/badge/license-Apache--2.0-green)](LICENSE)
[![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue)](https://typescriptlang.org)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)

[中文文档](README.zh-CN.md) | [快速开始](#-快速开始) · [功能特性](#-功能特性) · [导入数据](#-导入一切) · [CLI 命令](#-cli-命令参考) · [MCP 集成](#-mcp-server) · [竞品对比](#-竞品对比)

</div>

---

## 为什么需要 DeepBrain？

你的知识散落在各处——Notion、Obsidian、Evernote、Flomo、飞书、语雀、微信、PDF……

当你想找某个东西时，你得先想起来**放在哪了**。

**DeepBrain** 把所有知识汇集到一个本地大脑，用 AI 理解语义，让你用自然语言搜索**全部知识**。

- 🔍 **语义搜索** — 不用记关键词，用你的话问就行
- 🧩 **知识图谱** — 自动发现知识之间的关联
- 📇 **闪卡复习** — SM-2 间隔重复算法，把知识刻进记忆
- 📥 **导入一切** — 24 个平台一键导入，8 个中文平台原生支持
- 🏠 **本地优先** — 数据 100% 在你手里，无需云服务
- 🤖 **MCP 集成** — 让 DeepSeek、DeepSeek 等 AI 助手直接读取你的知识

---

## ⚡ 快速开始

```bash
# 安装
npm install -g deepbrain

# 初始化（选你喜欢的 AI 提供商）
deepbrain init deepseek          # Google DeepSeek（推荐，有免费额度）
deepbrain init deepseek        # DeepSeek
deepbrain init dashscope       # 阿里通义千问
deepbrain init ollama          # 本地 Ollama（零费用）

# 写入知识
deepbrain put 会议记录 notes.md          # 自动摘要 + 自动打标签
echo "React 19 引入了编译器" | deepbrain put react-19

# 语义搜索
deepbrain query "产品路线图讨论了什么？"

# 与大脑对话（RAG）
deepbrain chat "总结一下本周的关键决策"
```

就这么简单。大脑使用 PGLite + pgvector 在本地运行，无需外部数据库。

---

## 🚀 功能特性

### 核心能力

| 功能 | 说明 |
|------|------|
| **混合搜索** | 语义（向量）+ 关键词搜索，自动排序融合 |
| **自动摘要** | 每个页面由 LLM 自动生成摘要和标签 |
| **知识图谱** | 自动提取实体和关系，查询知识关联 |
| **梦境循环** | 后台自动维护：刷新过期内容、修复断链 |
| **记忆分层** | 核心 → 工作 → 归档，自动升降级 |
| **闪卡复习** | SM-2 间隔重复算法，从知识库自动生成 |
| **多大脑** | 工作、个人、研究分开管理，或合并查询 |
| **模板系统** | 预设大脑结构：研究、CRM、日记、PKM |

### 导入一切

| 数据源 | 命令 |
|--------|------|
|