Obsidian 知识库

Obsidian 仓库（vault）= 包含 Markdown 文件的文件夹 + .obsidian/ 配置目录。

配置

• 仓库路径（Vault Path）： /home/ruslan/webdav/data/ruslain
• 环境变量（Env）： OBSIDIAN_VAULT=/home/ruslan/webdav/data/ruslain

CLI 使用方式

脚本位置：/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

# 搜索（支持模糊匹配与音译匹配）——使用 ripgrep 实现高速检索
python3 obsidian_search.py "$OBSIDIAN_VAULT" "query" --limit 10 --json

# 列出笔记
python3 obsidian_cli.py --json list                    # 所有笔记
python3 obsidian_cli.py --json list "Projects"         # 指定文件夹内的笔记

# 列出文件夹
python3 obsidian_cli.py --json folders

# 读取笔记
python3 obsidian_cli.py --json read "Note Name"

# 创建笔记
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  # 自动推断文件夹

# 编辑笔记
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"

# 查看标签
python3 obsidian_cli.py --json tags

# 查看链接（入链 / 出链）
python3 obsidian_cli.py --json links "Note Name"

# 为内容推荐存放文件夹
python3 obsidian_cli.py --json suggest-folder "content text" --title "Note Title"

工作流：查询知识库

1. 使用用户查询运行 obsidian_search.py
2. 如有必要，读取排名靠前的结果以获取上下文
3. 基于检索到的内容组织回答
4. 引用来源时使用：[[Note Name]]

工作流：保存笔记

1. 若未指定文件夹 → 运行 suggest-folder 或使用 --auto-folder
2. 通过 create 命令创建笔记
3. 根据内容添加合适的标签
4. 向用户报告新创建笔记的路径

工作流：按提示编辑笔记

用户可能提出的提示示例：

• “在笔记 X 末尾添加简历” → edit X append -c "..."
• “将笔记 Y 重写得更简洁” → 先读取笔记，再重写，最后执行 edit Y replace -c "..."
• “在笔记 Z 中添加‘结论’章节” → edit Z replace-section -s "Выводы" -c "..."

笔记格式

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

# Title

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

Wiki 链接（Wikilinks）

• [[Note Name]] —— 指向某篇笔记的链接
• [[Note Name|Display Text]] —— 带别名显示的链接
• [[Note Name#Section]] —— 指向笔记中某节的链接

Frontmatter 字段

标准字段包括：

• created —— 创建时间戳
• modified —— 最后一次编辑时间戳
• tags —— 标签列表
• aliases —— 用于链接的别名（替代名称）

搜索行为

obsidian_search.py 使用以下策略：

• 使用 ripgrep 进行快速初始过滤
• 标题匹配（权重最高）
• 标签匹配
• 支持模糊内容搜索，并启用俄英音译转换（RU↔EN）
• 返回结果包含：路径、标题、匹配得分、命中上下文