{% comment %} KnowledgeVault Starter — 推广 README {% endcomment %}

KnowledgeVault Starter

一套开箱即用的 AI 驱动个人知识管理系统
基于 WorkBuddy + Obsidian + ima + Get笔记 + MpClipper
由屈臣氏内部审计经理 moss 实践验证

---

这是什么？

一套完整的个人知识管理 + AI 自动化系统，帮你：

• 📥 自动摄入：微信文章、小红书/抖音/B站视频、网页 → 自动存入 Obsidian
• 🤖 AI 自动编译：原始内容 → 结构化摘要（5 层深度）+ 概念卡片
• 🔗 自动建立知识关联：双向 [[wikilink]]，知识网络自动生长
• 📊 每日知识快报：每天早上 8 点推送昨日新知识摘要
• 🔍 语义搜索：本地 Ollama 向量化，隐私安全

---

架构图

知识摄入 ─┬─ ima（微信收藏）→ WorkBuddy 自动化
          ├─ MpClipper（小红书/网页）→ Obsidian 插件
          ├─ Get笔记（抖音/B站视频）→ Python 脚本 + launchd
          └─ 手动剪藏 → Obsidian Web Clipper

         ↓ 每天 22:30

AI 编译（WorkBuddy /compile）
  ├─ 格式归一化（MpClipper / Get笔记 → SCHEMA 标准）
  ├─ L1-L5 结构化摘要生成
  ├─ 概念卡片提取 + 双向链接
  └─ 索引自动更新

         ↓

知识输出 ─┬─ Obsidian（浏览 / 搜索 / 双向链接）
          ├─ 每日知识快报（8:00 推送）
          └─ 语义搜索（Smart Connections + 本地 Ollama）

---

快速开始

前置要求

工具	用途	必选
Obsidian	知识库前端	✅ 必选
WorkBuddy	AI 自动化调度	✅ 必选
ima	微信文章收藏入口	⭕ 推荐
Get笔记 App	抖音/B站视频摘要	⭕ 可选
Python 3.8+	Get笔记同步脚本	⭕ 可选
Ollama	本地语义搜索向量化	⭕ 可选

安装步骤

1. 克隆本仓库

git clone https://github.com/<你的用户名>/KnowledgeVault-Starter.git
cd KnowledgeVault-Starter

2. 填写配置

cp config.ini.example config.ini
# 编辑 config.ini，填写你的 Vault 路径

3. 运行安装脚本

bash install.sh

4. 打开 Obsidian

• 「打开其他仓库」→「打开文件夹为仓库」
• 选择你的 Vault 路径

5. 安装 Obsidian 插件 在 Obsidian 设置 → 第三方插件 → 浏览，安装：

• ✅ Templater
• ✅ Dataview
• ✅ QuickAdd
• ⭕ Obsidian Git（自动备份）
• ⭕ Smart Connections（语义搜索）
• ⭕ MpClipper Sync（手机剪藏）

6. 配置 WorkBuddy 自动化 在 WorkBuddy 中创建 4 个定时任务（提示词见 automations/ 目录）：

任务名	时间	提示词文件
ima → Obsidian 同步	每天 21:00	automations/ima-sync-prompt.md
知识编译 /compile	每天 22:30	automations/compile-prompt.md
健康检查 /lint	每周日 20:00	automations/lint-prompt.md
每日知识摘要	每天 08:00	automations/digest-prompt.md

---

使用教程

完整使用教程见 docs/usage-guide.md

日常使用场景

场景 1：微信看到好文章

1. 分享到 ima
2. 每晚 21:00 自动同步到 Vault
3. 22:30 自动生成摘要 + 概念卡片
4. 次日 08:00 收到知识快报

场景 2：刷到好的抖音/B站视频

1. 在 Get笔记 App 中收藏视频
2. 每晚 22:00 自动同步到 Vault
3. 22:30 自动编译

场景 3：手动记录想法

1. 在 Obsidian 中新建笔记到 思考/ 目录
2. 使用模板（Ctrl/Cmd + T）
3. AI 会自动索引（如果打了标签）

---

目录结构

KnowledgeVault-Starter/
├── vault-template/          # Obsidian Vault 模板
│   ├── SCHEMA.md          # 知识库宪法（必读！）
│   ├── CLUADE.md          # AI 协作规范
│   ├── 原始资料/           # 原始内容（只进不改）
│   ├── 知识库/             # AI 编译产物
│   │   ├── 摘要/
│   │   └── 概念/
│   ├── 输出/               # 运行时产物
│   ├── 思考/               # 个人思考
│   └── 模板/               # 笔记模板
├── scripts/                # 辅助脚本
│   ├── replace-placeholder.py  # 路径占位符替换
│   └── copy-template.py       # 模板复制（中文路径兼容）
├── automations/            # WorkBuddy 自动化提示词模板
│   ├── ima-sync-prompt.md
│   ├── compile-prompt.md
│   ├── lint-prompt.md
│   └── digest-prompt.md
├── docs/                   # 文档
│   └── usage-guide.md
├── config.ini.example      # 配置模板
├── install.sh              # 一键安装脚本
└── README.md              # 本文件

---

SCHEMA 规范（核心）

SCHEMA.md 是整个知识库的宪法，定义了：

• 📁 目录职责：哪些目录人写、哪些 AI 写、哪些只读
• 🏷️ Frontmatter 规范：所有笔记必须包含的 YAML 元数据
• 🧅 五层笔记结构：L1 元信息 → L2 核心观点 → L3 深层结构 → L4 行动启示 → L5 引用出口
• 🏷️ 标签治理：三级标签体系（领域/类型/状态）
• 📋 命名约定：文件命名规则
• 🔄 摄入通道：ima / MpClipper / Get笔记 / Web Clipper 的格式归一化规则

新人必读：先读 vault-template/SCHEMA.md 再开始使用！

---

常见问题

Q: 我不用 ima / Get笔记，可以用吗？

可以。 只用 MpClipper（手机剪藏）或手动写入 原始资料/ 也完全 OK。

Q: 不用 WorkBuddy 可以用吗？

可以，但需手动触发编译。
WorkBuddy 负责定时自动运行，不用就自己手动跑 /compile 就行。

Q: 我的 Vault 路径和你的不一样怎么办？

安装脚本会自动替换 {{VAULT_PATH}} 占位符，填好 config.ini 即可。

Q: Get笔记 token 多久过期？

约 90 天。过期后 run-sync.sh 会自动弹出 macOS 通知提醒你重新扫码。

Q: 会泄露隐私吗？

• 所有数据存在本地 Vault
• 语义搜索用本地 Ollama，不联网
• ima/Get笔记 只在摄入时联网，内容不对外分享

---

定制指南

修改编译提示词

编辑 automations/compile-prompt.md，调整 L1-L5 的输出格式。

修改标签体系

编辑 vault-template/SCHEMA.md 第四章，添加你的领域标签。

添加新的摄入通道

1. 在 SCHEMA.md 第八章添加新的通道说明
2. 在 /compile 提示词中添加对应的格式归一化规则
3. 更新本 README 的架构图

---

致谢

• Karpathy — 四阶段知识工作流（Ingest → Compile → Query → Maintain）
• Obsidian — 优秀的本地知识库工具
• WorkBuddy — AI 自动化调度引擎
• Get笔记 — 视频内容自动摘要
• Ollama + nomic-embed-text — 本地语义向量化

---

License

MIT License

---

💡 建议：Fork 本项目，改成你自己的知识管理工作流！ 欢迎 PR 和 Issue ✨