Obsidian 仓库读写
对 Obsidian 仓库做模糊与拼音检索,然后读、建、改笔记,含 frontmatter、标签、wikilink 与自动归档目录,产出可直接用的笔记改动。
功能与用途
查资料时想直接问笔记库而不是翻文件夹,写完东西又想一句话就存进对应目录。这个 Skill 提供 Python 脚本:搜索用 ripgrep 快速初筛,再按标题权重、标签匹配和带音译的模糊内容匹配打分;写入时支持建笔记、追加、前插、整篇替换、替换指定小节,还能只给内容就自动推荐该放哪个文件夹,返回结果带路径、标题、分数和命中片段。
适用场景
- 模糊检索知识库:当记不清具体标题或存在拼写偏差时,利用模糊与音译匹配快速定位相关笔记、引用出处与上下文片段。
- 自动推荐目录归档:将散落的想法或新整理的资料快速存入知识库,支持自动判断推荐所属文件夹,并规范生成标签与前置元数据。
- 指令式更新指定小节:通过指令直接向现有笔记末尾追加总结、开头插入摘要或精确替换特定小节,无需手动定位翻找文件。
适用人群
- 用 Obsidian 做第二大脑的开发者
- 需要按内容自动归档资料的研究者
- 把笔记库当知识底座做问答的内容工作者
使用步骤
- 配置仓库路径:设置 OBSIDIAN_VAULT 环境变量,并把仓库位置和脚本目录确认好。
- 用搜索脚本按关键词检索,看返回的路径、标题、分数和命中上下文。
- 需要建立上下文就读取排名靠前的笔记全文。
- 写入时明确是新建还是编辑:新建可指定目录或让脚本自动推荐,编辑选追加、前插、整篇替换或替换小节。
- 核对改动后的笔记路径与 frontmatter,确认标签和双链符合预期。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 知识
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- 1.0.0
- 最近更新
- 2026-05-11
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Work with Obsidian vaults as a knowledge base. Features: fuzzy/phonetic search across all notes, auto-folder detection for new notes, create/read/edit notes with frontmatter, manage tags and wikilinks. Use when: querying knowledge base, saving notes/documents, editing existing notes by user instructions.
使用前准备
- 需要 Python3 环境(含 ripgrep)并配置 OBSIDIAN_VAULT 环境变量指向仓库
- 示例中的仓库路径与脚本目录为作者本机路径,需按自己环境替换。
依赖与权限
- 读取用户主动提供的内容