AI 知识库模板 fan969690/ai-knowledge-base

🧠 AI 个人知识库 · 开源模板

让 AI 帮你维护一个越用越聪明的个人知识库。
一套可开箱即用的知识库结构 + AI 接入规则 + 维护机制，来自真实运行的个人案例。

💡 设计理念

核心思想：知识库是「AI 能读、能写、能自己维护的结构化大脑」

三个关键设计决策：

1. 结构可导航 —— 索引是地图
- 总索引 00-索引.md 列出所有文档，AI 和人都能定位
- 树形分层：记忆 / 知识 / 配置 / 归档，职责清晰不混放

2. AI 可读写 —— 规则即契约
- 根目录 AGENTS.md / 00-使用说明.md：告诉 AI「往哪放、怎么更新」
- 支持 AGENTS.md 的工具（DeepSeek Harness / Claude Code / Cursor）自动加载，零配置接入
- 密码/API Key 不入库（单独保密文件），避免泄露

3. 长期可维护 —— 机制防腐烂
- 记忆蒸馏：处理记录（原始层）→ 01-记忆（蒸馏层），长期事实自动升级
- 技能沉淀：重复做的事写成 SOP，按触发场景取用
- 索引收尾校验：每次任务收尾核对索引同步
- git 版本化：每天自动提交，误删可回溯
- 定期体检：断链/未登记/孤儿文件一键检查

一句话：知识库存「内容」，AI 记忆管「规矩」；两者配合，知识库才活起来。

🚀 快速开始（30 分钟跑起来）

方式一：一键初始化（推荐）

Linux/macOS
git clone https://github.com/fan969690/ai-knowledge-base.git
cd ai-knowledge-base
bash scripts/init.sh # 生成"我的知识库/"

Windows PowerShell
git clone https://github.com/fan969690/ai-knowledge-base.git
cd ai-knowledge-base
.\scripts\init.ps1 # 生成"我的知识库\"

方式二：手动复制

直接把 template/ 目录复制为你的知识库根目录。

接入你的 AI

1. 用 Obsidian 打开生成的知识库目录（设为 vault）
2. 编辑 01-记忆/ 5 个文件，填入你的真实信息（画像/习惯/偏好/项目/网络）
3. 把根目录 AGENTS.md 放到知识库根（或你的 AI 工具的用户级配置）
4. 对你的 AI 说：「这是你的知识库，先读使用说明，以后新知识都按规则存进来」
5. 开始使用！它会自动维护索引、蒸馏记忆、沉淀技能

📁 目录结构

ai-knowledge-base/
├── template/ # 知识库模板(复制即用) │ ├── 00-使用说明.md # AI 规则全文 │ ├── 00-索引.md # 总导航 │ ├── 00-首页.md │ ├── 01-记忆/ # 关于你的事实(画像/习惯/偏好/项目/网络) │ ├── 02-知识/ # 真正的知识(含技能库) │ ├── 03-配置/ # 环境快照 │ └── 04-归档/ ├── AGENTS.md # AI 接入规则(放知识库根/用户级配置) ├── scripts/ │ ├── init.sh / init.ps1 # 一键初始化(跨平台) │ └── 知识库体检.sh # 断链/未登记/孤儿检查 └── docs/ # 设计理念与借鉴说明

🔗 借鉴与致谢

本项目提炼自真实运行案例，设计理念借鉴了以下项目与体系：

| 项目/体系 | 借鉴点 |
| deepseek-ai/deepseek-harness | 「一切皆插件」架构；AGENTS.md 自动注入；工具/技能机制 |
| TencentDB-Agent-Memory | 记忆分层（原始层/蒸馏层）；记忆同步机制 |
| planning-with-files | 长任务进度写盘/断线恢复 |
| Claude Code / Cursor 实践 | AGENTS.md / CLAUDE.md 规则文件约定 |
| Obsidian 双链笔记体系 | [[双链]] 结构、vault 概念 |

设计来源：本人家庭服务器上实际运行的个人知识库（含 git 版本化、每日自动提交、技能库、体检机制），持续维护中。

📝 使用建议

- 别一上来建一堆分类 —— 先用 01-记忆 + 2~3 个知识主题，用起来再加
- 工具不是重点 —— Obsidian + 任意能读写文件的 AI 即可，结构才是核心
- 定期体检 —— 每月跑一次 知识库体检.sh
- 敏感信息 —— 密码/Key 单独放本机保密文件，文档只写引用

📄 许可

MIT License。可自由使用、修改、分发（保留版权声明）。

⭐ 支持

如果这个项目对你有帮助，欢迎 Star ⭐ 或提出 Issue。