换个聊天窗口，AI 还是知道你是谁、最近在做什么。
Personal Brain 是一个纯本地的个人记忆库。它把你的长期信息整理成普通 Markdown 文件，由你保管，也由你决定哪些内容可以交给 AI。
不用先学 RAG、向量数据库或 MCP。最简单的版本只需要复制一个文件夹，Obsidian 也不是必需品。
当前版本：v0.1.0-alpha。基础模板已经可以日常使用；本地关键词检索可选，MCP 仍是 Beta。
如果 Codex、Claude Code 或其他 AI 能读取本地文件，把下面这句话复制给它。
请帮我安装 Personal Brain。项目文件夹是「D:\请替换成你的路径\personal-brain」。先阅读项目里的「文档/AI辅助安装.md」，按默认安全方案把基础版装到“我的文档”，不要覆盖已有文件。装好后告诉我知识库路径和下一步。
请从「https://github.com/wuxiiing/personal-brain」安装 Personal Brain。先阅读仓库里的「文档/AI辅助安装.md」，按默认安全方案安装基础版，不要覆盖已有文件。装好后告诉我知识库路径和下一步。
只说“安装 Personal Brain”通常还不够。AI 不会凭项目名知道你指的是哪个仓库；第一次至少要给它本地项目文件夹或准确的 GitHub 地址。
如果 AI 此刻已经在项目文件夹里，可以更懒：
请阅读「文档/AI辅助安装.md」，帮我安装这个项目的基础版。不要覆盖已有文件，完成后带我做第一次建档。
这条路线默认不安装 Python、MCP、Hermes、向量数据库、云服务或遥测。
下载项目并解压后，双击：
工具/一键安装-Windows.cmd
它会把知识库复制到“我的文档”里的 Personal Brain 文件夹。
在项目目录打开终端，运行：
sh "./工具/一键安装.sh"安装脚本只复制 个人知识库模板/。如果目标文件夹已经有内容，它会停下来，不会偷偷合并或覆盖。
你也可以完全不用脚本：手动复制整个 个人知识库模板/ 文件夹，给副本改一个喜欢的名字。
让 AI 打开刚装好的知识库，再把这段话给它：
请先阅读这个知识库的 AGENTS.md，然后带我做第一次建档。最多问我 5 个最重要的问题，一次问一个。把我明确确认的信息整理进“基本档案”“现在”和“长期方向”；不确定的内容放进收件箱。不要编造，也不要替我扩大隐私范围。
没有能读写文件的 AI 也没关系。自己填写下面三页，就已经能开始：
10-关于我/基本档案.md01-现在.md10-关于我/长期方向.md
完整步骤见三分钟上手。
请记住：我现在的主线是……。先检查有没有旧信息冲突；确定的内容写到合适页面，不确定的内容放进收件箱，并告诉我你改了哪里。
请先读取这个知识库的 00-首页.md 和 01-现在.md。只在当前问题需要时继续读取相关链接，不要把收件箱当成已确认事实。
请登记这份我指定的 PDF、DOCX 或 PPTX：「文件路径」。只建立资料卡，写文件名、一句话说明和来源，不复制整份原文。作者的观点不是我的观点。如果值得深入学习，再问我要不要建立学习笔记。
请登记这个重要链接：「https://……」。只保存标题、链接和一句话用途；如果你无法访问页面就明确告诉我，不要猜内容。
请在我的知识库里找“……”，给出命中的页面和判断依据。找不到就直说。
请检查知识库里有没有重复、过时、互相冲突或长期滞留在收件箱的内容。先给我清单，不要直接大改。
AI 只能处理它确实有权限读取的文件。Personal Brain 不会自动扫描你的电脑，也不会自己吸收所有聊天记录。
个人知识库/
├─ 00-首页.md # 从这里开始
├─ 01-现在.md # 最近主线、阻塞和下一步
├─ 10-关于我/ # 稳定个人信息、偏好、长期方向
├─ 20-学习/ # 已经理解、以后能复用的知识
├─ 30-项目/ # 正在推进或已经完成的项目
├─ 40-决策/ # 重要选择和当时的理由
├─ 50-资料/ # 文件、文章、网站的资料卡
├─ 90-收件箱.md # 尚未确认的候选记忆
└─ _系统/ # 使用规则和页面模板
资料卡不是学习笔记。资料卡让你以后找得到原文；学习页才记录你真正理解和认可的内容。
| 模式 | 适合谁 | 需要安装什么 |
|---|---|---|
| 基础版 | 几乎所有新手 | 什么都不用，只有 Markdown 文件 |
| 本地关键词检索 | 页面很多、常忘记放在哪里 | Python 和项目运行时 |
| MCP（Beta） | AI 不能直接读文件，或想用统一工具查询 | Python、项目运行时和客户端配置 |
建议从基础版开始。首页、链接、Obsidian 自带搜索和普通文件搜索，已经足够个人知识库的早期使用。
MCP 不是知识库本体，只是一个受限“接口”；向量数据库也不是 Wiki 的必需品。当前版本没有向量检索，以后只有真实用户确实经常搜不到时，才考虑做成可选插件。
关键词检索说明见三分钟上手，MCP 安装与验证见MCP 配置。
flowchart TD
U["你：确认什么值得记住"] --> H["首页与现在：快速恢复上下文"]
A["AI：读取、整理、提出候选"] --> H
H --> W["Wiki：关于我、学习、项目、决策、资料卡"]
S["Sources：你指定的原始文件或网页"] --> C["资料卡：名称、一句话、来源"]
C --> W
M["Manual：读取、写入和隐私规则"] --> A
A --> I["收件箱：尚未确认的推断"]
I -->|"你确认"| W
W --> Q["可选：关键词检索或 MCP"]
它借鉴 LLM Wiki 的三层思路：原始资料保持不变，整理后的 Wiki 负责日常阅读，Manual 规定 AI 怎么读、怎么写、什么时候必须停下来问你。
想看代码模块、数据流、扩展点、路线图，或做自己的版本，请看架构与技术路线。这部分公开出来，就是为了让开发者可以 fork、修改和继续实验。
聊天里有大量临时想法、误解和过期状态。全部自动写入，最后很容易变成一个什么都有、什么都不可信的垃圾库。
Personal Brain 的做法是：你明确要求记住的内容才进入正式页面；AI 自己推断的内容先到收件箱；原始资料、个人理解和系统规则彼此分开。
项目自身没有云端、账号系统或遥测。你的 Markdown 和本地索引留在电脑上。
但本地保存不代表绝不会传出：如果你把页面发给云端 AI，或允许云端 AI 通过 MCP 读取，相关片段可能会发送给模型提供商。发送范围取决于你使用的客户端和服务条款。
电话、邮箱、证件号、密钥和工作机密等敏感内容应标记为：
privacy: sensitive这类页面默认不进入项目的可选索引，也不通过 MCP 返回。它不是文件加密；电脑本身仍需要密码、磁盘加密和正常的备份保护。详情见隐私与数据流。
不是。Wiki 指按主题整理、彼此链接、可以持续更新的知识页面。向量库只是一种可选检索方式，不是 Wiki 的组成条件。
不必须。Obsidian 的双链、搜索和书签很好用，但所有正式内容都是普通 Markdown，也可以用 VS Code、Typora 或文件管理器打开。
不必须。能直接读本地目录的 AI 可以按首页读取；不能访问文件，或需要受限工具接口时，才考虑 MCP。
不会，也不应该。你先指定文件或目录，AI 才能处理。默认只建立简短资料卡；是否继续写学习笔记由你决定。
- AI 辅助安装：想把安装直接交给 AI
- 三分钟上手：自己建立第一份知识库
- 架构与技术路线：理解、修改和扩展项目
- MCP 配置：安装可选接口并验证
- 隐私与数据流：知道数据会去哪里
- 故障排除：遇到问题先查这里
- 升级说明：保留个人内容并升级框架
- 参与贡献 · 安全政策 · 更新记录
示例/ 全部是虚构演示，不包含作者或任何真实用户的资料。
代码和模板采用 MIT License。你可以个人使用、修改、再分发，也可以基于它开发商业产品；再分发时请保留许可证和版权声明。