Obsidian KB

Obsidian知识库管理工具,提供扫描更新、查看报告、调整规则、导出数据、对比分析五大功能

Obsidian 知识库管理

管理 Obsidian Obsidian 知识库的密度分类、统计分析和规则维护。

功能选择

使用本技能时，请选择以下功能之一：

1. 扫描更新 - 重新扫描知识库，更新统计数据和密度分类
2. 查看报告 - 查看当前知识库统计报告和密度分布
3. 调整规则 - 修改文件夹密度分类规则
4. 导出数据 - 导出知识库统计数据（JSON/CSV格式）
5. 对比分析 - 对比两次扫描结果，分析知识库变化

---

功能1: 扫描更新

重新扫描 Obsidian 知识库，更新统计数据。

执行步骤

1. 确认知识库路径

   • 默认路径: <YOUR_VAULT_PATH>
   • 询问用户是否使用默认路径

2. 执行扫描

   bash

   # 统计总文件数
   find "<YOUR_VAULT_PATH>" -type f -name "*.md" | wc -l
   
   # 按文件夹分类统计
   find "<YOUR_VAULT_PATH>" -type f -name "*.md" -printf "%h\n" | sort | uniq -c
   

3. 分析密度分布

   • 根据 kb-density-rules.md 中的规则分类
   • 统计高/中/低密度文件数量
   • 识别新增文件夹

