个人知识库系统搭建：从工具选型到 AI 辅助的完整实践

{
  "alwaysUpdateLinks": true,
  "newLinkFormat": "relative",
  "useMarkdownLinks": true,
  "showLineNumber": true,
  "spellcheck": true
}

核心插件:
  - Dataview: 数据库查询
  - Templater: 模板引擎
  - QuickAdd: 快速捕获
  - Calendar: 日记视图
  - Tag Wrangler: 标签管理

进阶插件:
  - Obsidian Git: 自动备份
  - Smart Connections: AI 关联
  - Excalidraw: 手绘图表

;; 查找所有包含 #重要 标签的 TODO 任务
{{query (and (todo now later) (tag 重要))}}

┌─────────────────────────────────────────────────┐
│  重视数据主权 + 高度自定义？                      │
│  → Obsidian（首选）或 Logseq                     │
├─────────────────────────────────────────────────┤
│  需要团队协作 + 项目管理？                        │
│  → Notion                                        │
├─────────────────────────────────────────────────┤
│  视觉学习者 + 研究导向？                          │
│  → Heptabase                                     │
├─────────────────────────────────────────────────┤
│  每日笔记实践者 + 预算充足？                      │
│  → Roam Research                                 │
└─────────────────────────────────────────────────┘

┌──────────────────────────────────────────────┐
│  1. 闪念笔记 (Fleeting Notes)                │
│     - 临时想法，快速记录                      │
│     - 需要后续处理                            │
│     - 示例："也许可以用 AI 自动标签"          │
├──────────────────────────────────────────────┤
│  2. 文献笔记 (Literature Notes)              │
│     - 阅读后的摘要和理解                      │
│     - 用自己的话复述                          │
│     - 示例：《思考，快与慢》读书笔记          │
├──────────────────────────────────────────────┤
│  3. 永久笔记 (Permanent Notes)               │
│     - 经过思考的完整想法                      │
│     - 可独立存在                              │
│     - 示例：认知偏差对决策的影响              │
├──────────────────────────────────────────────┤
│  4. 索引笔记 (Index Notes)                   │
│     - 主题索引，连接相关笔记                  │
│     - 示例：认知心理学主题索引                │
└──────────────────────────────────────────────┘

# 2026-03-12 10:30 闪念

AI 可以自动分析笔记内容，生成标签和关联。
需要验证：准确率如何？误报怎么处理？

#闪念 #AI #知识管理

# 《如何阅读一本书》笔记

**作者**: Mortimer J. Adler
**阅读时间**: 2026-03-10
**核心观点**:
- 阅读是主动活动，不是被动接收
- 四个层次：基础、检视、分析、主题

**我的理解**:
大多数人的阅读停留在第一层，而知识工作者需要达到第三层（分析阅读）。

#文献 #阅读方法 #学习

# 主动阅读的三个问题

阅读任何内容时，问自己：

1. 整体在谈什么？（主题）
2. 细节是什么？如何论证？（论点）
3. 说得有道理吗？对我有何用？（评估）

**应用场景**:
- 技术文档阅读
- 学术论文筛选
- 书籍深度阅读

**相关**:
- [[阅读方法论]]
- [[知识吸收效率]]
- [[批判性思维]]

#永久 #阅读 #学习方法

---
created: {{date}} {{time}}
tags: [闪念]
---

# {{title}}

{{cursor}}

---
## 相关链接
- 

## 后续行动
- [ ] 处理为永久笔记

PARA/
├── 1-Projects（项目）
│   ├── 知识库系统搭建
│   ├── 技术博客写作
│   └── AI Agent 开发
├── 2-Areas（领域）
│   ├── 技术能力
│   ├── 写作能力
│   └── 健康管理
├── 3-Resources（资源）
│   ├── 笔记模板
│   ├── 代码片段
│   └── 书单
└── 4-Archives（归档）
    ├── 已完成项目
    └── 历史资料

mkdir -p PARA/{1-Projects,2-Areas,3-Resources,4-Archives}
cd PARA/1-Projects
mkdir "知识库系统搭建" "技术博客写作"
cd ../2-Areas
mkdir "技术能力" "写作能力" "知识管理"
cd ../3-Resources
mkdir "模板" "代码片段" "书单" "文章摘要"

---
project: {{title}}
status: active
start_date: {{date}}
deadline: 
tags: [项目]
---

# {{title}}

## 目标
- [ ] 

## 关键结果
- [ ] 

## 相关笔记
- 

## 进度记录
- {{date}}: 启动项目

---
## 会议记录
## 决策记录
## 参考资料

# 2026-03-12 周回顾

## 完成的项目
- [x] 知识库系统调研

## 进行中的项目
- [ ] 知识库系统搭建（进度 60%）

## 需要归档的内容
- 旧项目"博客平台 v1" → 移至 Archives

## 下周计划
- [ ] 完成 AI 辅助配置
- [ ] 写第一篇博客

