内容
# 人工智能代理维基
> 一个本地、私有的 **"第二大脑" 您的AI代理可以实际读取** — 语义搜索 + [MCP](https://modelcontextprotocol.io) 在您自己的Markdown笔记上。
**状态：早期开发中** — 正在从一个可用的私有系统中提取和概括。参见 [ROADMAP.md](ROADMAP.md)。
---
## 它是什么
人工智能代理维基将 *您自己的笔记*（纯Markdown）转化为一个可共享、可搜索的知识库，任何 **MCP兼容的AI代理** 都可以连接到它。所有操作都在 **您的本地机器上运行** — 您的知识永远不会离开您的计算机。
## 为什么
- 🧠 **大型语言模型不知道您的上下文。** 人工智能代理维基为它们提供了对您实际编写和思考的内容（RAG）的检索，因此答案基于您的知识 — 而不是通用的网络内容，并且幻觉现象大大减少。
- 🔒 **本地和私有。** 在您自己的机器上使用PostgreSQL + [pgvector](https://github.com/pgvector/pgvector)。无需上传到云端。
- 🌍 **多语言。** 使用 [BGE-M3](https://huggingface.co/BAAI/bge-m3) 嵌入 — 优秀地支持中文和100多种语言，而不仅仅是英语。
- 🔌 **代理原生。** 暴露一个MCP服务器，因此Claude和其他MCP客户端可以零代码连接。多个代理共享一个大脑。
## 安装
一行命令：
```bash
curl -fsSL https://raw.githubusercontent.com/petrludwig-collab/HumanAgentWiki/main/install.sh | bash
```
或克隆并运行安装程序：
```bash
git clone https://github.com/petrludwig-collab/HumanAgentWiki.git
cd HumanAgentWiki && ./install.sh
```
它检查先决条件，创建虚拟环境，安装依赖项，启动PostgreSQL（如果可用，则使用Docker，否则使用本地实例），写入 `.env`，并创建模式。然后使用 `./haw` 启动器：
```bash
./haw index # 为您的笔记建立索引（./notes下的Markdown）
./haw web # 在 http://127.0.0.1:8808 访问网页界面
./haw serve # 为您的代理提供MCP服务器
```
> 使用捆绑的演示立即试用：`NOTES_DIR=./sample_notes ./haw index && ./haw web`
## 工作原理（纯中文）
1. 您的笔记是 **Markdown文件**，通过 `[[链接]]` 链接，如同维基一样。
2. 它们被分割并 **嵌入** — 每个想法都获得一个“含义指纹”，存储在pgvector中。
3. 搜索通过 **含义而非关键词** 找到内容 — 搜索 *"如何避免因AI而变得愚蠢"*，它会找到您的关于 *"认知懒惰"* 的笔记，即使没有这些确切的词语。
4. **增量索引** — 只有更改的文件会重新嵌入（几秒钟，而不是几分钟）。
5. 一个 **MCP服务器**（`brain_search` / `brain_get` / `brain_neighbors`）允许您的代理实时查询它。
## 分类 - 无需配置文件
您在应用中直接定义顶级 **类别**（使用 +/- 添加/删除） — 例如 *书籍、播客、采访、笔记* — 并开始将内容保存到它们。无需YAML，无需编辑配置文件。在第一次运行 时，您会获得 **示例笔记 + 内置指南**，以便您立即看到它的工作原理。
## 快速入门
```bash
# 1. 启动PostgreSQL + pgvector
docker compose up -d
# 2. 安装依赖项（建议使用虚拟环境）
pip install -r requirements.txt
# 3. 配置（复制并编辑，如果需要）
cp .env.example .env && set -a && . ./.env && set +a
# 4. 创建模式
python cli.py init-db
# 5. 为您的笔记建立索引（将Markdown放入./notes — 文件夹是类别；
# 或尝试捆绑的演示：）
NOTES_DIR=./sample_notes python cli.py index
# 6. 从终端搜索…
NOTES_DIR=./sample_notes python cli.py search "小习惯如何复合"
# 7. …或为您的代理运行MCP服务器
python cli.py serve
# 8. …或打开网页界面（管理类别，编写/链接笔记，搜索）
python cli.py web # 然后打开 http://127.0.0.1:8808
```
然后，将任何MCP客户端指向 `http://127.0.0.1:8802/mcp`。对于Claude Code：
```bash
claude mcp add --transport http humanagentwiki http://127.0.0.1:8802/mcp
```
暴露的工具：`brain_search`，`brain_get`，`brain_neighbors`。
## 网页界面
`python cli.py web` 打开一个类似维基的界面（无需构建步骤，纯JS）：
- **3D图形** — 您的笔记作为交互式3D图形（旋转/缩放/平移），节点按类别着色，边来自 `[[链接]]`。点击节点以打开它。这是核心功能。
- **类别** — 使用 +/- 在左侧面板中添加/删除顶级类别。
- **笔记编辑器** — 在右侧滑动：选择类别，编写内容，并使用 `[[...]]` 链接其他笔记（自动完成）。保存会写入Markdown文件，**提交到git**（完整历史），并重新索引。
- **搜索** — 跨所有内容的语义搜索。
## 开发
```bash
pip install -r requirements-dev.txt
pytest # 纯辅助函数的单元测试（无需数据库）
```
## 路线图
参见 [ROADMAP.md](ROADMAP.md)。
## 许可证
[MIT](LICENSE)
