用途:在 Obsidian vault(笔记库)中创建、搜索、读取和链接笔记。Obsidian vault 本质是 Markdown 文件目录,多数操作无需专用 CLI 即可完成。
准备方式: 方式一,直接文件访问,无需安装,用 Bash 直接读写 .md 文件。 方式二,使用 obsidian-cli 获得更丰富操作:npm install -g obsidian-cli;或用社区工具 obsidian-export:cargo install obsidian-export。 配置库路径:export OBSIDIAN_VAULT="$HOME/Documents/ObsidianVault",可加入 ~/.zshrc 或 ~/.bashrc 持久化。
主要能力与用法:列出笔记 find "$OBSIDIAN_VAULT" -name ".md" -type f;搜索内容 grep -r "<query>" "$OBSIDIAN_VAULT" --include=".md" -l;读取 cat "$OBSIDIAN_VAULT/<Note Name>.md";创建可写入对应路径;追加用 echo 重定向;按文件夹列出用 ls。内部链接使用 Obsidian wikilink 语法 [[Note Name]]、[[Note Name|Display Text]]、[[Note Name#Heading]]。元数据使用 YAML frontmatter(tags、date、aliases 等)。
规则与限制:先检查 OBSIDIAN_VAULT 是否设置,未设置需向用户询问路径并建议写入 shell 配置;简单读写优先用直接文件访问;创建笔记时使用规范 Markdown 与 YAML frontmatter;读取超过 100 行的长笔记时只显示前 50 行,完整内容保存到 workspace/;追加时先读取以保留已有 frontmatter;文件名避免特殊字符,仅用 - 和 _;回复简洁,用 1-2 行确认路径与操作。其他细节暂未提供。