doc-obsidian 用两个 CLI 工具统一管理 Obsidian 仓库,无需打开 Obsidian 应用。qmd 负责关键词、语义和混合搜索,可执行 npm i -g @anthropic/qmd 安装;notesmd-cli 负责增删改查、移动、frontmatter、日记和反向链接,可执行 brew install yakitrak/yakitrak/notesmd-cli 安装。
初始配置:先用 notesmd-cli set-default "VaultName" 设置默认仓库,再执行 qmd collection add ~/path/to/vault --name vault --mask "**/*.md" 建立索引,随后 qmd embed 生成向量嵌入。用 notesmd-cli print-default 和 qmd status 验证。保持索引更新可执行 qmd update 与 qmd embed。
搜索方面,qmd search 用于关键词,qmd vsearch 用于语义,qmd query 用于混合搜索(质量最佳),支持 --json、--md、--full、-n 等输出参数。笔记操作方面,notesmd-cli 可创建、追加、覆盖、读取、移动重命名、删除和查看反向链接;创建时 --append 与 --overwrite 互斥,未指定时已存在文件不变。移动会自动更新全库的 [[wikilinks]] 和 markdown 链接,而删除是永久性的且不会更新引用链接。
该技能无局部编辑功能,只有追加和覆盖;如需替换某段或修正某行,需先用 notesmd-cli print-default --path-only 解析仓库路径,再读取内容并用 Edit 工具按完整路径修改,切勿硬编码路径或使用 sed/awk。日记功能通过 notesmd-cli daily 创建或打开当天笔记,文件夹、日期格式和模板读取 .obsidian/daily-notes.json。模板以普通 markdown 文件存放在 meta/templates/,用 cp 复用。frontmatter 支持打印、编辑和删除,值会自动推断类型。该技能也可作为 AI 代理的持久记忆库,用语义或混合搜索检索上下文。部分细节资料未提供。