🧠 AI 个人知识库

August 15, 2026 · View on GitHub

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

license ai obsidian

💡 设计理念

核心思想:知识库是"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。