Obsidian 知识库

Obsidian 仓库 = 包含 Markdown 文件的文件夹 +.obsidian/ 文件夹配置。

配置

• 仓库路径： /home/ruslan/webdav/data/ruslain
• 环境变量： OBSIDIAN_VAULT=/home/ruslan/webdav/data/ruslain

命令行界面用法

脚本位置：/home/ruslan/.openclaw/workspace/skills/obsidian/scripts

注意：全局标志（--vault、--json）必须放在命令**之前**。

export OBSIDIAN_VAULT=/home/ruslan/webdav/data/ruslain
cd /home/ruslan/.openclaw/workspace/skills/obsidian/scripts

# Search (fuzzy/phonetic) - uses ripgrep for speed
python3 obsidian_search.py "$OBSIDIAN_VAULT" "query" --limit 10 --json

# List notes
python3 obsidian_cli.py --json list                    # all notes
python3 obsidian_cli.py --json list "Projects"         # in folder

# List folders
python3 obsidian_cli.py --json folders

# Read note
python3 obsidian_cli.py --json read "Note Name"

# Create note
python3 obsidian_cli.py --json create "Title" -c "Content" -f "Folder" -t tag1 tag2
python3 obsidian_cli.py --json create "Title" -c "Content" --auto-folder  # auto-detect folder

# Edit note
python3 obsidian_cli.py --json edit "Note" append -c "Text to append"
python3 obsidian_cli.py --json edit "Note" prepend -c "Text at start"
python3 obsidian_cli.py --json edit "Note" replace -c "New full content"
python3 obsidian_cli.py --json edit "Note" replace-section -s "Summary" -c "New section text"

# Tags
python3 obsidian_cli.py --json tags

# Links (incoming/outgoing)
python3 obsidian_cli.py --json links "Note Name"

# Suggest folder for content
python3 obsidian_cli.py --json suggest-folder "content text" --title "Note Title"

工作流程：查询知识库

1. 运行obsidian_search.py并附带用户查询
2. 如需上下文，请阅读顶部结果
3. 根据找到的内容构建答案
4. 引用来源：[[笔记名称]]

工作流程：保存笔记

1. 如果未指定文件夹 → 运行建议文件夹或使用--自动文件夹
2. 使用以下命令创建笔记创建命令
3. 根据内容添加适当的标签
4. 向用户报告创建的路径

工作流程：通过提示编辑笔记

用户提示示例：

• "在笔记X末尾添加摘要" →编辑 X 追加 -c "..."
• "更简洁地重写笔记Y" → 读取笔记，重写，编辑 Y 替换 -c "..."
• "在笔记Z中添加'结论'部分" →编辑 Z 替换部分 -s "结论" -c "..."

笔记格式

---
created: 2024-01-15T10:30:00
modified: 2024-01-15T12:00:00
tags:
  - project
  - work
---

# Title

Content with [[wikilinks]] and #inline-tags.

维基链接

• [[笔记名称]]— 指向笔记的链接
• [[笔记名称|显示文本]]— 带别名的链接
• [[笔记名称#章节]]— 指向章节的链接

前置元数据字段

标准字段：

• 创建时间— 创建时间戳
• 修改时间— 最后编辑时间戳
• 标签— 标签列表
• 别名— 用于链接的替代名称

搜索行为

obsidian_search.py使用：

• ripgrep 进行快速初始筛选
• 标题匹配（最高权重）
• 标签匹配
• 带有音译（俄语↔英语）的模糊内容搜索
• 返回：路径、标题、分数、匹配上下文