Obsidian KB

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

Audits

Pending

ClawScanPass

Agentic behavior and permission review.

Static analysisPending

Pattern checks against bundled files.

VirusTotalPending

Multi-engine malware detections and file reputation.

Install

openclaw skills install obsidian-kb

Obsidian 知识库管理

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

功能选择

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

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

功能1: 扫描更新

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

执行步骤

确认知识库路径
- 默认路径: <YOUR_VAULT_PATH>
- 询问用户是否使用默认路径

执行扫描

# 统计总文件数
find "<YOUR_VAULT_PATH>" -type f -name "*.md" | wc -l

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

分析密度分布
- 根据 kb-density-rules.md 中的规则分类
- 统计高/中/低密度文件数量
- 识别新增文件夹
更新规则文件
- 更新统计数据部分
- 添加新发现的文件夹（如有）
- 同步更新两个位置：
  - ~/.claude/kb-density-rules.md
  - `<YOUR_WORKSPACE_PATH>
生成扫描报告
- 总文件数变化
- 各密度级别文件数变化
- 新增/删除的文件夹
- 扫描时间戳

输出格式

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

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

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

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

功能2: 查看报告

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

执行步骤

读取规则文件
- 读取 ~/.claude/kb-density-rules.md
- 提取统计数据部分
生成可视化报告
- 密度分布饼图（文字描述）
- 各文件夹文件数排行
- 高价值文件夹列表
显示关键指标
- 知识库总规模
- 有效文件占比
- 高密度文件占比
- 最后更新时间

输出格式

## Obsidian 知识库现状报告

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

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

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

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

功能3: 调整规则

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

执行步骤

显示当前规则
- 读取并显示当前所有文件夹的密度分类
- 按密度级别分组显示
询问调整需求
- 用户想调整哪个文件夹？
- 调整为什么密度级别？（High/Medium/Low）
- 调整原因？（用于记录）
验证调整
- 检查文件夹是否存在
- 显示该文件夹当前文件数
- 确认调整是否合理
更新规则文件
- 修改密度分类
- 添加调整记录（时间、原因）
- 同步更新两个位置
重新统计
- 基于新规则重新计算统计数据
- 显示调整前后对比

输出格式

## 规则调整记录

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

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

功能4: 导出数据

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

执行步骤

选择导出格式
- JSON: 完整数据，适合程序处理
- CSV: 表格数据，适合Excel分析
选择导出内容
- 完整统计数据
- 仅文件夹列表
- 仅密度分类
- 自定义选择
生成导出文件
- 文件名: obsidian-kb-export-[时间戳].[格式]
- 保存位置: 询问用户或使用默认位置
验证导出
- 检查文件是否生成
- 显示文件大小和路径

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 导出格式

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

功能5: 对比分析

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

执行步骤

加载历史数据
- 读取当前规则文件中的统计数据
- 询问用户是否有历史导出文件
- 或执行新扫描作为对比基准
执行新扫描
- 按功能1的流程扫描知识库
- 生成新的统计数据
对比分析
- 总文件数变化
- 各密度级别变化
- 文件夹级别变化
- 新增/删除的文件夹
趋势分析
- 知识库增长速度
- 高价值内容占比变化
- 活跃文件夹识别
- 冷门文件夹识别
生成对比报告
- 可视化变化趋势
- 关键指标对比
- 建议和洞察

输出格式

## Obsidian 知识库对比分析

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

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

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

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

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

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

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

使用说明

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

注意事项

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

Obsidian KB

Audits

Install

Obsidian 知识库管理

功能选择

功能1: 扫描更新

执行步骤

输出格式

功能2: 查看报告

执行步骤

输出格式

功能3: 调整规则

执行步骤

输出格式

功能4: 导出数据

执行步骤

JSON 导出格式

CSV 导出格式

功能5: 对比分析

执行步骤

输出格式

相关文档

使用说明

注意事项