┌─────────────────────────────────────────────────┐
│  PARA 提供宏观结构（行动导向）                    │
│  ↓                                              │
│  在 Resources 中存储 Zettelkasten 笔记            │
│  ↓                                              │
│  Projects 引用相关永久笔记                       │
│  ↓                                              │
│  项目完成后，笔记保留在 Resources 持续复用         │
└─────────────────────────────────────────────────┘

Vault/
├── 0-Inbox/           # 临时收集（每日清空）
├── 1-Projects/        # PARA Projects
│   ├── 知识库系统搭建/
│   └── 技术博客写作/
├── 2-Areas/           # PARA Areas
│   ├── 技术能力/
│   └── 写作能力/
├── 3-Resources/       # PARA Resources + Zettelkasten
│   ├── 永久笔记/
│   ├── 文献笔记/
│   └── 模板/
├── 4-Archives/        # PARA Archives
├── 5-Daily/           # 每日笔记
└── 9-Templates/       # 模板库

mkdir -p ~/knowledge-base
cd ~/knowledge-base
git init

模板文件夹：9-Templates
日记模板：9-Templates/日记模板.md

快速捕获：Ctrl+Shift+Q
创建日记：Ctrl+Shift+D
搜索笔记：Ctrl+Shift+F
打开图谱：Ctrl+Shift+G

---
date: {{date}}
day: {{weekday}}
tags: [日记]
---

# {{date}} 日记

## 今日重点
1. 

## 工作记录
### 完成
- 

### 进行中
- 

## 学习笔记
- 

## 闪念记录
- 

## 明日计划
- [ ] 

---
## 情绪记录
能量水平：⭐⭐⭐⭐
心情：平静

## 感恩事项
1. 

---
title: {{title}}
type: literature
source: 
author: 
date: {{date}}
tags: [文献]
---

# {{title}}

## 来源
- 链接：
- 作者：
- 日期：

## 核心观点
1. 

## 关键引用
> 

## 我的理解


## 关联笔记
- [[ ]]

---
## 行动项
- [ ] 

---
title: {{title}}
type: permanent
created: {{date}}
updated: 
tags: []
---

# {{title}}

## 核心概念


## 详细说明


## 应用场景


## 相关笔记
- [[ ]]
- [[ ]]

---
## 历史版本
- {{date}}: 创建

TABLE date, file.link as 笔记
FROM "3-Resources/文献笔记" 
WHERE date >= date(this.file.day) - dur(7 days)
SORT date DESC

TASK FROM "1-Projects" 
WHERE !completed
GROUP BY file.link

TABLE length(outgoing-links) as 出链数, 
       length(incoming-links) as 入链数
FROM "3-Resources/永久笔记"
SORT length(incoming-links) DESC
LIMIT 10

# .obsidian/obsidian-git/config.json
{
  "commitMessage": "vault backup: {{date}}",
  "autoBackupInterval": 60,  // 分钟
  "autoPush": true,
  "autoPullOnBoot": true
}

#!/bin/bash
cd ~/knowledge-base
git add .
git commit -m "vault backup: $(date '+%Y-%m-%d %H:%M')"
git push origin main
echo "备份完成：$(date)"

# 每小时自动备份
0 * * * * /bin/bash ~/knowledge-base/scripts/backup.sh

#!/usr/bin/env python3
"""
AI 自动标签脚本
使用本地 LLM 分析笔记内容，生成建议标签
"""

import os
import re
from pathlib import Path
from openai import OpenAI

# 配置
VAULT_PATH = "/root/knowledge-base/0-Inbox"
API_KEY = os.getenv("SILICONFLOW_API_KEY")
API_URL = "https://api.siliconflow.com/v1"

client = OpenAI(api_key=API_KEY, base_url=API_URL)

def extract_content(file_path):
    """提取 Markdown 内容（移除 frontmatter）"""
    with open(file_path, 'r', encoding='utf-8') as f:
        content = f.read()
    # 移除 frontmatter
    content = re.sub(r'^---\n.*?\n---\n', '', content, flags=re.DOTALL)
    return content

def generate_tags(content):
    """使用 AI 生成标签"""
    prompt = f"""
分析以下笔记内容，生成 3-5 个标签。
要求：
1. 标签简洁（2-4 个字）
2. 使用现有标签体系（技术、学习、项目、方法、工具等）
3. 输出格式：#标签 1 #标签 2 #标签 3

笔记内容：
{content[:1000]}  # 限制长度
"""

    response = client.chat.completions.create(
        model="deepseek-ai/DeepSeek-V3",
        messages=[{"role": "user", "content": prompt}],
        max_tokens=100,
        temperature=0.3
    )

    return response.choices[0].message.content

def add_tags_to_file(file_path, tags):
    """将标签添加到文件 frontmatter"""
    with open(file_path, 'r', encoding='utf-8') as f:
        content = f.read()

    # 查找 frontmatter 结束位置
    match = re.search(r'^---\n.*?\n---\n', content, flags=re.DOTALL)
    if match:
        insert_pos = match.end()
        # 在 frontmatter 后添加 tags 行
        lines = content[:insert_pos].rstrip().split('\n')
        # 查找 tags 行或创建新行
        tags_line = f"tags: {tags}\n"
        content = content[:insert_pos-1] + '\n' + tags_line + content[insert_pos:]

    with open(file_path, 'w', encoding='utf-8') as f:
        f.write(content)

