名称： obsidian
描述： >
将 Obsidian 知识库作为知识库使用。功能：支持跨所有笔记的模糊/拼音搜索、新笔记自动文件夹检测、创建/读取/编辑带 Frontmatter 的笔记、管理标签和维基链接。
使用场景：查询知识库、保存笔记/文档、根据用户指令编辑现有笔记。

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

# 搜索（模糊/拼音） - 使用 ripgrep 提升速度
python3 obsidian_search.py "$OBSIDIAN_VAULT" "查询词" --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 "笔记名称"

# 创建笔记
python3 obsidian_cli.py --json create "标题" -c "内容" -f "文件夹" -t 标签1 标签2
python3 obsidian_cli.py --json create "标题" -c "内容" --auto-folder  # 自动检测文件夹

# 编辑笔记
python3 obsidian_cli.py --json edit "笔记" append -c "追加的文本"
python3 obsidian_cli.py --json edit "笔记" prepend -c "开头的文本"
python3 obsidian_cli.py --json edit "笔记" replace -c "新的完整内容"
python3 obsidian_cli.py --json edit "笔记" replace-section -s "章节标题" -c "新的章节内容"

# 标签管理
python3 obsidian_cli.py --json tags

# 链接（入链/出链）
python3 obsidian_cli.py --json links "笔记名称"

# 根据内容建议文件夹
python3 obsidian_cli.py --json suggest-folder "内容文本" --title "笔记标题"

工作流：查询知识库

1. 使用用户查询运行 obsidian_search.py
2. 如需上下文，读取排名靠前的搜索结果
3. 基于找到的内容组织答案
4. 引用来源：[[笔记名称]]

工作流：保存笔记

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
**标签：**
  - project
  - work
---

# 标题

内容包含 [[维基链接]] 和 #行内标签。

维基链接

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

Frontmatter 字段

标准字段：
- created — 创建时间戳
- modified — 最后编辑时间戳
- tags — 标签列表
- aliases — 用于链接的替代名称

搜索行为

obsidian_search.py 使用：
- ripgrep 进行快速初始过滤
- 标题匹配（最高权重）
- 标签匹配
- 带拼音音译的模糊内容搜索（俄语↔英语）
- 返回：路径、标题、匹配度、匹配的上下文