4. 更新规则文件

   • 更新统计数据部分
   • 添加新发现的文件夹（如有）
   • 同步更新两个位置：
     • ~/.claude/kb-density-rules.md
     • `<YOUR_WORKSPACE_PATH>

5. 生成扫描报告

   • 总文件数变化
   • 各密度级别文件数变化
   • 新增/删除的文件夹
   • 扫描时间戳

输出格式

markdown

## Obsidian 知识库扫描报告
**扫描时间:** [时间戳]
**知识库路径:** <YOUR_VAULT_PATH>

### 统计概览
- 总文件数: XXX (较上次 +/-XX)
- 高密度文件: XXX (较上次 +/-XX)
- 中密度文件: XXX (较上次 +/-XX)
- 低密度文件: XXX (较上次 +/-XX)
- 垃圾箱文件: XXX (较上次 +/-XX)

### 变化详情
[列出主要变化]

### 新增文件夹
[列出新发现的文件夹，需要分类]

---

功能2: 查看报告

查看当前知识库统计报告和密度分布。

执行步骤

1. 读取规则文件

   • 读取 ~/.claude/kb-density-rules.md
   • 提取统计数据部分

2. 生成可视化报告

   • 密度分布饼图（文字描述）
   • 各文件夹文件数排行
   • 高价值文件夹列表

3. 显示关键指标

   • 知识库总规模
   • 有效文件占比
   • 高密度文件占比
   • 最后更新时间

输出格式

markdown

## Obsidian 知识库现状报告

### 核心指标
- 📊 总文件数: XXX
- ✅ 有效文件: XXX (XX%)
- 🔥 高密度文件: XXX (XX%)
- 📅 最后更新: [时间]

### 密度分布
- 高密度 (High): XXX 文件 (XX%)
- 中密度 (Medium): XXX 文件 (XX%)
- 低密度 (Low): XXX 文件 (XX%)
- 垃圾箱 (Trash): XXX 文件 (XX%)

### 高价值文件夹 TOP 10
[按文件数排序的高密度文件夹]

### 使用建议
[基于当前统计数据的使用建议]

---

功能3: 调整规则

修改文件夹密度分类规则。

执行步骤

1. 显示当前规则

   • 读取并显示当前所有文件夹的密度分类
   • 按密度级别分组显示

2. 询问调整需求

   • 用户想调整哪个文件夹？
   • 调整为什么密度级别？（High/Medium/Low）
   • 调整原因？（用于记录）

3. 验证调整

   • 检查文件夹是否存在
   • 显示该文件夹当前文件数
   • 确认调整是否合理

4. 更新规则文件

   • 修改密度分类
   • 添加调整记录（时间、原因）
   • 同步更新两个位置

5. 重新统计

   • 基于新规则重新计算统计数据
   • 显示调整前后对比

输出格式

markdown

## 规则调整记录

**调整时间:** [时间戳]
**调整文件夹:** [文件夹路径]
**原密度级别:** [High/Medium/Low]
**新密度级别:** [High/Medium/Low]
**调整原因:** [用户提供的原因]

### 影响分析
- 该文件夹文件数: XXX
- 调整后高密度文件总数: XXX (变化 +/-XX)
- 调整后中密度文件总数: XXX (变化 +/-XX)
- 调整后低密度文件总数: XXX (变化 +/-XX)

---

功能4: 导出数据

导出知识库统计数据为结构化格式。

执行步骤

1. 选择导出格式

   • JSON: 完整数据，适合程序处理
   • CSV: 表格数据，适合Excel分析

2. 选择导出内容

   • 完整统计数据
   • 仅文件夹列表
   • 仅密度分类
   • 自定义选择

3. 生成导出文件

   • 文件名: obsidian-kb-export-[时间戳].[格式]
   • 保存位置: 询问用户或使用默认位置

4. 验证导出

   • 检查文件是否生成
   • 显示文件大小和路径

JSON 导出格式

json

{
  "export_time": "2026-02-15T14:30:00",
  "knowledge_base_path": "D:\\Obsidian\\Obsidian\\Obsidian",
  "statistics": {
    "total_files": 2505,
    "high_density": 175,
    "medium_density": 57,
    "low_density": 481,
    "trash": 1785
  },
  "folders": [
    {
      "path": "领域",
      "density": "High",
      "file_count": 58,
      "description": "专业领域知识"
    }
  ]
}

CSV 导出格式

csv

文件夹路径,密度级别,文件数,说明
领域,High,58,专业领域知识
项目,High,47,具体项目记录
...

---

功能5: 对比分析

对比两次扫描结果，分析知识库变化趋势。

执行步骤

1. 加载历史数据

   • 读取当前规则文件中的统计数据
   • 询问用户是否有历史导出文件
   • 或执行新扫描作为对比基准

2. 执行新扫描

   • 按功能1的流程扫描知识库
   • 生成新的统计数据

3. 对比分析

   • 总文件数变化
   • 各密度级别变化
   • 文件夹级别变化
   • 新增/删除的文件夹

4. 趋势分析

   • 知识库增长速度
   • 高价值内容占比变化
   • 活跃文件夹识别
   • 冷门文件夹识别

5. 生成对比报告

   • 可视化变化趋势
   • 关键指标对比
   • 建议和洞察

输出格式

markdown

## Obsidian 知识库对比分析

**对比时间段:** [开始时间] → [结束时间]
**时间跨度:** XX天

### 整体变化
- 总文件数: XXX → XXX (+/-XX, +/-XX%)
- 高密度文件: XXX → XXX (+/-XX, +/-XX%)
- 中密度文件: XXX → XXX (+/-XX, +/-XX%)
- 低密度文件: XXX → XXX (+/-XX, +/-XX%)

### 增长最快的文件夹 TOP 5
[列出增长最多的文件夹]

### 新增文件夹
[列出新增的文件夹]

### 删除/清理的文件夹
[列出删除的文件夹]

### 趋势洞察
- 📈 知识库日均增长: XX 文件/天
- 🎯 高价值内容占比: XX% → XX%
- 🔥 最活跃领域: [文件夹名称]
- ❄️ 冷门领域: [文件夹名称]

### 建议
[基于变化趋势的使用建议]

---

相关文档

• 密度规则文件: ~/.claude/kb-density-rules.md

使用说明

1. 每次使用时选择一个功能
2. 功能1（扫描更新）建议每周执行一次
3. 功能3（调整规则）会自动触发重新统计
4. 功能4（导出数据）可用于备份和外部分析
5. 功能5（对比分析）建议每月执行一次，追踪知识库成长

注意事项

• 扫描大型知识库可能需要较长时间
• 调整规则前建议先导出当前数据备份
• 对比分析需要至少两次扫描数据
• 所有修改会同步更新全局和工作区两个位置