def main():
    """主函数"""
    for file_path in Path(VAULT_PATH).glob("*.md"):
        print(f"处理：{file_path.name}")
        content = extract_content(file_path)
        tags = generate_tags(content)
        print(f"建议标签：{tags}")
        # 手动确认后取消下面注释
        # add_tags_to_file(file_path, tags)

if __name__ == "__main__":
    main()

# 运行自动标签脚本
python3 scripts/auto-tag.py

# 输出示例
处理：AI 知识管理实践.md
建议标签：#AI #知识管理 #自动化

from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("SILICONFLOW_API_KEY"),
    base_url="https://api.siliconflow.com/v1"
)

def get_embedding(text):
    response = client.embeddings.create(
        model="BAAI/bge-large-zh-v1.5",
        input=text
    )
    return response.data[0].embedding

from sklearn.metrics.pairwise import cosine_similarity
import numpy as np

def find_similar_notes(query_embedding, note_embeddings, top_k=5):
    """查找最相似的笔记"""
    similarities = cosine_similarity(
        [query_embedding], 
        note_embeddings
    )[0]

    top_indices = np.argsort(similarities)[::-1][:top_k]
    return [(idx, similarities[idx]) for idx in top_indices]

#!/usr/bin/env python3
"""
AI 摘要生成脚本
为文献笔记生成结构化摘要
"""

import os
from pathlib import Path
from openai import OpenAI

API_KEY = os.getenv("SILICONFLOW_API_KEY")
client = OpenAI(api_key=API_KEY, base_url="https://api.siliconflow.com/v1")

def summarize_article(content):
    """生成结构化摘要"""
    prompt = f"""
为以下文章生成结构化摘要（300 字以内）：

格式：
【核心观点】1-2 句话
【关键论据】3-5 个要点
【我的启发】1-2 句个人思考

文章内容：
{content[:2000]}
"""

    response = client.chat.completions.create(
        model="deepseek-ai/DeepSeek-V3",
        messages=[{"role": "user", "content": prompt}],
        max_tokens=400,
        temperature=0.5
    )

    return response.choices[0].message.content

def main():
    vault_path = Path("/root/knowledge-base/0-Inbox")
    for file_path in vault_path.glob("*.md"):
        if "摘要" not in file_path.name:
            continue
        content = file_path.read_text(encoding='utf-8')
        summary = summarize_article(content)
        print(f"=== {file_path.name} ===\n{summary}\n")

if __name__ == "__main__":
    main()

1. 将仓库放在 iCloud Drive
2. 所有设备登录同一 Apple ID
3. Obsidian 打开 iCloud 中的仓库

# 安装 Syncthing
sudo apt install syncthing

# 配置同步文件夹
# 设置：~/knowledge-base
# 设备：手机、平板、电脑

# 每天手动同步
git pull origin main
# 编辑...
git add .
git commit -m "update"
git push

主仓库：~/knowledge-base（电脑）
备份 1：Git 私有仓库（GitHub）
备份 2：移动硬盘（每周手动备份）
备份 3：NAS（自动同步）

#!/bin/bash
# 3-2-1 备份脚本

VAULT=~/knowledge-base
DATE=$(date +%Y%m%d)

# 本地备份到移动硬盘
rsync -av $VAULT/ /mnt/backup/knowledge-base-$DATE/

# Git 备份
cd $VAULT
git add .
git commit -m "backup: $DATE"
git push

# 压缩归档
tar -czf ~/backups/knowledge-base-$DATE.tar.gz $VAULT

echo "备份完成：$DATE"

# 1. Notion 导出为 Markdown
# 设置 → Export → Markdown & CSV

# 2. 使用转换脚本
python3 scripts/notion-to-obsidian.py

# 3. 手动调整格式
# - 修复内部链接
# - 调整标签格式

# 使用官方导入工具
# https://help.evernote.com/hc/en-us/articles/360052563914

# 或使用第三方工具
# https://github.com/obsidianmd/obsidian-importer

设置 → 图谱视图 → 限制节点数：500

设置 → 社区插件 → 禁用不常用的

按领域拆分：
- knowledge-base-personal
- knowledge-base-work
- knowledge-base-study

设置 → 外观 → 启用硬件加速

第 1 周：只写日记，熟悉基本操作
第 2 周：开始记录读书笔记
第 3 周：尝试双向链接
第 4 周：引入模板系统
第 2 月：配置 Dataview 查询
第 3 月：引入 AI 辅助

# 周回顾模板

## 本周新增笔记
{{dataview: 本周创建的笔记数量}}

## 最有价值的笔记
1. 
2. 
3. 

## 需要处理的闪念
- [ ] 

## 知识缺口发现
- 

## 下周改进
- [ ] 

必备:
  - Dataview
  - Templater
  - QuickAdd
  - Calendar

进阶:
  - Smart Connections (AI)
  - Obsidian Git
  - Excalidraw
  - Kanban